]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
no need to reference doc strings for documented modules
authorGuido van Rossum <guido@python.org>
Thu, 16 Feb 1995 16:28:48 +0000 (16:28 +0000)
committerGuido van Rossum <guido@python.org>
Thu, 16 Feb 1995 16:28:48 +0000 (16:28 +0000)
Doc/tut.tex
Doc/tut/tut.tex

index c29d3a765d8fdbeb6194153f7b5d643eae7942f5..ffe03d092130241a27f8dfdc1d109d4fac688aa8 100644 (file)
@@ -3276,7 +3276,8 @@ In this release, the built-in exceptions are still strings.
 Two new modules, \code{pickle} and \code{shelve}, support storage and
 retrieval of (almost) arbitrary Python objects on disk, using the
 \code{dbm} package.  A third module, \code{copy}, provides flexible
-object copying operations.
+object copying operations.  More information on these modules is
+provided in the Library Reference Manual.
 
 \subsection{Persistent Objects}
 
@@ -3308,9 +3309,6 @@ on files.  The operation \code{shelve.open(filename)} returns a
 dictionary-like interface.  Database keys are strings, objects stored
 in the database can be anything that \code{pickle} will handle.
 
-More information on these modules can be glanced from their
-documentation strings (see below).
-
 \subsection{Copying Objects}
 
 The module \code{copy} exports two functions: \code{copy()} and
@@ -3338,8 +3336,6 @@ as \code{pickle} --- user-defined classes can control how they are
 copied by providing methods named \code{__getinitargs__()},
 \code{__getstate__()} and \code{__setstate__()}.
 
-More info in the module's documentation string.
-
 
 \section{Documentation Strings}
 
@@ -3496,21 +3492,21 @@ this forms the basis for a future restricted execution mode.
 
 There is a growing number of modules available for writing WWW tools.
 The previous release already sported modules \code{gopherlib},
-\code{ftplib}, \code{httplib} and \code{urllib} (unifying the previous
-three) for accessing data through the commonest WWW protocols.  This
-release also provides \code{cgi}, to ease the writing of server-side
-scripts that use the Common Gateway Interface protocol, supported by
-most WWW servers.  The module \code{urlparse} provides precise parsing
-of a URL string into its components (address scheme, network location,
-path, parameters, query, and fragment identifier).
-
-There is no complete parser for HTML files yet, although the
-\code{Demo/www} directory in the distribution contains some old code
-that should be a start if you wanted to contribute one.
-Unfortunately Python seems to be too slow for real-time parsing and
-formatting of HTML such as required by interactive WWW browsers --- but
-it's ideal for writing a ``robot'' (an automated WWW browser that
-searches the web for information).
+\code{ftplib}, \code{httplib} and \code{urllib} (which unifies the
+other three) for accessing data through the commonest WWW protocols.
+This release also provides \code{cgi}, to ease the writing of
+server-side scripts that use the Common Gateway Interface protocol,
+supported by most WWW servers.  The module \code{urlparse} provides
+precise parsing of a URL string into its components (address scheme,
+network location, path, parameters, query, and fragment identifier).
+
+A rudimentary, parser for HTML files is available in the module
+\code{htmllib}.  It currently supports a subset of HTML 1.0 (if you
+bring it up to date, I'd love to receive your fixes!).  Unfortunately
+Python seems to be too slow for real-time parsing and formatting of
+HTML such as required by interactive WWW browsers --- but it's ideal
+for writing a ``robot'' (an automated WWW browser that searches the
+web for information).
 
 
 \section{Miscellaneous}
index c29d3a765d8fdbeb6194153f7b5d643eae7942f5..ffe03d092130241a27f8dfdc1d109d4fac688aa8 100644 (file)
@@ -3276,7 +3276,8 @@ In this release, the built-in exceptions are still strings.
 Two new modules, \code{pickle} and \code{shelve}, support storage and
 retrieval of (almost) arbitrary Python objects on disk, using the
 \code{dbm} package.  A third module, \code{copy}, provides flexible
-object copying operations.
+object copying operations.  More information on these modules is
+provided in the Library Reference Manual.
 
 \subsection{Persistent Objects}
 
@@ -3308,9 +3309,6 @@ on files.  The operation \code{shelve.open(filename)} returns a
 dictionary-like interface.  Database keys are strings, objects stored
 in the database can be anything that \code{pickle} will handle.
 
-More information on these modules can be glanced from their
-documentation strings (see below).
-
 \subsection{Copying Objects}
 
 The module \code{copy} exports two functions: \code{copy()} and
@@ -3338,8 +3336,6 @@ as \code{pickle} --- user-defined classes can control how they are
 copied by providing methods named \code{__getinitargs__()},
 \code{__getstate__()} and \code{__setstate__()}.
 
-More info in the module's documentation string.
-
 
 \section{Documentation Strings}
 
@@ -3496,21 +3492,21 @@ this forms the basis for a future restricted execution mode.
 
 There is a growing number of modules available for writing WWW tools.
 The previous release already sported modules \code{gopherlib},
-\code{ftplib}, \code{httplib} and \code{urllib} (unifying the previous
-three) for accessing data through the commonest WWW protocols.  This
-release also provides \code{cgi}, to ease the writing of server-side
-scripts that use the Common Gateway Interface protocol, supported by
-most WWW servers.  The module \code{urlparse} provides precise parsing
-of a URL string into its components (address scheme, network location,
-path, parameters, query, and fragment identifier).
-
-There is no complete parser for HTML files yet, although the
-\code{Demo/www} directory in the distribution contains some old code
-that should be a start if you wanted to contribute one.
-Unfortunately Python seems to be too slow for real-time parsing and
-formatting of HTML such as required by interactive WWW browsers --- but
-it's ideal for writing a ``robot'' (an automated WWW browser that
-searches the web for information).
+\code{ftplib}, \code{httplib} and \code{urllib} (which unifies the
+other three) for accessing data through the commonest WWW protocols.
+This release also provides \code{cgi}, to ease the writing of
+server-side scripts that use the Common Gateway Interface protocol,
+supported by most WWW servers.  The module \code{urlparse} provides
+precise parsing of a URL string into its components (address scheme,
+network location, path, parameters, query, and fragment identifier).
+
+A rudimentary, parser for HTML files is available in the module
+\code{htmllib}.  It currently supports a subset of HTML 1.0 (if you
+bring it up to date, I'd love to receive your fixes!).  Unfortunately
+Python seems to be too slow for real-time parsing and formatting of
+HTML such as required by interactive WWW browsers --- but it's ideal
+for writing a ``robot'' (an automated WWW browser that searches the
+web for information).
 
 
 \section{Miscellaneous}