[Python-checkins] r56921 - in doctools/trunk: Doc-26/c-api/refcounting.rst Doc-26/library/cgi.rst Doc-26/library/fl.rst Doc-26/library/pickle.rst Doc-26/library/profile.rst Doc-26/library/re.rst Doc-26/library/signal.rst Doc-26/library/stdtypes.rst Doc-26/library/urllib.rst Doc-26/reference/lexical_analysis.rst Doc-26/tutorial/interpreter.rst Doc-3k/c-api/refcounting.rst Doc-3k/library/cgi.rst Doc-3k/library/pickle.rst Doc-3k/library/profile.rst Doc-3k/library/re.rst Doc-3k/library/signal.rst Doc-3k/library/stdtypes.rst Doc-3k/library/urllib.rst Doc-3k/reference/lexical_analysis.rst Doc-3k/tutorial/interpreter.rst
georg.brandl
python-checkins at python.org
Sat Aug 11 14:11:03 CEST 2007
Author: georg.brandl
Date: Sat Aug 11 14:11:02 2007
New Revision: 56921
Modified:
doctools/trunk/Doc-26/c-api/refcounting.rst
doctools/trunk/Doc-26/library/cgi.rst
doctools/trunk/Doc-26/library/fl.rst
doctools/trunk/Doc-26/library/pickle.rst
doctools/trunk/Doc-26/library/profile.rst
doctools/trunk/Doc-26/library/re.rst
doctools/trunk/Doc-26/library/signal.rst
doctools/trunk/Doc-26/library/stdtypes.rst
doctools/trunk/Doc-26/library/urllib.rst
doctools/trunk/Doc-26/reference/lexical_analysis.rst
doctools/trunk/Doc-26/tutorial/interpreter.rst
doctools/trunk/Doc-3k/c-api/refcounting.rst
doctools/trunk/Doc-3k/library/cgi.rst
doctools/trunk/Doc-3k/library/pickle.rst
doctools/trunk/Doc-3k/library/profile.rst
doctools/trunk/Doc-3k/library/re.rst
doctools/trunk/Doc-3k/library/signal.rst
doctools/trunk/Doc-3k/library/stdtypes.rst
doctools/trunk/Doc-3k/library/urllib.rst
doctools/trunk/Doc-3k/reference/lexical_analysis.rst
doctools/trunk/Doc-3k/tutorial/interpreter.rst
Log:
A few more short fixes.
Modified: doctools/trunk/Doc-26/c-api/refcounting.rst
==============================================================================
--- doctools/trunk/Doc-26/c-api/refcounting.rst (original)
+++ doctools/trunk/Doc-26/c-api/refcounting.rst Sat Aug 11 14:11:02 2007
@@ -64,7 +64,7 @@
.. versionadded:: 2.4
The following functions are for runtime dynamic embedding of Python:
-:cfunc:`Py_IncRef(PyObject \*o)`, :cfunc:`Py_DecRef(PyObject \*o)`. They are
+``Py_IncRef(PyObject \*o)``, `Py_DecRef(PyObject \*o)``. They are
simply exported function versions of :cfunc:`Py_XINCREF` and
:cfunc:`Py_XDECREF`, respectively.
Modified: doctools/trunk/Doc-26/library/cgi.rst
==============================================================================
--- doctools/trunk/Doc-26/library/cgi.rst (original)
+++ doctools/trunk/Doc-26/library/cgi.rst Sat Aug 11 14:11:02 2007
@@ -58,11 +58,11 @@
print "Hello, world!"
+.. _using-the-cgi-module:
+
Using the cgi module
--------------------
-.. _using the cgi module:
-
Begin by writing ``import cgi``. Do not use ``from cgi import *`` --- the
module defines all sorts of names for its own use or for backward compatibility
that you don't want in your namespace.
@@ -262,11 +262,11 @@
this module, drop me a note.
+.. _functions-in-cgi-module:
+
Functions
---------
-.. _functions in cgi module:
-
These are useful if you want more control, or if you want to employ some of the
algorithms implemented in this module in other circumstances.
Modified: doctools/trunk/Doc-26/library/fl.rst
==============================================================================
--- doctools/trunk/Doc-26/library/fl.rst (original)
+++ doctools/trunk/Doc-26/library/fl.rst Sat Aug 11 14:11:02 2007
@@ -42,11 +42,11 @@
:cfunc:`foreground` and to the FORMS routine :cfunc:`fl_init`.
+.. _fl-functions:
+
Functions Defined in Module :mod:`fl`
-------------------------------------
-.. _fl functions:
-
Module :mod:`fl` defines the following functions. For more information about
what they do, see the description of the equivalent C function in the FORMS
documentation:
Modified: doctools/trunk/Doc-26/library/pickle.rst
==============================================================================
--- doctools/trunk/Doc-26/library/pickle.rst (original)
+++ doctools/trunk/Doc-26/library/pickle.rst Sat Aug 11 14:11:02 2007
@@ -429,7 +429,7 @@
is for tuples and strings). Instances of a new-style type :class:`C` are
created using ::
- obj = C.__new__(C, \*args)
+ obj = C.__new__(C, *args)
where *args* is the result of calling :meth:`__getnewargs__` on the original
Modified: doctools/trunk/Doc-26/library/profile.rst
==============================================================================
--- doctools/trunk/Doc-26/library/profile.rst (original)
+++ doctools/trunk/Doc-26/library/profile.rst Sat Aug 11 14:11:02 2007
@@ -41,11 +41,11 @@
support. ...but I'd appreciate the feedback.
+.. _profiler-introduction:
+
Introduction to the profilers
=============================
-.. _profiler introduction:
-
.. index::
single: deterministic profiling
single: profiling, deterministic
@@ -243,11 +243,11 @@
(implemented using :mod:`cmd`) and interactive help.
+.. _deterministic-profiling:
+
What Is Deterministic Profiling?
================================
-.. _deterministic profiling:
-
:dfn:`Deterministic profiling` is meant to reflect the fact that all *function
call*, *function return*, and *exception* events are monitored, and precise
timings are made for the intervals between these events (during which time the
@@ -623,11 +623,11 @@
your results will "less often" show up as negative in profile statistics.
+.. _profiler-extensions:
+
Extensions --- Deriving Better Profilers
========================================
-.. _profiler extensions:
-
The :class:`Profile` class of both modules, :mod:`profile` and :mod:`cProfile`,
were written so that derived classes could be developed to extend the profiler.
The details are not described here, as doing this successfully requires an
Modified: doctools/trunk/Doc-26/library/re.rst
==============================================================================
--- doctools/trunk/Doc-26/library/re.rst (original)
+++ doctools/trunk/Doc-26/library/re.rst Sat Aug 11 14:11:02 2007
@@ -406,11 +406,11 @@
re.compile("^a", re.M).search("ba", 1) # fails; no preceding \n
+.. _contents-of-module-re:
+
Module Contents
---------------
-.. _contents of module re:
-
The module defines several functions, constants, and an exception. Some of the
functions are simplified versions of the full featured methods for compiled
regular expressions. Most non-trivial applications always use the compiled
Modified: doctools/trunk/Doc-26/library/signal.rst
==============================================================================
--- doctools/trunk/Doc-26/library/signal.rst (original)
+++ doctools/trunk/Doc-26/library/signal.rst Sat Aug 11 14:11:02 2007
@@ -128,11 +128,11 @@
descriptions in the :mod:`inspect` module).
+.. _signal-example:
+
Example
-------
-.. _signal example:
-
Here is a minimal example program. It uses the :func:`alarm` function to limit
the time spent waiting to open a file; this is useful if the file is for a
serial device that may not be turned on, which would normally cause the
Modified: doctools/trunk/Doc-26/library/stdtypes.rst
==============================================================================
--- doctools/trunk/Doc-26/library/stdtypes.rst (original)
+++ doctools/trunk/Doc-26/library/stdtypes.rst Sat Aug 11 14:11:02 2007
@@ -363,7 +363,7 @@
Bit-string Operations on Integer Types
--------------------------------------
-.. _bit-string operations:
+.. _bit-string-operations:
Plain and long integer types support additional operations that make sense only
for bit-strings. Negative numbers are treated as their 2's complement value
@@ -2214,8 +2214,6 @@
Classes and Class Instances
---------------------------
-.. _classes and instances:
-
See :ref:`objects` and :ref:`class` for these.
Modified: doctools/trunk/Doc-26/library/urllib.rst
==============================================================================
--- doctools/trunk/Doc-26/library/urllib.rst (original)
+++ doctools/trunk/Doc-26/library/urllib.rst Sat Aug 11 14:11:02 2007
@@ -433,11 +433,11 @@
environment.
+.. _urllib-examples:
+
Examples
--------
-.. _urllib examples:
-
Here is an example session that uses the ``GET`` method to retrieve a URL
containing parameters::
Modified: doctools/trunk/Doc-26/reference/lexical_analysis.rst
==============================================================================
--- doctools/trunk/Doc-26/reference/lexical_analysis.rst (original)
+++ doctools/trunk/Doc-26/reference/lexical_analysis.rst Sat Aug 11 14:11:02 2007
@@ -323,7 +323,7 @@
definitions:
.. productionlist::
- identifier: (`letter`|"_") (`letter` | `digit` | "_")\*
+ identifier: (`letter`|"_") (`letter` | `digit` | "_")*
letter: `lowercase` | `uppercase`
lowercase: "a"..."z"
uppercase: "A"..."Z"
Modified: doctools/trunk/Doc-26/tutorial/interpreter.rst
==============================================================================
--- doctools/trunk/Doc-26/tutorial/interpreter.rst (original)
+++ doctools/trunk/Doc-26/tutorial/interpreter.rst Sat Aug 11 14:11:02 2007
@@ -166,8 +166,6 @@
$ chmod +x myscript.py
-.. % $ <-- bow to font-lock
-
Source Code Encoding
--------------------
@@ -176,7 +174,7 @@
best way to do it is to put one more special comment line right after the ``#!``
line to define the source file encoding::
- # -\*- coding: encoding -\*-
+ # -*- coding: encoding -*-
With that declaration, all characters in the source file will be treated as
Modified: doctools/trunk/Doc-3k/c-api/refcounting.rst
==============================================================================
--- doctools/trunk/Doc-3k/c-api/refcounting.rst (original)
+++ doctools/trunk/Doc-3k/c-api/refcounting.rst Sat Aug 11 14:11:02 2007
@@ -64,7 +64,7 @@
.. versionadded:: 2.4
The following functions are for runtime dynamic embedding of Python:
-:cfunc:`Py_IncRef(PyObject \*o)`, :cfunc:`Py_DecRef(PyObject \*o)`. They are
+``Py_IncRef(PyObject \*o)``, `Py_DecRef(PyObject \*o)``. They are
simply exported function versions of :cfunc:`Py_XINCREF` and
:cfunc:`Py_XDECREF`, respectively.
Modified: doctools/trunk/Doc-3k/library/cgi.rst
==============================================================================
--- doctools/trunk/Doc-3k/library/cgi.rst (original)
+++ doctools/trunk/Doc-3k/library/cgi.rst Sat Aug 11 14:11:02 2007
@@ -58,11 +58,11 @@
print "Hello, world!"
+.. _using-the-cgi-module:
+
Using the cgi module
--------------------
-.. _using the cgi module:
-
Begin by writing ``import cgi``. Do not use ``from cgi import *`` --- the
module defines all sorts of names for its own use or for backward compatibility
that you don't want in your namespace.
@@ -262,11 +262,11 @@
this module, drop me a note.
+.. _functions-in-cgi-module:
+
Functions
---------
-.. _functions in cgi module:
-
These are useful if you want more control, or if you want to employ some of the
algorithms implemented in this module in other circumstances.
Modified: doctools/trunk/Doc-3k/library/pickle.rst
==============================================================================
--- doctools/trunk/Doc-3k/library/pickle.rst (original)
+++ doctools/trunk/Doc-3k/library/pickle.rst Sat Aug 11 14:11:02 2007
@@ -429,7 +429,7 @@
is for tuples and strings). Instances of a new-style type :class:`C` are
created using ::
- obj = C.__new__(C, \*args)
+ obj = C.__new__(C, *args)
where *args* is the result of calling :meth:`__getnewargs__` on the original
Modified: doctools/trunk/Doc-3k/library/profile.rst
==============================================================================
--- doctools/trunk/Doc-3k/library/profile.rst (original)
+++ doctools/trunk/Doc-3k/library/profile.rst Sat Aug 11 14:11:02 2007
@@ -41,11 +41,11 @@
support. ...but I'd appreciate the feedback.
+.. _profiler-introduction:
+
Introduction to the profilers
=============================
-.. _profiler introduction:
-
.. index::
single: deterministic profiling
single: profiling, deterministic
@@ -243,11 +243,11 @@
(implemented using :mod:`cmd`) and interactive help.
+.. _deterministic-profiling:
+
What Is Deterministic Profiling?
================================
-.. _deterministic profiling:
-
:dfn:`Deterministic profiling` is meant to reflect the fact that all *function
call*, *function return*, and *exception* events are monitored, and precise
timings are made for the intervals between these events (during which time the
@@ -623,11 +623,11 @@
your results will "less often" show up as negative in profile statistics.
+.. _profiler-extensions:
+
Extensions --- Deriving Better Profilers
========================================
-.. _profiler extensions:
-
The :class:`Profile` class of both modules, :mod:`profile` and :mod:`cProfile`,
were written so that derived classes could be developed to extend the profiler.
The details are not described here, as doing this successfully requires an
Modified: doctools/trunk/Doc-3k/library/re.rst
==============================================================================
--- doctools/trunk/Doc-3k/library/re.rst (original)
+++ doctools/trunk/Doc-3k/library/re.rst Sat Aug 11 14:11:02 2007
@@ -406,11 +406,11 @@
re.compile("^a", re.M).search("ba", 1) # fails; no preceding \n
+.. _contents-of-module-re:
+
Module Contents
---------------
-.. _contents of module re:
-
The module defines several functions, constants, and an exception. Some of the
functions are simplified versions of the full featured methods for compiled
regular expressions. Most non-trivial applications always use the compiled
Modified: doctools/trunk/Doc-3k/library/signal.rst
==============================================================================
--- doctools/trunk/Doc-3k/library/signal.rst (original)
+++ doctools/trunk/Doc-3k/library/signal.rst Sat Aug 11 14:11:02 2007
@@ -128,11 +128,11 @@
descriptions in the :mod:`inspect` module).
+.. _signal-example:
+
Example
-------
-.. _signal example:
-
Here is a minimal example program. It uses the :func:`alarm` function to limit
the time spent waiting to open a file; this is useful if the file is for a
serial device that may not be turned on, which would normally cause the
Modified: doctools/trunk/Doc-3k/library/stdtypes.rst
==============================================================================
--- doctools/trunk/Doc-3k/library/stdtypes.rst (original)
+++ doctools/trunk/Doc-3k/library/stdtypes.rst Sat Aug 11 14:11:02 2007
@@ -356,7 +356,7 @@
Bit-string Operations on Integer Types
--------------------------------------
-.. _bit-string operations:
+.. _bit-string-operations:
Plain and long integer types support additional operations that make sense only
for bit-strings. Negative numbers are treated as their 2's complement value
@@ -2185,8 +2185,6 @@
Classes and Class Instances
---------------------------
-.. _classes and instances:
-
See :ref:`objects` and :ref:`class` for these.
Modified: doctools/trunk/Doc-3k/library/urllib.rst
==============================================================================
--- doctools/trunk/Doc-3k/library/urllib.rst (original)
+++ doctools/trunk/Doc-3k/library/urllib.rst Sat Aug 11 14:11:02 2007
@@ -433,11 +433,11 @@
environment.
+.. _urllib-examples:
+
Examples
--------
-.. _urllib examples:
-
Here is an example session that uses the ``GET`` method to retrieve a URL
containing parameters::
Modified: doctools/trunk/Doc-3k/reference/lexical_analysis.rst
==============================================================================
--- doctools/trunk/Doc-3k/reference/lexical_analysis.rst (original)
+++ doctools/trunk/Doc-3k/reference/lexical_analysis.rst Sat Aug 11 14:11:02 2007
@@ -323,7 +323,7 @@
definitions:
.. productionlist::
- identifier: (`letter`|"_") (`letter` | `digit` | "_")\*
+ identifier: (`letter`|"_") (`letter` | `digit` | "_")*
letter: `lowercase` | `uppercase`
lowercase: "a"..."z"
uppercase: "A"..."Z"
Modified: doctools/trunk/Doc-3k/tutorial/interpreter.rst
==============================================================================
--- doctools/trunk/Doc-3k/tutorial/interpreter.rst (original)
+++ doctools/trunk/Doc-3k/tutorial/interpreter.rst Sat Aug 11 14:11:02 2007
@@ -166,8 +166,6 @@
$ chmod +x myscript.py
-.. % $ <-- bow to font-lock
-
Source Code Encoding
--------------------
@@ -176,7 +174,7 @@
best way to do it is to put one more special comment line right after the ``#!``
line to define the source file encoding::
- # -\*- coding: encoding -\*-
+ # -*- coding: encoding -*-
With that declaration, all characters in the source file will be treated as
More information about the Python-checkins
mailing list