]> granicus.if.org Git - python/commitdiff
#22613: minor other fixes in library docs (thanks Jacques Ducasse)
authorGeorg Brandl <georg@python.org>
Fri, 31 Oct 2014 09:25:48 +0000 (10:25 +0100)
committerGeorg Brandl <georg@python.org>
Fri, 31 Oct 2014 09:25:48 +0000 (10:25 +0100)
Doc/library/ctypes.rst
Doc/library/pydoc.rst
Doc/library/tempfile.rst

index 4109d56b0bd7998ce32ac4d4ce28aa11573ff0ce..adb95959ff03292da52e4927a2d23b898f696fdd 100644 (file)
@@ -1909,7 +1909,7 @@ Utility functions
 .. function:: find_msvcrt()
    :module: ctypes.util
 
-   Windows only: return the filename of the VC runtype library used by Python,
+   Windows only: return the filename of the VC runtime library used by Python,
    and by the extension modules.  If the name of the library cannot be
    determined, ``None`` is returned.
 
@@ -2446,11 +2446,6 @@ other data types containing pointer type fields.
       and so on).  Later assignments to the :attr:`_fields_` class variable will
       raise an AttributeError.
 
-      Structure and union subclass constructors accept both positional and named
-      arguments.  Positional arguments are used to initialize the fields in the
-      same order as they appear in the :attr:`_fields_` definition, named
-      arguments are used to initialize the fields with the corresponding name.
-
       It is possible to defined sub-subclasses of structure types, they inherit
       the fields of the base class plus the :attr:`_fields_` defined in the
       sub-subclass, if any.
index df37b71b850e60ea23d3288eb3b7f3ea909a555c..494a48d60712a878669c541aebe1226697b4cc50 100644 (file)
@@ -22,6 +22,13 @@ The :mod:`pydoc` module automatically generates documentation from Python
 modules.  The documentation can be presented as pages of text on the console,
 served to a Web browser, or saved to HTML files.
 
+For modules, classes, functions and methods, the displayed documentation is
+derived from the docstring (i.e. the :attr:`__doc__` attribute) of the object,
+and recursively of its documentable members.  If there is no docstring,
+:mod:`pydoc` tries to obtain a description from the block of comment lines just
+above the definition of the class, function or method in the source file, or at
+the top of the module (see :func:`inspect.getcomments`).
+
 The built-in function :func:`help` invokes the online help system in the
 interactive interpreter, which uses :mod:`pydoc` to generate its documentation
 as text on the console.  The same text documentation can also be viewed from
index 827f5f59baa02135049ebcd9a19a7e3d564e86f6..67eda2111fc4575c2b2048d9e01c9680ef1754f6 100644 (file)
@@ -185,7 +185,7 @@ The module defines the following user-callable functions:
          >>> os.path.exists(f.name)
          False
 
-The module uses two global variables that tell it how to construct a
+The module uses a global variable that tell it how to construct a
 temporary name.  They are initialized at the first call to any of the
 functions above.  The caller may change them, but this is discouraged; use
 the appropriate function arguments, instead.