mirror of
https://github.com/python/cpython.git
synced 2025-10-30 01:47:38 +00:00
Merge doc fixes.
This commit is contained in:
commit
1ebca48030
8 changed files with 23 additions and 24 deletions
|
|
@ -76,7 +76,7 @@ devoted to discussing various metacharacters and what they do.
|
||||||
Here's a complete list of the metacharacters; their meanings will be discussed
|
Here's a complete list of the metacharacters; their meanings will be discussed
|
||||||
in the rest of this HOWTO. ::
|
in the rest of this HOWTO. ::
|
||||||
|
|
||||||
. ^ $ * + ? { [ ] \ | ( )
|
. ^ $ * + ? { } [ ] \ | ( )
|
||||||
|
|
||||||
The first metacharacters we'll look at are ``[`` and ``]``. They're used for
|
The first metacharacters we'll look at are ``[`` and ``]``. They're used for
|
||||||
specifying a character class, which is a set of characters that you wish to
|
specifying a character class, which is a set of characters that you wish to
|
||||||
|
|
|
||||||
|
|
@ -284,7 +284,8 @@ implement its socket handling::
|
||||||
asyncore.dispatcher.__init__(self)
|
asyncore.dispatcher.__init__(self)
|
||||||
self.create_socket()
|
self.create_socket()
|
||||||
self.connect( (host, 80) )
|
self.connect( (host, 80) )
|
||||||
self.buffer = bytes('GET %s HTTP/1.0\r\n\r\n' % path, 'ascii')
|
self.buffer = bytes('GET %s HTTP/1.0\r\nHost: %s\r\n\r\n' %
|
||||||
|
(path, host), 'ascii')
|
||||||
|
|
||||||
def handle_connect(self):
|
def handle_connect(self):
|
||||||
pass
|
pass
|
||||||
|
|
|
||||||
|
|
@ -1173,6 +1173,9 @@ Several constants are available to specify character cell attributes:
|
||||||
+------------------+-------------------------------+
|
+------------------+-------------------------------+
|
||||||
| ``A_NORMAL`` | Normal attribute. |
|
| ``A_NORMAL`` | Normal attribute. |
|
||||||
+------------------+-------------------------------+
|
+------------------+-------------------------------+
|
||||||
|
| ``A_REVERSE`` | Reverse background and |
|
||||||
|
| | foreground colors. |
|
||||||
|
+------------------+-------------------------------+
|
||||||
| ``A_STANDOUT`` | Standout mode. |
|
| ``A_STANDOUT`` | Standout mode. |
|
||||||
+------------------+-------------------------------+
|
+------------------+-------------------------------+
|
||||||
| ``A_UNDERLINE`` | Underline mode. |
|
| ``A_UNDERLINE`` | Underline mode. |
|
||||||
|
|
|
||||||
|
|
@ -161,7 +161,7 @@ The :mod:`locale` module defines the following exception and functions:
|
||||||
.. data:: D_T_FMT
|
.. data:: D_T_FMT
|
||||||
|
|
||||||
Get a string that can be used as a format string for :func:`strftime` to
|
Get a string that can be used as a format string for :func:`strftime` to
|
||||||
represent time and date in a locale-specific way.
|
represent date and time in a locale-specific way.
|
||||||
|
|
||||||
.. data:: D_FMT
|
.. data:: D_FMT
|
||||||
|
|
||||||
|
|
@ -246,12 +246,17 @@ The :mod:`locale` module defines the following exception and functions:
|
||||||
|
|
||||||
.. data:: ERA_D_T_FMT
|
.. data:: ERA_D_T_FMT
|
||||||
|
|
||||||
Get a format string for :func:`strftime` to represent dates and times in a
|
Get a format string for :func:`strftime` to represent date and time in a
|
||||||
locale-specific era-based way.
|
locale-specific era-based way.
|
||||||
|
|
||||||
.. data:: ERA_D_FMT
|
.. data:: ERA_D_FMT
|
||||||
|
|
||||||
Get a format string for :func:`strftime` to represent time in a
|
Get a format string for :func:`strftime` to represent a date in a
|
||||||
|
locale-specific era-based way.
|
||||||
|
|
||||||
|
.. data:: ERA_T_FMT
|
||||||
|
|
||||||
|
Get a format string for :func:`strftime` to represent a time in a
|
||||||
locale-specific era-based way.
|
locale-specific era-based way.
|
||||||
|
|
||||||
.. data:: ALT_DIGITS
|
.. data:: ALT_DIGITS
|
||||||
|
|
|
||||||
|
|
@ -2322,7 +2322,7 @@ copying. Memory is generally interpreted as simple bytes.
|
||||||
.. class:: memoryview(obj)
|
.. class:: memoryview(obj)
|
||||||
|
|
||||||
Create a :class:`memoryview` that references *obj*. *obj* must support the
|
Create a :class:`memoryview` that references *obj*. *obj* must support the
|
||||||
buffer protocol. Builtin objects that support the buffer protocol include
|
buffer protocol. Built-in objects that support the buffer protocol include
|
||||||
:class:`bytes` and :class:`bytearray`.
|
:class:`bytes` and :class:`bytearray`.
|
||||||
|
|
||||||
A :class:`memoryview` has the notion of an *element*, which is the
|
A :class:`memoryview` has the notion of an *element*, which is the
|
||||||
|
|
|
||||||
|
|
@ -2306,9 +2306,11 @@ The demo scripts are:
|
||||||
| bytedesign | complex classical | :func:`tracer`, delay,|
|
| bytedesign | complex classical | :func:`tracer`, delay,|
|
||||||
| | turtle graphics pattern | :func:`update` |
|
| | turtle graphics pattern | :func:`update` |
|
||||||
+----------------+------------------------------+-----------------------+
|
+----------------+------------------------------+-----------------------+
|
||||||
| chaos | graphs verhust dynamics, | world coordinates |
|
| chaos | graphs Verhulst dynamics, | world coordinates |
|
||||||
| | proves that you must not | |
|
| | shows that computer's | |
|
||||||
| | trust computers' computations| |
|
| | computations can generate | |
|
||||||
|
| | results sometimes against the| |
|
||||||
|
| | common sense expectations | |
|
||||||
+----------------+------------------------------+-----------------------+
|
+----------------+------------------------------+-----------------------+
|
||||||
| clock | analog clock showing time | turtles as clock's |
|
| clock | analog clock showing time | turtles as clock's |
|
||||||
| | of your computer | hands, ontimer |
|
| | of your computer | hands, ontimer |
|
||||||
|
|
|
||||||
|
|
@ -119,9 +119,6 @@ square brackets, is recursively defined as follows.
|
||||||
* If the target list is a comma-separated list of targets: The object must be an
|
* If the target list is a comma-separated list of targets: The object must be an
|
||||||
iterable with the same number of items as there are targets in the target list,
|
iterable with the same number of items as there are targets in the target list,
|
||||||
and the items are assigned, from left to right, to the corresponding targets.
|
and the items are assigned, from left to right, to the corresponding targets.
|
||||||
(This rule is relaxed as of Python 1.5; in earlier versions, the object had to
|
|
||||||
be a tuple. Since strings are sequences, an assignment like ``a, b = "xy"`` is
|
|
||||||
now legal as long as the string has the right length.)
|
|
||||||
|
|
||||||
* If the target list contains one target prefixed with an asterisk, called a
|
* If the target list contains one target prefixed with an asterisk, called a
|
||||||
"starred" target: The object must be a sequence with at least as many items
|
"starred" target: The object must be a sequence with at least as many items
|
||||||
|
|
@ -991,10 +988,3 @@ pre-existing bindings in the local scope.
|
||||||
|
|
||||||
:pep:`3104` - Access to Names in Outer Scopes
|
:pep:`3104` - Access to Names in Outer Scopes
|
||||||
The specification for the :keyword:`nonlocal` statement.
|
The specification for the :keyword:`nonlocal` statement.
|
||||||
|
|
||||||
|
|
||||||
.. rubric:: Footnotes
|
|
||||||
|
|
||||||
.. [#] It may occur within an :keyword:`except` or :keyword:`else` clause. The
|
|
||||||
restriction on occurring in the :keyword:`try` clause is implementor's
|
|
||||||
laziness and will eventually be lifted.
|
|
||||||
|
|
|
||||||
|
|
@ -19,18 +19,16 @@ the :func:`print` function. (A third way is using the :meth:`write` method
|
||||||
of file objects; the standard output file can be referenced as ``sys.stdout``.
|
of file objects; the standard output file can be referenced as ``sys.stdout``.
|
||||||
See the Library Reference for more information on this.)
|
See the Library Reference for more information on this.)
|
||||||
|
|
||||||
.. index:: module: string
|
|
||||||
|
|
||||||
Often you'll want more control over the formatting of your output than simply
|
Often you'll want more control over the formatting of your output than simply
|
||||||
printing space-separated values. There are two ways to format your output; the
|
printing space-separated values. There are two ways to format your output; the
|
||||||
first way is to do all the string handling yourself; using string slicing and
|
first way is to do all the string handling yourself; using string slicing and
|
||||||
concatenation operations you can create any layout you can imagine. The
|
concatenation operations you can create any layout you can imagine. The
|
||||||
standard module :mod:`string` contains some useful operations for padding
|
string type has some methods that perform useful operations for padding
|
||||||
strings to a given column width; these will be discussed shortly. The second
|
strings to a given column width; these will be discussed shortly. The second
|
||||||
way is to use the :meth:`str.format` method.
|
way is to use the :meth:`str.format` method.
|
||||||
|
|
||||||
The :mod:`string` module contains a class Template which offers yet another way
|
The :mod:`string` module contains a :class:`~string.Template` class which offers
|
||||||
to substitute values into strings.
|
yet another way to substitute values into strings.
|
||||||
|
|
||||||
One question remains, of course: how do you convert values to strings? Luckily,
|
One question remains, of course: how do you convert values to strings? Luckily,
|
||||||
Python has ways to convert any value to a string: pass it to the :func:`repr`
|
Python has ways to convert any value to a string: pass it to the :func:`repr`
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue