From ef871f6160db0bd5475cc4721c90788d85cb4f95 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Fri, 12 Mar 2010 10:06:40 +0000 Subject: Merged revisions 78859-78860 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ........ r78859 | georg.brandl | 2010-03-12 10:57:43 +0100 (Fr, 12 Mär 2010) | 1 line Get rid of backticks. ........ r78860 | georg.brandl | 2010-03-12 11:02:03 +0100 (Fr, 12 Mär 2010) | 1 line Fix warnings from "make check". ........ --- Doc/c-api/exceptions.rst | 2 +- Doc/c-api/unicode.rst | 2 +- Doc/distutils/examples.rst | 16 ++++++++-------- Doc/distutils/uploading.rst | 8 ++++---- Doc/library/http.client.rst | 2 +- Doc/library/logging.rst | 8 ++++---- Doc/library/site.rst | 4 ++-- Doc/library/sys.rst | 2 +- Doc/whatsnew/2.2.rst | 2 +- Doc/whatsnew/2.7.rst | 2 +- 10 files changed, 24 insertions(+), 24 deletions(-) diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst index dc9d7b1..5fa35a0 100644 --- a/Doc/c-api/exceptions.rst +++ b/Doc/c-api/exceptions.rst @@ -214,7 +214,7 @@ in various ways. There is a separate error indicator for each thread. .. note:: The `"%lld"` and `"%llu"` format specifiers are only available - when `HAVE_LONG_LONG` is defined. + when :const:`HAVE_LONG_LONG` is defined. .. versionchanged:: 3.2 Support for `"%lld"` and `"%llu"` added. diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst index 0455ae5..53c817a 100644 --- a/Doc/c-api/unicode.rst +++ b/Doc/c-api/unicode.rst @@ -313,7 +313,7 @@ APIs: .. note:: The `"%lld"` and `"%llu"` format specifiers are only available - when `HAVE_LONG_LONG` is defined. + when :const:`HAVE_LONG_LONG` is defined. .. versionchanged:: 3.2 Support for `"%lld"` and `"%llu"` added. diff --git a/Doc/distutils/examples.rst b/Doc/distutils/examples.rst index 60656e7..a5a0239 100644 --- a/Doc/distutils/examples.rst +++ b/Doc/distutils/examples.rst @@ -257,9 +257,9 @@ Running the ``check`` command will display some warnings:: (maintainer and maintainer_email) must be supplied -If you use the reStructuredText syntax in the `long_description` field and +If you use the reStructuredText syntax in the ``long_description`` field and `docutils `_ is installed you can check if -the syntax is fine with the ``check`` command, using the `restructuredtext` +the syntax is fine with the ``check`` command, using the ``restructuredtext`` option. For example, if the :file:`setup.py` script is changed like this:: @@ -278,7 +278,7 @@ For example, if the :file:`setup.py` script is changed like this:: url='http://example.com', long_description=desc) Where the long description is broken, ``check`` will be able to detect it -by using the `docutils` parser:: +by using the :mod:`docutils` parser:: $ pythontrunk setup.py check --restructuredtext running check @@ -293,20 +293,20 @@ Reading the metadata The :func:`distutils.core.setup` function provides a command-line interface that allows you to query the metadata fields of a project through the -`setup.py` script of a given project:: +:file:`setup.py` script of a given project:: $ python setup.py --name distribute -This call reads the `name` metadata by running the +This call reads the ``name`` metadata by running the :func:`distutils.core.setup` function. Although, when a source or binary distribution is created with Distutils, the metadata fields are written in a static file called :file:`PKG-INFO`. When a Distutils-based project is installed in Python, the :file:`PKG-INFO` file is copied alongside the modules and packages of the distribution under :file:`NAME-VERSION-pyX.X.egg-info`, -where `NAME` is the name of the project, `VERSION` its version as defined -in the Metadata, and `pyX.X` the major and minor version of Python like -`2.7` or `3.2`. +where ``NAME`` is the name of the project, ``VERSION`` its version as defined +in the Metadata, and ``pyX.X`` the major and minor version of Python like +``2.7`` or ``3.2``. You can read back this static file, by using the :class:`distutils.dist.DistributionMetadata` class and its diff --git a/Doc/distutils/uploading.rst b/Doc/distutils/uploading.rst index e947245..7b790b1 100644 --- a/Doc/distutils/uploading.rst +++ b/Doc/distutils/uploading.rst @@ -60,13 +60,13 @@ in the package:: setup(name='Distutils', long_description=open('README.txt')) -In that case, `README.txt` is a regular reStructuredText text file located -in the root of the package besides `setup.py`. +In that case, :file:`README.txt` is a regular reStructuredText text file located +in the root of the package besides :file:`setup.py`. To prevent registering broken reStructuredText content, you can use the -:program:`rst2html` program that is provided by the `docutils` package +:program:`rst2html` program that is provided by the :mod:`docutils` package and check the ``long_description`` from the command line:: $ python setup.py --long-description | rst2html.py > output.html -`docutils` will display a warning if there's something wrong with your syntax. +:mod:`docutils` will display a warning if there's something wrong with your syntax. diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst index 9f906df..bc50423 100644 --- a/Doc/library/http.client.rst +++ b/Doc/library/http.client.rst @@ -498,7 +498,7 @@ statement. .. attribute:: HTTPResponse.debuglevel - A debugging hook. If `debuglevel` is greater than zero, messages + A debugging hook. If :attr:`debuglevel` is greater than zero, messages will be printed to stdout as the response is read and parsed. diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index a576838..6e809cd 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -1210,12 +1210,12 @@ swallowed. Other exceptions which occur during the :meth:`emit` method of a :class:`Handler` subclass are passed to its :meth:`handleError` method. The default implementation of :meth:`handleError` in :class:`Handler` checks -to see if a module-level variable, `raiseExceptions`, is set. If set, a -traceback is printed to `sys.stderr`. If not set, the exception is swallowed. +to see if a module-level variable, :data:`raiseExceptions`, is set. If set, a +traceback is printed to :data:`sys.stderr`. If not set, the exception is swallowed. -**Note:** The default value of `raiseExceptions` is `True`. This is because +**Note:** The default value of :data:`raiseExceptions` is ``True``. This is because during development, you typically want to be notified of any exceptions that -occur. It's advised that you set `raiseExceptions` to `False` for production +occur. It's advised that you set :data:`raiseExceptions` to ``False`` for production usage. .. _context-info: diff --git a/Doc/library/site.rst b/Doc/library/site.rst index eb4079d..b347ee8 100644 --- a/Doc/library/site.rst +++ b/Doc/library/site.rst @@ -124,9 +124,9 @@ empty, and the path manipulations are skipped; however the import of .. function:: getuserbase() - Returns the `user base` directory path. + Returns the "user base" directory path. - The `user base` directory can be used to store data. If the global + The "user base" directory can be used to store data. If the global variable ``USER_BASE`` is not initialized yet, this function will also set it. diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index f3f0846..5342220 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -339,7 +339,7 @@ always available. specific. If given, *default* will be returned if the object does not provide means to - retrieve the size. Otherwise a `TypeError` will be raised. + retrieve the size. Otherwise a :exc:`TypeError` will be raised. :func:`getsizeof` calls the object's ``__sizeof__`` method and adds an additional garbage collector overhead if the object is managed by the garbage diff --git a/Doc/whatsnew/2.2.rst b/Doc/whatsnew/2.2.rst index 31e8dd0..89e4d76 100644 --- a/Doc/whatsnew/2.2.rst +++ b/Doc/whatsnew/2.2.rst @@ -30,7 +30,7 @@ understand the complete implementation and design rationale for a change, refer to the PEP for a particular new feature. -.. seealso (now defunct) +.. see also, now defunct http://www.unixreview.com/documents/s=1356/urm0109h/0109h.htm "What's So Special About Python 2.2?" is also about the new 2.2 features, and diff --git a/Doc/whatsnew/2.7.rst b/Doc/whatsnew/2.7.rst index 4a2d9bc..a76c6e7 100644 --- a/Doc/whatsnew/2.7.rst +++ b/Doc/whatsnew/2.7.rst @@ -539,7 +539,7 @@ changes, or look through the Subversion logs for all the details. Contributed by Raymond Hettinger; :issue:`1696199`. - The new `OrderedDict` class is described in the earlier section + The new `~collections.OrderedDict` class is described in the earlier section :ref:`pep-0372`. The :class:`namedtuple` class now has an optional *rename* parameter. -- cgit v0.12