mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-27 02:39:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 13

Fix references to file-related functions and methods (os.* vs file.*).

Browse source
This commit is contained in:
Georg Brandl 2009-05-22 09:43:17 +00:00
parent aafd6b850e
commit 012408c2b9
1 changed files with 15 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

28
Doc/library/os.rst
View file

@ -354,7 +354,7 @@ These functions create new file objects. (See also :func:`open`.)
is ``'r'`` (default) or ``'w'``. The *bufsize* argument has the same meaning as is ``'r'`` (default) or ``'w'``. The *bufsize* argument has the same meaning as
the corresponding argument to the built-in :func:`open` function. The exit the corresponding argument to the built-in :func:`open` function. The exit
status of the command (encoded in the format specified for :func:`wait`) is status of the command (encoded in the format specified for :func:`wait`) is
available as the return value of the :meth:`close` method of the file object, available as the return value of the :meth:`~file.close` method of the file object,
except that when the exit status is zero (termination without errors), ``None`` except that when the exit status is zero (termination without errors), ``None``
is returned. Availability: Unix, Windows. is returned. Availability: Unix, Windows.
@ -475,9 +475,9 @@ by file descriptors.
.. note:: .. note::
This function is intended for low-level I/O and must be applied to a file This function is intended for low-level I/O and must be applied to a file
descriptor as returned by :func:`open` or :func:`pipe`. To close a "file descriptor as returned by :func:`os.open` or :func:`pipe`. To close a "file
object" returned by the built-in function :func:`open` or by :func:`popen` or object" returned by the built-in function :func:`open` or by :func:`popen` or
:func:`fdopen`, use its :meth:`close` method. :func:`fdopen`, use its :meth:`~file.close` method.
.. function:: closerange(fd_low, fd_high) .. function:: closerange(fd_low, fd_high)
@ -604,8 +604,8 @@ by file descriptors.
.. note:: .. note::
This function is intended for low-level I/O. For normal usage, use the built-in This function is intended for low-level I/O. For normal usage, use the built-in
function :func:`open`, which returns a "file object" with :meth:`read` and function :func:`open`, which returns a "file object" with :meth:`~file.read` and
:meth:`write` methods (and many more). To wrap a file descriptor in a "file :meth:`~file.write` methods (and many more). To wrap a file descriptor in a "file
object", use :func:`fdopen`. object", use :func:`fdopen`.
@ -634,22 +634,22 @@ by file descriptors.
.. note:: .. note::
This function is intended for low-level I/O and must be applied to a file This function is intended for low-level I/O and must be applied to a file
descriptor as returned by :func:`open` or :func:`pipe`. To read a "file object" descriptor as returned by :func:`os.open` or :func:`pipe`. To read a "file object"
returned by the built-in function :func:`open` or by :func:`popen` or returned by the built-in function :func:`open` or by :func:`popen` or
:func:`fdopen`, or :data:`sys.stdin`, use its :meth:`read` or :meth:`readline` :func:`fdopen`, or :data:`sys.stdin`, use its :meth:`~file.read` or
methods. :meth:`~file.readline` methods.
.. function:: tcgetpgrp(fd) .. function:: tcgetpgrp(fd)
Return the process group associated with the terminal given by *fd* (an open Return the process group associated with the terminal given by *fd* (an open
file descriptor as returned by :func:`open`). Availability: Unix. file descriptor as returned by :func:`os.open`). Availability: Unix.
.. function:: tcsetpgrp(fd, pg) .. function:: tcsetpgrp(fd, pg)
Set the process group associated with the terminal given by *fd* (an open file Set the process group associated with the terminal given by *fd* (an open file
descriptor as returned by :func:`open`) to *pg*. Availability: Unix. descriptor as returned by :func:`os.open`) to *pg*. Availability: Unix.
.. function:: ttyname(fd) .. function:: ttyname(fd)
@ -667,13 +667,13 @@ by file descriptors.
.. note:: .. note::
This function is intended for low-level I/O and must be applied to a file This function is intended for low-level I/O and must be applied to a file
descriptor as returned by :func:`open` or :func:`pipe`. To write a "file descriptor as returned by :func:`os.open` or :func:`pipe`. To write a "file
object" returned by the built-in function :func:`open` or by :func:`popen` or object" returned by the built-in function :func:`open` or by :func:`popen` or
:func:`fdopen`, or :data:`sys.stdout` or :data:`sys.stderr`, use its :meth:`write` :func:`fdopen`, or :data:`sys.stdout` or :data:`sys.stderr`, use its
method. :meth:`~file.write` method.
The following constants are options for the *flags* parameter to the The following constants are options for the *flags* parameter to the
:func:`open` function. They can be combined using the bitwise OR operator :func:`~os.open` function. They can be combined using the bitwise OR operator
``|``. Some of them are not available on all platforms. For descriptions of ``|``. Some of them are not available on all platforms. For descriptions of
their availability and use, consult the :manpage:`open(2)` manual page on Unix their availability and use, consult the :manpage:`open(2)` manual page on Unix
or `the MSDN <http://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>` on Windows. or `the MSDN <http://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>` on Windows.