Consistently use \POSIX{} to denote POSIX. There were at least two different

ways to do it previously (not counting module names).
This commit is contained in:
Fred Drake 1998-02-09 20:27:12 +00:00
parent 41785fb864
commit 65b32f7f74
18 changed files with 60 additions and 60 deletions

View file

@ -119,7 +119,7 @@ Returns the standard info string of the object.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{tod_gettime}{} \begin{funcdesc}{tod_gettime}{}
Returns the time (in seconds since the Epoch, in UCT, as for POSIX) from Returns the time (in seconds since the Epoch, in UCT, as for \POSIX{}) from
a time server. a time server.
\end{funcdesc} \end{funcdesc}

View file

@ -3,9 +3,9 @@
\label{module-locale} \label{module-locale}
The \code{locale} module opens access to the POSIX locale database and The \code{locale} module opens access to the \POSIX{} locale database
functionality. The POSIX locale mechanism allows applications to and functionality. The \POSIX{} locale mechanism allows applications
integrate certain cultural aspects into an applications, without to integrate certain cultural aspects into an applications, without
requiring the programmer to know all the specifics of each country requiring the programmer to know all the specifics of each country
where the software is executed. where the software is executed.

View file

@ -32,7 +32,7 @@ Group comp.lang.python has 59 articles, range 3742 to 3803
3798 Re: a few questions about the Mac implementation 3798 Re: a few questions about the Mac implementation
3799 Re: PROPOSAL: A Generic Python Object Interface for Python C Modules 3799 Re: PROPOSAL: A Generic Python Object Interface for Python C Modules
3802 Re: executable python scripts 3802 Re: executable python scripts
3803 Re: POSIX wait and SIGCHLD 3803 Re: \POSIX{} wait and SIGCHLD
>>> s.quit() >>> s.quit()
'205 news.cwi.nl closing connection. Goodbye.' '205 news.cwi.nl closing connection. Goodbye.'
>>> >>>

View file

@ -13,7 +13,7 @@ exports the same functions and data as found there. The design of all
Python's built-in OS dependent modules is such that as long as the same Python's built-in OS dependent modules is such that as long as the same
functionality is available, it uses the same interface; e.g., the functionality is available, it uses the same interface; e.g., the
function \code{os.stat(\var{file})} returns stat info about a \var{file} in a function \code{os.stat(\var{file})} returns stat info about a \var{file} in a
format compatible with the POSIX interface. format compatible with the \POSIX{} interface.
Extensions peculiar to a particular OS are also available through the Extensions peculiar to a particular OS are also available through the
\code{os} module, but using them is of course a threat to portability! \code{os} module, but using them is of course a threat to portability!
@ -43,20 +43,20 @@ more portable than \code{posixpath.split(\var{file})}.
\begin{datadesc}{curdir} \begin{datadesc}{curdir}
The constant string used by the OS to refer to the current directory, The constant string used by the OS to refer to the current directory,
e.g. \code{'.'} for POSIX or \code{':'} for the Mac. e.g. \code{'.'} for \POSIX{} or \code{':'} for the Mac.
\end{datadesc} \end{datadesc}
\begin{datadesc}{pardir} \begin{datadesc}{pardir}
The constant string used by the OS to refer to the parent directory, The constant string used by the OS to refer to the parent directory,
e.g. \code{'..'} for POSIX or \code{'::'} for the Mac. e.g. \code{'..'} for \POSIX{} or \code{'::'} for the Mac.
\end{datadesc} \end{datadesc}
\begin{datadesc}{sep} \begin{datadesc}{sep}
The character used by the OS to separate pathname components, The character used by the OS to separate pathname components,
e.g. \code{'/'} for POSIX or \code{':'} for the Mac. Note that knowing this e.g. \code{'/'} for \POSIX{} or \code{':'} for the Mac. Note that
is not sufficient to be able to parse or concatenate pathnames---better knowing this is not sufficient to be able to parse or concatenate
use \code{os.path.split()} and \code{os.path.join()}---but it is pathnames --- better use \code{os.path.split()} and
occasionally useful. \code{os.path.join()}---but it is occasionally useful.
\end{datadesc} \end{datadesc}
\begin{datadesc}{altsep} \begin{datadesc}{altsep}
@ -67,7 +67,7 @@ or \code{None} if only one separator character exists. This is set to
\begin{datadesc}{pathsep} \begin{datadesc}{pathsep}
The character conventionally used by the OS to separate search patch The character conventionally used by the OS to separate search patch
components (as in \code{\$PATH}), e.g.\ \code{':'} for POSIX or components (as in \code{\$PATH}), e.g.\ \code{':'} for \POSIX{} or
\code{';'} for MS-DOS. \code{';'} for MS-DOS.
\end{datadesc} \end{datadesc}

View file

@ -3,7 +3,7 @@
\bimodindex{posix} \bimodindex{posix}
This module provides access to operating system functionality that is This module provides access to operating system functionality that is
standardized by the C Standard and the POSIX standard (a thinly disguised standardized by the C Standard and the \POSIX{} standard (a thinly disguised
\UNIX{} interface). \UNIX{} interface).
\strong{Do not import this module directly.} Instead, import the \strong{Do not import this module directly.} Instead, import the
@ -19,7 +19,7 @@ when an entry is \code{os.environ} is changed.
\refstmodindex{os} \refstmodindex{os}
The descriptions below are very terse; refer to the corresponding The descriptions below are very terse; refer to the corresponding
\UNIX{} manual (or POSIX documentation) entry for more information. \UNIX{} manual (or \POSIX{} documentation) entry for more information.
Arguments called \var{path} refer to a pathname given as a string. Arguments called \var{path} refer to a pathname given as a string.
Errors are reported as exceptions; the usual exceptions are given Errors are reported as exceptions; the usual exceptions are given
@ -52,8 +52,8 @@ a mapping object that behaves almost like a dictionary but invokes
\renewcommand{\indexsubitem}{(exception in module posix)} \renewcommand{\indexsubitem}{(exception in module posix)}
\begin{excdesc}{error} \begin{excdesc}{error}
This exception is raised when a POSIX function returns a This exception is raised when a \POSIX{} function returns a
POSIX-related error (e.g., not for illegal argument types). Its \POSIX{}-related error (e.g., not for illegal argument types). Its
string value is \code{'posix.error'}. The accompanying value is a string value is \code{'posix.error'}. The accompanying value is a
pair containing the numeric error code from \code{errno} and the pair containing the numeric error code from \code{errno} and the
corresponding string, as would be printed by the C function corresponding string, as would be printed by the C function
@ -214,7 +214,7 @@ without symbolic links, this is identical to \code{posix.stat()}.)
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{mkfifo}{path\optional{\, mode}} \begin{funcdesc}{mkfifo}{path\optional{\, mode}}
Create a FIFO (a POSIX named pipe) named \var{path} with numeric mode Create a FIFO (a \POSIX{} named pipe) named \var{path} with numeric mode
\var{mode}. The default \var{mode} is 0666 (octal). The current \var{mode}. The default \var{mode} is 0666 (octal). The current
umask value is first masked out from the mode. umask value is first masked out from the mode.
(Not on MS-DOS.) (Not on MS-DOS.)

View file

@ -2,7 +2,7 @@
\label{module-posixpath} \label{module-posixpath}
\stmodindex{posixpath} \stmodindex{posixpath}
This module implements some useful functions on POSIX pathnames. This module implements some useful functions on \POSIX{} pathnames.
\strong{Do not import this module directly.} Instead, import the \strong{Do not import this module directly.} Instead, import the
module \code{os} and use \code{os.path}. module \code{os} and use \code{os.path}.
@ -78,7 +78,7 @@ file system where a different file system has been mounted. The
function checks whether \var{p}'s parent, \file{\var{p}/..}, is on a function checks whether \var{p}'s parent, \file{\var{p}/..}, is on a
different device than \var{p}, or whether \file{\var{p}/..} and different device than \var{p}, or whether \file{\var{p}/..} and
\var{p} point to the same i-node on the same device --- this should \var{p} point to the same i-node on the same device --- this should
detect mount points for all \UNIX{} and POSIX variants. detect mount points for all \UNIX{} and \POSIX{} variants.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{join}{p\optional{\, q\optional{\, ...}}} \begin{funcdesc}{join}{p\optional{\, q\optional{\, ...}}}

View file

@ -1,15 +1,15 @@
\section{Built-in Module \sectcode{termios}} \section{Built-in Module \sectcode{termios}}
\label{module-termios} \label{module-termios}
\bimodindex{termios} \bimodindex{termios}
\indexii{Posix}{I/O control} \indexii{\POSIX{}}{I/O control}
\indexii{tty}{I/O control} \indexii{tty}{I/O control}
\renewcommand{\indexsubitem}{(in module termios)} \renewcommand{\indexsubitem}{(in module termios)}
This module provides an interface to the Posix calls for tty I/O This module provides an interface to the \POSIX{} calls for tty I/O
control. For a complete description of these calls, see the Posix or control. For a complete description of these calls, see the \POSIX{} or
\UNIX{} manual pages. It is only available for those \UNIX{} versions \UNIX{} manual pages. It is only available for those \UNIX{} versions
that support Posix \code{termios} style tty I/O control (and then that support \POSIX{} \code{termios} style tty I/O control (and then
only if configured at installation time). only if configured at installation time).
All functions in this module take a file descriptor \var{fd} as their All functions in this module take a file descriptor \var{fd} as their
@ -94,13 +94,13 @@ def getpass(prompt = "Password: "):
% %
\section{Standard Module \sectcode{TERMIOS}} \section{Standard Module \sectcode{TERMIOS}}
\stmodindex{TERMIOS} \stmodindex{TERMIOS}
\indexii{Posix}{I/O control} \indexii{\POSIX{}}{I/O control}
\indexii{tty}{I/O control} \indexii{tty}{I/O control}
\renewcommand{\indexsubitem}{(in module TERMIOS)} \renewcommand{\indexsubitem}{(in module TERMIOS)}
This module defines the symbolic constants required to use the This module defines the symbolic constants required to use the
\code{termios} module (see the previous section). See the Posix or \code{termios} module (see the previous section). See the \POSIX{} or
\UNIX{} manual pages (or the source) for a list of those constants. \UNIX{} manual pages (or the source) for a list of those constants.
\refbimodindex{termios} \refbimodindex{termios}

View file

@ -13,7 +13,7 @@ semaphores}) are provided.
\index{semaphores, binary} \index{semaphores, binary}
The module is optional. It is supported on Windows NT and '95, SGI The module is optional. It is supported on Windows NT and '95, SGI
IRIX, Solaris 2.x, as well as on systems that have a POSIX thread IRIX, Solaris 2.x, as well as on systems that have a \POSIX{} thread
(a.k.a. ``pthread'') implementation. (a.k.a. ``pthread'') implementation.
\index{pthreads} \index{pthreads}
\indexii{threads}{posix} \indexii{threads}{posix}

View file

@ -7,10 +7,10 @@ some or many variants of it. Here's an overview:
\begin{description} \begin{description}
\item[posix] \item[posix]
--- The most common Posix system calls (normally used via module \code{os}). --- The most common \POSIX{} system calls (normally used via module \code{os}).
\item[posixpath] \item[posixpath]
--- Common Posix pathname manipulations (normally used via \code{os.path}). --- Common \POSIX{} pathname manipulations (normally used via \code{os.path}).
\item[pwd] \item[pwd]
--- The password database (\code{getpwnam()} and friends). --- The password database (\code{getpwnam()} and friends).
@ -28,7 +28,7 @@ some or many variants of it. Here's an overview:
--- GNU's reinterpretation of dbm. --- GNU's reinterpretation of dbm.
\item[termios] \item[termios]
--- Posix style tty control. --- \POSIX{} style tty control.
\item[TERMIOS] \item[TERMIOS]
--- The symbolic constants required to use the \code{termios} module. --- The symbolic constants required to use the \code{termios} module.

View file

@ -119,7 +119,7 @@ Returns the standard info string of the object.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{tod_gettime}{} \begin{funcdesc}{tod_gettime}{}
Returns the time (in seconds since the Epoch, in UCT, as for POSIX) from Returns the time (in seconds since the Epoch, in UCT, as for \POSIX{}) from
a time server. a time server.
\end{funcdesc} \end{funcdesc}

View file

@ -3,9 +3,9 @@
\label{module-locale} \label{module-locale}
The \code{locale} module opens access to the POSIX locale database and The \code{locale} module opens access to the \POSIX{} locale database
functionality. The POSIX locale mechanism allows applications to and functionality. The \POSIX{} locale mechanism allows applications
integrate certain cultural aspects into an applications, without to integrate certain cultural aspects into an applications, without
requiring the programmer to know all the specifics of each country requiring the programmer to know all the specifics of each country
where the software is executed. where the software is executed.

View file

@ -32,7 +32,7 @@ Group comp.lang.python has 59 articles, range 3742 to 3803
3798 Re: a few questions about the Mac implementation 3798 Re: a few questions about the Mac implementation
3799 Re: PROPOSAL: A Generic Python Object Interface for Python C Modules 3799 Re: PROPOSAL: A Generic Python Object Interface for Python C Modules
3802 Re: executable python scripts 3802 Re: executable python scripts
3803 Re: POSIX wait and SIGCHLD 3803 Re: \POSIX{} wait and SIGCHLD
>>> s.quit() >>> s.quit()
'205 news.cwi.nl closing connection. Goodbye.' '205 news.cwi.nl closing connection. Goodbye.'
>>> >>>

View file

@ -13,7 +13,7 @@ exports the same functions and data as found there. The design of all
Python's built-in OS dependent modules is such that as long as the same Python's built-in OS dependent modules is such that as long as the same
functionality is available, it uses the same interface; e.g., the functionality is available, it uses the same interface; e.g., the
function \code{os.stat(\var{file})} returns stat info about a \var{file} in a function \code{os.stat(\var{file})} returns stat info about a \var{file} in a
format compatible with the POSIX interface. format compatible with the \POSIX{} interface.
Extensions peculiar to a particular OS are also available through the Extensions peculiar to a particular OS are also available through the
\code{os} module, but using them is of course a threat to portability! \code{os} module, but using them is of course a threat to portability!
@ -43,20 +43,20 @@ more portable than \code{posixpath.split(\var{file})}.
\begin{datadesc}{curdir} \begin{datadesc}{curdir}
The constant string used by the OS to refer to the current directory, The constant string used by the OS to refer to the current directory,
e.g. \code{'.'} for POSIX or \code{':'} for the Mac. e.g. \code{'.'} for \POSIX{} or \code{':'} for the Mac.
\end{datadesc} \end{datadesc}
\begin{datadesc}{pardir} \begin{datadesc}{pardir}
The constant string used by the OS to refer to the parent directory, The constant string used by the OS to refer to the parent directory,
e.g. \code{'..'} for POSIX or \code{'::'} for the Mac. e.g. \code{'..'} for \POSIX{} or \code{'::'} for the Mac.
\end{datadesc} \end{datadesc}
\begin{datadesc}{sep} \begin{datadesc}{sep}
The character used by the OS to separate pathname components, The character used by the OS to separate pathname components,
e.g. \code{'/'} for POSIX or \code{':'} for the Mac. Note that knowing this e.g. \code{'/'} for \POSIX{} or \code{':'} for the Mac. Note that
is not sufficient to be able to parse or concatenate pathnames---better knowing this is not sufficient to be able to parse or concatenate
use \code{os.path.split()} and \code{os.path.join()}---but it is pathnames --- better use \code{os.path.split()} and
occasionally useful. \code{os.path.join()}---but it is occasionally useful.
\end{datadesc} \end{datadesc}
\begin{datadesc}{altsep} \begin{datadesc}{altsep}
@ -67,7 +67,7 @@ or \code{None} if only one separator character exists. This is set to
\begin{datadesc}{pathsep} \begin{datadesc}{pathsep}
The character conventionally used by the OS to separate search patch The character conventionally used by the OS to separate search patch
components (as in \code{\$PATH}), e.g.\ \code{':'} for POSIX or components (as in \code{\$PATH}), e.g.\ \code{':'} for \POSIX{} or
\code{';'} for MS-DOS. \code{';'} for MS-DOS.
\end{datadesc} \end{datadesc}

View file

@ -3,7 +3,7 @@
\bimodindex{posix} \bimodindex{posix}
This module provides access to operating system functionality that is This module provides access to operating system functionality that is
standardized by the C Standard and the POSIX standard (a thinly disguised standardized by the C Standard and the \POSIX{} standard (a thinly disguised
\UNIX{} interface). \UNIX{} interface).
\strong{Do not import this module directly.} Instead, import the \strong{Do not import this module directly.} Instead, import the
@ -19,7 +19,7 @@ when an entry is \code{os.environ} is changed.
\refstmodindex{os} \refstmodindex{os}
The descriptions below are very terse; refer to the corresponding The descriptions below are very terse; refer to the corresponding
\UNIX{} manual (or POSIX documentation) entry for more information. \UNIX{} manual (or \POSIX{} documentation) entry for more information.
Arguments called \var{path} refer to a pathname given as a string. Arguments called \var{path} refer to a pathname given as a string.
Errors are reported as exceptions; the usual exceptions are given Errors are reported as exceptions; the usual exceptions are given
@ -52,8 +52,8 @@ a mapping object that behaves almost like a dictionary but invokes
\renewcommand{\indexsubitem}{(exception in module posix)} \renewcommand{\indexsubitem}{(exception in module posix)}
\begin{excdesc}{error} \begin{excdesc}{error}
This exception is raised when a POSIX function returns a This exception is raised when a \POSIX{} function returns a
POSIX-related error (e.g., not for illegal argument types). Its \POSIX{}-related error (e.g., not for illegal argument types). Its
string value is \code{'posix.error'}. The accompanying value is a string value is \code{'posix.error'}. The accompanying value is a
pair containing the numeric error code from \code{errno} and the pair containing the numeric error code from \code{errno} and the
corresponding string, as would be printed by the C function corresponding string, as would be printed by the C function
@ -214,7 +214,7 @@ without symbolic links, this is identical to \code{posix.stat()}.)
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{mkfifo}{path\optional{\, mode}} \begin{funcdesc}{mkfifo}{path\optional{\, mode}}
Create a FIFO (a POSIX named pipe) named \var{path} with numeric mode Create a FIFO (a \POSIX{} named pipe) named \var{path} with numeric mode
\var{mode}. The default \var{mode} is 0666 (octal). The current \var{mode}. The default \var{mode} is 0666 (octal). The current
umask value is first masked out from the mode. umask value is first masked out from the mode.
(Not on MS-DOS.) (Not on MS-DOS.)

View file

@ -2,7 +2,7 @@
\label{module-posixpath} \label{module-posixpath}
\stmodindex{posixpath} \stmodindex{posixpath}
This module implements some useful functions on POSIX pathnames. This module implements some useful functions on \POSIX{} pathnames.
\strong{Do not import this module directly.} Instead, import the \strong{Do not import this module directly.} Instead, import the
module \code{os} and use \code{os.path}. module \code{os} and use \code{os.path}.
@ -78,7 +78,7 @@ file system where a different file system has been mounted. The
function checks whether \var{p}'s parent, \file{\var{p}/..}, is on a function checks whether \var{p}'s parent, \file{\var{p}/..}, is on a
different device than \var{p}, or whether \file{\var{p}/..} and different device than \var{p}, or whether \file{\var{p}/..} and
\var{p} point to the same i-node on the same device --- this should \var{p} point to the same i-node on the same device --- this should
detect mount points for all \UNIX{} and POSIX variants. detect mount points for all \UNIX{} and \POSIX{} variants.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{join}{p\optional{\, q\optional{\, ...}}} \begin{funcdesc}{join}{p\optional{\, q\optional{\, ...}}}

View file

@ -1,15 +1,15 @@
\section{Built-in Module \sectcode{termios}} \section{Built-in Module \sectcode{termios}}
\label{module-termios} \label{module-termios}
\bimodindex{termios} \bimodindex{termios}
\indexii{Posix}{I/O control} \indexii{\POSIX{}}{I/O control}
\indexii{tty}{I/O control} \indexii{tty}{I/O control}
\renewcommand{\indexsubitem}{(in module termios)} \renewcommand{\indexsubitem}{(in module termios)}
This module provides an interface to the Posix calls for tty I/O This module provides an interface to the \POSIX{} calls for tty I/O
control. For a complete description of these calls, see the Posix or control. For a complete description of these calls, see the \POSIX{} or
\UNIX{} manual pages. It is only available for those \UNIX{} versions \UNIX{} manual pages. It is only available for those \UNIX{} versions
that support Posix \code{termios} style tty I/O control (and then that support \POSIX{} \code{termios} style tty I/O control (and then
only if configured at installation time). only if configured at installation time).
All functions in this module take a file descriptor \var{fd} as their All functions in this module take a file descriptor \var{fd} as their
@ -94,13 +94,13 @@ def getpass(prompt = "Password: "):
% %
\section{Standard Module \sectcode{TERMIOS}} \section{Standard Module \sectcode{TERMIOS}}
\stmodindex{TERMIOS} \stmodindex{TERMIOS}
\indexii{Posix}{I/O control} \indexii{\POSIX{}}{I/O control}
\indexii{tty}{I/O control} \indexii{tty}{I/O control}
\renewcommand{\indexsubitem}{(in module TERMIOS)} \renewcommand{\indexsubitem}{(in module TERMIOS)}
This module defines the symbolic constants required to use the This module defines the symbolic constants required to use the
\code{termios} module (see the previous section). See the Posix or \code{termios} module (see the previous section). See the \POSIX{} or
\UNIX{} manual pages (or the source) for a list of those constants. \UNIX{} manual pages (or the source) for a list of those constants.
\refbimodindex{termios} \refbimodindex{termios}

View file

@ -13,7 +13,7 @@ semaphores}) are provided.
\index{semaphores, binary} \index{semaphores, binary}
The module is optional. It is supported on Windows NT and '95, SGI The module is optional. It is supported on Windows NT and '95, SGI
IRIX, Solaris 2.x, as well as on systems that have a POSIX thread IRIX, Solaris 2.x, as well as on systems that have a \POSIX{} thread
(a.k.a. ``pthread'') implementation. (a.k.a. ``pthread'') implementation.
\index{pthreads} \index{pthreads}
\indexii{threads}{posix} \indexii{threads}{posix}

View file

@ -7,10 +7,10 @@ some or many variants of it. Here's an overview:
\begin{description} \begin{description}
\item[posix] \item[posix]
--- The most common Posix system calls (normally used via module \code{os}). --- The most common \POSIX{} system calls (normally used via module \code{os}).
\item[posixpath] \item[posixpath]
--- Common Posix pathname manipulations (normally used via \code{os.path}). --- Common \POSIX{} pathname manipulations (normally used via \code{os.path}).
\item[pwd] \item[pwd]
--- The password database (\code{getpwnam()} and friends). --- The password database (\code{getpwnam()} and friends).
@ -28,7 +28,7 @@ some or many variants of it. Here's an overview:
--- GNU's reinterpretation of dbm. --- GNU's reinterpretation of dbm.
\item[termios] \item[termios]
--- Posix style tty control. --- \POSIX{} style tty control.
\item[TERMIOS] \item[TERMIOS]
--- The symbolic constants required to use the \code{termios} module. --- The symbolic constants required to use the \code{termios} module.