Commit f25fa6dd authored by Fred Drake's avatar Fred Drake

avoid ugly markup based on the unfortunate conversions of ">>" and "<<" to

guillemets; no need for magic here
parent f863609c
...@@ -630,7 +630,7 @@ determination. ...@@ -630,7 +630,7 @@ determination.
Returns the result of right shifting \var{o1} by \var{o2} on Returns the result of right shifting \var{o1} by \var{o2} on
success, or \NULL{} on failure. The operation is done success, or \NULL{} on failure. The operation is done
\emph{in-place} when \var{o1} supports it. This is the equivalent \emph{in-place} when \var{o1} supports it. This is the equivalent
of the Python statement \samp{\var{o1} >\code{>=} \var{o2}}. of the Python statement \samp{\var{o1} >>= \var{o2}}.
\end{cfuncdesc} \end{cfuncdesc}
......
...@@ -88,7 +88,7 @@ described here are distributed with the Python sources in the ...@@ -88,7 +88,7 @@ described here are distributed with the Python sources in the
Once the Debug build has succeeded, bring up a DOS box, and change Once the Debug build has succeeded, bring up a DOS box, and change
to the \file{example_nt\textbackslash Debug} directory. You to the \file{example_nt\textbackslash Debug} directory. You
should now be able to repeat the following session (\code{C>} is should now be able to repeat the following session (\code{C>} is
the DOS prompt, \code{>\code{>}>} is the Python prompt; note that the DOS prompt, \code{>>>} is the Python prompt; note that
build information and various debug output from Python may not build information and various debug output from Python may not
match this screen dump exactly): match this screen dump exactly):
......
...@@ -19,7 +19,7 @@ There are two parts to this job: ...@@ -19,7 +19,7 @@ There are two parts to this job:
\begin{enumerate} \begin{enumerate}
\item Being able to tell if a line of input completes a Python \item Being able to tell if a line of input completes a Python
statement: in short, telling whether to print statement: in short, telling whether to print
`\code{>\code{>}>~}' or `\code{...~}' next. `\code{>>>~}' or `\code{...~}' next.
\item Remembering which future statements the user has entered, so \item Remembering which future statements the user has entered, so
subsequent input can be compiled with these in effect. subsequent input can be compiled with these in effect.
\end{enumerate} \end{enumerate}
......
...@@ -333,8 +333,8 @@ NO!!! ...@@ -333,8 +333,8 @@ NO!!!
\end{verbatim} \end{verbatim}
Any expected output must immediately follow the final Any expected output must immediately follow the final
\code{'>\code{>}>~'} or \code{'...~'} line containing the code, and \code{'>>>~'} or \code{'...~'} line containing the code, and
the expected output (if any) extends to the next \code{'>\code{>}>~'} the expected output (if any) extends to the next \code{'>>>~'}
or all-whitespace line. or all-whitespace line.
The fine print: The fine print:
...@@ -386,7 +386,7 @@ Backslashes in a raw docstring: m\n ...@@ -386,7 +386,7 @@ Backslashes in a raw docstring: m\n
\end{verbatim} \end{verbatim}
and as many leading whitespace characters are stripped from the and as many leading whitespace characters are stripped from the
expected output as appeared in the initial \code{'>\code{>}>~'} line expected output as appeared in the initial \code{'>>>~'} line
that started the example. that started the example.
\end{itemize} \end{itemize}
......
...@@ -132,7 +132,7 @@ implementation does nothing. ...@@ -132,7 +132,7 @@ implementation does nothing.
\begin{methoddesc}{handle_decl}{decl} \begin{methoddesc}{handle_decl}{decl}
Method called when an SGML declaration is read by the parser. The Method called when an SGML declaration is read by the parser. The
\var{decl} parameter will be the entire contents of the declaration \var{decl} parameter will be the entire contents of the declaration
inside the \code{<!}...\code{>} markup.It is intended to be overridden inside the \code{<!}...\code{>} markup. It is intended to be overridden
by a derived class; the base class implementation does nothing. by a derived class; the base class implementation does nothing.
\end{methoddesc} \end{methoddesc}
......
...@@ -320,7 +320,7 @@ and \var{b} sequences. ...@@ -320,7 +320,7 @@ and \var{b} sequences.
\begin{funcdesc}{irshift}{a, b} \begin{funcdesc}{irshift}{a, b}
\funcline{__irshift__}{a, b} \funcline{__irshift__}{a, b}
\code{a = irshift(a, b)} is equivalent to \code{a >}\code{>= b}. \code{a = irshift(a, b)} is equivalent to \code{a >>= b}.
\versionadded{2.5} \versionadded{2.5}
\end{funcdesc} \end{funcdesc}
...@@ -499,7 +499,7 @@ symbols in the Python syntax and the functions in the ...@@ -499,7 +499,7 @@ symbols in the Python syntax and the functions in the
{\code{neg(\var{a})}} {\code{neg(\var{a})}}
\lineiii{Negation (Logical)}{\code{not \var{a}}} \lineiii{Negation (Logical)}{\code{not \var{a}}}
{\code{not_(\var{a})}} {\code{not_(\var{a})}}
\lineiii{Right Shift}{\code{\var{a} >\code{>} \var{b}}} \lineiii{Right Shift}{\code{\var{a} >> \var{b}}}
{\code{rshift(\var{a}, \var{b})}} {\code{rshift(\var{a}, \var{b})}}
\lineiii{Sequence Repitition}{\code{\var{seq} * \var{i}}} \lineiii{Sequence Repitition}{\code{\var{seq} * \var{i}}}
{\code{repeat(\var{seq}, \var{i})}} {\code{repeat(\var{seq}, \var{i})}}
......
...@@ -410,7 +410,7 @@ else: ...@@ -410,7 +410,7 @@ else:
Strings specifying the primary and secondary prompt of the Strings specifying the primary and secondary prompt of the
interpreter. These are only defined if the interpreter is in interpreter. These are only defined if the interpreter is in
interactive mode. Their initial values in this case are interactive mode. Their initial values in this case are
\code{'>\code{>}> '} and \code{'... '}. If a non-string object is \code{'>>>~'} and \code{'... '}. If a non-string object is
assigned to either variable, its \function{str()} is re-evaluated assigned to either variable, its \function{str()} is re-evaluated
each time the interpreter prepares to read a new interactive each time the interpreter prepares to read a new interactive
command; this can be used to implement a dynamic prompt. command; this can be used to implement a dynamic prompt.
......
...@@ -54,7 +54,7 @@ Name a directory in which to save annotated listing files. ...@@ -54,7 +54,7 @@ Name a directory in which to save annotated listing files.
\item[\longprogramopt{missing}, \programopt{-m}] \item[\longprogramopt{missing}, \programopt{-m}]
When generating annotated listings, mark lines which When generating annotated listings, mark lines which
were not executed with \code{>}\code{>}\code{>}\code{>}\code{>}\code{>}. were not executed with `\code{>>>>>>}'.
\item[\longprogramopt{summary}, \programopt{-s}] \item[\longprogramopt{summary}, \programopt{-s}]
When using \longprogramopt{count} or \longprogramopt{report}, write a When using \longprogramopt{count} or \longprogramopt{report}, write a
......
...@@ -1875,8 +1875,8 @@ These methods are ...@@ -1875,8 +1875,8 @@ These methods are
called to implement the binary arithmetic operations (\code{+}, called to implement the binary arithmetic operations (\code{+},
\code{-}, \code{*}, \code{//}, \code{\%}, \code{-}, \code{*}, \code{//}, \code{\%},
\function{divmod()}\bifuncindex{divmod}, \function{divmod()}\bifuncindex{divmod},
\function{pow()}\bifuncindex{pow}, \code{**}, \code{<}\code{<}, \function{pow()}\bifuncindex{pow}, \code{**}, \code{<<},
\code{>}\code{>}, \code{\&}, \code{\^}, \code{|}). For instance, to \code{>>}, \code{\&}, \code{\^}, \code{|}). For instance, to
evaluate the expression \var{x}\code{+}\var{y}, where \var{x} is an evaluate the expression \var{x}\code{+}\var{y}, where \var{x} is an
instance of a class that has an \method{__add__()} method, instance of a class that has an \method{__add__()} method,
\code{\var{x}.__add__(\var{y})} is called. The \method{__divmod__()} \code{\var{x}.__add__(\var{y})} is called. The \method{__divmod__()}
...@@ -1915,8 +1915,8 @@ These methods are ...@@ -1915,8 +1915,8 @@ These methods are
called to implement the binary arithmetic operations (\code{+}, called to implement the binary arithmetic operations (\code{+},
\code{-}, \code{*}, \code{/}, \code{\%}, \code{-}, \code{*}, \code{/}, \code{\%},
\function{divmod()}\bifuncindex{divmod}, \function{divmod()}\bifuncindex{divmod},
\function{pow()}\bifuncindex{pow}, \code{**}, \code{<}\code{<}, \function{pow()}\bifuncindex{pow}, \code{**}, \code{<<},
\code{>}\code{>}, \code{\&}, \code{\^}, \code{|}) with reflected \code{>>}, \code{\&}, \code{\^}, \code{|}) with reflected
(swapped) operands. These functions are only called if the left (swapped) operands. These functions are only called if the left
operand does not support the corresponding operation. For instance, operand does not support the corresponding operation. For instance,
to evaluate the expression \var{x}\code{-}\var{y}, where \var{y} is an to evaluate the expression \var{x}\code{-}\var{y}, where \var{y} is an
...@@ -1942,7 +1942,7 @@ complicated). ...@@ -1942,7 +1942,7 @@ complicated).
\methodline[numeric object]{__ior__}{self, other} \methodline[numeric object]{__ior__}{self, other}
These methods are called to implement the augmented arithmetic These methods are called to implement the augmented arithmetic
operations (\code{+=}, \code{-=}, \code{*=}, \code{/=}, \code{\%=}, operations (\code{+=}, \code{-=}, \code{*=}, \code{/=}, \code{\%=},
\code{**=}, \code{<}\code{<=}, \code{>}\code{>=}, \code{\&=}, \code{**=}, \code{<<=}, \code{>>=}, \code{\&=},
\code{\textasciicircum=}, \code{|=}). These methods should attempt to do the \code{\textasciicircum=}, \code{|=}). These methods should attempt to do the
operation in-place (modifying \var{self}) and return the result (which operation in-place (modifying \var{self}) and return the result (which
could be, but does not have to be, \var{self}). If a specific method could be, but does not have to be, \var{self}). If a specific method
......
...@@ -1158,7 +1158,7 @@ have the same precedence and chain from left to right --- see section ...@@ -1158,7 +1158,7 @@ have the same precedence and chain from left to right --- see section
\hline \hline
\lineii{\code{\&}} {Bitwise AND} \lineii{\code{\&}} {Bitwise AND}
\hline \hline
\lineii{\code{<}\code{<}, \code{>}\code{>}} {Shifts} \lineii{\code{<<}, \code{>>}} {Shifts}
\hline \hline
\lineii{\code{+}, \code{-}}{Addition and subtraction} \lineii{\code{+}, \code{-}}{Addition and subtraction}
\hline \hline
......
...@@ -377,7 +377,7 @@ right type (but even this is determined by the sliced object). ...@@ -377,7 +377,7 @@ right type (but even this is determined by the sliced object).
\begin{productionlist} \begin{productionlist}
\production{print_stmt} \production{print_stmt}
{"print" ( \optional{\token{expression} ("," \token{expression})* \optional{","}}} {"print" ( \optional{\token{expression} ("," \token{expression})* \optional{","}}}
\productioncont{| ">\code{>}" \token{expression} \productioncont{| ">>" \token{expression}
\optional{("," \token{expression})+ \optional{","}} )} \optional{("," \token{expression})+ \optional{","}} )}
\end{productionlist} \end{productionlist}
......
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
\index{>>>} \index{>>>}
\item[\code{>\code{>}>}] \item[\code{>>>}]
The typical Python prompt of the interactive shell. Often seen for The typical Python prompt of the interactive shell. Often seen for
code examples that can be tried right away in the interpreter. code examples that can be tried right away in the interpreter.
......
...@@ -264,7 +264,7 @@ the command or module to handle. ...@@ -264,7 +264,7 @@ the command or module to handle.
When commands are read from a tty, the interpreter is said to be in When commands are read from a tty, the interpreter is said to be in
\emph{interactive mode}. In this mode it prompts for the next command \emph{interactive mode}. In this mode it prompts for the next command
with the \emph{primary prompt}, usually three greater-than signs with the \emph{primary prompt}, usually three greater-than signs
(\samp{>\code{>}>~}); for continuation lines it prompts with the (\samp{>>>~}); for continuation lines it prompts with the
\emph{secondary prompt}, by default three dots (\samp{...~}). \emph{secondary prompt}, by default three dots (\samp{...~}).
The interpreter prints a welcome message stating its version number The interpreter prints a welcome message stating its version number
and a copyright notice before printing the first prompt: and a copyright notice before printing the first prompt:
...@@ -423,7 +423,7 @@ if filename and os.path.isfile(filename): ...@@ -423,7 +423,7 @@ if filename and os.path.isfile(filename):
\chapter{An Informal Introduction to Python \label{informal}} \chapter{An Informal Introduction to Python \label{informal}}
In the following examples, input and output are distinguished by the In the following examples, input and output are distinguished by the
presence or absence of prompts (\samp{>\code{>}>~} and \samp{...~}): to repeat presence or absence of prompts (\samp{>>>~} and \samp{...~}): to repeat
the example, you must type everything after the prompt, when the the example, you must type everything after the prompt, when the
prompt appears; lines that do not begin with a prompt are output from prompt appears; lines that do not begin with a prompt are output from
the interpreter. % the interpreter. %
...@@ -455,7 +455,7 @@ STRING = "# This is not a comment." ...@@ -455,7 +455,7 @@ STRING = "# This is not a comment."
\section{Using Python as a Calculator \label{calculator}} \section{Using Python as a Calculator \label{calculator}}
Let's try some simple Python commands. Start the interpreter and wait Let's try some simple Python commands. Start the interpreter and wait
for the primary prompt, \samp{>\code{>}>~}. (It shouldn't take long.) for the primary prompt, \samp{>>>~}. (It shouldn't take long.)
\subsection{Numbers \label{numbers}} \subsection{Numbers \label{numbers}}
......
...@@ -400,7 +400,7 @@ statement \code{a += 2} increments the value of the variable ...@@ -400,7 +400,7 @@ statement \code{a += 2} increments the value of the variable
% The empty groups below prevent conversion to guillemets. % The empty groups below prevent conversion to guillemets.
The full list of supported assignment operators is \code{+=}, The full list of supported assignment operators is \code{+=},
\code{-=}, \code{*=}, \code{/=}, \code{\%=}, \code{**=}, \code{\&=}, \code{-=}, \code{*=}, \code{/=}, \code{\%=}, \code{**=}, \code{\&=},
\code{|=}, \verb|^=|, \code{>{}>=}, and \code{<{}<=}. Python classes can \code{|=}, \verb|^=|, \code{>>=}, and \code{<<=}. Python classes can
override the augmented assignment operators by defining methods named override the augmented assignment operators by defining methods named
\method{__iadd__}, \method{__isub__}, etc. For example, the following \method{__iadd__}, \method{__isub__}, etc. For example, the following
\class{Number} class stores a number and supports using += to create a \class{Number} class stores a number and supports using += to create a
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment