summaryrefslogtreecommitdiffstats
path: root/Doc/lib
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1995-03-02 12:37:30 (GMT)
committerGuido van Rossum <guido@python.org>1995-03-02 12:37:30 (GMT)
commit0bf4d892ebbc2ba1b56c5710c36abfd4e9a3c73c (patch)
treeb8b50f1fea349c3db9e2947ac62d9a1ec74a119d /Doc/lib
parentdc46c7f7346ba2f70dc011e8a38287e80dc5cb63 (diff)
downloadcpython-0bf4d892ebbc2ba1b56c5710c36abfd4e9a3c73c.zip
cpython-0bf4d892ebbc2ba1b56c5710c36abfd4e9a3c73c.tar.gz
cpython-0bf4d892ebbc2ba1b56c5710c36abfd4e9a3c73c.tar.bz2
add warning about strop
Diffstat (limited to 'Doc/lib')
-rw-r--r--Doc/lib/libstring.tex22
1 files changed, 15 insertions, 7 deletions
diff --git a/Doc/lib/libstring.tex b/Doc/lib/libstring.tex
index 7628a10..84d73e8 100644
--- a/Doc/lib/libstring.tex
+++ b/Doc/lib/libstring.tex
@@ -3,8 +3,11 @@
\stmodindex{string}
This module defines some constants useful for checking character
-classes, some exceptions, and some useful string functions.
-The constants are:
+classes and some useful string functions. See the modules
+\code{regex} and \code{regsub} for string functions based on regular
+expressions.
+
+The constants defined in this module are are:
\renewcommand{\indexsubitem}{(data in module string)}
\begin{datadesc}{digits}
@@ -48,11 +51,7 @@ The constants are:
undefined.
\end{datadesc}
-The exceptions are:
-
-\renewcommand{\indexsubitem}{(exception in module string)}
-
-The functions are:
+The functions defined in this module are:
\renewcommand{\indexsubitem}{(in module string)}
@@ -169,3 +168,12 @@ The string is never truncated.
Pad a numeric string on the left with zero digits until the given
width is reached. Strings starting with a sign are handled correctly.
\end{funcdesc}
+
+This module is implemented in Python. Much of its functionality has
+been reimplemented in the built-in module \code{strop}. However, you
+should \emph{never} import the latter module directly. When
+\code{string} discovers that \code{strop} exists, it transparently
+replaces parts of itself with the implementation from \code{strop}.
+After initialization, there is \emph{no} overhead in using
+\code{string} instead of \code{strop}.
+\bimodindex{strop}