[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]

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::