Document cPickle and cStringIO.

diff --git a/Doc/lib/libpickle.tex b/Doc/lib/libpickle.tex
index 038b7638d67ef8a32d51fa526ca1729f4e84d060..65075b94260abda74b7a412372aca8b8648b1d39 100644 (file)
--- a/Doc/lib/libpickle.tex
+++ b/Doc/lib/libpickle.tex
@@ -270,3 +270,21 @@ registration}
 
 \seemodule{shelve}{indexed databases of objects; uses \module{pickle}}
 \end{seealso}
+
+
+\section{Built-in Module \module{cPickle}}
+\bimodindex{cPickle}
+\label{module-cPickle}
+
+% This section was written by Fred L. Drake, Jr. <fdrake@acm.org>
+
+The \module{cPickle} module provides a similar interface and identical
+functionality as the \module{pickle} module, but can be up to 1000
+times faster since it is implemented in \C{}.  The only other
+important difference to note is that \function{Pickler()} and
+\function{Unpickler()} are functions and not classes, and so cannot be
+subclassed.  This should not be an issue in most cases.
+
+The format of the pickle data is identical to that produced using the
+\module{pickle} module, so it is possible to use \module{pickle} and
+\module{cPickle} interchangably with existing pickles.

diff --git a/Doc/lib/libstrio.tex b/Doc/lib/libstrio.tex
index 0088ec32dfcc71e0a4a36037e3d28962a81a3fac..86ebf46688ac77fb87da75430356bc07905628be 100644 (file)
--- a/Doc/lib/libstrio.tex
+++ b/Doc/lib/libstrio.tex
@@ -24,3 +24,19 @@ Retrieve the entire contents of the ``file'' at any time before the
 \begin{methoddesc}{close}{}
 Free the memory buffer.
 \end{methoddesc}
+
+
+\section{Built-in Module \module{cStringIO}}
+\bimodindex{cStringIO}
+\label{module-cStringIO}
+
+% This section was written by Fred L. Drake, Jr. <fdrake@acm.org>
+
+The module \module{cStringIO} provides an interface similar to that of
+the \module{StringIO} module.  Heavy use of \class{StringIO.StringIO}
+objects can be made more efficient by using the function
+\function{StringIO()} from this module instead.
+
+Since this module provides a factory function which returns objects of
+built-in types, there's no way to build your own version using
+subclassing.  Use the original \module{StringIO} module in that case.

diff --git a/Doc/lib/libundoc.tex b/Doc/lib/libundoc.tex
index 601d750282bc2fa66e484c94d953d9a2214a2550..99386fe513d1ecd47d764de9f3e443f021508f74 100644 (file)
--- a/Doc/lib/libundoc.tex
+++ b/Doc/lib/libundoc.tex
@@ -7,17 +7,6 @@ them!  (The idea and most contents for this chapter were taken from a
 posting by Fredrik Lundh; I have revised some modules' status.)
 
 
-\section{Fundamental, and pretty straightforward to document}
-
-\begin{description}
-\item[cPickle.c]
---- mostly the same as pickle but no subclassing
-
-\item[cStringIO.c]
---- mostly the same as StringIO but no subclassing
-\end{description}
-
-
 \section{Frameworks; somewhat harder to document, but well worth the effort}
 
 \begin{description}

diff --git a/Doc/libpickle.tex b/Doc/libpickle.tex
index 038b7638d67ef8a32d51fa526ca1729f4e84d060..65075b94260abda74b7a412372aca8b8648b1d39 100644 (file)
--- a/Doc/libpickle.tex
+++ b/Doc/libpickle.tex
@@ -270,3 +270,21 @@ registration}
 
 \seemodule{shelve}{indexed databases of objects; uses \module{pickle}}
 \end{seealso}
+
+
+\section{Built-in Module \module{cPickle}}
+\bimodindex{cPickle}
+\label{module-cPickle}
+
+% This section was written by Fred L. Drake, Jr. <fdrake@acm.org>
+
+The \module{cPickle} module provides a similar interface and identical
+functionality as the \module{pickle} module, but can be up to 1000
+times faster since it is implemented in \C{}.  The only other
+important difference to note is that \function{Pickler()} and
+\function{Unpickler()} are functions and not classes, and so cannot be
+subclassed.  This should not be an issue in most cases.
+
+The format of the pickle data is identical to that produced using the
+\module{pickle} module, so it is possible to use \module{pickle} and
+\module{cPickle} interchangably with existing pickles.

diff --git a/Doc/libstrio.tex b/Doc/libstrio.tex
index 0088ec32dfcc71e0a4a36037e3d28962a81a3fac..86ebf46688ac77fb87da75430356bc07905628be 100644 (file)
--- a/Doc/libstrio.tex
+++ b/Doc/libstrio.tex
@@ -24,3 +24,19 @@ Retrieve the entire contents of the ``file'' at any time before the
 \begin{methoddesc}{close}{}
 Free the memory buffer.
 \end{methoddesc}
+
+
+\section{Built-in Module \module{cStringIO}}
+\bimodindex{cStringIO}
+\label{module-cStringIO}
+
+% This section was written by Fred L. Drake, Jr. <fdrake@acm.org>
+
+The module \module{cStringIO} provides an interface similar to that of
+the \module{StringIO} module.  Heavy use of \class{StringIO.StringIO}
+objects can be made more efficient by using the function
+\function{StringIO()} from this module instead.
+
+Since this module provides a factory function which returns objects of
+built-in types, there's no way to build your own version using
+subclassing.  Use the original \module{StringIO} module in that case.

diff --git a/Doc/libundoc.tex b/Doc/libundoc.tex
index 601d750282bc2fa66e484c94d953d9a2214a2550..99386fe513d1ecd47d764de9f3e443f021508f74 100644 (file)
--- a/Doc/libundoc.tex
+++ b/Doc/libundoc.tex
@@ -7,17 +7,6 @@ them!  (The idea and most contents for this chapter were taken from a
 posting by Fredrik Lundh; I have revised some modules' status.)
 
 
-\section{Fundamental, and pretty straightforward to document}
-
-\begin{description}
-\item[cPickle.c]
---- mostly the same as pickle but no subclassing
-
-\item[cStringIO.c]
---- mostly the same as StringIO but no subclassing
-\end{description}
-
-
 \section{Frameworks; somewhat harder to document, but well worth the effort}
 
 \begin{description}