[Python-checkins] r56768 - doctools/trunk/Doc-26/library/stdtypes.rst doctools/trunk/Doc-26/library/string.rst doctools/trunk/Doc-26/library/strings.rst
mark.summerfield
python-checkins at python.org
Mon Aug 6 11:21:32 CEST 2007
Author: mark.summerfield
Date: Mon Aug 6 11:21:32 2007
New Revision: 56768
Modified:
doctools/trunk/Doc-26/library/stdtypes.rst
doctools/trunk/Doc-26/library/string.rst
doctools/trunk/Doc-26/library/strings.rst
Log:
Added more cross-references for strings. And one more for open().
Modified: doctools/trunk/Doc-26/library/stdtypes.rst
==============================================================================
--- doctools/trunk/Doc-26/library/stdtypes.rst (original)
+++ doctools/trunk/Doc-26/library/stdtypes.rst Mon Aug 6 11:21:32 2007
@@ -657,9 +657,13 @@
.. index:: pair: string; methods
-These are the string methods which both 8-bit strings and Unicode objects
-support:
-
+Below are listed the string methods which both 8-bit strings and Unicode
+objects support. In addition, Python's strings support the
+sequence type methods described in the
+:ref:`typesseq` section (above). To output formatted strings use
+template strings or the ``%`` operator described in the
+:ref:`typesseq-strings` section (below). Also, see the :mod:`re` module for
+string functions based on regular expressions.
.. method:: str.capitalize()
@@ -1744,11 +1748,12 @@
module: os
module: socket
-File objects are implemented using C's ``stdio`` package and can be created with
-the built-in constructor :func:`file` described in section
-:ref:`built-in-funcs`. [#]_ File objects are also returned by some other
-built-in functions and methods, such as :func:`os.popen` and :func:`os.fdopen`
-and the :meth:`makefile` method of socket objects.
+File objects are implemented using C's ``stdio`` package and can be
+created with the built-in :func:`file` and (more usually) :func:`open`
+constructors described in the :ref:`built-in-funcs` section. [#]_ File
+objects are also returned by some other built-in functions and methods,
+such as :func:`os.popen` and :func:`os.fdopen` and the :meth:`makefile`
+method of socket objects.
When a file operation fails for an I/O-related reason, the exception
:exc:`IOError` is raised. This includes situations where the operation is not
Modified: doctools/trunk/Doc-26/library/string.rst
==============================================================================
--- doctools/trunk/Doc-26/library/string.rst (original)
+++ doctools/trunk/Doc-26/library/string.rst Mon Aug 6 11:21:32 2007
@@ -8,10 +8,15 @@
.. index:: module: re
-The :mod:`string` module contains a number of useful constants and classes, as
-well as some deprecated legacy functions that are also available as methods on
-strings. See the module :mod:`re` for string functions based on regular
-expressions.
+The :mod:`string` module contains a number of useful constants and
+classes, as well as some deprecated legacy functions that are also
+available as methods on strings. In addition, Python's built-in string
+classes support the sequence type methods described in the
+:ref:`typesseq` section, and also the string-specific methods described
+in the :ref:`string-methods` section. To output formatted strings use
+template strings or the ``%`` operator described in the
+:ref:`typesseq-strings` section. Also, see the :mod:`re` module for
+string functions based on regular expressions.
String constants
Modified: doctools/trunk/Doc-26/library/strings.rst
==============================================================================
--- doctools/trunk/Doc-26/library/strings.rst (original)
+++ doctools/trunk/Doc-26/library/strings.rst Mon Aug 6 11:21:32 2007
@@ -12,7 +12,8 @@
methods described in the :ref:`typesseq` section, and also the
string-specific methods described in the :ref:`string-methods` section.
To output formatted strings use template strings or the ``%`` operator
-described in the :ref:`typesseq-strings` section.
+described in the :ref:`typesseq-strings` section. Also, see the
+:mod:`re` module for string functions based on regular expressions.
.. toctree::
More information about the Python-checkins
mailing list