From: Guido van Rossum <guido@python.org>
Date: Tue, 9 Dec 1997 19:45:47 +0000 (+0000)
Subject: Added note about the module's obsolescence.
X-Git-Tag: v1.5b2~42
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=28f9a68deb7ca9e9d44c2dcc0fc4d80430219eb0;p=python

Added note about the module's obsolescence.
---

diff --git a/Doc/lib/libregex.tex b/Doc/lib/libregex.tex
index ee1563d566..bf937f23d0 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
diff --git a/Doc/libregex.tex b/Doc/libregex.tex
index ee1563d566..bf937f23d0 100644
--- a/Doc/libregex.tex
+++ b/Doc/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