add hg and python

1 files changed, 54 insertions, 0 deletions

diff --git a/sys/src/cmd/python/Doc/lib/libfpformat.tex b/sys/src/cmd/python/Doc/lib/libfpformat.tex
new file mode 100644
index 000000000..a3a628223
--- /dev/null
+++ b/sys/src/cmd/python/Doc/lib/libfpformat.tex
@@ -0,0 +1,54 @@
+\section{\module{fpformat} ---
+         Floating point conversions}
+
+\declaremodule{standard}{fpformat}
+\sectionauthor{Moshe Zadka}{moshez@zadka.site.co.il}
+\modulesynopsis{General floating point formatting functions.}
+
+
+The \module{fpformat} module defines functions for dealing with
+floating point numbers representations in 100\% pure
+Python. \note{This module is unneeded: everything here could
+be done via the \code{\%} string interpolation operator.}
+
+The \module{fpformat} module defines the following functions and an
+exception:
+
+
+\begin{funcdesc}{fix}{x, digs}
+Format \var{x} as \code{[-]ddd.ddd} with \var{digs} digits after the
+point and at least one digit before.
+If \code{\var{digs} <= 0}, the decimal point is suppressed.
+
+\var{x} can be either a number or a string that looks like
+one. \var{digs} is an integer.
+
+Return value is a string.
+\end{funcdesc}
+
+\begin{funcdesc}{sci}{x, digs}
+Format \var{x} as \code{[-]d.dddE[+-]ddd} with \var{digs} digits after the 
+point and exactly one digit before.
+If \code{\var{digs} <= 0}, one digit is kept and the point is suppressed.
+
+\var{x} can be either a real number, or a string that looks like
+one. \var{digs} is an integer.
+
+Return value is a string.
+\end{funcdesc}
+
+\begin{excdesc}{NotANumber}
+Exception raised when a string passed to \function{fix()} or
+\function{sci()} as the \var{x} parameter does not look like a number.
+This is a subclass of \exception{ValueError} when the standard
+exceptions are strings.  The exception value is the improperly
+formatted string that caused the exception to be raised.
+\end{excdesc}
+
+Example:
+
+\begin{verbatim}
+>>> import fpformat
+>>> fpformat.fix(1.23, 1)
+'1.2'
+\end{verbatim}