traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

#7642: update to os.system() docs.

This commit is contained in:
Georg Brandl 2010-10-14 06:35:53 +00:00
parent a62cbf7cce
commit 8f7b427b5b
1 changed files with 15 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
Doc/library/os.rst
View File

@ -1925,26 +1925,25 @@ written in Python, such as a mail server's external command delivery program.
Execute the command (a string) in a subshell. This is implemented by calling Execute the command (a string) in a subshell. This is implemented by calling
the Standard C function :c:func:`system`, and has the same limitations. the Standard C function :c:func:`system`, and has the same limitations.
Changes to :data:`sys.stdin`, etc. are not reflected in the environment of the Changes to :data:`sys.stdin`, etc. are not reflected in the environment of
executed command. the executed command. If *command* generates any output, it will be sent to
the interpreter standard output stream.
On Unix, the return value is the exit status of the process encoded in the On Unix, the return value is the exit status of the process encoded in the
format specified for :func:`wait`. Note that POSIX does not specify the meaning format specified for :func:`wait`. Note that POSIX does not specify the
of the return value of the C :c:func:`system` function, so the return value of meaning of the return value of the C :c:func:`system` function, so the return
the Python function is system-dependent. value of the Python function is system-dependent.
On Windows, the return value is that returned by the system shell after running On Windows, the return value is that returned by the system shell after
*command*, given by the Windows environment variable :envvar:`COMSPEC`: on running *command*. The shell is given by the Windows environment variable
:program:`command.com` systems (Windows 95, 98 and ME) this is always ``0``; on :envvar:`COMSPEC`: it is usually :program:`cmd.exe`, which returns the exit
:program:`cmd.exe` systems (Windows NT, 2000 and XP) this is the exit status of status of the command run; on systems using a non-native shell, consult your
the command run; on systems using a non-native shell, consult your shell shell documentation.
documentation.
The :mod:`subprocess` module provides more powerful facilities for spawning new The :mod:`subprocess` module provides more powerful facilities for spawning
processes and retrieving their results; using that module is preferable to using new processes and retrieving their results; using that module is preferable
this function. See the to using this function. See the :ref:`subprocess-replacements` section in
:ref:`subprocess-replacements` section in the :mod:`subprocess` documentation the :mod:`subprocess` documentation for some helpful recipes.
for some helpful recipes.
Availability: Unix, Windows. Availability: Unix, Windows.