From 295da24eafd9c3bb9326d62a1a2e822059698b2b Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Mon, 10 Aug 1998 19:42:37 +0000 Subject: New section header style. Fix up a few synopses. --- Doc/lib/libaifc.tex | 3 ++- Doc/lib/libal.tex | 6 ++++-- Doc/lib/libamoeba.tex | 3 ++- Doc/lib/libanydbm.tex | 6 ++++-- Doc/lib/libarray.tex | 3 ++- Doc/lib/libaudioop.tex | 3 ++- Doc/lib/libbase64.tex | 6 ++++-- Doc/lib/libbasehttp.tex | 3 ++- Doc/lib/libbastion.tex | 3 ++- Doc/lib/libbinascii.tex | 3 ++- Doc/lib/libbinhex.tex | 3 ++- Doc/lib/libbisect.tex | 3 ++- Doc/lib/libbltin.tex | 3 ++- Doc/lib/libcalendar.tex | 3 ++- Doc/lib/libcd.tex | 3 ++- Doc/lib/libcgi.tex | 7 ++++--- Doc/lib/libcmath.tex | 3 ++- Doc/lib/libcmd.tex | 9 +++++---- Doc/lib/libcode.tex | 3 ++- Doc/lib/libcommands.tex | 6 +++--- Doc/lib/libcopy.tex | 3 ++- Doc/lib/libcopyreg.tex | 3 ++- Doc/lib/libcrypt.tex | 3 ++- Doc/lib/libdbm.tex | 3 ++- Doc/lib/libdis.tex | 3 ++- Doc/lib/liberrno.tex | 3 ++- Doc/lib/libfcntl.tex | 3 ++- Doc/lib/libfileinput.tex | 11 ++++++----- Doc/lib/libfl.tex | 9 ++++++--- Doc/lib/libfm.tex | 3 ++- Doc/lib/libfnmatch.tex | 3 ++- Doc/lib/libformatter.tex | 3 ++- Doc/lib/libftplib.tex | 3 ++- Doc/lib/libfuncs.tex | 3 +-- Doc/lib/libgdbm.tex | 3 ++- Doc/lib/libgetopt.tex | 3 ++- Doc/lib/libgl.tex | 9 ++++++--- Doc/lib/libglob.tex | 3 ++- Doc/lib/libgopherlib.tex | 3 ++- Doc/lib/libgrp.tex | 3 ++- Doc/lib/libgzip.tex | 3 ++- Doc/lib/libhtmllib.tex | 3 ++- Doc/lib/libhttplib.tex | 3 ++- Doc/lib/libimageop.tex | 3 ++- Doc/lib/libimaplib.tex | 7 ++++--- Doc/lib/libimgfile.tex | 3 ++- Doc/lib/libimghdr.tex | 3 ++- Doc/lib/libimp.tex | 3 ++- Doc/lib/libjpeg.tex | 3 ++- Doc/lib/libkeyword.tex | 5 +++-- Doc/lib/liblocale.tex | 3 ++- Doc/lib/libmailbox.tex | 3 ++- Doc/lib/libmailcap.tex | 3 ++- Doc/lib/libmain.tex | 3 ++- Doc/lib/libmarshal.tex | 7 ++++--- Doc/lib/libmath.tex | 3 ++- Doc/lib/libmd5.tex | 3 ++- Doc/lib/libmimetools.tex | 3 ++- Doc/lib/libmimetypes.tex | 3 ++- Doc/lib/libmimify.tex | 3 ++- Doc/lib/libmpz.tex | 6 ++++-- Doc/lib/libmultifile.tex | 5 +++-- Doc/lib/libni.tex | 3 ++- Doc/lib/libnntplib.tex | 3 ++- Doc/lib/liboperator.tex | 8 ++++---- Doc/lib/libos.tex | 3 ++- Doc/lib/libpanel.tex | 9 ++++++--- Doc/lib/libparser.tex | 8 +++++--- Doc/lib/libpickle.tex | 6 ++++-- Doc/lib/libpopen2.tex | 5 ++++- Doc/lib/libpoplib.tex | 3 ++- Doc/lib/libposix.tex | 3 ++- Doc/lib/libposixfile.tex | 3 ++- Doc/lib/libposixpath.tex | 3 ++- Doc/lib/libpprint.tex | 3 ++- Doc/lib/libpwd.tex | 3 ++- Doc/lib/libqueue.tex | 5 +++-- Doc/lib/libquopri.tex | 6 ++++-- Doc/lib/librand.tex | 3 ++- Doc/lib/librandom.tex | 6 ++++-- Doc/lib/libre.tex | 3 ++- Doc/lib/libregex.tex | 3 ++- Doc/lib/libregsub.tex | 3 ++- Doc/lib/libresource.tex | 3 ++- Doc/lib/librexec.tex | 3 ++- Doc/lib/librfc822.tex | 3 ++- Doc/lib/librgbimg.tex | 5 +++-- Doc/lib/librotor.tex | 3 ++- Doc/lib/libselect.tex | 3 ++- Doc/lib/libsgmllib.tex | 3 ++- Doc/lib/libshelve.tex | 3 ++- Doc/lib/libsignal.tex | 3 ++- Doc/lib/libsite.tex | 3 ++- Doc/lib/libsmtplib.tex | 5 +++-- Doc/lib/libsocket.tex | 3 ++- Doc/lib/libsocksvr.tex | 3 ++- Doc/lib/libsoundex.tex | 3 ++- Doc/lib/libstat.tex | 18 ++++++++++-------- Doc/lib/libstdwin.tex | 9 ++++++--- Doc/lib/libstring.tex | 3 ++- Doc/lib/libstringio.tex | 6 ++++-- Doc/lib/libstruct.tex | 3 ++- Doc/lib/libsunaudio.tex | 7 ++++--- Doc/lib/libsymbol.tex | 3 ++- Doc/lib/libsys.tex | 5 +++-- Doc/lib/libsyslog.tex | 3 ++- Doc/lib/libtempfile.tex | 3 ++- Doc/lib/libtemplate.tex | 34 ++++++++++++++++++++-------------- Doc/lib/libtermios.tex | 9 ++++++--- Doc/lib/libthread.tex | 5 +++-- Doc/lib/libthreading.tex | 3 ++- Doc/lib/libtime.tex | 3 ++- Doc/lib/libtoken.tex | 3 ++- Doc/lib/libtraceback.tex | 3 ++- Doc/lib/libtypes.tex | 3 ++- Doc/lib/liburllib.tex | 3 ++- Doc/lib/liburlparse.tex | 3 ++- Doc/lib/libuser.tex | 3 ++- Doc/lib/libuserdict.tex | 6 ++++-- Doc/lib/libuu.tex | 3 ++- Doc/lib/libwhichdb.tex | 3 ++- Doc/lib/libwhrandom.tex | 3 ++- Doc/lib/libxdrlib.tex | 5 +++-- Doc/lib/libxmllib.tex | 3 ++- Doc/lib/libzlib.tex | 3 ++- Doc/templates/module.tex | 34 ++++++++++++++++++++-------------- 126 files changed, 364 insertions(+), 209 deletions(-) diff --git a/Doc/lib/libaifc.tex b/Doc/lib/libaifc.tex index d7433e7..76ff871 100644 --- a/Doc/lib/libaifc.tex +++ b/Doc/lib/libaifc.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{aifc}} +\section{\module{aifc} --- + Read and write audio files in AIFF or AIFC format.} \declaremodule{standard}{aifc} \modulesynopsis{Read and write audio files in AIFF or AIFC format.} diff --git a/Doc/lib/libal.tex b/Doc/lib/libal.tex index 8b9a8f8..e1b1e6f 100644 --- a/Doc/lib/libal.tex +++ b/Doc/lib/libal.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{al}} +\section{\module{al} --- + Audio functions on the SGI.} \declaremodule{builtin}{al} \modulesynopsis{Audio functions on the SGI.} @@ -161,7 +162,8 @@ Get status information on last error. \end{methoddesc} -\section{Standard Module \module{AL}} +\section{\module{AL} --- + Constants used with the \module{al} module.} \declaremodule{standard}{AL} \modulesynopsis{Constants used with the \module{al} module.} diff --git a/Doc/lib/libamoeba.tex b/Doc/lib/libamoeba.tex index e59b487..3bc7b89 100644 --- a/Doc/lib/libamoeba.tex +++ b/Doc/lib/libamoeba.tex @@ -1,6 +1,7 @@ \chapter{Amoeba Specific Services} -\section{Built-in Module \module{amoeba}} +\section{\module{amoeba} --- + None} \declaremodule{builtin}{amoeba} \modulesynopsis{None} diff --git a/Doc/lib/libanydbm.tex b/Doc/lib/libanydbm.tex index 2344c5a..11f5783 100644 --- a/Doc/lib/libanydbm.tex +++ b/Doc/lib/libanydbm.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{anydbm}} +\section{\module{anydbm} --- + Generic interface to DBM-style database modules.} \declaremodule{standard}{anydbm} \modulesynopsis{Generic interface to DBM-style database modules.} @@ -46,7 +47,8 @@ strings. -\section{Standard Module \module{dumbdbm}} +\section{\module{dumbdbm} --- + Portable implementation of the simple DBM interface.} \declaremodule{standard}{dumbdbm} \modulesynopsis{Portable implementation of the simple DBM interface.} diff --git a/Doc/lib/libarray.tex b/Doc/lib/libarray.tex index 4c8b5f2..b36ee26 100644 --- a/Doc/lib/libarray.tex +++ b/Doc/lib/libarray.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{array}} +\section{\module{array} --- + Efficient arrays of uniformly typed numeric values.} \declaremodule{builtin}{array} \modulesynopsis{Efficient arrays of uniformly typed numeric values.} diff --git a/Doc/lib/libaudioop.tex b/Doc/lib/libaudioop.tex index 5081a60..2a3e9b0 100644 --- a/Doc/lib/libaudioop.tex +++ b/Doc/lib/libaudioop.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{audioop}} +\section{\module{audioop} --- + Manipulate raw audio data.} \declaremodule{builtin}{audioop} \modulesynopsis{Manipulate raw audio data.} diff --git a/Doc/lib/libbase64.tex b/Doc/lib/libbase64.tex index 2d34e1d..aa68c04 100644 --- a/Doc/lib/libbase64.tex +++ b/Doc/lib/libbase64.tex @@ -1,7 +1,9 @@ -\section{Standard Module \module{base64}} +\section{\module{base64} --- + Encode and decode MIME base64 encoding.} \declaremodule{standard}{base64} -\modulesynopsis{Encode/decode binary files using the MIME base64 encoding.} +\modulesynopsis{Encode and decode files using the MIME base64 +encoding.} \indexii{base64}{encoding} \index{MIME!base64 encoding} diff --git a/Doc/lib/libbasehttp.tex b/Doc/lib/libbasehttp.tex index e680305..0a8a0fc 100644 --- a/Doc/lib/libbasehttp.tex +++ b/Doc/lib/libbasehttp.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{BaseHTTPServer}} +\section{\module{BaseHTTPServer} --- + Basic HTTP server.} \declaremodule{standard}{BaseHTTPServer} \modulesynopsis{Basic HTTP server (base class for diff --git a/Doc/lib/libbastion.tex b/Doc/lib/libbastion.tex index 08b435d..15bb029 100644 --- a/Doc/lib/libbastion.tex +++ b/Doc/lib/libbastion.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{Bastion}} +\section{\module{Bastion} --- + Providing restricted access to objects.} \declaremodule{standard}{Bastion} \modulesynopsis{Providing restricted access to objects.} diff --git a/Doc/lib/libbinascii.tex b/Doc/lib/libbinascii.tex index aedb696..239565a 100644 --- a/Doc/lib/libbinascii.tex +++ b/Doc/lib/libbinascii.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{binascii}} +\section{\module{binascii} --- + Convert between binary and various ascii-encoded representations.} \declaremodule{builtin}{binascii} \modulesynopsis{Tools for converting between binary and various diff --git a/Doc/lib/libbinhex.tex b/Doc/lib/libbinhex.tex index 782a272..1829b40 100644 --- a/Doc/lib/libbinhex.tex +++ b/Doc/lib/libbinhex.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{binhex}} +\section{\module{binhex} --- + Encode and decode files in binhex4 format.} \declaremodule{standard}{binhex} \modulesynopsis{Encode and decode files in binhex4 format.} diff --git a/Doc/lib/libbisect.tex b/Doc/lib/libbisect.tex index dd40bc4..246d6c7 100644 --- a/Doc/lib/libbisect.tex +++ b/Doc/lib/libbisect.tex @@ -2,7 +2,8 @@ % example based on the PyModules FAQ entry by Aaron Watters % . -\section{Standard Module \module{bisect}} +\section{\module{bisect} --- + Array bisection algorithms for binary searching.} \declaremodule{standard}{bisect} \modulesynopsis{Array bisection algorithms for binary searching.} diff --git a/Doc/lib/libbltin.tex b/Doc/lib/libbltin.tex index 3c5dad4..7e10985 100644 --- a/Doc/lib/libbltin.tex +++ b/Doc/lib/libbltin.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{__builtin__}} +\section{\module{__builtin__} --- + Built-in functions.} \declaremodule[builtin]{builtin}{__builtin__} \modulesynopsis{The set of built-in functions.} diff --git a/Doc/lib/libcalendar.tex b/Doc/lib/libcalendar.tex index 553f8fa..0c7207b 100644 --- a/Doc/lib/libcalendar.tex +++ b/Doc/lib/libcalendar.tex @@ -1,6 +1,7 @@ % This section was contributed by Drew Csillag . -\section{Standard Module \module{calendar}} +\section{\module{calendar} --- + Functions that emulate the \UNIX{} \program{cal} program.} \declaremodule{standard}{calendar} \modulesynopsis{Functions that emulate the \UNIX{} \program{cal} diff --git a/Doc/lib/libcd.tex b/Doc/lib/libcd.tex index 7c114d8..656d156 100644 --- a/Doc/lib/libcd.tex +++ b/Doc/lib/libcd.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{cd}} +\section{\module{cd} --- + Interface to the CD-ROM on Silicon Graphics systems.} \declaremodule{builtin}{cd} \modulesynopsis{Interface to the CD-ROM on Silicon Graphics systems.} diff --git a/Doc/lib/libcgi.tex b/Doc/lib/libcgi.tex index de8d86d..b24d490 100644 --- a/Doc/lib/libcgi.tex +++ b/Doc/lib/libcgi.tex @@ -1,8 +1,9 @@ -\section{Standard Module \module{cgi}} +\section{\module{cgi} --- + Common Gateway Interface support.} \declaremodule{standard}{cgi} -\modulesynopsis{Common Gateway Interface, used to interpret forms in server-side -scripts.} +\modulesynopsis{Common Gateway Interface support, used to interpret +forms in server-side scripts.} \indexii{WWW}{server} \indexii{CGI}{protocol} diff --git a/Doc/lib/libcmath.tex b/Doc/lib/libcmath.tex index 5337967..d5328e3 100644 --- a/Doc/lib/libcmath.tex +++ b/Doc/lib/libcmath.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{cmath}} +\section{\module{cmath} --- + Mathematical functions for complex numbers.} \declaremodule{builtin}{cmath} diff --git a/Doc/lib/libcmd.tex b/Doc/lib/libcmd.tex index d5d6cf8..153d7a3 100644 --- a/Doc/lib/libcmd.tex +++ b/Doc/lib/libcmd.tex @@ -1,9 +1,10 @@ -% Documentation by ESR -\section{Standard Module \module{cmd}} +\section{\module{cmd} --- + Build line-oriented command interpreters.} \declaremodule{standard}{cmd} +\sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com} -\modulesynopsis{Build line-oriented command interpreters; this is used by module -\module{pdb}.} +\modulesynopsis{Build line-oriented command interpreters; this is used +by module \module{pdb}.} The \class{Cmd} class provides a simple framework for writing diff --git a/Doc/lib/libcode.tex b/Doc/lib/libcode.tex index 12728c7..ab80fc1 100644 --- a/Doc/lib/libcode.tex +++ b/Doc/lib/libcode.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{code}} +\section{\module{code} --- + Code object services.} \declaremodule{standard}{code} \modulesynopsis{Code object services.} diff --git a/Doc/lib/libcommands.tex b/Doc/lib/libcommands.tex index bea1401..6b49fae 100644 --- a/Doc/lib/libcommands.tex +++ b/Doc/lib/libcommands.tex @@ -1,7 +1,7 @@ -% Documentation written by Sue Williams. - -\section{Standard Module \module{commands}} +\section{\module{commands} --- + Wrapper functions for \function{os.popen()}.} \declaremodule{standard}{commands} +\sectionauthor{Sue Williams}{sbw@provis.com} \modulesynopsis{Wrapper functions for \function{os.popen()}.} diff --git a/Doc/lib/libcopy.tex b/Doc/lib/libcopy.tex index c019476..14e667e 100644 --- a/Doc/lib/libcopy.tex +++ b/Doc/lib/libcopy.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{copy}} +\section{\module{copy} --- + Shallow and deep copy operations.} \declaremodule{standard}{copy} \modulesynopsis{Shallow and deep copy operations.} diff --git a/Doc/lib/libcopyreg.tex b/Doc/lib/libcopyreg.tex index 0874b4e..e6e6e44 100644 --- a/Doc/lib/libcopyreg.tex +++ b/Doc/lib/libcopyreg.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{copy_reg}} +\section{\module{copy_reg} --- + Register \module{pickle} support functions.} \declaremodule[copyreg]{standard}{copy_reg} \modulesynopsis{Register \module{pickle} support functions.} diff --git a/Doc/lib/libcrypt.tex b/Doc/lib/libcrypt.tex index 418b9d5..1702324 100644 --- a/Doc/lib/libcrypt.tex +++ b/Doc/lib/libcrypt.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{crypt}} +\section{\module{crypt} --- + The \cfunction{crypt()} function used to check \UNIX{} passwords.} \declaremodule{builtin}{crypt} \modulesynopsis{The \cfunction{crypt()} function used to check \UNIX{} passwords.} diff --git a/Doc/lib/libdbm.tex b/Doc/lib/libdbm.tex index b7ee647..2efa6e0 100644 --- a/Doc/lib/libdbm.tex +++ b/Doc/lib/libdbm.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{dbm}} +\section{\module{dbm} --- + The standard ``database'' interface, based on ndbm.} \declaremodule{builtin}{dbm} \modulesynopsis{The standard ``database'' interface, based on ndbm.} diff --git a/Doc/lib/libdis.tex b/Doc/lib/libdis.tex index 9c7fee6..116225c 100644 --- a/Doc/lib/libdis.tex +++ b/Doc/lib/libdis.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{dis}} +\section{\module{dis} --- + Disassembler.} \declaremodule{standard}{dis} \modulesynopsis{Disassembler.} diff --git a/Doc/lib/liberrno.tex b/Doc/lib/liberrno.tex index c21f0fd..7e0c1a9 100644 --- a/Doc/lib/liberrno.tex +++ b/Doc/lib/liberrno.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{errno}} +\section{\module{errno} --- + Standard errno system symbols.} \declaremodule{standard}{errno} \modulesynopsis{Standard errno system symbols.} diff --git a/Doc/lib/libfcntl.tex b/Doc/lib/libfcntl.tex index e693067..c64cc83 100644 --- a/Doc/lib/libfcntl.tex +++ b/Doc/lib/libfcntl.tex @@ -1,5 +1,6 @@ % Manual text by Jaap Vermeulen -\section{Built-in Module \module{fcntl}} +\section{\module{fcntl} --- + The \function{fcntl()} and \function{ioctl()} system calls.} \declaremodule{builtin}{fcntl} \modulesynopsis{The \function{fcntl()} and \function{ioctl()} system calls.} diff --git a/Doc/lib/libfileinput.tex b/Doc/lib/libfileinput.tex index 1613cfa..5f9fc10 100644 --- a/Doc/lib/libfileinput.tex +++ b/Doc/lib/libfileinput.tex @@ -1,10 +1,11 @@ -% Documentation heavily adapted from module docstring. - -\section{Standard Module \module{fileinput}} +\section{\module{fileinput} --- + Iteration over lines from multiple input streams.} \declaremodule{standard}{fileinput} +\moduleauthor{Guido van Rossum}{guido@python.org} +\sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org} -\modulesynopsis{Perl-like iteration over lines from multiple input streams, with -``save in place'' capability.} +\modulesynopsis{Perl-like iteration over lines from multiple input +streams, with ``save in place'' capability.} This module implements a helper class and functions to quickly write a diff --git a/Doc/lib/libfl.tex b/Doc/lib/libfl.tex index 601b2c8..3ff90a4 100644 --- a/Doc/lib/libfl.tex +++ b/Doc/lib/libfl.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{fl}} +\section{\module{fl} --- + FORMS library interface for GUI applications.} \declaremodule{builtin}{fl} \modulesynopsis{FORMS library interface for GUI applications.} @@ -464,7 +465,8 @@ FORMS objects have these data attributes; see the FORMS documentation: \lineiii{automatic}{int (read-only)}{(see FORMS docs)} \end{tableiii} -\section{Standard Module \module{FL}} +\section{\module{FL} --- + Constants used with the \module{fl} module.} \declaremodule{standard}{FL} \modulesynopsis{Constants used with the \module{fl} module.} @@ -481,7 +483,8 @@ import fl from FL import * \end{verbatim} -\section{Standard Module \module{flp}} +\section{\module{flp} --- + Loading functions for stored FORMS designs.} \declaremodule{standard}{flp} \modulesynopsis{Loading functions for stored FORMS designs.} diff --git a/Doc/lib/libfm.tex b/Doc/lib/libfm.tex index b52fd26..381d93e 100644 --- a/Doc/lib/libfm.tex +++ b/Doc/lib/libfm.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{fm}} +\section{\module{fm} --- + \emph{Font Manager} interface for SGI workstations.} \declaremodule{builtin}{fm} \modulesynopsis{\emph{Font Manager} interface for SGI workstations.} diff --git a/Doc/lib/libfnmatch.tex b/Doc/lib/libfnmatch.tex index b1f3a1b..78d0318 100644 --- a/Doc/lib/libfnmatch.tex +++ b/Doc/lib/libfnmatch.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{fnmatch}} +\section{\module{fnmatch} --- + \UNIX{} shell style pathname pattern matching.} \declaremodule{standard}{fnmatch} \modulesynopsis{\UNIX{} shell style pathname pattern matching.} diff --git a/Doc/lib/libformatter.tex b/Doc/lib/libformatter.tex index c1cf14f..9bb12b2 100644 --- a/Doc/lib/libformatter.tex +++ b/Doc/lib/libformatter.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{formatter}} +\section{\module{formatter} --- + Generic output formatter and device interface.} \declaremodule{standard}{formatter} \modulesynopsis{Generic output formatter and device interface.} diff --git a/Doc/lib/libftplib.tex b/Doc/lib/libftplib.tex index 166fd6e..5840e83 100644 --- a/Doc/lib/libftplib.tex +++ b/Doc/lib/libftplib.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{ftplib}} +\section{\module{ftplib} --- + FTP protocol client.} \declaremodule{standard}{ftplib} \modulesynopsis{FTP protocol client (requires sockets).} diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index bc121c1..7f00121 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -1,5 +1,4 @@ -\section{Built-in Functions} -\label{built-in-funcs} +\section{Built-in Functions \label{built-in-funcs}} The Python interpreter has a number of functions built into it that are always available. They are listed here in alphabetical order. diff --git a/Doc/lib/libgdbm.tex b/Doc/lib/libgdbm.tex index 844c3b3..adb1304 100644 --- a/Doc/lib/libgdbm.tex +++ b/Doc/lib/libgdbm.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{gdbm}} +\section{\module{gdbm} --- + GNU's reinterpretation of dbm.} \declaremodule{builtin}{gdbm} \modulesynopsis{GNU's reinterpretation of dbm.} diff --git a/Doc/lib/libgetopt.tex b/Doc/lib/libgetopt.tex index 6f839a7..72824a7 100644 --- a/Doc/lib/libgetopt.tex +++ b/Doc/lib/libgetopt.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{getopt}} +\section{\module{getopt} --- + Parser for command line options.} \declaremodule{standard}{getopt} \modulesynopsis{Parser for command line options.} diff --git a/Doc/lib/libgl.tex b/Doc/lib/libgl.tex index 6824418..6940437 100644 --- a/Doc/lib/libgl.tex +++ b/Doc/lib/libgl.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{gl}} +\section{\module{gl} --- + Functions from the Silicon Graphics \emph{Graphics Library}.} \declaremodule{builtin}{gl} \modulesynopsis{Functions from the Silicon Graphics \emph{Graphics Library}.} @@ -185,7 +186,8 @@ def main(): main() \end{verbatim} % -\section{Standard Module \module{DEVICE}} +\section{\module{DEVICE} --- + Constants used with the \module{gl} module.} \declaremodule{standard}{DEVICE} \modulesynopsis{Constants used with the \module{gl} module.} @@ -196,7 +198,8 @@ This modules defines the constants used by the Silicon Graphics Read the module source file for details. -\section{Standard Module \module{GL}} +\section{\module{GL} --- + Constants used with the \module{gl} module.} \declaremodule{standard}{GL} \modulesynopsis{Constants used with the \module{gl} module.} diff --git a/Doc/lib/libglob.tex b/Doc/lib/libglob.tex index 8c93e43..5ef06f3 100644 --- a/Doc/lib/libglob.tex +++ b/Doc/lib/libglob.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{glob}} +\section{\module{glob} --- + \UNIX{} shell style pathname pattern expansion.} \declaremodule{standard}{glob} \modulesynopsis{\UNIX{} shell style pathname pattern expansion.} diff --git a/Doc/lib/libgopherlib.tex b/Doc/lib/libgopherlib.tex index a6e6fc3..e2cbaa2 100644 --- a/Doc/lib/libgopherlib.tex +++ b/Doc/lib/libgopherlib.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{gopherlib}} +\section{\module{gopherlib} --- + Gopher protocol client.} \declaremodule{standard}{gopherlib} \modulesynopsis{Gopher protocol client (requires sockets).} diff --git a/Doc/lib/libgrp.tex b/Doc/lib/libgrp.tex index 986c831..b15128d 100644 --- a/Doc/lib/libgrp.tex +++ b/Doc/lib/libgrp.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{grp}} +\section{\module{grp} --- + The group database.} \declaremodule{builtin}{grp} diff --git a/Doc/lib/libgzip.tex b/Doc/lib/libgzip.tex index 4bc7d80..3bae734 100644 --- a/Doc/lib/libgzip.tex +++ b/Doc/lib/libgzip.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{gzip}} +\section{\module{gzip} --- + \program{gzip} compression and decompression using files.} \declaremodule{standard}{gzip} \modulesynopsis{Interfaces for \program{gzip} compression and diff --git a/Doc/lib/libhtmllib.tex b/Doc/lib/libhtmllib.tex index 899e76e..100be55 100644 --- a/Doc/lib/libhtmllib.tex +++ b/Doc/lib/libhtmllib.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{htmllib}} +\section{\module{htmllib} --- + A parser for HTML documents.} \declaremodule{standard}{htmllib} \modulesynopsis{A parser for HTML documents.} diff --git a/Doc/lib/libhttplib.tex b/Doc/lib/libhttplib.tex index e217967..51b74eb 100644 --- a/Doc/lib/libhttplib.tex +++ b/Doc/lib/libhttplib.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{httplib}} +\section{\module{httplib} --- + HTTP protocol client.} \declaremodule{standard}{httplib} \modulesynopsis{HTTP protocol client (requires sockets).} diff --git a/Doc/lib/libimageop.tex b/Doc/lib/libimageop.tex index 1c01241..ded5b51 100644 --- a/Doc/lib/libimageop.tex +++ b/Doc/lib/libimageop.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{imageop}} +\section{\module{imageop} --- + Manipulate raw image data.} \declaremodule{builtin}{imageop} \modulesynopsis{Manipulate raw image data.} diff --git a/Doc/lib/libimaplib.tex b/Doc/lib/libimaplib.tex index 5501cd2..14daf41 100644 --- a/Doc/lib/libimaplib.tex +++ b/Doc/lib/libimaplib.tex @@ -1,10 +1,11 @@ % Based on HTML documentation by Piers Lauder ; % converted by Fred L. Drake, Jr. . -% -% The imaplib module was written by Piers Lauder. -\section{Standard Module \module{imaplib}} +\section{\module{imaplib} --- + IMAP4 protocol client.} \declaremodule{standard}{imaplib} +\moduleauthor{Piers Lauder}{piers@staff.cs.usyd.edu.au} +\sectionauthor{Piers Lauder}{piers@staff.cs.usyd.edu.au} \modulesynopsis{IMAP4 protocol client (requires sockets).} diff --git a/Doc/lib/libimgfile.tex b/Doc/lib/libimgfile.tex index d4c3002..7ea57a4 100644 --- a/Doc/lib/libimgfile.tex +++ b/Doc/lib/libimgfile.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{imgfile}} +\section{\module{imgfile} --- + Support for SGI imglib files.} \declaremodule{builtin}{imgfile} \modulesynopsis{Support for SGI imglib files.} diff --git a/Doc/lib/libimghdr.tex b/Doc/lib/libimghdr.tex index 637dca2..2a162a2 100644 --- a/Doc/lib/libimghdr.tex +++ b/Doc/lib/libimghdr.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{imghdr}} +\section{\module{imghdr} --- + Determine the type of image contained in a file or byte stream.} \declaremodule{standard}{imghdr} \modulesynopsis{Determine the type of image contained in a file or byte stream.} diff --git a/Doc/lib/libimp.tex b/Doc/lib/libimp.tex index 945ffde..bf50143 100644 --- a/Doc/lib/libimp.tex +++ b/Doc/lib/libimp.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{imp}} +\section{\module{imp} --- + Access the implementation of the \keyword{import} statement.} \declaremodule{builtin}{imp} \modulesynopsis{Access the implementation of the \keyword{import} statement.} diff --git a/Doc/lib/libjpeg.tex b/Doc/lib/libjpeg.tex index 2c227ff..9c2c57a 100644 --- a/Doc/lib/libjpeg.tex +++ b/Doc/lib/libjpeg.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{jpeg}} +\section{\module{jpeg} --- + Read and write image files in compressed JPEG format.} \declaremodule{builtin}{jpeg} \modulesynopsis{Read and write image files in compressed JPEG format.} diff --git a/Doc/lib/libkeyword.tex b/Doc/lib/libkeyword.tex index 24635a5..16cff84 100644 --- a/Doc/lib/libkeyword.tex +++ b/Doc/lib/libkeyword.tex @@ -1,7 +1,8 @@ -\section{Standard Module \module{keyword}} +\section{\module{keyword} --- + Test whether a string is a Python keyword.} \declaremodule{standard}{keyword} -\modulesynopsis{Test whether a string is a keyword in the Python language.} +\modulesynopsis{Test whether a string is a keyword in Python.} This module allows a Python program to determine if a string is a diff --git a/Doc/lib/liblocale.tex b/Doc/lib/liblocale.tex index 9b08872..d70ffcf 100644 --- a/Doc/lib/liblocale.tex +++ b/Doc/lib/liblocale.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{locale}} +\section{\module{locale} --- + Internationalization services.} \declaremodule{standard}{locale} diff --git a/Doc/lib/libmailbox.tex b/Doc/lib/libmailbox.tex index 5ebc57d..8110291 100644 --- a/Doc/lib/libmailbox.tex +++ b/Doc/lib/libmailbox.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{mailbox}} +\section{\module{mailbox} --- + Read various mailbox formats.} \declaremodule{standard}{mailbox} \modulesynopsis{Read various mailbox formats.} diff --git a/Doc/lib/libmailcap.tex b/Doc/lib/libmailcap.tex index 8c8b705..e6c5396 100644 --- a/Doc/lib/libmailcap.tex +++ b/Doc/lib/libmailcap.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{mailcap}} +\section{\module{mailcap} --- + Mailcap file handling.} \declaremodule{standard}{mailcap} \modulesynopsis{Mailcap file handling.} diff --git a/Doc/lib/libmain.tex b/Doc/lib/libmain.tex index 39edfd7..949d2b2 100644 --- a/Doc/lib/libmain.tex +++ b/Doc/lib/libmain.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{__main__}} +\section{\module{__main__} --- + Top-level script environment.} \declaremodule[main]{builtin}{__main__} \modulesynopsis{The environment where the top-level script is run.} diff --git a/Doc/lib/libmarshal.tex b/Doc/lib/libmarshal.tex index ab7cd05..a30dd1e 100644 --- a/Doc/lib/libmarshal.tex +++ b/Doc/lib/libmarshal.tex @@ -1,8 +1,9 @@ -\section{Built-in Module \module{marshal}} +\section{\module{marshal} --- + Python object serialization (with different constraints).} \declaremodule{builtin}{marshal} -\modulesynopsis{Convert Python objects to streams of bytes and back (with -different constraints).} +\modulesynopsis{Convert Python objects to streams of bytes and back +(with different constraints).} This module contains functions that can read and write Python diff --git a/Doc/lib/libmath.tex b/Doc/lib/libmath.tex index 7ecda2e..49bc226 100644 --- a/Doc/lib/libmath.tex +++ b/Doc/lib/libmath.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{math}} +\section{\module{math} --- + Mathematical functions (\function{sin()} etc.).} \declaremodule{builtin}{math} diff --git a/Doc/lib/libmd5.tex b/Doc/lib/libmd5.tex index b754a66..85b380b 100644 --- a/Doc/lib/libmd5.tex +++ b/Doc/lib/libmd5.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{md5}} +\section{\module{md5} --- + MD5 message digest algorithm.} \declaremodule{builtin}{md5} \modulesynopsis{RSA's MD5 message digest algorithm.} diff --git a/Doc/lib/libmimetools.tex b/Doc/lib/libmimetools.tex index 4cb1300..1b90d89 100644 --- a/Doc/lib/libmimetools.tex +++ b/Doc/lib/libmimetools.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{mimetools}} +\section{\module{mimetools} --- + Tools for parsing MIME style message bodies.} \declaremodule{standard}{mimetools} \modulesynopsis{Tools for parsing MIME style message bodies.} diff --git a/Doc/lib/libmimetypes.tex b/Doc/lib/libmimetypes.tex index afd5cca..0beb5f5 100644 --- a/Doc/lib/libmimetypes.tex +++ b/Doc/lib/libmimetypes.tex @@ -2,7 +2,8 @@ % , based in part on original docstrings in the % mimetypes module. -\section{Standard Module \module{mimetypes}} +\section{\module{mimetypes} --- + Mapping of filename extensions to MIME types.} \declaremodule{standard}{mimetypes} \modulesynopsis{Mapping of filename extensions to MIME types.} diff --git a/Doc/lib/libmimify.tex b/Doc/lib/libmimify.tex index 87740b3..7d91d99 100644 --- a/Doc/lib/libmimify.tex +++ b/Doc/lib/libmimify.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{mimify}} +\section{\module{mimify} --- + Mimification and unmimification of mail messages.} \declaremodule{standard}{mimify} \modulesynopsis{Mimification and unmimification of mail messages.} diff --git a/Doc/lib/libmpz.tex b/Doc/lib/libmpz.tex index 98f09a8..c761ea1 100644 --- a/Doc/lib/libmpz.tex +++ b/Doc/lib/libmpz.tex @@ -1,7 +1,9 @@ -\section{Built-in Module \module{mpz}} +\section{\module{mpz} --- + GNU MP library for arbitrary precision arithmetic.} \declaremodule{builtin}{mpz} -\modulesynopsis{Interface to the GNU MP library for arbitrary precision arithmetic.} +\modulesynopsis{Interface to the GNU MP library for arbitrary +precision arithmetic.} This is an optional module. It is only available when Python is diff --git a/Doc/lib/libmultifile.tex b/Doc/lib/libmultifile.tex index 9cca993..d3fb862 100644 --- a/Doc/lib/libmultifile.tex +++ b/Doc/lib/libmultifile.tex @@ -1,6 +1,7 @@ -% Documentation by ESR -\section{Standard Module \module{multifile}} +\section{\module{multifile} --- + Support for reading files which contain distinct parts.} \declaremodule{standard}{multifile} +\sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com} \modulesynopsis{Support for reading files which contain distinct parts, such as some MIME data.} diff --git a/Doc/lib/libni.tex b/Doc/lib/libni.tex index e962eea..fa2b3ee 100644 --- a/Doc/lib/libni.tex +++ b/Doc/lib/libni.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{ni}} +\section{\module{ni} --- + None} \declaremodule{standard}{ni} \modulesynopsis{None} diff --git a/Doc/lib/libnntplib.tex b/Doc/lib/libnntplib.tex index d6e0f81..8b59fed 100644 --- a/Doc/lib/libnntplib.tex +++ b/Doc/lib/libnntplib.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{nntplib}} +\section{\module{nntplib} --- + NNTP protocol client.} \declaremodule{standard}{nntplib} \modulesynopsis{NNTP protocol client (requires sockets).} diff --git a/Doc/lib/liboperator.tex b/Doc/lib/liboperator.tex index f5186e0..c329009 100644 --- a/Doc/lib/liboperator.tex +++ b/Doc/lib/liboperator.tex @@ -1,7 +1,7 @@ -% Contributed by Skip Montanaro, from the module's doc strings. - -\section{Built-in Module \module{operator}} +\section{\module{operator} --- + Standard operators as functions.} \declaremodule{builtin}{operator} +\sectionauthor{Skip Montanaro}{skip@automatrix.com} \modulesynopsis{All Python's standard operators as built-in functions.} @@ -90,7 +90,7 @@ Return the outcome of \keyword{not} \var{o}. \end{funcdesc} \begin{funcdesc}{truth}{o} -Return 1 if \var{o} is true, and 0 otherwise. +Return \code{1} if \var{o} is true, and 0 otherwise. \end{funcdesc} \begin{funcdesc}{concat}{a, b} diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex index 41198ec..75d4182 100644 --- a/Doc/lib/libos.tex +++ b/Doc/lib/libos.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{os}} +\section{\module{os} --- + Miscellaneous OS interfaces.} \declaremodule{standard}{os} \modulesynopsis{Miscellaneous OS interfaces.} diff --git a/Doc/lib/libpanel.tex b/Doc/lib/libpanel.tex index 66ac2a8..cc56dad 100644 --- a/Doc/lib/libpanel.tex +++ b/Doc/lib/libpanel.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{panel}} +\section{\module{panel} --- + None} \declaremodule{standard}{panel} \modulesynopsis{None} @@ -31,7 +32,8 @@ before calling or \code{panel.defpanellist()}. -\section{Standard Module \module{panelparser}} +\section{\module{panelparser} --- + None} \declaremodule{standard}{panelparser} \modulesynopsis{None} @@ -49,7 +51,8 @@ to Python strings and sub-expressions (recursively) to Python lists. For more details, read the module file. % XXXXJH should be funcdesc, I think -\section{Built-in Module \module{pnl}} +\section{\module{pnl} --- + None} \declaremodule{builtin}{pnl} \modulesynopsis{None} diff --git a/Doc/lib/libparser.tex b/Doc/lib/libparser.tex index cbea16d..80ad493 100644 --- a/Doc/lib/libparser.tex +++ b/Doc/lib/libparser.tex @@ -9,11 +9,13 @@ % in any way. % -\section{Built-in Module \module{parser}} +\section{\module{parser} --- + Access parse trees of Python code.} \declaremodule{builtin}{parser} +\moduleauthor{Fred L. Drake, Jr.}{fdrake@acm.org} +\sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org} -\modulesynopsis{Retrieve and submit parse trees from and to the runtime support -environment.} +\modulesynopsis{Access parse trees of Python source code.} \index{parsing!Python source code} diff --git a/Doc/lib/libpickle.tex b/Doc/lib/libpickle.tex index 60999eb..6f9ece7 100644 --- a/Doc/lib/libpickle.tex +++ b/Doc/lib/libpickle.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{pickle}} +\section{\module{pickle} --- + Python object serialization.} \declaremodule{standard}{pickle} \modulesynopsis{Convert Python objects to streams of bytes and back.} @@ -274,7 +275,8 @@ registration} \end{seealso} -\section{Built-in Module \module{cPickle}} +\section{\module{cPickle} --- + Alternate implementation of \module{pickle}.} \declaremodule{builtin}{cPickle} \modulesynopsis{Faster version of \module{pickle}, but not subclassable.} diff --git a/Doc/lib/libpopen2.tex b/Doc/lib/libpopen2.tex index d36be01..30d6e04 100644 --- a/Doc/lib/libpopen2.tex +++ b/Doc/lib/libpopen2.tex @@ -2,9 +2,12 @@ % , with some re-organization by Fred L. % Drake, Jr. . -\section{Standard Module \module{popen2}} +\section{\module{popen2} --- + Subprocesses with accessible standard I/O streams.} \declaremodule{standard}{popen2} +\sectionauthor{Drew Csillag}{drew_csillag@geocities.com} + \modulesynopsis{Subprocesses with accessible standard I/O streams.} diff --git a/Doc/lib/libpoplib.tex b/Doc/lib/libpoplib.tex index 2c21a7f..e3ec5e1 100644 --- a/Doc/lib/libpoplib.tex +++ b/Doc/lib/libpoplib.tex @@ -3,7 +3,8 @@ %it since I just stole most of it from the poplib.py source code and %the imaplib ``chapter''. -\section{Standard Module \module{poplib}} +\section{\module{poplib} --- + POP3 protocol client.} \declaremodule{standard}{poplib} \modulesynopsis{POP3 protocol client (requires sockets).} diff --git a/Doc/lib/libposix.tex b/Doc/lib/libposix.tex index dbfc692..e3f2929 100644 --- a/Doc/lib/libposix.tex +++ b/Doc/lib/libposix.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{posix}} +\section{\module{posix} --- + The most common \POSIX{} system calls.} \declaremodule{builtin}{posix} \modulesynopsis{The most common \POSIX{} system calls (normally used via module diff --git a/Doc/lib/libposixfile.tex b/Doc/lib/libposixfile.tex index b1742f1..9c0ffd8 100644 --- a/Doc/lib/libposixfile.tex +++ b/Doc/lib/libposixfile.tex @@ -1,5 +1,6 @@ % Manual text and implementation by Jaap Vermeulen -\section{Standard Module \module{posixfile}} +\section{\module{posixfile} --- + A file-like object with support for locking.} \declaremodule{builtin}{posixfile} \modulesynopsis{A file-like object with support for locking.} diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex index 87c8010..83f468d 100644 --- a/Doc/lib/libposixpath.tex +++ b/Doc/lib/libposixpath.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{posixpath}} +\section{\module{posixpath} --- + Common \POSIX{} pathname manipulations.} \declaremodule{standard}{posixpath} \modulesynopsis{Common \POSIX{} pathname manipulations.} diff --git a/Doc/lib/libpprint.tex b/Doc/lib/libpprint.tex index 0632875..d676dc4 100644 --- a/Doc/lib/libpprint.tex +++ b/Doc/lib/libpprint.tex @@ -1,6 +1,7 @@ %% Author: Fred L. Drake, Jr. -\section{Standard Module \module{pprint}} +\section{\module{pprint} --- + Data pretty printer.} \declaremodule{standard}{pprint} \modulesynopsis{Data pretty printer.} diff --git a/Doc/lib/libpwd.tex b/Doc/lib/libpwd.tex index 32113b4..7841c1e 100644 --- a/Doc/lib/libpwd.tex +++ b/Doc/lib/libpwd.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{pwd}} +\section{\module{pwd} --- + The password database.} \declaremodule{builtin}{pwd} diff --git a/Doc/lib/libqueue.tex b/Doc/lib/libqueue.tex index 3231e11..667d813 100644 --- a/Doc/lib/libqueue.tex +++ b/Doc/lib/libqueue.tex @@ -1,7 +1,8 @@ -\section{Standard Module \module{Queue}} +\section{\module{Queue} --- + A synchronized queue class.} \declaremodule{standard}{Queue} -\modulesynopsis{A stynchronized queue class.} +\modulesynopsis{A synchronized queue class.} diff --git a/Doc/lib/libquopri.tex b/Doc/lib/libquopri.tex index 6b1d209..748579d 100644 --- a/Doc/lib/libquopri.tex +++ b/Doc/lib/libquopri.tex @@ -1,7 +1,9 @@ -\section{Standard Module \module{quopri}} +\section{\module{quopri} --- + Encode and decode MIME quoted-printable encoding.} \declaremodule{standard}{quopri} -\modulesynopsis{Encode/decode binary files using the MIME quoted-printable encoding.} +\modulesynopsis{Encode and decode files using the MIME +quoted-printable encoding.} This module performs quoted-printable transport encoding and decoding, diff --git a/Doc/lib/librand.tex b/Doc/lib/librand.tex index 7a5adea..e335718 100644 --- a/Doc/lib/librand.tex +++ b/Doc/lib/librand.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{rand}} +\section{\module{rand} --- + None} \declaremodule{standard}{rand} \modulesynopsis{None} diff --git a/Doc/lib/librandom.tex b/Doc/lib/librandom.tex index 4806876..63abbb3 100644 --- a/Doc/lib/librandom.tex +++ b/Doc/lib/librandom.tex @@ -1,7 +1,9 @@ -\section{Standard Module \module{random}} +\section{\module{random} --- + Generate pseudo-random numbers with various distributions.} \declaremodule{standard}{random} -\modulesynopsis{Generate pseudo-random numbers with various common distributions.} +\modulesynopsis{Generate pseudo-random numbers with various common +distributions.} This module implements pseudo-random number generators for various diff --git a/Doc/lib/libre.tex b/Doc/lib/libre.tex index 79d93ad..a453fbf 100644 --- a/Doc/lib/libre.tex +++ b/Doc/lib/libre.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{re}} +\section{\module{re} --- + New Perl-style regular expression search and match operations.} \declaremodule{standard}{re} \moduleauthor{Andrew M. Kuchling}{akuchling@acm.org} \sectionauthor{Andrew M. Kuchling}{akuchling@acm.org} diff --git a/Doc/lib/libregex.tex b/Doc/lib/libregex.tex index 253d50b..ffe959a 100644 --- a/Doc/lib/libregex.tex +++ b/Doc/lib/libregex.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{regex}} +\section{\module{regex} --- + Regular expression search and match operations.} \declaremodule{builtin}{regex} \modulesynopsis{Regular expression search and match operations.} diff --git a/Doc/lib/libregsub.tex b/Doc/lib/libregsub.tex index 0a75f36..b779193 100644 --- a/Doc/lib/libregsub.tex +++ b/Doc/lib/libregsub.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{regsub}} +\section{\module{regsub} --- + Substitution and splitting operations that use regular expressions.} \declaremodule{standard}{regsub} \modulesynopsis{Substitution and splitting operations that use regular expressions.} diff --git a/Doc/lib/libresource.tex b/Doc/lib/libresource.tex index 887268e..1d70e9e 100644 --- a/Doc/lib/libresource.tex +++ b/Doc/lib/libresource.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{resource}} +\section{\module{resource} --- + Resource usage information.} \declaremodule{builtin}{resource} diff --git a/Doc/lib/librexec.tex b/Doc/lib/librexec.tex index 8881c93..a7e8913 100644 --- a/Doc/lib/librexec.tex +++ b/Doc/lib/librexec.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{rexec}} +\section{\module{rexec} --- + Basic restricted execution framework.} \declaremodule{standard}{rexec} \modulesynopsis{Basic restricted execution framework.} diff --git a/Doc/lib/librfc822.tex b/Doc/lib/librfc822.tex index e9317d2..61aadd8 100644 --- a/Doc/lib/librfc822.tex +++ b/Doc/lib/librfc822.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{rfc822}} +\section{\module{rfc822} --- + Parse RFC 822 mail headers.} \declaremodule{standard}{rfc822} \modulesynopsis{Parse \rfc{822} style mail headers.} diff --git a/Doc/lib/librgbimg.tex b/Doc/lib/librgbimg.tex index d06eb76..5ef0603 100644 --- a/Doc/lib/librgbimg.tex +++ b/Doc/lib/librgbimg.tex @@ -1,8 +1,9 @@ -\section{Built-in Module \module{rgbimg}} +\section{\module{rgbimg} --- + Read and write image files in ``SGI RGB'' format.} \declaremodule{builtin}{rgbimg} \modulesynopsis{Read and write image files in ``SGI RGB'' format (the module is -\emph{not} SGI specific though)!} +\emph{not} SGI specific though!).} The \module{rgbimg} module allows Python programs to access SGI imglib image diff --git a/Doc/lib/librotor.tex b/Doc/lib/librotor.tex index a59e2ca..5cfe2b7 100644 --- a/Doc/lib/librotor.tex +++ b/Doc/lib/librotor.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{rotor}} +\section{\module{rotor} --- + Enigma-like encryption and decryption.} \declaremodule{builtin}{rotor} \modulesynopsis{Enigma-like encryption and decryption.} diff --git a/Doc/lib/libselect.tex b/Doc/lib/libselect.tex index b8dfacc..eec8de1 100644 --- a/Doc/lib/libselect.tex +++ b/Doc/lib/libselect.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{select}} +\section{\module{select} --- + Wait for I/O completion on multiple streams.} \declaremodule{builtin}{select} \modulesynopsis{Wait for I/O completion on multiple streams.} diff --git a/Doc/lib/libsgmllib.tex b/Doc/lib/libsgmllib.tex index 642dacd..a8dfa0b 100644 --- a/Doc/lib/libsgmllib.tex +++ b/Doc/lib/libsgmllib.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{sgmllib}} +\section{\module{sgmllib} --- + Simple SGML parser.} \declaremodule{standard}{sgmllib} \modulesynopsis{Only as much of an SGML parser as needed to parse HTML.} diff --git a/Doc/lib/libshelve.tex b/Doc/lib/libshelve.tex index 6b5aa76..4b7f773 100644 --- a/Doc/lib/libshelve.tex +++ b/Doc/lib/libshelve.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{shelve}} +\section{\module{shelve} --- + Python object persistency.} \declaremodule{standard}{shelve} \modulesynopsis{Python object persistency.} diff --git a/Doc/lib/libsignal.tex b/Doc/lib/libsignal.tex index 86d6967..ee68ace 100644 --- a/Doc/lib/libsignal.tex +++ b/Doc/lib/libsignal.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{signal}} +\section{\module{signal} --- + Set handlers for asynchronous events.} \declaremodule{builtin}{signal} diff --git a/Doc/lib/libsite.tex b/Doc/lib/libsite.tex index 020b266..e8bafd6 100644 --- a/Doc/lib/libsite.tex +++ b/Doc/lib/libsite.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{site}} +\section{\module{site} --- + A standard way to reference site-specific modules.} \declaremodule{standard}{site} \modulesynopsis{A standard way to reference site-specific modules.} diff --git a/Doc/lib/libsmtplib.tex b/Doc/lib/libsmtplib.tex index 21cadce..d7929eb 100644 --- a/Doc/lib/libsmtplib.tex +++ b/Doc/lib/libsmtplib.tex @@ -1,6 +1,7 @@ -% Documentation by ESR -\section{Standard Module \module{smtplib}} +\section{\module{smtplib} --- + SMTP protocol client.} \declaremodule{standard}{smtplib} +\sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com} \modulesynopsis{SMTP protocol client (requires sockets).} diff --git a/Doc/lib/libsocket.tex b/Doc/lib/libsocket.tex index 47a2914..c6476b9 100644 --- a/Doc/lib/libsocket.tex +++ b/Doc/lib/libsocket.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{socket}} +\section{\module{socket} --- + Low-level networking interface.} \declaremodule{builtin}{socket} \modulesynopsis{Low-level networking interface.} diff --git a/Doc/lib/libsocksvr.tex b/Doc/lib/libsocksvr.tex index a07b0e3..80ac724 100644 --- a/Doc/lib/libsocksvr.tex +++ b/Doc/lib/libsocksvr.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{SocketServer}} +\section{\module{SocketServer} --- + A framework for network servers.} \declaremodule{standard}{SocketServer} \modulesynopsis{A framework for network servers.} diff --git a/Doc/lib/libsoundex.tex b/Doc/lib/libsoundex.tex index 83e8bc7..8073a8c 100644 --- a/Doc/lib/libsoundex.tex +++ b/Doc/lib/libsoundex.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{soundex}} +\section{\module{soundex} --- + None} \declaremodule{builtin}{soundex} \modulesynopsis{None} diff --git a/Doc/lib/libstat.tex b/Doc/lib/libstat.tex index 102630a..b74e98b 100644 --- a/Doc/lib/libstat.tex +++ b/Doc/lib/libstat.tex @@ -1,18 +1,20 @@ -% By Skip Montanaro - -\section{Standard Module \module{stat}} +\section{\module{stat} --- + Utilities for interpreting \function{stat()} results.} \declaremodule{standard}{stat} +\sectionauthor{Skip Montanaro}{skip@automatrix.com} + \modulesynopsis{Utilities for interpreting the results of \function{os.stat()}, \function{os.lstat()} and \function{os.fstat()}.} -The \code{stat} module defines constants and functions for interpreting the -results of \code{os.stat()} and \code{os.lstat()} (if they exist). -For complete details about the \code{stat()} and \code{lstat()} system -calls, consult your local man pages. +The \module{stat} module defines constants and functions for +interpreting the results of \function{os.stat()} and +\function{os.lstat()} (if they exist). For complete details about the +\cfunction{stat()} and \cfunction{lstat()} system calls, consult your +local man pages. -The \code{stat} module defines the following functions: +The \module{stat} module defines the following functions: \begin{funcdesc}{S_ISDIR}{mode} diff --git a/Doc/lib/libstdwin.tex b/Doc/lib/libstdwin.tex index 64ccdd9..9edfba5 100644 --- a/Doc/lib/libstdwin.tex +++ b/Doc/lib/libstdwin.tex @@ -14,7 +14,8 @@ of dialogs. For most platforms, alternative, native solutions exist under X11, Win32 for Windows and Windows NT, and a collection of native toolkit interfaces for the Macintosh. -\section{Built-in Module \module{stdwin}} +\section{\module{stdwin} --- + None} \declaremodule{builtin}{stdwin} \modulesynopsis{None} @@ -777,7 +778,8 @@ def main(): main() \end{verbatim} % -\section{Standard Module \module{stdwinevents}} +\section{\module{stdwinevents} --- + None} \declaremodule{standard}{stdwinevents} \modulesynopsis{None} @@ -794,7 +796,8 @@ Suggested usage is >>> \end{verbatim} % -\section{Standard Module \module{rect}} +\section{\module{rect} --- + None} \declaremodule{standard}{rect} \modulesynopsis{None} diff --git a/Doc/lib/libstring.tex b/Doc/lib/libstring.tex index 226f453..f7189fd 100644 --- a/Doc/lib/libstring.tex +++ b/Doc/lib/libstring.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{string}} +\section{\module{string} --- + Common string operations.} \declaremodule{standard}{string} \modulesynopsis{Common string operations.} diff --git a/Doc/lib/libstringio.tex b/Doc/lib/libstringio.tex index 6b7d2c5..0e59e03 100644 --- a/Doc/lib/libstringio.tex +++ b/Doc/lib/libstringio.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{StringIO}} +\section{\module{StringIO} --- + Read and write strings as if they were files.} \declaremodule{standard}{StringIO} @@ -28,7 +29,8 @@ Free the memory buffer. \end{methoddesc} -\section{Built-in Module \module{cStringIO}} +\section{\module{cStringIO} --- + Faster version of \module{StringIO}, but not subclassable.} \declaremodule{builtin}{cStringIO} \modulesynopsis{Faster version of \module{StringIO}, but not subclassable.} diff --git a/Doc/lib/libstruct.tex b/Doc/lib/libstruct.tex index 08b930c..be7d80b 100644 --- a/Doc/lib/libstruct.tex +++ b/Doc/lib/libstruct.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{struct}} +\section{\module{struct} --- + Interpret strings as packed binary data.} \declaremodule{builtin}{struct} \modulesynopsis{Interpret strings as packed binary data.} diff --git a/Doc/lib/libsunaudio.tex b/Doc/lib/libsunaudio.tex index 920b048..cc7c1ed 100644 --- a/Doc/lib/libsunaudio.tex +++ b/Doc/lib/libsunaudio.tex @@ -1,10 +1,11 @@ -\section{Built-in Module \module{sunaudiodev}} +\section{\module{sunaudiodev} --- + Access to Sun audio hardware.} \declaremodule{builtin}{sunaudiodev} -\modulesynopsis{None} +\modulesynopsis{Access to Sun audio hardware.} -This module allows you to access the sun audio interface. The sun +This module allows you to access the Sun audio interface. The Sun audio hardware is capable of recording and playing back audio data in u-LAW\index{u-LAW} format with a sample rate of 8K per second. A full description can be found in the \manpage{audio}{7I} manual page. diff --git a/Doc/lib/libsymbol.tex b/Doc/lib/libsymbol.tex index 6dbc76e..7d9f9ac 100644 --- a/Doc/lib/libsymbol.tex +++ b/Doc/lib/libsymbol.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{symbol}} +\section{\module{symbol} --- + Constants representing internal nodes of the parse tree.} \declaremodule{standard}{symbol} \modulesynopsis{Constants representing internal nodes of the parse tree.} diff --git a/Doc/lib/libsys.tex b/Doc/lib/libsys.tex index 1f37bc8..eadd978 100644 --- a/Doc/lib/libsys.tex +++ b/Doc/lib/libsys.tex @@ -1,7 +1,8 @@ -\section{Built-in Module \module{sys}} +\section{\module{sys} --- + System-specific parameters and functions.} \declaremodule{builtin}{sys} -\modulesynopsis{Access system specific parameters and functions.} +\modulesynopsis{Access system-specific parameters and functions.} This module provides access to some variables used or maintained by the interpreter and to functions that interact strongly with the interpreter. diff --git a/Doc/lib/libsyslog.tex b/Doc/lib/libsyslog.tex index cd32bbf..70a05be 100644 --- a/Doc/lib/libsyslog.tex +++ b/Doc/lib/libsyslog.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{syslog}} +\section{\module{syslog} --- + \UNIX{} syslog library routines.} \declaremodule{builtin}{syslog} \modulesynopsis{An interface to the \UNIX{} syslog library routines.} diff --git a/Doc/lib/libtempfile.tex b/Doc/lib/libtempfile.tex index dadd357..95034bb 100644 --- a/Doc/lib/libtempfile.tex +++ b/Doc/lib/libtempfile.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{tempfile}} +\section{\module{tempfile} --- + Generate temporary file names.} \declaremodule{standard}{tempfile} \modulesynopsis{Generate temporary file names.} diff --git a/Doc/lib/libtemplate.tex b/Doc/lib/libtemplate.tex index e82bb21..cff05d1 100644 --- a/Doc/lib/libtemplate.tex +++ b/Doc/lib/libtemplate.tex @@ -3,26 +3,32 @@ % ==== 1. ==== -% Choose one of the following section headers and index entries; -% \section generates the section header, \declmodule produces the -% appropriate index entry for this module. Note that these should -% only be used for the defining entry for the module. Other -% references to the module should use \refbimodindex, \refstmodindex, -% \refexmodindex or \refmodindex, as appropriate. +% The section prologue. Give the section a title and provide some +% meta-information. References to the module should use +% \refbimodindex, \refstmodindex, \refexmodindex or \refmodindex, as +% appropriate. -\section{Built-in Module \module{spam}} % If implemented in C, in -\declaremodule{builtin}{spam} % standard library +\section{\module{spam} --- + Short one-line descrition, for section title.} -\section{Standard Module \module{spam}} % If implemented in Python, in -\declaremodule{standard}{spam} % standard library +% Choose one of these to specify the module module name. If there's +% an underscore in the name, use +% \declaremodule[modname]{...}{mod_name} instead. +% +\declaremodule{builtin}{spam} % standard library, in C +\declaremodule{standard}{spam} % standard library, in Python +\declaremodule{extension}{spam} % not standard, in C +\declaremodule{}{spam} % not standard, in Python -\section{Extension Module \module{spam}}% If implemented in C, but not -\declaremodule{extension}{spam} % in standard library +% These apply to all modules: -\section{Module \module{spam}} % If implemented in Python, but not -\declaremodule{}{spam} % in standard library +\moduleauthor{name}{email} % Author of the module code; + % omit if not known. +\sectionauthor{name}{email} % Author of the documentation. +% Leave at least one blank line after this, to simplify ad-hoc tools +% that are sometimes used to massage these files. \modulesynopsis{This is a one-line descrition, for the chapter header.} diff --git a/Doc/lib/libtermios.tex b/Doc/lib/libtermios.tex index 18b63bf..9c9c3c8 100644 --- a/Doc/lib/libtermios.tex +++ b/Doc/lib/libtermios.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{termios}} +\section{\module{termios} --- + \POSIX{} style tty control.} \declaremodule{builtin}{termios} \modulesynopsis{\POSIX{} style tty control.} @@ -94,10 +95,12 @@ def getpass(prompt = "Password: "): return passwd \end{verbatim} -\section{Standard Module \module{TERMIOS}} +\section{\module{TERMIOS} --- + Constants used with the \module{termios} module.} \declaremodule[TERMIOSuppercase]{standard}{TERMIOS} -\modulesynopsis{The symbolic constants required to use the \module{termios} module.} +\modulesynopsis{Symbolic constants required to use the +\module{termios} module.} \indexii{\POSIX{}}{I/O control} \indexii{tty}{I/O control} diff --git a/Doc/lib/libthread.tex b/Doc/lib/libthread.tex index 2e55b41..df87118 100644 --- a/Doc/lib/libthread.tex +++ b/Doc/lib/libthread.tex @@ -1,7 +1,8 @@ -\section{Built-in Module \module{thread}} +\section{\module{thread} --- + Multiple threads of control.} \declaremodule{builtin}{thread} -\modulesynopsis{Create multiple threads of control within one namespace.} +\modulesynopsis{Create multiple threads of control within one interpreter.} This module provides low-level primitives for working with multiple diff --git a/Doc/lib/libthreading.tex b/Doc/lib/libthreading.tex index 928b422..d2c5ff3 100644 --- a/Doc/lib/libthreading.tex +++ b/Doc/lib/libthreading.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{threading}} +\section{\module{threading} --- + Higher-level threading interfaces.} \declaremodule{standard}{threading} \modulesynopsis{Higher-level threading interfaces.} diff --git a/Doc/lib/libtime.tex b/Doc/lib/libtime.tex index caafd50..f63ecb0 100644 --- a/Doc/lib/libtime.tex +++ b/Doc/lib/libtime.tex @@ -1,4 +1,5 @@ -\section{Built-in Module \module{time}} +\section{\module{time} --- + Time access and conversions.} \declaremodule{builtin}{time} \modulesynopsis{Time access and conversions.} diff --git a/Doc/lib/libtoken.tex b/Doc/lib/libtoken.tex index ce3bd5c..87477c5 100644 --- a/Doc/lib/libtoken.tex +++ b/Doc/lib/libtoken.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{token}} +\section{\module{token} --- + Constants representing terminal nodes of the parse tree.} \declaremodule{standard}{token} \modulesynopsis{Constants representing terminal nodes of the parse tree.} diff --git a/Doc/lib/libtraceback.tex b/Doc/lib/libtraceback.tex index 29c8ac6..e2a7e07 100644 --- a/Doc/lib/libtraceback.tex +++ b/Doc/lib/libtraceback.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{traceback}} +\section{\module{traceback} --- + Print or retrieve a stack traceback.} \declaremodule{standard}{traceback} \modulesynopsis{Print or retrieve a stack traceback.} diff --git a/Doc/lib/libtypes.tex b/Doc/lib/libtypes.tex index f3c4ee0..5f9034c 100644 --- a/Doc/lib/libtypes.tex +++ b/Doc/lib/libtypes.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{types}} +\section{\module{types} --- + Names for all built-in types.} \declaremodule{standard}{types} \modulesynopsis{Names for all built-in types.} diff --git a/Doc/lib/liburllib.tex b/Doc/lib/liburllib.tex index 7a98582..ab57e55 100644 --- a/Doc/lib/liburllib.tex +++ b/Doc/lib/liburllib.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{urllib}} +\section{\module{urllib} --- + Open an arbitrary object given by URL.} \declaremodule{standard}{urllib} \modulesynopsis{Open an arbitrary object given by URL (requires sockets).} diff --git a/Doc/lib/liburlparse.tex b/Doc/lib/liburlparse.tex index 9a2b4f5..60c83cc 100644 --- a/Doc/lib/liburlparse.tex +++ b/Doc/lib/liburlparse.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{urlparse}} +\section{\module{urlparse} --- + Parse URLs into components.} \declaremodule{standard}{urlparse} \modulesynopsis{Parse URLs into components.} diff --git a/Doc/lib/libuser.tex b/Doc/lib/libuser.tex index 5527225..484af7e 100644 --- a/Doc/lib/libuser.tex +++ b/Doc/lib/libuser.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{user}} +\section{\module{user} --- + A standard way to reference user-specific modules.} \declaremodule{standard}{user} \modulesynopsis{A standard way to reference user-specific modules.} diff --git a/Doc/lib/libuserdict.tex b/Doc/lib/libuserdict.tex index 6c29906..f37d4cc 100644 --- a/Doc/lib/libuserdict.tex +++ b/Doc/lib/libuserdict.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{UserDict}} +\section{\module{UserDict} --- + Class wrapper for dictionary objects.} \declaremodule{standard}{UserDict} \modulesynopsis{Class wrapper for dictionary objects.} @@ -24,7 +25,8 @@ class. \end{memberdesc} -\section{Standard Module \module{UserList}} +\section{\module{UserList} --- + Class wrapper for list objects.} \declaremodule{standard}{UserList} \modulesynopsis{Class wrapper for list objects.} diff --git a/Doc/lib/libuu.tex b/Doc/lib/libuu.tex index b052de7..4145823 100644 --- a/Doc/lib/libuu.tex +++ b/Doc/lib/libuu.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{uu}} +\section{\module{uu} --- + Encode and decode files in uuencode format.} \declaremodule{standard}{uu} \modulesynopsis{Encode and decode files in uuencode format.} diff --git a/Doc/lib/libwhichdb.tex b/Doc/lib/libwhichdb.tex index db4f555..b3035cf 100644 --- a/Doc/lib/libwhichdb.tex +++ b/Doc/lib/libwhichdb.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{whichdb}} +\section{\module{whichdb} --- + Guess which DBM-style module created a given database.} \declaremodule{standard}{whichdb} \modulesynopsis{Guess which DBM-style module created a given database.} diff --git a/Doc/lib/libwhrandom.tex b/Doc/lib/libwhrandom.tex index bc7d402..8df1b77 100644 --- a/Doc/lib/libwhrandom.tex +++ b/Doc/lib/libwhrandom.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{whrandom}} +\section{\module{whrandom} --- + Floating point pseudo-random number generator.} \declaremodule{standard}{whrandom} \modulesynopsis{Floating point pseudo-random number generator.} diff --git a/Doc/lib/libxdrlib.tex b/Doc/lib/libxdrlib.tex index 6de8d92..3565eb7 100644 --- a/Doc/lib/libxdrlib.tex +++ b/Doc/lib/libxdrlib.tex @@ -1,8 +1,9 @@ -\section{Standard Module \module{xdrlib}} +\section{\module{xdrlib} --- + Encode and decode XDR data.} \declaremodule{standard}{xdrlib} \modulesynopsis{Encoders and decoders for the External Data -Representation.} +Representation (XDR).} \index{XDR} \index{External Data Representation} diff --git a/Doc/lib/libxmllib.tex b/Doc/lib/libxmllib.tex index 129ab17..d8aa3ed 100644 --- a/Doc/lib/libxmllib.tex +++ b/Doc/lib/libxmllib.tex @@ -1,4 +1,5 @@ -\section{Standard Module \module{xmllib}} +\section{\module{xmllib} --- + A parser for XML documents.} % Author: Sjoerd Mullender \declaremodule{standard}{xmllib} diff --git a/Doc/lib/libzlib.tex b/Doc/lib/libzlib.tex index 0369507..9dbb16b 100644 --- a/Doc/lib/libzlib.tex +++ b/Doc/lib/libzlib.tex @@ -1,7 +1,8 @@ % XXX The module has been extended (by Jeremy) but this documentation % hasn't been updated completely. -\section{Built-in Module \module{zlib}} +\section{\module{zlib} --- + Compression and decompression compatible with \program{gzip}.} \declaremodule{builtin}{zlib} \modulesynopsis{Low-level interface to compression and decompression diff --git a/Doc/templates/module.tex b/Doc/templates/module.tex index e82bb21..cff05d1 100644 --- a/Doc/templates/module.tex +++ b/Doc/templates/module.tex @@ -3,26 +3,32 @@ % ==== 1. ==== -% Choose one of the following section headers and index entries; -% \section generates the section header, \declmodule produces the -% appropriate index entry for this module. Note that these should -% only be used for the defining entry for the module. Other -% references to the module should use \refbimodindex, \refstmodindex, -% \refexmodindex or \refmodindex, as appropriate. +% The section prologue. Give the section a title and provide some +% meta-information. References to the module should use +% \refbimodindex, \refstmodindex, \refexmodindex or \refmodindex, as +% appropriate. -\section{Built-in Module \module{spam}} % If implemented in C, in -\declaremodule{builtin}{spam} % standard library +\section{\module{spam} --- + Short one-line descrition, for section title.} -\section{Standard Module \module{spam}} % If implemented in Python, in -\declaremodule{standard}{spam} % standard library +% Choose one of these to specify the module module name. If there's +% an underscore in the name, use +% \declaremodule[modname]{...}{mod_name} instead. +% +\declaremodule{builtin}{spam} % standard library, in C +\declaremodule{standard}{spam} % standard library, in Python +\declaremodule{extension}{spam} % not standard, in C +\declaremodule{}{spam} % not standard, in Python -\section{Extension Module \module{spam}}% If implemented in C, but not -\declaremodule{extension}{spam} % in standard library +% These apply to all modules: -\section{Module \module{spam}} % If implemented in Python, but not -\declaremodule{}{spam} % in standard library +\moduleauthor{name}{email} % Author of the module code; + % omit if not known. +\sectionauthor{name}{email} % Author of the documentation. +% Leave at least one blank line after this, to simplify ad-hoc tools +% that are sometimes used to massage these files. \modulesynopsis{This is a one-line descrition, for the chapter header.} -- cgit v0.12