diff options
author | Georg Brandl <georg@python.org> | 2009-07-26 14:54:51 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2009-07-26 14:54:51 (GMT) |
commit | 22b3431426349a424e3486c279db8b84cf671da0 (patch) | |
tree | db3aa6b6addb5e07c53de6ff2a5e8250d472bb58 /Doc/library | |
parent | 7a72b3ad7b02612254c7e256b8a67ce7ccf7994a (diff) | |
download | cpython-22b3431426349a424e3486c279db8b84cf671da0.zip cpython-22b3431426349a424e3486c279db8b84cf671da0.tar.gz cpython-22b3431426349a424e3486c279db8b84cf671da0.tar.bz2 |
Merged revisions 74209 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
r74209 | georg.brandl | 2009-07-26 16:37:28 +0200 (So, 26 Jul 2009) | 1 line
builtin -> built-in.
........
Diffstat (limited to 'Doc/library')
-rw-r--r-- | Doc/library/2to3.rst | 2 | ||||
-rw-r--r-- | Doc/library/__future__.rst | 2 | ||||
-rw-r--r-- | Doc/library/ast.rst | 2 | ||||
-rw-r--r-- | Doc/library/collections.rst | 2 | ||||
-rw-r--r-- | Doc/library/configparser.rst | 2 | ||||
-rw-r--r-- | Doc/library/curses.rst | 6 | ||||
-rw-r--r-- | Doc/library/gettext.rst | 6 | ||||
-rw-r--r-- | Doc/library/heapq.rst | 2 | ||||
-rw-r--r-- | Doc/library/io.rst | 2 | ||||
-rw-r--r-- | Doc/library/multiprocessing.rst | 8 | ||||
-rw-r--r-- | Doc/library/numbers.rst | 2 | ||||
-rw-r--r-- | Doc/library/pprint.rst | 2 | ||||
-rw-r--r-- | Doc/library/sqlite3.rst | 2 | ||||
-rw-r--r-- | Doc/library/stdtypes.rst | 2 | ||||
-rw-r--r-- | Doc/library/string.rst | 2 | ||||
-rw-r--r-- | Doc/library/sys.rst | 2 | ||||
-rw-r--r-- | Doc/library/undoc.rst | 1 | ||||
-rw-r--r-- | Doc/library/weakref.rst | 2 | ||||
-rw-r--r-- | Doc/library/winreg.rst | 2 | ||||
-rw-r--r-- | Doc/library/xmlrpc.client.rst | 2 | ||||
-rw-r--r-- | Doc/library/zipimport.rst | 2 |
21 files changed, 27 insertions, 28 deletions
diff --git a/Doc/library/2to3.rst b/Doc/library/2to3.rst index 9b2b4e4..43ee2a4 100644 --- a/Doc/library/2to3.rst +++ b/Doc/library/2to3.rst @@ -216,7 +216,7 @@ and off individually. They are described here in more detail. .. 2to3fixer:: itertools Changes usage of :func:`itertools.ifilter`, :func:`itertools.izip`, and - :func:`itertools.imap` to their builtin equivalents. + :func:`itertools.imap` to their built-in equivalents. :func:`itertools.ifilterfalse` is changed to :func:`itertools.filterfalse`. .. 2to3fixer:: long diff --git a/Doc/library/__future__.rst b/Doc/library/__future__.rst index b09246e..29f3109 100644 --- a/Doc/library/__future__.rst +++ b/Doc/library/__future__.rst @@ -52,7 +52,7 @@ Instances of class :class:`_Feature` have two corresponding methods, :meth:`getOptionalRelease` and :meth:`getMandatoryRelease`. *CompilerFlag* is the (bitfield) flag that should be passed in the fourth -argument to the builtin function :func:`compile` to enable the feature in +argument to the built-in function :func:`compile` to enable the feature in dynamically compiled code. This flag is stored in the :attr:`compiler_flag` attribute on :class:`_Feature` instances. diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst index 2cf9da1..9bf374f 100644 --- a/Doc/library/ast.rst +++ b/Doc/library/ast.rst @@ -16,7 +16,7 @@ Python release; this module helps to find out programmatically what the current grammar looks like. An abstract syntax tree can be generated by passing :data:`ast.PyCF_ONLY_AST` as -a flag to the :func:`compile` builtin function, or using the :func:`parse` +a flag to the :func:`compile` built-in function, or using the :func:`parse` helper provided in this module. The result will be a tree of objects whose classes all inherit from :class:`ast.AST`. An abstract syntax tree can be compiled into a Python code object using the built-in :func:`compile` function. diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst index 779f154..1d82364 100644 --- a/Doc/library/collections.rst +++ b/Doc/library/collections.rst @@ -487,7 +487,7 @@ stack manipulations such as ``dup``, ``drop``, ``swap``, ``over``, ``pick``, .. class:: defaultdict([default_factory[, ...]]) Returns a new dictionary-like object. :class:`defaultdict` is a subclass of the - builtin :class:`dict` class. It overrides one method and adds one writable + built-in :class:`dict` class. It overrides one method and adds one writable instance variable. The remaining functionality is the same as for the :class:`dict` class and is not documented here. diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst index 6f840b9..a54bc19 100644 --- a/Doc/library/configparser.rst +++ b/Doc/library/configparser.rst @@ -50,7 +50,7 @@ Default values can be specified by passing them into the :class:`ConfigParser` constructor as a dictionary. Additional defaults may be passed into the :meth:`get` method which will override all others. -Sections are normally stored in a builtin dictionary. An alternative dictionary +Sections are normally stored in a built-in dictionary. An alternative dictionary type can be passed to the :class:`ConfigParser` constructor. For example, if a dictionary type is passed that sorts its keys, the sections will be sorted on write-back, as will be the keys within each section. diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst index bb750ba..f1da52a 100644 --- a/Doc/library/curses.rst +++ b/Doc/library/curses.rst @@ -606,9 +606,9 @@ the following methods: .. note:: A *character* means a C character (an ASCII code), rather then a Python - character (a string of length 1). (This note is true whenever the documentation - mentions a character.) The builtin :func:`ord` is handy for conveying strings to - codes. + character (a string of length 1). (This note is true whenever the + documentation mentions a character.) The built-in :func:`ord` is handy for + conveying strings to codes. Paint character *ch* at ``(y, x)`` with attributes *attr*, overwriting any character previously painter at that location. By default, the character diff --git a/Doc/library/gettext.rst b/Doc/library/gettext.rst index 015b889..a29d953 100644 --- a/Doc/library/gettext.rst +++ b/Doc/library/gettext.rst @@ -189,7 +189,7 @@ class can also install themselves in the built-in namespace as the function .. function:: install(domain, localedir=None, codeset=None, names=None) - This installs the function :func:`_` in Python's builtin namespace, based on + This installs the function :func:`_` in Python's builtins namespace, based on *domain*, *localedir*, and *codeset* which are passed to the function :func:`translation`. @@ -203,7 +203,7 @@ class can also install themselves in the built-in namespace as the function print(_('This string will be translated.')) For convenience, you want the :func:`_` function to be installed in Python's - builtin namespace, so it is easily accessible in all modules of your + builtins namespace, so it is easily accessible in all modules of your application. @@ -294,7 +294,7 @@ are the methods of :class:`NullTranslations`: binding it to ``_``. If the *names* parameter is given, it must be a sequence containing the - names of functions you want to install in the builtin namespace in + names of functions you want to install in the builtins namespace in addition to :func:`_`. Supported names are ``'gettext'`` (bound to :meth:`self.gettext`), ``'ngettext'`` (bound to :meth:`self.ngettext`), ``'lgettext'`` and ``'lngettext'``. diff --git a/Doc/library/heapq.rst b/Doc/library/heapq.rst index 6acb283..d7658ae 100644 --- a/Doc/library/heapq.rst +++ b/Doc/library/heapq.rst @@ -134,7 +134,7 @@ The module also offers three general purpose functions based on heaps. The latter two functions perform best for smaller values of *n*. For larger values, it is more efficient to use the :func:`sorted` function. Also, when -``n==1``, it is more efficient to use the builtin :func:`min` and :func:`max` +``n==1``, it is more efficient to use the built-in :func:`min` and :func:`max` functions. diff --git a/Doc/library/io.rst b/Doc/library/io.rst index 71d3f67..4c80e60 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -12,7 +12,7 @@ .. sectionauthor:: Benjamin Peterson <benjamin@python.org> The :mod:`io` module provides the Python interfaces to stream handling. The -builtin :func:`open` function is defined in this module. +built-in :func:`open` function is defined in this module. At the top of the I/O hierarchy is the abstract base class :class:`IOBase`. It defines the basic interface to a stream. Note, however, that there is no diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index af7af2b..006fd5e 100644 --- a/Doc/library/multiprocessing.rst +++ b/Doc/library/multiprocessing.rst @@ -1554,9 +1554,9 @@ with the :class:`Pool` class. .. method:: apply(func[, args[, kwds]]) Call *func* with arguments *args* and keyword arguments *kwds*. It blocks - till the result is ready. Given this blocks - :meth:`apply_async` is better suited - for performing work in parallel. Additionally, the passed - in function is only executed in one of the workers of the pool. + till the result is ready. Given this blocks, :meth:`apply_async` is better + suited for performing work in parallel. Additionally, the passed in + function is only executed in one of the workers of the pool. .. method:: apply_async(func[, args[, kwds[, callback]]]) @@ -1569,7 +1569,7 @@ with the :class:`Pool` class. .. method:: map(func, iterable[, chunksize]) - A parallel equivalent of the :func:`map` builtin function (it supports only + A parallel equivalent of the :func:`map` built-in function (it supports only one *iterable* argument though). It blocks till the result is ready. This method chops the iterable into a number of chunks which it submits to diff --git a/Doc/library/numbers.rst b/Doc/library/numbers.rst index ae14c90..2b13a79 100644 --- a/Doc/library/numbers.rst +++ b/Doc/library/numbers.rst @@ -22,7 +22,7 @@ The numeric tower .. class:: Complex Subclasses of this type describe complex numbers and include the operations - that work on the builtin :class:`complex` type. These are: conversions to + that work on the built-in :class:`complex` type. These are: conversions to :class:`complex` and :class:`bool`, :attr:`.real`, :attr:`.imag`, ``+``, ``-``, ``*``, ``/``, :func:`abs`, :meth:`conjugate`, ``==``, and ``!=``. All except ``-`` and ``!=`` are abstract. diff --git a/Doc/library/pprint.rst b/Doc/library/pprint.rst index dd85746..d1d1bae 100644 --- a/Doc/library/pprint.rst +++ b/Doc/library/pprint.rst @@ -13,7 +13,7 @@ Python data structures in a form which can be used as input to the interpreter. If the formatted structures include objects which are not fundamental Python types, the representation may not be loadable. This may be the case if objects such as files, sockets, classes, or instances are included, as well as many -other builtin objects which are not representable as Python constants. +other built-in objects which are not representable as Python constants. The formatted representation keeps objects on a single line if it can, and breaks them onto multiple lines if they don't fit within the allowed width. diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index 53164b8..a4d9c7f 100644 --- a/Doc/library/sqlite3.rst +++ b/Doc/library/sqlite3.rst @@ -822,7 +822,7 @@ directly using only a single call on the :class:`Connection` object. Accessing columns by name instead of by index ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -One useful feature of the :mod:`sqlite3` module is the builtin +One useful feature of the :mod:`sqlite3` module is the built-in :class:`sqlite3.Row` class designed to be used as a row factory. Rows wrapped with this class can be accessed both by index (like tuples) and diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index 1ccc457..04d0b5d 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -1595,7 +1595,7 @@ set``. Being an unordered collection, sets do not record element position or order of insertion. Accordingly, sets do not support indexing, slicing, or other sequence-like behavior. -There are currently two builtin set types, :class:`set` and :class:`frozenset`. +There are currently two built-in set types, :class:`set` and :class:`frozenset`. The :class:`set` type is mutable --- the contents can be changed using methods like :meth:`add` and :meth:`remove`. Since it is mutable, it has no hash value and cannot be used as either a dictionary key or as an element of another set. diff --git a/Doc/library/string.rst b/Doc/library/string.rst index 2c000b0..2a46a35 100644 --- a/Doc/library/string.rst +++ b/Doc/library/string.rst @@ -287,7 +287,7 @@ Format Specification Mini-Language "Format specifications" are used within replacement fields contained within a format string to define how individual values are presented (see -:ref:`formatstrings`.) They can also be passed directly to the builtin +:ref:`formatstrings`.) They can also be passed directly to the built-in :func:`format` function. Each formattable type may define how the format specification is to be interpreted. diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index c4e3923..d0e4d65 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -738,7 +738,7 @@ always available. ``'c_call'`` A C function is about to be called. This may be an extension function or - a builtin. *arg* is the C function object. + a built-in. *arg* is the C function object. ``'c_return'`` A C function has returned. *arg* is ``None``. diff --git a/Doc/library/undoc.rst b/Doc/library/undoc.rst index 987f95e..6dd1aed 100644 --- a/Doc/library/undoc.rst +++ b/Doc/library/undoc.rst @@ -25,4 +25,3 @@ documented beyond this mention. There's little need to document these. :mod:`posixpath` --- Implementation of :mod:`os.path` on POSIX. - diff --git a/Doc/library/weakref.rst b/Doc/library/weakref.rst index 0f3ebe6..7c7be95 100644 --- a/Doc/library/weakref.rst +++ b/Doc/library/weakref.rst @@ -62,7 +62,7 @@ instances, functions written in Python (but not in C), instance methods, sets, frozensets, file objects, :term:`generator`\s, type objects, sockets, arrays, deques, and regular expression pattern objects. -Several builtin types such as :class:`list` and :class:`dict` do not directly +Several built-in types such as :class:`list` and :class:`dict` do not directly support weak references but can add support through subclassing:: class Dict(dict): diff --git a/Doc/library/winreg.rst b/Doc/library/winreg.rst index f42e7f2..f048067 100644 --- a/Doc/library/winreg.rst +++ b/Doc/library/winreg.rst @@ -399,7 +399,7 @@ detached). The object also support comparison semantics, so handle objects will compare true if they both reference the same underlying Windows handle value. -Handle objects can be converted to an integer (e.g., using the builtin +Handle objects can be converted to an integer (e.g., using the built-in :func:`int` function), in which case the underlying Windows handle value is returned. You can also use the :meth:`Detach` method to return the integer handle, and also disconnect the Windows handle from the handle object. diff --git a/Doc/library/xmlrpc.client.rst b/Doc/library/xmlrpc.client.rst index 1601430..e004fa7 100644 --- a/Doc/library/xmlrpc.client.rst +++ b/Doc/library/xmlrpc.client.rst @@ -87,7 +87,7 @@ between conformable Python objects and XML on the wire. :exc:`ProtocolError` used to signal an error in the HTTP/HTTPS transport layer. Both :exc:`Fault` and :exc:`ProtocolError` derive from a base class called :exc:`Error`. Note that the xmlrpc client module currently does not marshal - instances of subclasses of builtin types. + instances of subclasses of built-in types. When passing strings, characters special to XML such as ``<``, ``>``, and ``&`` will be automatically escaped. However, it's the caller's responsibility to diff --git a/Doc/library/zipimport.rst b/Doc/library/zipimport.rst index 3fd0595..2315823 100644 --- a/Doc/library/zipimport.rst +++ b/Doc/library/zipimport.rst @@ -10,7 +10,7 @@ This module adds the ability to import Python modules (:file:`\*.py`, :file:`\*.py[co]`) and packages from ZIP-format archives. It is usually not needed to use the :mod:`zipimport` module explicitly; it is automatically used -by the builtin :keyword:`import` mechanism for ``sys.path`` items that are paths +by the built-in :keyword:`import` mechanism for ``sys.path`` items that are paths to ZIP archives. Typically, ``sys.path`` is a list of directory names as strings. This module |