mirror of
https://github.com/python/cpython.git
synced 2025-08-18 07:41:05 +00:00
Avoid using the default reST role. Makes Doc/tools/rstlint.py happy.
This commit is contained in:
parent
a971df3cd5
commit
a7cbe28bcc
4 changed files with 13 additions and 13 deletions
|
@ -17,9 +17,9 @@ installed Python and Subversion, you can just run ::
|
||||||
cd Doc
|
cd Doc
|
||||||
make html
|
make html
|
||||||
|
|
||||||
to check out the necessary toolset in the `tools/` subdirectory and build the
|
to check out the necessary toolset in the :file:`tools/` subdirectory and build
|
||||||
HTML output files. To view the generated HTML, point your favorite browser at
|
the HTML output files. To view the generated HTML, point your favorite browser
|
||||||
the top-level index `build/html/index.html` after running "make".
|
at the top-level index :file:`build/html/index.html` after running "make".
|
||||||
|
|
||||||
Available make targets are:
|
Available make targets are:
|
||||||
|
|
||||||
|
@ -50,10 +50,10 @@ Available make targets are:
|
||||||
|
|
||||||
* "pydoc-topics", which builds a Python module containing a dictionary with
|
* "pydoc-topics", which builds a Python module containing a dictionary with
|
||||||
plain text documentation for the labels defined in
|
plain text documentation for the labels defined in
|
||||||
`tools/sphinxext/pyspecific.py` -- pydoc needs these to show topic and
|
:file:`tools/sphinxext/pyspecific.py` -- pydoc needs these to show topic and
|
||||||
keyword help.
|
keyword help.
|
||||||
|
|
||||||
A "make update" updates the Subversion checkouts in `tools/`.
|
A "make update" updates the Subversion checkouts in :file:`tools/`.
|
||||||
|
|
||||||
|
|
||||||
Without make
|
Without make
|
||||||
|
|
|
@ -22,8 +22,8 @@ structs and the intended conversion to/from Python values.
|
||||||
alignment is taken into account when unpacking. This behavior is chosen so
|
alignment is taken into account when unpacking. This behavior is chosen so
|
||||||
that the bytes of a packed struct correspond exactly to the layout in memory
|
that the bytes of a packed struct correspond exactly to the layout in memory
|
||||||
of the corresponding C struct. To handle platform-independent data formats
|
of the corresponding C struct. To handle platform-independent data formats
|
||||||
or omit implicit pad bytes, use `standard` size and alignment instead of
|
or omit implicit pad bytes, use ``standard`` size and alignment instead of
|
||||||
`native` size and alignment: see :ref:`struct-alignment` for details.
|
``native`` size and alignment: see :ref:`struct-alignment` for details.
|
||||||
|
|
||||||
Functions and Exceptions
|
Functions and Exceptions
|
||||||
------------------------
|
------------------------
|
||||||
|
|
|
@ -307,7 +307,7 @@ as the start directory.
|
||||||
|
|
||||||
Test discovery loads tests by importing them. Once test discovery has
|
Test discovery loads tests by importing them. Once test discovery has
|
||||||
found all the test files from the start directory you specify it turns the
|
found all the test files from the start directory you specify it turns the
|
||||||
paths into package names to import. For example `foo/bar/baz.py` will be
|
paths into package names to import. For example :file:`foo/bar/baz.py` will be
|
||||||
imported as ``foo.bar.baz``.
|
imported as ``foo.bar.baz``.
|
||||||
|
|
||||||
If you have a package installed globally and attempt test discovery on
|
If you have a package installed globally and attempt test discovery on
|
||||||
|
@ -905,11 +905,11 @@ Test cases
|
||||||
+---------------------------------------------------------+--------------------------------------+------------+
|
+---------------------------------------------------------+--------------------------------------+------------+
|
||||||
| Method | Checks that | New in |
|
| Method | Checks that | New in |
|
||||||
+=========================================================+======================================+============+
|
+=========================================================+======================================+============+
|
||||||
| :meth:`assertRaises(exc, fun, *args, **kwds) | ``fun(*args, **kwds)`` raises `exc` | |
|
| :meth:`assertRaises(exc, fun, *args, **kwds) | ``fun(*args, **kwds)`` raises *exc* | |
|
||||||
| <TestCase.assertRaises>` | | |
|
| <TestCase.assertRaises>` | | |
|
||||||
+---------------------------------------------------------+--------------------------------------+------------+
|
+---------------------------------------------------------+--------------------------------------+------------+
|
||||||
| :meth:`assertRaisesRegexp(exc, re, fun, *args, **kwds) | ``fun(*args, **kwds)`` raises `exc` | 2.7 |
|
| :meth:`assertRaisesRegexp(exc, re, fun, *args, **kwds) | ``fun(*args, **kwds)`` raises *exc* | 2.7 |
|
||||||
| <TestCase.assertRaisesRegexp>` | and the message matches `re` | |
|
| <TestCase.assertRaisesRegexp>` | and the message matches *re* | |
|
||||||
+---------------------------------------------------------+--------------------------------------+------------+
|
+---------------------------------------------------------+--------------------------------------+------------+
|
||||||
|
|
||||||
.. method:: assertRaises(exception, callable, *args, **kwds)
|
.. method:: assertRaises(exception, callable, *args, **kwds)
|
||||||
|
@ -995,7 +995,7 @@ Test cases
|
||||||
| <TestCase.assertItemsEqual>` | works with unhashable objs | |
|
| <TestCase.assertItemsEqual>` | works with unhashable objs | |
|
||||||
+---------------------------------------+--------------------------------+--------------+
|
+---------------------------------------+--------------------------------+--------------+
|
||||||
| :meth:`assertDictContainsSubset(a, b) | all the key/value pairs | 2.7 |
|
| :meth:`assertDictContainsSubset(a, b) | all the key/value pairs | 2.7 |
|
||||||
| <TestCase.assertDictContainsSubset>` | in `a` exist in `b` | |
|
| <TestCase.assertDictContainsSubset>` | in *a* exist in *b* | |
|
||||||
+---------------------------------------+--------------------------------+--------------+
|
+---------------------------------------+--------------------------------+--------------+
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -36,7 +36,7 @@ The :mod:`urllib2` module defines the following functions:
|
||||||
:mimetype:`application/x-www-form-urlencoded` format. The
|
:mimetype:`application/x-www-form-urlencoded` format. The
|
||||||
:func:`urllib.urlencode` function takes a mapping or sequence of 2-tuples and
|
:func:`urllib.urlencode` function takes a mapping or sequence of 2-tuples and
|
||||||
returns a string in this format. urllib2 module sends HTTP/1.1 requests with
|
returns a string in this format. urllib2 module sends HTTP/1.1 requests with
|
||||||
`Connection:close` header included.
|
``Connection:close`` header included.
|
||||||
|
|
||||||
The optional *timeout* parameter specifies a timeout in seconds for blocking
|
The optional *timeout* parameter specifies a timeout in seconds for blocking
|
||||||
operations like the connection attempt (if not specified, the global default
|
operations like the connection attempt (if not specified, the global default
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue