summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libregex.tex
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1997-12-09 19:45:47 (GMT)
committerGuido van Rossum <guido@python.org>1997-12-09 19:45:47 (GMT)
commit28f9a68deb7ca9e9d44c2dcc0fc4d80430219eb0 (patch)
treec6e4c10b267f9198b8952c7e02e59ab8d3a55e36 /Doc/lib/libregex.tex
parent5bdea89c892b1a10281eeae7b60da7f9a0c15ec4 (diff)
downloadcpython-28f9a68deb7ca9e9d44c2dcc0fc4d80430219eb0.zip
cpython-28f9a68deb7ca9e9d44c2dcc0fc4d80430219eb0.tar.gz
cpython-28f9a68deb7ca9e9d44c2dcc0fc4d80430219eb0.tar.bz2
Added note about the module's obsolescence.
Diffstat (limited to 'Doc/lib/libregex.tex')
-rw-r--r--Doc/lib/libregex.tex12
1 files changed, 11 insertions, 1 deletions
diff --git a/Doc/lib/libregex.tex b/Doc/lib/libregex.tex
index ee1563d..bf937f2 100644
--- a/Doc/lib/libregex.tex
+++ b/Doc/lib/libregex.tex
@@ -3,7 +3,17 @@
\bimodindex{regex}
This module provides regular expression matching operations similar to
-those found in Emacs. It is always available.
+those found in Emacs.
+
+\strong{Obsolescence note:}
+This module is obsolete as of Python version 1.5; it is still being
+maintained because much existing code still uses it. All new code in
+need of regular expressions should use the new \code{re} module, which
+supports the more powerful and regular Perl-style regular expressions.
+Existing code should be converted. The standard library module
+\code{reconvert} helps in converting \code{regex} style regular
+expressions to \code{re} style regular expressions. (The interfaces
+are different too, so the conversion cannot be fully automated.)
By default the patterns are Emacs-style regular expressions
(with one exception). There is