Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Logical markup.

This commit is contained in:
Fred Drake 1998-03-11 06:24:46 +00:00
parent 60ba44750f
commit fdbd51db8b
2 changed files with 36 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
Doc/lib/libcommands.tex
View File

@ -2,34 +2,35 @@
\stmodindex{commands}
\label{module-commands}
The \code{commands} module contains wrapper functions for \code{os.popen()}
which take a system command as a string and return any output generated by
the command and, optionally, the exit status.
The \module{commands} module contains wrapper functions for
\function{os.popen()} which take a system command as a string and
return any output generated by the command and, optionally, the exit
status.
The \code{commands} module is only usable on systems which support
\code{popen()} (currently \UNIX{}).
The \module{commands} module is only usable on systems which support
\function{os.popen()} (currently \UNIX{}). It defines the following
functions:
The \code{commands} module defines the following functions:
\setindexsubitem{(in module commands)}
\begin{funcdesc}{getstatusoutput}{cmd}
Execute the string \var{cmd} in a shell with \code{os.popen()} and return
a 2-tuple (status, output). \var{cmd} is actually run as
\code{\{ cmd ; \} 2>\&1}, so that the returned output will contain output
or error messages. A trailing newline is stripped from the output.
The exit status for the command can be interpreted according to the
rules for the \C{} function \code{wait()}.
Execute the string \var{cmd} in a shell with \function{os.popen()} and
return a 2-tuple \code{(\var{status}, \var{output})}. \var{cmd} is
actually run as \code{\{ \var{cmd} ; \} 2>\&1}, so that the returned
output will contain output or error messages. A trailing newline is
stripped from the output. The exit status for the command can be
interpreted according to the rules for the \C{} function
\cfunction{wait()}.
\end{funcdesc}
\begin{funcdesc}{getoutput}{cmd}
Like \code{getstatusoutput()}, except the exit status is ignored and
the return value is a string containing the command's output.
Like \function{getstatusoutput()}, except the exit status is ignored
and the return value is a string containing the command's output.
\end{funcdesc}
\begin{funcdesc}{getstatus}{file}
Return the output of \samp{ls -ld \var{file}} as a string. This
function uses the \code{getoutput()} function, and properly escapes
backslashes and dollar signs in the argument.
function uses the \function{getoutput()} function, and properly
escapes backslashes and dollar signs in the argument.
\end{funcdesc}
Example:

35
Doc/libcommands.tex
View File

@ -2,34 +2,35 @@
\stmodindex{commands}
\label{module-commands}
The \code{commands} module contains wrapper functions for \code{os.popen()}
which take a system command as a string and return any output generated by
the command and, optionally, the exit status.
The \module{commands} module contains wrapper functions for
\function{os.popen()} which take a system command as a string and
return any output generated by the command and, optionally, the exit
status.
The \code{commands} module is only usable on systems which support
\code{popen()} (currently \UNIX{}).
The \module{commands} module is only usable on systems which support
\function{os.popen()} (currently \UNIX{}). It defines the following
functions:
The \code{commands} module defines the following functions:
\setindexsubitem{(in module commands)}
\begin{funcdesc}{getstatusoutput}{cmd}
Execute the string \var{cmd} in a shell with \code{os.popen()} and return
a 2-tuple (status, output). \var{cmd} is actually run as
\code{\{ cmd ; \} 2>\&1}, so that the returned output will contain output
or error messages. A trailing newline is stripped from the output.
The exit status for the command can be interpreted according to the
rules for the \C{} function \code{wait()}.
Execute the string \var{cmd} in a shell with \function{os.popen()} and
return a 2-tuple \code{(\var{status}, \var{output})}. \var{cmd} is
actually run as \code{\{ \var{cmd} ; \} 2>\&1}, so that the returned
output will contain output or error messages. A trailing newline is
stripped from the output. The exit status for the command can be
interpreted according to the rules for the \C{} function
\cfunction{wait()}.
\end{funcdesc}
\begin{funcdesc}{getoutput}{cmd}
Like \code{getstatusoutput()}, except the exit status is ignored and
the return value is a string containing the command's output.
Like \function{getstatusoutput()}, except the exit status is ignored
and the return value is a string containing the command's output.
\end{funcdesc}
\begin{funcdesc}{getstatus}{file}
Return the output of \samp{ls -ld \var{file}} as a string. This
function uses the \code{getoutput()} function, and properly escapes
backslashes and dollar signs in the argument.
function uses the \function{getoutput()} function, and properly
escapes backslashes and dollar signs in the argument.
\end{funcdesc}
Example: