summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/formatter.rst4
-rw-r--r--Doc/library/pdb.rst8
-rw-r--r--Doc/tools/sphinx-build.py5
3 files changed, 9 insertions, 8 deletions
diff --git a/Doc/library/formatter.rst b/Doc/library/formatter.rst
index 2774a2b..ba09b8e 100644
--- a/Doc/library/formatter.rst
+++ b/Doc/library/formatter.rst
@@ -242,8 +242,8 @@ typically be provided by the application.
.. method:: writer.new_font(font)
Set the font style. The value of *font* will be ``None``, indicating that the
- device's default font should be used, or a tuple of the form ``(``*size*,
- *italic*, *bold*, *teletype*``)``. Size will be a string indicating the size of
+ device's default font should be used, or a tuple of the form ``(size,
+ italic, bold, teletype)``. Size will be a string indicating the size of
font that should be used; specific strings and their interpretation must be
defined by the application. The *italic*, *bold*, and *teletype* values are
Boolean values specifying which of those font attributes should be used.
diff --git a/Doc/library/pdb.rst b/Doc/library/pdb.rst
index 804dd23..d84c549 100644
--- a/Doc/library/pdb.rst
+++ b/Doc/library/pdb.rst
@@ -178,7 +178,7 @@ d(own)
u(p)
Move the current frame one level up in the stack trace (to an older frame).
-b(reak) [[*filename*:]*lineno*``|``*function*[, *condition*]]
+b(reak) [[*filename*:]\ *lineno* | *function*\ [, *condition*]]
With a *lineno* argument, set a break there in the current file. With a
*function* argument, set a break at the first executable statement within that
function. The line number may be prefixed with a filename and a colon, to
@@ -193,7 +193,7 @@ b(reak) [[*filename*:]*lineno*``|``*function*[, *condition*]]
times that breakpoint has been hit, the current ignore count, and the associated
condition if any.
-tbreak [[*filename*:]*lineno*``|``*function*[, *condition*]]
+tbreak [[*filename*:]\ *lineno* | *function*\ [, *condition*]]
Temporary breakpoint, which is removed automatically when it is first hit. The
arguments are the same as break.
@@ -279,7 +279,7 @@ j(ump) *lineno*
possible to jump into the middle of a :keyword:`for` loop or out of a
:keyword:`finally` clause.
-l(ist) [*first*[, *last*]]
+l(ist) [*first*\ [, *last*]]
List source code for the current file. Without arguments, list 11 lines around
the current line or continue the previous listing. With one argument, list 11
lines around at that line. With two arguments, list the given range; if the
@@ -324,7 +324,7 @@ alias [*name* [command]]
unalias *name*
Deletes the specified alias.
-[!]*statement*
+[!]\ *statement*
Execute the (one-line) *statement* in the context of the current stack frame.
The exclamation point can be omitted unless the first word of the statement
resembles a debugger command. To set a global variable, you can prefix the
diff --git a/Doc/tools/sphinx-build.py b/Doc/tools/sphinx-build.py
index 8c9331e..e19b10a 100644
--- a/Doc/tools/sphinx-build.py
+++ b/Doc/tools/sphinx-build.py
@@ -13,9 +13,10 @@ if __name__ == '__main__':
if sys.version_info[:3] < (2, 5, 0):
print >>sys.stderr, """\
-Error: Sphinx needs to be executed with Python 2.5 or newer.
+Error: Sphinx needs to be executed with Python 2.5 or newer
(If you run this from the Makefile, you can set the PYTHON variable
-to the path of an alternative interpreter executable.)
+to the path of an alternative interpreter executable, e.g.,
+``make html PYTHON=python2.5``).
"""
sys.exit(1)