Kaydet (Commit) 276a58b8 authored tarafından Senthil Kumaran's avatar Senthil Kumaran

Merge from 3.2 . Replace the term members with correct and appropriate…

Merge from 3.2 . Replace the term members with correct  and appropriate terminology. Initial patch by Adam Woodbeck.
......@@ -50,7 +50,7 @@ A :class:`Cmd` instance has the following methods:
the line as argument.
The optional argument is a banner or intro string to be issued before the first
prompt (this overrides the :attr:`intro` class member).
prompt (this overrides the :attr:`intro` class attribute).
If the :mod:`readline` module is loaded, input will automatically inherit
:program:`bash`\ -like history-list editing (e.g. :kbd:`Control-P` scrolls back
......
......@@ -1639,7 +1639,7 @@ You can instantiate a :class:`Textbox` object as follows:
each keystroke entered with the keystroke as a parameter; command dispatch
is done on the result. This method returns the window contents as a
string; whether blanks in the window are included is affected by the
:attr:`stripspaces` member.
:attr:`stripspaces` attribute.
.. method:: do_command(ch)
......@@ -1711,7 +1711,7 @@ You can instantiate a :class:`Textbox` object as follows:
.. attribute:: stripspaces
This data member is a flag which controls the interpretation of blanks in
This attribute is a flag which controls the interpretation of blanks in
the window. When it is on, trailing blanks on each line are ignored; any
cursor motion that would land the cursor on a trailing blank goes to the
end of that line instead, and trailing blanks are stripped when the window
......
This diff is collapsed.
......@@ -654,7 +654,7 @@ Decimal objects
Normalize the number by stripping the rightmost trailing zeros and
converting any result equal to :const:`Decimal('0')` to
:const:`Decimal('0e0')`. Used for producing canonical values for members
:const:`Decimal('0e0')`. Used for producing canonical values for attributes
of an equivalence class. For example, ``Decimal('32.100')`` and
``Decimal('0.321000e+2')`` both normalize to the equivalent value
``Decimal('32.1')``.
......
......@@ -1127,11 +1127,10 @@ DocTest Objects
.. class:: DocTest(examples, globs, name, filename, lineno, docstring)
A collection of doctest examples that should be run in a single namespace. The
constructor arguments are used to initialize the member variables of the same
names.
constructor arguments are used to initialize the attributes of the same names.
:class:`DocTest` defines the following member variables. They are initialized by
:class:`DocTest` defines the following attributes. They are initialized by
the constructor, and should not be modified directly.
......@@ -1184,11 +1183,11 @@ Example Objects
.. class:: Example(source, want, exc_msg=None, lineno=0, indent=0, options=None)
A single interactive example, consisting of a Python statement and its expected
output. The constructor arguments are used to initialize the member variables
of the same names.
output. The constructor arguments are used to initialize the attributes of
the same names.
:class:`Example` defines the following member variables. They are initialized by
:class:`Example` defines the following attributes. They are initialized by
the constructor, and should not be modified directly.
......@@ -1675,9 +1674,9 @@ There are two exceptions that may be raised by :class:`DebugRunner` instances:
An exception raised by :class:`DocTestRunner` to signal that a doctest example's
actual output did not match its expected output. The constructor arguments are
used to initialize the member variables of the same names.
used to initialize the attributes of the same names.
:exc:`DocTestFailure` defines the following member variables:
:exc:`DocTestFailure` defines the following attributes:
.. attribute:: DocTestFailure.test
......@@ -1699,9 +1698,9 @@ There are two exceptions that may be raised by :class:`DebugRunner` instances:
An exception raised by :class:`DocTestRunner` to signal that a doctest
example raised an unexpected exception. The constructor arguments are used
to initialize the member variables of the same names.
to initialize the attributes of the same names.
:exc:`UnexpectedException` defines the following member variables:
:exc:`UnexpectedException` defines the following attributes:
.. attribute:: UnexpectedException.test
......
......@@ -61,7 +61,7 @@ The module defines the following items:
time is used. This module ignores the timestamp when decompressing;
however, some programs, such as :program:`gunzip`\ , make use of it.
The format of the timestamp is the same as that of the return value of
``time.time()`` and of the ``st_mtime`` member of the object returned
``time.time()`` and of the ``st_mtime`` attribute of the object returned
by ``os.stat()``.
Calling a :class:`GzipFile` object's :meth:`close` method does not close
......
......@@ -11,7 +11,7 @@
This module defines three dictionaries, ``name2codepoint``, ``codepoint2name``,
and ``entitydefs``. ``entitydefs`` is used to provide the :attr:`entitydefs`
member of the :class:`html.parser.HTMLParser` class. The definition provided
attribute of the :class:`html.parser.HTMLParser` class. The definition provided
here contains all the entities defined by XHTML 1.0 that can be handled using
simple textual substitution in the Latin-1 character set (ISO-8859-1).
......
......@@ -152,7 +152,7 @@ Morsel Objects
.. method:: Morsel.set(key, value, coded_value)
Set the *key*, *value* and *coded_value* members.
Set the *key*, *value* and *coded_value* attributes.
.. method:: Morsel.isReservedKey(K)
......
......@@ -391,8 +391,8 @@ I/O Base Classes
:class:`RawIOBase` implementation, but wrap one, like
:class:`BufferedWriter` and :class:`BufferedReader` do.
:class:`BufferedIOBase` provides or overrides these members in addition to
those from :class:`IOBase`:
:class:`BufferedIOBase` provides or overrides these methods and attribute in
addition to those from :class:`IOBase`:
.. attribute:: raw
......
......@@ -407,7 +407,7 @@ tuples or objects that the method normally returns will be empty.
Send an ``ARTICLE`` command, where *message_spec* has the same meaning as
for :meth:`stat`. Return a tuple ``(response, info)`` where *info*
is a :class:`~collections.namedtuple` with three members *number*,
is a :class:`~collections.namedtuple` with three attributes *number*,
*message_id* and *lines* (in that order). *number* is the article number
in the group (or 0 if the information is not available), *message_id* the
message id as a string, and *lines* a list of lines (without terminating
......
......@@ -1826,11 +1826,12 @@ Files and Directories
.. note::
The exact meaning and resolution of the :attr:`st_atime`, :attr:`st_mtime`, and
:attr:`st_ctime` members depends on the operating system and the file system.
For example, on Windows systems using the FAT or FAT32 file systems,
:attr:`st_mtime` has 2-second resolution, and :attr:`st_atime` has only 1-day
resolution. See your operating system documentation for details.
The exact meaning and resolution of the :attr:`st_atime`,
:attr:`st_mtime`, and :attr:`st_ctime` attributes depend on the operating
system and the file system. For example, on Windows systems using the FAT
or FAT32 file systems, :attr:`st_mtime` has 2-second resolution, and
:attr:`st_atime` has only 1-day resolution. See your operating system
documentation for details.
For backward compatibility, the return value of :func:`~os.stat` is also accessible
as a tuple of at least 10 integers giving the most important (and portable)
......
......@@ -45,7 +45,7 @@ Class Objects
The :class:`Class` objects used as values in the dictionary returned by
:func:`readmodule` and :func:`readmodule_ex` provide the following data
members:
attributes:
.. attribute:: Class.module
......@@ -89,7 +89,7 @@ Function Objects
----------------
The :class:`Function` objects used as values in the dictionary returned by
:func:`readmodule_ex` provide the following data members:
:func:`readmodule_ex` provide the following attributes:
.. attribute:: Function.module
......
......@@ -66,7 +66,7 @@ string instead.
Repr Objects
------------
:class:`Repr` instances provide several members which can be used to provide
:class:`Repr` instances provide several attributes which can be used to provide
size limits for the representations of different object types, and methods
which format specific object types.
......
......@@ -24,8 +24,8 @@ The :mod:`shlex` module defines the following functions:
Split the string *s* using shell-like syntax. If *comments* is :const:`False`
(the default), the parsing of comments in the given string will be disabled
(setting the :attr:`commenters` member of the :class:`shlex` instance to the
empty string). This function operates in POSIX mode by default, but uses
(setting the :attr:`commenters` attribute of the :class:`shlex` instance to
the empty string). This function operates in POSIX mode by default, but uses
non-POSIX mode if the *posix* argument is false.
.. note::
......@@ -44,7 +44,7 @@ The :mod:`shlex` module defines the following class:
from. It must be a file-/stream-like object with :meth:`read` and
:meth:`readline` methods, or a string. If no argument is given, input will
be taken from ``sys.stdin``. The second optional argument is a filename
string, which sets the initial value of the :attr:`infile` member. If the
string, which sets the initial value of the :attr:`infile` attribute. If the
*instream* argument is omitted or equal to ``sys.stdin``, this second
argument defaults to "stdin". The *posix* argument defines the operational
mode: when *posix* is not true (default), the :class:`shlex` instance will
......@@ -202,8 +202,8 @@ either control lexical analysis or can be used for debugging:
.. attribute:: shlex.source
This member is ``None`` by default. If you assign a string to it, that string
will be recognized as a lexical-level inclusion request similar to the
This attribute is ``None`` by default. If you assign a string to it, that
string will be recognized as a lexical-level inclusion request similar to the
``source`` keyword in various shells. That is, the immediately following token
will opened as a filename and input taken from that stream until EOF, at which
point the :meth:`close` method of that stream will be called and the input
......@@ -213,7 +213,7 @@ either control lexical analysis or can be used for debugging:
.. attribute:: shlex.debug
If this member is numeric and ``1`` or more, a :class:`shlex` instance will
If this attribute is numeric and ``1`` or more, a :class:`shlex` instance will
print verbose progress output on its behavior. If you need to use this, you can
read the module source code to learn the details.
......
......@@ -81,7 +81,7 @@ a threading UDP server class is created as follows::
class ThreadingUDPServer(ThreadingMixIn, UDPServer): pass
The mix-in class must come first, since it overrides a method defined in
:class:`UDPServer`. Setting the various member variables also changes the
:class:`UDPServer`. Setting the various attributes also change the
behavior of the underlying server mechanism.
To implement a service, you must derive a class from :class:`BaseRequestHandler`
......
......@@ -2578,7 +2578,7 @@ statement is not, strictly speaking, an operation on a module object; ``import
foo`` does not require a module object named *foo* to exist, rather it requires
an (external) *definition* for a module named *foo* somewhere.)
A special member of every module is :attr:`__dict__`. This is the dictionary
A special attribute of every module is :attr:`__dict__`. This is the dictionary
containing the module's symbol table. Modifying this dictionary will actually
change the module's symbol table, but direct assignment to the :attr:`__dict__`
attribute is not possible (you can write ``m.__dict__['a'] = 1``, which defines
......
......@@ -567,38 +567,39 @@ on Windows.
.. attribute:: dwFlags
A bit field that determines whether certain :class:`STARTUPINFO` members
are used when the process creates a window. ::
A bit field that determines whether certain :class:`STARTUPINFO`
attributes are used when the process creates a window. ::
si = subprocess.STARTUPINFO()
si.dwFlags = subprocess.STARTF_USESTDHANDLES | subprocess.STARTF_USESHOWWINDOW
.. attribute:: hStdInput
If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this member is
the standard input handle for the process. If :data:`STARTF_USESTDHANDLES`
is not specified, the default for standard input is the keyboard buffer.
If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute
is the standard input handle for the process. If
:data:`STARTF_USESTDHANDLES` is not specified, the default for standard
input is the keyboard buffer.
.. attribute:: hStdOutput
If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this member is
the standard output handle for the process. Otherwise, this member is
ignored and the default for standard output is the console window's
If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute
is the standard output handle for the process. Otherwise, this attribute
is ignored and the default for standard output is the console window's
buffer.
.. attribute:: hStdError
If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this member is
the standard error handle for the process. Otherwise, this member is
If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute
is the standard error handle for the process. Otherwise, this attribute is
ignored and the default for standard error is the console window's buffer.
.. attribute:: wShowWindow
If :attr:`dwFlags` specifies :data:`STARTF_USESHOWWINDOW`, this member
If :attr:`dwFlags` specifies :data:`STARTF_USESHOWWINDOW`, this attribute
can be any of the values that can be specified in the ``nCmdShow``
parameter for the
`ShowWindow <http://msdn.microsoft.com/en-us/library/ms633548(v=vs.85).aspx>`__
function, except for ``SW_SHOWDEFAULT``. Otherwise, this member is
function, except for ``SW_SHOWDEFAULT``. Otherwise, this attribute is
ignored.
:data:`SW_HIDE` is provided for this attribute. It is used when
......@@ -632,12 +633,12 @@ The :mod:`subprocess` module exposes the following constants.
.. data:: STARTF_USESTDHANDLES
Specifies that the :attr:`STARTUPINFO.hStdInput`,
:attr:`STARTUPINFO.hStdOutput`, and :attr:`STARTUPINFO.hStdError` members
:attr:`STARTUPINFO.hStdOutput`, and :attr:`STARTUPINFO.hStdError` attributes
contain additional information.
.. data:: STARTF_USESHOWWINDOW
Specifies that the :attr:`STARTUPINFO.wShowWindow` member contains
Specifies that the :attr:`STARTUPINFO.wShowWindow` attribute contains
additional information.
.. data:: CREATE_NEW_CONSOLE
......
......@@ -60,7 +60,7 @@ The module defines the following user-callable items:
This function operates exactly as :func:`TemporaryFile` does, except that
the file is guaranteed to have a visible name in the file system (on
Unix, the directory entry is not unlinked). That name can be retrieved
from the :attr:`name` member of the file object. Whether the name can be
from the :attr:`name` attribute of the file object. Whether the name can be
used to open the file a second time, while the named temporary file is
still open, varies across platforms (it can be so used on Unix; it cannot
on Windows NT or later). If *delete* is true (the default), the file is
......@@ -96,7 +96,7 @@ The module defines the following user-callable items:
of the temporary directory object), the newly created temporary directory
and all its contents are removed from the filesystem.
The directory name can be retrieved from the :attr:`name` member
The directory name can be retrieved from the :attr:`name` attribute
of the returned object.
The directory can be explicitly cleaned up by calling the
......
......@@ -105,7 +105,7 @@ The :mod:`urllib.request` module defines the following functions:
can be imported), :class:`HTTPSHandler` will also be added.
A :class:`BaseHandler` subclass may also change its :attr:`handler_order`
member variable to modify its position in the handlers list.
attribute to modify its position in the handlers list.
.. function:: pathname2url(path)
......@@ -546,7 +546,7 @@ intended for direct use:
Remove any parents.
The following members and methods should only be used by classes derived from
The following attribute and methods should only be used by classes derived from
:class:`BaseHandler`.
.. note::
......
......@@ -260,7 +260,7 @@ Exceptions in this module are coded as class instances:
.. exception:: Error
The base exception class. :exc:`Error` has a single public data member
The base exception class. :exc:`Error` has a single public attribute
:attr:`msg` containing the description of the error.
......
......@@ -136,7 +136,7 @@ returning a value, which may be either returned data in a conformant type or a
:class:`Fault` or :class:`ProtocolError` object indicating an error.
Servers that support the XML introspection API support some common methods
grouped under the reserved :attr:`system` member:
grouped under the reserved :attr:`system` attribute:
.. method:: ServerProxy.system.listMethods()
......@@ -310,7 +310,7 @@ Fault Objects
-------------
A :class:`Fault` object encapsulates the content of an XML-RPC fault tag. Fault
objects have the following members:
objects have the following attributes:
.. attribute:: Fault.faultCode
......@@ -359,7 +359,7 @@ ProtocolError Objects
A :class:`ProtocolError` object describes a protocol error in the underlying
transport layer (such as a 404 'not found' error if the server named by the URI
does not exist). It has the following members:
does not exist). It has the following attributes:
.. attribute:: ProtocolError.url
......
......@@ -1459,7 +1459,7 @@ complete list of changes, or look through the SVN logs for all the details.
On FreeBSD, the :func:`os.stat` function now returns times with nanosecond
resolution, and the returned object now has :attr:`st_gen` and
:attr:`st_birthtime`. The :attr:`st_flags` member is also available, if the
:attr:`st_birthtime`. The :attr:`st_flags` attribute is also available, if the
platform supports it. (Contributed by Antti Louko and Diego Pettenò.)
.. (Patch 1180695, 1212117)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment