Commit 95763551 authored by Georg Brandl's avatar Georg Brandl

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

parent b17066f0
...@@ -1925,26 +1925,25 @@ written in Python, such as a mail server's external command delivery program. ...@@ -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
The :mod:`subprocess` module provides more powerful facilities for spawning new new processes and retrieving their results; using that module is preferable
processes and retrieving their results; using that module is preferable to using to using this function. See the :ref:`subprocess-replacements` section in
this function. See the the :mod:`subprocess` documentation for some helpful recipes.
:ref:`subprocess-replacements` section in the :mod:`subprocess` documentation
for some helpful recipes.
Availability: Unix, Windows. Availability: Unix, Windows.
......
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