diff options
author | Fred Drake <fdrake@acm.org> | 1997-12-29 21:39:39 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 1997-12-29 21:39:39 (GMT) |
commit | 78f8e98232a551f2b53fdd5e60188a14292b906c (patch) | |
tree | eb15a7a72851f718f70a015cfdbf13ea2a9cde70 /Doc | |
parent | 6810a29c649001fc3c6033f471bc0f63b73f7775 (diff) | |
download | cpython-78f8e98232a551f2b53fdd5e60188a14292b906c.zip cpython-78f8e98232a551f2b53fdd5e60188a14292b906c.tar.gz cpython-78f8e98232a551f2b53fdd5e60188a14292b906c.tar.bz2 |
Lots of minor nits that allow this file to get processed without failures by
the info generation phases. Most of the errors had occurred in the makeinfo
step.
Commented out the warning at the top; this should still really be removed
before 1.5, but that's not my call. It generated problems for the info
conversion as well.
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/lib/libre.tex | 52 | ||||
-rw-r--r-- | Doc/libre.tex | 52 |
2 files changed, 54 insertions, 50 deletions
diff --git a/Doc/lib/libre.tex b/Doc/lib/libre.tex index 208f8d1..65c47ff 100644 --- a/Doc/lib/libre.tex +++ b/Doc/lib/libre.tex @@ -4,10 +4,10 @@ \bimodindex{re} % XXX Remove before 1.5final release. -{\large\bf This documentation is preliminary and incomplete. If you -find a bug or documentation error, or just find something unclear, -please send a message to -\code{string-sig@python.org}, and we'll fix it.} +%{\large\bf This documentation is preliminary and incomplete. If you +%find a bug or documentation error, or just find something unclear, +%please send a message to +%\code{string-sig@python.org}, and we'll fix it.} This module provides regular expression matching operations similar to those found in Perl. It's 8-bit clean: both patterns and strings may @@ -246,13 +246,13 @@ Python's string literals. equivalent to the set \code{[0-9]}. % \item[\code{\e D}]Matches any non-digit character; this is -equivalent to the set \code{[{\^}0-9]}. +equivalent to the set \code{[\^0-9]}. % \item[\code{\e s}]Matches any whitespace character; this is equivalent to the set \code{[ \e t\e n\e r\e f\e v]}. % \item[\code{\e S}]Matches any non-whitespace character; this is -equivalent to the set \code{[{\^} \e t\e n\e r\e f\e v]}. +equivalent to the set \code{[\^ \e t\e n\e r\e f\e v]}. % \item[\code{\e w}]When the LOCALE flag is not specified, matches any alphanumeric character; this is equivalent to the set \code{[a-zA-Z0-9_]}. With LOCALE, it will match @@ -261,7 +261,7 @@ for the current locale. % \item[\code{\e W}]When the LOCALE flag is not specified, matches any non-alphanumeric character; this is equivalent to the set -\code{[{\^}a-zA-Z0-9_]}. With LOCALE, it will match any character +\code{[\^a-zA-Z0-9_]}. With LOCALE, it will match any character not in the set \code{[0-9_]}, and not defined as a letter for the current locale. @@ -273,6 +273,7 @@ for the current locale. \end{itemize} \subsection{Module Contents} +\nodename{Contents of Module re} The module defines the following functions and constants, and an exception: @@ -287,22 +288,24 @@ The module defines the following functions and constants, and an exception: \var{flags} value. Values can be any of the following variables, combined using bitwise OR (the \code{|} operator). -\begin{itemize} +\begin{description} + +% The use of \quad in the item labels is ugly but adds enough space +% to the label that it doesn't get visually run-in with the text. -\item {I or IGNORECASE or \code{(?i)}} +\item[I or IGNORECASE or \code{(?i)}\quad] -{Perform case-insensitive matching; expressions like \code{[A-Z]} will match +Perform case-insensitive matching; expressions like \code{[A-Z]} will match lowercase letters, too. This is not affected by the current locale. -} -\item {L or LOCALE or \code{(?L)}} -{Make \code{\e w}, \code{\e W}, \code{\e b}, +\item[L or LOCALE or \code{(?L)}\quad] + +Make \code{\e w}, \code{\e W}, \code{\e b}, \code{\e B}, dependent on the current locale. -} -\item {M or MULTILINE or \code{(?m)}} +\item[M or MULTILINE or \code{(?m)}\quad] -{When specified, the pattern character \code{\^} matches at the +When specified, the pattern character \code{\^} matches at the beginning of the string and at the beginning of each line (immediately following each newline); and the pattern character \code{\$} matches at the end of the string and at the end of each line @@ -310,25 +313,24 @@ lowercase letters, too. This is not affected by the current locale. By default, \code{\^} matches only at the beginning of the string, and \code{\$} only at the end of the string and immediately before the newline (if any) at the end of the string. -} -\item {S or DOTALL or \code{(?s)}} +\item[S or DOTALL or \code{(?s)}\quad] -{Make the \code{.} special character any character at all, including a +Make the \code{.} special character any character at all, including a newline; without this flag, \code{.} will match anything \emph{except} -a newline.} +a newline. -\item {X or VERBOSE or \code{(?x)}} +\item[X or VERBOSE or \code{(?x)}\quad] -{Ignore whitespace within the pattern +Ignore whitespace within the pattern except when in a character class or preceded by an unescaped backslash, and, when a line contains a \code{\#} neither in a character class or preceded by an unescaped backslash, all characters from the -leftmost such \code{\#} through the end of the line are ignored. } +leftmost such \code{\#} through the end of the line are ignored. -\end{itemize} +\end{description} - The sequence +The sequence % \bcode\begin{verbatim} prog = re.compile(pat) diff --git a/Doc/libre.tex b/Doc/libre.tex index 208f8d1..65c47ff 100644 --- a/Doc/libre.tex +++ b/Doc/libre.tex @@ -4,10 +4,10 @@ \bimodindex{re} % XXX Remove before 1.5final release. -{\large\bf This documentation is preliminary and incomplete. If you -find a bug or documentation error, or just find something unclear, -please send a message to -\code{string-sig@python.org}, and we'll fix it.} +%{\large\bf This documentation is preliminary and incomplete. If you +%find a bug or documentation error, or just find something unclear, +%please send a message to +%\code{string-sig@python.org}, and we'll fix it.} This module provides regular expression matching operations similar to those found in Perl. It's 8-bit clean: both patterns and strings may @@ -246,13 +246,13 @@ Python's string literals. equivalent to the set \code{[0-9]}. % \item[\code{\e D}]Matches any non-digit character; this is -equivalent to the set \code{[{\^}0-9]}. +equivalent to the set \code{[\^0-9]}. % \item[\code{\e s}]Matches any whitespace character; this is equivalent to the set \code{[ \e t\e n\e r\e f\e v]}. % \item[\code{\e S}]Matches any non-whitespace character; this is -equivalent to the set \code{[{\^} \e t\e n\e r\e f\e v]}. +equivalent to the set \code{[\^ \e t\e n\e r\e f\e v]}. % \item[\code{\e w}]When the LOCALE flag is not specified, matches any alphanumeric character; this is equivalent to the set \code{[a-zA-Z0-9_]}. With LOCALE, it will match @@ -261,7 +261,7 @@ for the current locale. % \item[\code{\e W}]When the LOCALE flag is not specified, matches any non-alphanumeric character; this is equivalent to the set -\code{[{\^}a-zA-Z0-9_]}. With LOCALE, it will match any character +\code{[\^a-zA-Z0-9_]}. With LOCALE, it will match any character not in the set \code{[0-9_]}, and not defined as a letter for the current locale. @@ -273,6 +273,7 @@ for the current locale. \end{itemize} \subsection{Module Contents} +\nodename{Contents of Module re} The module defines the following functions and constants, and an exception: @@ -287,22 +288,24 @@ The module defines the following functions and constants, and an exception: \var{flags} value. Values can be any of the following variables, combined using bitwise OR (the \code{|} operator). -\begin{itemize} +\begin{description} + +% The use of \quad in the item labels is ugly but adds enough space +% to the label that it doesn't get visually run-in with the text. -\item {I or IGNORECASE or \code{(?i)}} +\item[I or IGNORECASE or \code{(?i)}\quad] -{Perform case-insensitive matching; expressions like \code{[A-Z]} will match +Perform case-insensitive matching; expressions like \code{[A-Z]} will match lowercase letters, too. This is not affected by the current locale. -} -\item {L or LOCALE or \code{(?L)}} -{Make \code{\e w}, \code{\e W}, \code{\e b}, +\item[L or LOCALE or \code{(?L)}\quad] + +Make \code{\e w}, \code{\e W}, \code{\e b}, \code{\e B}, dependent on the current locale. -} -\item {M or MULTILINE or \code{(?m)}} +\item[M or MULTILINE or \code{(?m)}\quad] -{When specified, the pattern character \code{\^} matches at the +When specified, the pattern character \code{\^} matches at the beginning of the string and at the beginning of each line (immediately following each newline); and the pattern character \code{\$} matches at the end of the string and at the end of each line @@ -310,25 +313,24 @@ lowercase letters, too. This is not affected by the current locale. By default, \code{\^} matches only at the beginning of the string, and \code{\$} only at the end of the string and immediately before the newline (if any) at the end of the string. -} -\item {S or DOTALL or \code{(?s)}} +\item[S or DOTALL or \code{(?s)}\quad] -{Make the \code{.} special character any character at all, including a +Make the \code{.} special character any character at all, including a newline; without this flag, \code{.} will match anything \emph{except} -a newline.} +a newline. -\item {X or VERBOSE or \code{(?x)}} +\item[X or VERBOSE or \code{(?x)}\quad] -{Ignore whitespace within the pattern +Ignore whitespace within the pattern except when in a character class or preceded by an unescaped backslash, and, when a line contains a \code{\#} neither in a character class or preceded by an unescaped backslash, all characters from the -leftmost such \code{\#} through the end of the line are ignored. } +leftmost such \code{\#} through the end of the line are ignored. -\end{itemize} +\end{description} - The sequence +The sequence % \bcode\begin{verbatim} prog = re.compile(pat) |