diff --git a/Doc-26/c-api/refcounting.rst b/Doc-26/c-api/refcounting.rst index d20de7400..9dc357f0e 100644 --- a/Doc-26/c-api/refcounting.rst +++ b/Doc-26/c-api/refcounting.rst @@ -64,7 +64,7 @@ objects. .. 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. diff --git a/Doc-26/library/cgi.rst b/Doc-26/library/cgi.rst index 5ef9bafcc..29ed5459e 100644 --- a/Doc-26/library/cgi.rst +++ b/Doc-26/library/cgi.rst @@ -58,11 +58,11 @@ prints a simple piece of HTML:: 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 @@ these and would be inconvenienced when they disappeared from a next version of 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. diff --git a/Doc-26/library/fl.rst b/Doc-26/library/fl.rst index 0849fbf48..741dd1857 100644 --- a/Doc-26/library/fl.rst +++ b/Doc-26/library/fl.rst @@ -42,11 +42,11 @@ event handling is available, though, so you can mix FORMS with pure GL windows. :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: diff --git a/Doc-26/library/pickle.rst b/Doc-26/library/pickle.rst index 795758729..f65d11c7c 100644 --- a/Doc-26/library/pickle.rst +++ b/Doc-26/library/pickle.rst @@ -429,7 +429,7 @@ affected by the values passed to the :meth:`__new__` method for the type (as it 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 diff --git a/Doc-26/library/profile.rst b/Doc-26/library/profile.rst index 9dd821726..e688bac6c 100644 --- a/Doc-26/library/profile.rst +++ b/Doc-26/library/profile.rst @@ -41,11 +41,11 @@ suggestions for improvements to: jar@netscape.com. I won't promise *any* 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 @@ reading and examining profile dumps. It has a simple line-oriented interface (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 @@ If you have a choice, you are better off choosing a smaller constant, and then 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 diff --git a/Doc-26/library/re.rst b/Doc-26/library/re.rst index 46ae1cdcb..90d57ccbb 100644 --- a/Doc-26/library/re.rst +++ b/Doc-26/library/re.rst @@ -406,11 +406,11 @@ argument regardless of whether a newline precedes it. 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 diff --git a/Doc-26/library/signal.rst b/Doc-26/library/signal.rst index 9f41d3c31..54cce533b 100644 --- a/Doc-26/library/signal.rst +++ b/Doc-26/library/signal.rst @@ -128,11 +128,11 @@ The :mod:`signal` module defines the following functions: 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 diff --git a/Doc-26/library/stdtypes.rst b/Doc-26/library/stdtypes.rst index 7e894bb77..cdc9302c2 100644 --- a/Doc-26/library/stdtypes.rst +++ b/Doc-26/library/stdtypes.rst @@ -363,7 +363,7 @@ Notes: 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 @@ Modules built into the interpreter are written like this: ``