mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

no need to reference doc strings for documented modules

Browse source
This commit is contained in:
Guido van Rossum 1995-02-16 16:28:48 +00:00
parent 817a842ad2
commit bcc958259a
2 changed files with 32 additions and 40 deletions
Download patch file Download diff file Expand all files Collapse all files

36
Doc/tut.tex
View 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 Two new modules, \code{pickle} and \code{shelve}, support storage and
retrieval of (almost) arbitrary Python objects on disk, using the retrieval of (almost) arbitrary Python objects on disk, using the
\code{dbm} package. A third module, \code{copy}, provides flexible \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} \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 dictionary-like interface. Database keys are strings, objects stored
in the database can be anything that \code{pickle} will handle. 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} \subsection{Copying Objects}
The module \code{copy} exports two functions: \code{copy()} and 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__()}, copied by providing methods named \code{__getinitargs__()},
\code{__getstate__()} and \code{__setstate__()}. \code{__getstate__()} and \code{__setstate__()}.
More info in the module's documentation string.
\section{Documentation Strings} \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. There is a growing number of modules available for writing WWW tools.
The previous release already sported modules \code{gopherlib}, The previous release already sported modules \code{gopherlib},
\code{ftplib}, \code{httplib} and \code{urllib} (unifying the previous \code{ftplib}, \code{httplib} and \code{urllib} (which unifies the
three) for accessing data through the commonest WWW protocols. This other three) for accessing data through the commonest WWW protocols.
release also provides \code{cgi}, to ease the writing of server-side This release also provides \code{cgi}, to ease the writing of
scripts that use the Common Gateway Interface protocol, supported by server-side scripts that use the Common Gateway Interface protocol,
most WWW servers. The module \code{urlparse} provides precise parsing supported by most WWW servers. The module \code{urlparse} provides
of a URL string into its components (address scheme, network location, precise parsing of a URL string into its components (address scheme,
path, parameters, query, and fragment identifier). network location, path, parameters, query, and fragment identifier).
There is no complete parser for HTML files yet, although the A rudimentary, parser for HTML files is available in the module
\code{Demo/www} directory in the distribution contains some old code \code{htmllib}. It currently supports a subset of HTML 1.0 (if you
that should be a start if you wanted to contribute one. bring it up to date, I'd love to receive your fixes!). Unfortunately
Unfortunately Python seems to be too slow for real-time parsing and Python seems to be too slow for real-time parsing and formatting of
formatting of HTML such as required by interactive WWW browsers --- but HTML such as required by interactive WWW browsers --- but it's ideal
it's ideal for writing a ``robot'' (an automated WWW browser that for writing a ``robot'' (an automated WWW browser that searches the
searches the web for information). web for information).
\section{Miscellaneous} \section{Miscellaneous}

36
Doc/tut/tut.tex
View 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 Two new modules, \code{pickle} and \code{shelve}, support storage and
retrieval of (almost) arbitrary Python objects on disk, using the retrieval of (almost) arbitrary Python objects on disk, using the
\code{dbm} package. A third module, \code{copy}, provides flexible \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} \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 dictionary-like interface. Database keys are strings, objects stored
in the database can be anything that \code{pickle} will handle. 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} \subsection{Copying Objects}
The module \code{copy} exports two functions: \code{copy()} and 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__()}, copied by providing methods named \code{__getinitargs__()},
\code{__getstate__()} and \code{__setstate__()}. \code{__getstate__()} and \code{__setstate__()}.
More info in the module's documentation string.
\section{Documentation Strings} \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. There is a growing number of modules available for writing WWW tools.
The previous release already sported modules \code{gopherlib}, The previous release already sported modules \code{gopherlib},
\code{ftplib}, \code{httplib} and \code{urllib} (unifying the previous \code{ftplib}, \code{httplib} and \code{urllib} (which unifies the
three) for accessing data through the commonest WWW protocols. This other three) for accessing data through the commonest WWW protocols.
release also provides \code{cgi}, to ease the writing of server-side This release also provides \code{cgi}, to ease the writing of
scripts that use the Common Gateway Interface protocol, supported by server-side scripts that use the Common Gateway Interface protocol,
most WWW servers. The module \code{urlparse} provides precise parsing supported by most WWW servers. The module \code{urlparse} provides
of a URL string into its components (address scheme, network location, precise parsing of a URL string into its components (address scheme,
path, parameters, query, and fragment identifier). network location, path, parameters, query, and fragment identifier).
There is no complete parser for HTML files yet, although the A rudimentary, parser for HTML files is available in the module
\code{Demo/www} directory in the distribution contains some old code \code{htmllib}. It currently supports a subset of HTML 1.0 (if you
that should be a start if you wanted to contribute one. bring it up to date, I'd love to receive your fixes!). Unfortunately
Unfortunately Python seems to be too slow for real-time parsing and Python seems to be too slow for real-time parsing and formatting of
formatting of HTML such as required by interactive WWW browsers --- but HTML such as required by interactive WWW browsers --- but it's ideal
it's ideal for writing a ``robot'' (an automated WWW browser that for writing a ``robot'' (an automated WWW browser that searches the
searches the web for information). web for information).
\section{Miscellaneous} \section{Miscellaneous}