mirror of
				https://github.com/python/cpython.git
				synced 2025-11-04 03:44:55 +00:00 
			
		
		
		
	Merge doc fixes.
This commit is contained in:
		
						commit
						891391bf68
					
				
					 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
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -282,7 +282,8 @@ implement its socket handling::
 | 
				
			||||||
           asyncore.dispatcher.__init__(self)
 | 
					           asyncore.dispatcher.__init__(self)
 | 
				
			||||||
           self.create_socket(socket.AF_INET, socket.SOCK_STREAM)
 | 
					           self.create_socket(socket.AF_INET, socket.SOCK_STREAM)
 | 
				
			||||||
           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
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -2311,7 +2311,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