]> granicus.if.org Git - python/commitdiff
Add :term:s for "new-style class".
authorGeorg Brandl <georg@python.org>
Sun, 21 Oct 2007 12:15:05 +0000 (12:15 +0000)
committerGeorg Brandl <georg@python.org>
Sun, 21 Oct 2007 12:15:05 +0000 (12:15 +0000)
Doc/glossary.rst
Doc/library/ctypes.rst
Doc/library/functions.rst
Doc/library/logging.rst
Doc/library/pickle.rst
Doc/library/sqlite3.rst
Doc/library/xmlrpclib.rst
Doc/reference/compound_stmts.rst
Doc/reference/datamodel.rst
Doc/tutorial/classes.rst
Doc/using/cmdline.rst

index a81d2c97389508137ba689389be252eae2f79321..65a47f14b562502dd62bb95a02ef77ca7ce8982b 100644 (file)
@@ -255,6 +255,8 @@ Glossary
       powerful, elegant solutions.  They have been used for logging attribute
       access, adding thread-safety, tracking object creation, implementing
       singletons, and many other tasks.
+
+      More information can be found in :ref:`metaclasses`.
     
    mutable
       Mutable objects can change their value but keep their :func:`id`.  See
@@ -286,6 +288,8 @@ Glossary
       use Python's newer, versatile features like :attr:`__slots__`,
       descriptors, properties, :meth:`__getattribute__`, class methods, and
       static methods.
+
+      More information can be found in :ref:`newstyle`.
     
    Python 3000
       Nickname for the next major Python version, 3.0 (coined long ago when the
index 4b749d1c4f7e1ac984a9a5335bd100024ef06e6b..2df733c604e5adcd594aec9d38b9e1b7fa38171c 100644 (file)
@@ -1950,7 +1950,7 @@ Data types
    in case the memory block contains pointers.
 
 Common methods of ctypes data types, these are all class methods (to be exact,
-they are methods of the metaclass):
+they are methods of the :term:`metaclass`):
 
 
 .. method:: _CData.from_address(address)
index f98adce9a1455e3202af950782a1eee28bbd71c6..6c03472cbd211e3c19b7ee08b76f12c778be63f8 100644 (file)
@@ -350,7 +350,7 @@ available.  They are listed here in alphabetical order.
 
    The *expression* argument is parsed and evaluated as a Python expression
    (technically speaking, a condition list) using the *globals* and *locals*
-   dictionaries as global and local name space.  If the *globals* dictionary is
+   dictionaries as global and local namespace.  If the *globals* dictionary is
    present and lacks '__builtins__', the current globals are copied into *globals*
    before *expression* is parsed.  This means that *expression* normally has full
    access to the standard :mod:`__builtin__` module and restricted environments are
@@ -808,8 +808,8 @@ available.  They are listed here in alphabetical order.
 
 .. function:: property([fget[, fset[, fdel[, doc]]]])
 
-   Return a property attribute for new-style classes (classes that derive from
-   :class:`object`).
+   Return a property attribute for :term:`new-style class`\es (classes that
+   derive from :class:`object`).
 
    *fget* is a function for getting an attribute value, likewise *fset* is a
    function for setting, and *fdel* a function for del'ing, an attribute.  Typical
@@ -1112,8 +1112,8 @@ available.  They are listed here in alphabetical order.
    Return the superclass of *type*.  If the second argument is omitted the super
    object returned is unbound.  If the second argument is an object,
    ``isinstance(obj, type)`` must be true.  If the second argument is a type,
-   ``issubclass(type2, type)`` must be true. :func:`super` only works for new-style
-   classes.
+   ``issubclass(type2, type)`` must be true. :func:`super` only works for
+   :term:`new-style class`\es.
 
    A typical use for calling a cooperative superclass method is::
 
index 7e8703ab474020144565935a12b6b40510eb8ad2..1dbb343ff9350d7cf54a29ffb94fb11521f855bb 100644 (file)
@@ -22,7 +22,7 @@ logging system for applications.
 
 Logging is performed by calling methods on instances of the :class:`Logger`
 class (hereafter called :dfn:`loggers`). Each instance has a name, and they are
-conceptually arranged in a name space hierarchy using dots (periods) as
+conceptually arranged in a namespace hierarchy using dots (periods) as
 separators. For example, a logger named "scan" is the parent of loggers
 "scan.text", "scan.html" and "scan.pdf". Logger names can be anything you want,
 and indicate the area of an application in which a logged message originates.
index ab19ff89e9378bd9d372ad77db408cc52add468d..e4471f2274fea6d3f389daf590a4564956be5cdd 100644 (file)
@@ -122,7 +122,7 @@ There are currently 3 different protocols which can be used for pickling.
   earlier versions of Python.
 
 * Protocol version 2 was introduced in Python 2.3.  It provides much more
-  efficient pickling of new-style classes.
+  efficient pickling of :term:`new-style class`\es.
 
 Refer to :pep:`307` for more information.
 
@@ -430,8 +430,8 @@ New-style types can provide a :meth:`__getnewargs__` method that is used for
 protocol 2.  Implementing this method is needed if the type establishes some
 internal invariants when the instance is created, or if the memory allocation is
 affected by the values passed to the :meth:`__new__` method for the type (as it
-is for tuples and strings).  Instances of a new-style type :class:`C` are
-created using ::
+is for tuples and strings).  Instances of a :term:`new-style class` :class:`C`
+are created using ::
 
    obj = C.__new__(C, *args)
 
@@ -459,8 +459,8 @@ can do what they want. [#]_
 
 .. warning::
 
-   For new-style classes, if :meth:`__getstate__` returns a false value, the
-   :meth:`__setstate__` method will not be called.
+   For :term:`new-style class`\es, if :meth:`__getstate__` returns a false
+   value, the :meth:`__setstate__` method will not be called.
 
 
 Pickling and unpickling extension types
index 029b8ba46965891ebbb06e715a294845fad25161..b84de767d05798ec9f65bcad218bbddc1c461b36 100644 (file)
@@ -549,7 +549,7 @@ string representation and register the function with :meth:`register_adapter`.
 
 .. note::
 
-   The type/class to adapt must be a new-style class, i. e. it must have
+   The type/class to adapt must be a :term:`new-style class`, i. e. it must have
    :class:`object` as one of its bases.
 
 .. literalinclude:: ../includes/sqlite3/adapter_point_2.py
index b3efb5ce14c71f1580238a9fbf8834a80773f0e0..1faa891e8dc8c16d15fd09890f4ecb65f6df88a5 100644 (file)
@@ -113,8 +113,9 @@ between conformable Python objects and XML on the wire.
       The *use_datetime* flag was added.
 
    .. versionchanged:: 2.6
-      Instances of new-style classes can be passed in if they have an *__dict__*
-      attribute and don't have a base class that is marshalled in a special way.
+      Instances of :term:`new-style class`\es can be passed in if they have an
+      *__dict__* attribute and don't have a base class that is marshalled in a
+      special way.
 
 
 .. seealso::
index 87d9d68da55a2eed2b20aa00bdaad0ccb2db85df..cebdcf1e2f7cf6cf4efe592411327ce69c80ed7a 100644 (file)
@@ -534,8 +534,9 @@ must be given a value in the :meth:`__init__` method or in another method.  Both
 class and instance variables are accessible through the notation
 "``self.name``", and an instance variable hides a class variable with the same
 name when accessed in this way.  Class variables with immutable values can be
-used as defaults for instance variables. For new-style classes, descriptors can
-be used to create instance variables with different implementation details.
+used as defaults for instance variables. For :term:`new-style class`\es,
+descriptors can be used to create instance variables with different
+implementation details.
 
 .. rubric:: Footnotes
 
index beecc7c0b9fcbc78e0650664a7e84b5cda67edd5..078293c800f22f275be885c9e80ccbdf0c14d95b 100644 (file)
@@ -1082,6 +1082,7 @@ Internal types
 .. % Types
 .. % =========================================================================
 
+.. _newstyle:
 
 New-style and classic classes
 =============================
index d5bde442d7d982af37bea630ed1206bdab5feda6..e4e8451c5b1e9a4ff056adaacb49301482b9e959 100644 (file)
@@ -495,8 +495,8 @@ figure out the consequences of a name conflict with an attribute of
 :class:`Base2`.  The depth-first rule makes no differences between direct and
 inherited attributes of :class:`Base1`.)
 
-For new-style classes, the method resolution order changes dynamically to
-support cooperative calls to :func:`super`.  This approach is known in some
+For :term:`new-style class`\es, the method resolution order changes dynamically
+to support cooperative calls to :func:`super`.  This approach is known in some
 other multiple-inheritance languages as call-next-method and is more powerful
 than the super call found in single-inheritance languages.
 
index 952adb2d0d8adc4bdd9bba9c573af0fae64281bc..efe2af69869b041f9a6ac00df565c965d8b915ab 100644 (file)
@@ -373,7 +373,7 @@ Environment variables
    
    If this is the name of a readable file, the Python commands in that file are
    executed before the first prompt is displayed in interactive mode.  The file
-   is executed in the same name space where interactive commands are executed so
+   is executed in the same namespace where interactive commands are executed so
    that objects defined or imported in it can be used without qualification in
    the interactive session.  You can also change the prompts :data:`sys.ps1` and
    :data:`sys.ps2` in this file.