Commit 5c4cf158 authored by Fred Drake's avatar Fred Drake

Normalize whitespace.

Fix a number of markup consistency buglets.
parent f2928eb0
...@@ -68,7 +68,7 @@ Set([1, 2, 5]) ...@@ -68,7 +68,7 @@ Set([1, 2, 5])
The union and intersection of sets can be computed with the The union and intersection of sets can be computed with the
\method{union()} and \method{intersection()} methods, or, \method{union()} and \method{intersection()} methods, or,
alternatively, using the bitwise operators \samp{\&} and \samp{|}. alternatively, using the bitwise operators \code{\&} and \code{|}.
Mutable sets also have in-place versions of these methods, Mutable sets also have in-place versions of these methods,
\method{union_update()} and \method{intersection_update()}. \method{union_update()} and \method{intersection_update()}.
...@@ -356,9 +356,9 @@ plus a newline. ...@@ -356,9 +356,9 @@ plus a newline.
Python's file objects can now support end of line conventions other Python's file objects can now support end of line conventions other
than the one followed by the platform on which Python is running. than the one followed by the platform on which Python is running.
Opening a file with the mode \samp{U} or \samp{rU} will open a file Opening a file with the mode \code{'U'} or \code{'rU'} will open a file
for reading in universal newline mode. All three line ending for reading in universal newline mode. All three line ending
conventions will be translated to a \samp{\e n} in the strings conventions will be translated to a \character{\e n} in the strings
returned by the various file methods such as \method{read()} and returned by the various file methods such as \method{read()} and
\method{readline()}. \method{readline()}.
...@@ -369,7 +369,7 @@ without needing to convert the line-endings. ...@@ -369,7 +369,7 @@ without needing to convert the line-endings.
This feature can be disabled at compile-time by specifying This feature can be disabled at compile-time by specifying
\longprogramopt{without-universal-newlines} when running Python's \longprogramopt{without-universal-newlines} when running Python's
\file{configure} script. \program{configure} script.
\begin{seealso} \begin{seealso}
...@@ -449,7 +449,7 @@ False ...@@ -449,7 +449,7 @@ False
Python's Booleans were added with the primary goal of making code Python's Booleans were added with the primary goal of making code
clearer. For example, if you're reading a function and encounter the clearer. For example, if you're reading a function and encounter the
statement \code{return 1}, you might wonder whether the \samp{1} statement \code{return 1}, you might wonder whether the \code{1}
represents a truth value, or whether it's an index, or whether it's a represents a truth value, or whether it's an index, or whether it's a
coefficient that multiplies some other quantity. If the statement is coefficient that multiplies some other quantity. If the statement is
\code{return True}, however, the meaning of the return value is quite \code{return True}, however, the meaning of the return value is quite
...@@ -479,7 +479,8 @@ random object, and the Boolean type is a subclass of the ...@@ -479,7 +479,8 @@ random object, and the Boolean type is a subclass of the
To sum up \constant{True} and \constant{False} in a sentence: they're To sum up \constant{True} and \constant{False} in a sentence: they're
alternative ways to spell the integer values 1 and 0, with the single alternative ways to spell the integer values 1 and 0, with the single
difference that \function{str()} and \function{repr()} return the difference that \function{str()} and \function{repr()} return the
strings \samp{True} and \samp{False} instead of \samp{1} and \samp{0}. strings \code{'True'} and \code{'False'} instead of \code{'1'} and
\code{'0'}.
\begin{seealso} \begin{seealso}
...@@ -742,7 +743,7 @@ by setting the limit back to a lower number by calling ...@@ -742,7 +743,7 @@ by setting the limit back to a lower number by calling
\item One minor but far-reaching change is that the names of extension \item One minor but far-reaching change is that the names of extension
types defined by the modules included with Python now contain the types defined by the modules included with Python now contain the
module and a \samp{.} in front of the type name. For example, in module and a \character{.} in front of the type name. For example, in
Python 2.2, if you created a socket and printed its Python 2.2, if you created a socket and printed its
\member{__class__}, you'd get this output: \member{__class__}, you'd get this output:
...@@ -878,16 +879,16 @@ details. ...@@ -878,16 +879,16 @@ details.
\begin{itemize} \begin{itemize}
\item The \module{array} module now supports arrays of Unicode \item The \module{array} module now supports arrays of Unicode
characters using the \samp{u} format character. Arrays also now characters using the \character{u} format character. Arrays also now
support using the \code{+=} assignment operator to add another array's support using the \code{+=} assignment operator to add another array's
contents, and the \code{*=} assignment operator to repeat an array. contents, and the \code{*=} assignment operator to repeat an array.
(Contributed by Jason Orendorff.) (Contributed by Jason Orendorff.)
\item The Distutils \class{Extension} class now supports \item The Distutils \class{Extension} class now supports
an extra constructor argument named \samp{depends} for listing an extra constructor argument named \var{depends} for listing
additional source files that an extension depends on. This lets additional source files that an extension depends on. This lets
Distutils recompile the module if any of the dependency files are Distutils recompile the module if any of the dependency files are
modified. For example, if \samp{sampmodule.c} includes the header modified. For example, if \file{sampmodule.c} includes the header
file \file{sample.h}, you would create the \class{Extension} object like file \file{sample.h}, you would create the \class{Extension} object like
this: this:
...@@ -1246,7 +1247,7 @@ allocate objects, and \cfunction{PyObject_GC_Del} to deallocate them. ...@@ -1246,7 +1247,7 @@ allocate objects, and \cfunction{PyObject_GC_Del} to deallocate them.
\item Python can now optionally be built as a shared library \item Python can now optionally be built as a shared library
(\file{libpython2.3.so}) by supplying \longprogramopt{enable-shared} (\file{libpython2.3.so}) by supplying \longprogramopt{enable-shared}
when running Python's \file{configure} script. (Contributed by Ondrej when running Python's \program{configure} script. (Contributed by Ondrej
Palkovsky.) Palkovsky.)
\item The \csimplemacro{DL_EXPORT} and \csimplemacro{DL_IMPORT} macros \item The \csimplemacro{DL_EXPORT} and \csimplemacro{DL_IMPORT} macros
...@@ -1258,7 +1259,7 @@ macros. ...@@ -1258,7 +1259,7 @@ macros.
\item The interpreter can be compiled without any docstrings for \item The interpreter can be compiled without any docstrings for
the built-in functions and modules by supplying the built-in functions and modules by supplying
\longprogramopt{without-doc-strings} to the \file{configure} script. \longprogramopt{without-doc-strings} to the \program{configure} script.
This makes the Python executable about 10\% smaller, but will also This makes the Python executable about 10\% smaller, but will also
mean that you can't get help for Python's built-ins. (Contributed by mean that you can't get help for Python's built-ins. (Contributed by
Gustavo Niemeyer.) Gustavo Niemeyer.)
...@@ -1266,7 +1267,7 @@ Gustavo Niemeyer.) ...@@ -1266,7 +1267,7 @@ Gustavo Niemeyer.)
\item The cycle detection implementation used by the garbage collection \item The cycle detection implementation used by the garbage collection
has proven to be stable, so it's now being made mandatory; you can no has proven to be stable, so it's now being made mandatory; you can no
longer compile Python without it, and the longer compile Python without it, and the
\longprogramopt{with-cycle-gc} switch to \file{configure} has been removed. \longprogramopt{with-cycle-gc} switch to \program{configure} has been removed.
\item The \cfunction{PyArg_NoArgs()} macro is now deprecated, and code \item The \cfunction{PyArg_NoArgs()} macro is now deprecated, and code
that uses it should be changed. For Python 2.2 and later, the method that uses it should be changed. For Python 2.2 and later, the method
...@@ -1376,14 +1377,14 @@ variable name in your code, a different name must be chosen. ...@@ -1376,14 +1377,14 @@ variable name in your code, a different name must be chosen.
\exception{SyntaxWarning} warning. \exception{SyntaxWarning} warning.
\item Names of extension types defined by the modules included with \item Names of extension types defined by the modules included with
Python now contain the module and a \samp{.} in front of the type Python now contain the module and a \character{.} in front of the type
name. name.
\item For strings \var{X} and \var{Y}, \code{\var{X} in \var{Y}} now works \item For strings \var{X} and \var{Y}, \code{\var{X} in \var{Y}} now works
if \var{X} is more than one character long. if \var{X} is more than one character long.
\item The Distutils \function{setup()} function has gained various new \item The Distutils \function{setup()} function has gained various new
keyword arguments such as \samp{depends}. Old versions of the keyword arguments such as \var{depends}. Old versions of the
Distutils will abort if passed unknown keywords. The fix is to check Distutils will abort if passed unknown keywords. The fix is to check
for the presence of the new \function{get_distutil_options()} function for the presence of the new \function{get_distutil_options()} function
in your \file{setup.py} if you want to only support the new keywords in your \file{setup.py} if you want to only support the new keywords
......
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