mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-07-24 03:35:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Logical markup.

Browse source
This commit is contained in:
Fred Drake 1998-03-10 03:38:31 +00:00
parent a44d74086c
commit 92f31f1260
2 changed files with 22 additions and 24 deletions
Download patch file Download diff file Expand all files Collapse all files

23
Doc/lib/libtempfile.tex
View file

@ -4,7 +4,6 @@
\indexii{temporary}{file name} \indexii{temporary}{file name}
\indexii{temporary}{file} \indexii{temporary}{file}
\setindexsubitem{(in module tempfile)}
This module generates temporary file names. It is not \UNIX{} specific, This module generates temporary file names. It is not \UNIX{} specific,
but it may require some help on non-\UNIX{} systems. but it may require some help on non-\UNIX{} systems.
@ -22,30 +21,30 @@ will return the same filename.
The module uses two global variables that tell it how to construct a The module uses two global variables that tell it how to construct a
temporary name. The caller may assign values to them; by default they temporary name. The caller may assign values to them; by default they
are initialized at the first call to \code{mktemp()}. are initialized at the first call to \function{mktemp()}.
\begin{datadesc}{tempdir} \begin{datadesc}{tempdir}
When set to a value other than \code{None}, this variable defines the When set to a value other than \code{None}, this variable defines the
directory in which filenames returned by \code{mktemp()} reside. The directory in which filenames returned by \function{mktemp()} reside.
default is taken from the environment variable \code{TMPDIR}; if this The default is taken from the environment variable \code{TMPDIR}; if
is not set, either \file{/usr/tmp} is used (on \UNIX{}), or the current this is not set, either \file{/usr/tmp} is used (on \UNIX{}), or the
working directory (all other systems). No check is made to see current working directory (all other systems). No check is made to
whether its value is valid. see whether its value is valid.
\end{datadesc} \end{datadesc}
\ttindex{TMPDIR} \ttindex{TMPDIR}
\begin{datadesc}{template} \begin{datadesc}{template}
When set to a value other than \code{None}, this variable defines the When set to a value other than \code{None}, this variable defines the
prefix of the final component of the filenames returned by prefix of the final component of the filenames returned by
\code{mktemp()}. A string of decimal digits is added to generate \function{mktemp()}. A string of decimal digits is added to generate
unique filenames. The default is either \file{@\var{pid}.} where unique filenames. The default is either \file{@\var{pid}.} where
\var{pid} is the current process ID (on \UNIX{}), or \file{tmp} (all \var{pid} is the current process ID (on \UNIX{}), or \file{tmp} (all
other systems). other systems).
\end{datadesc} \end{datadesc}
Warning: if a \UNIX{} process uses \code{mktemp()}, then calls \strong{Warning:} if a \UNIX{} process uses \code{mktemp()}, then
\code{fork()} and both parent and child continue to use calls \function{fork()} and both parent and child continue to use
\code{mktemp()}, the processes will generate conflicting temporary \function{mktemp()}, the processes will generate conflicting temporary
names. To resolve this, the child process should assign \code{None} names. To resolve this, the child process should assign \code{None}
to \code{template}, to force recomputing the default on the next call to \code{template}, to force recomputing the default on the next call
to \code{mktemp()}. to \function{mktemp()}.

23
Doc/libtempfile.tex
View file

@ -4,7 +4,6 @@
\indexii{temporary}{file name} \indexii{temporary}{file name}
\indexii{temporary}{file} \indexii{temporary}{file}
\setindexsubitem{(in module tempfile)}
This module generates temporary file names. It is not \UNIX{} specific, This module generates temporary file names. It is not \UNIX{} specific,
but it may require some help on non-\UNIX{} systems. but it may require some help on non-\UNIX{} systems.
@ -22,30 +21,30 @@ will return the same filename.
The module uses two global variables that tell it how to construct a The module uses two global variables that tell it how to construct a
temporary name. The caller may assign values to them; by default they temporary name. The caller may assign values to them; by default they
are initialized at the first call to \code{mktemp()}. are initialized at the first call to \function{mktemp()}.
\begin{datadesc}{tempdir} \begin{datadesc}{tempdir}
When set to a value other than \code{None}, this variable defines the When set to a value other than \code{None}, this variable defines the
directory in which filenames returned by \code{mktemp()} reside. The directory in which filenames returned by \function{mktemp()} reside.
default is taken from the environment variable \code{TMPDIR}; if this The default is taken from the environment variable \code{TMPDIR}; if
is not set, either \file{/usr/tmp} is used (on \UNIX{}), or the current this is not set, either \file{/usr/tmp} is used (on \UNIX{}), or the
working directory (all other systems). No check is made to see current working directory (all other systems). No check is made to
whether its value is valid. see whether its value is valid.
\end{datadesc} \end{datadesc}
\ttindex{TMPDIR} \ttindex{TMPDIR}
\begin{datadesc}{template} \begin{datadesc}{template}
When set to a value other than \code{None}, this variable defines the When set to a value other than \code{None}, this variable defines the
prefix of the final component of the filenames returned by prefix of the final component of the filenames returned by
\code{mktemp()}. A string of decimal digits is added to generate \function{mktemp()}. A string of decimal digits is added to generate
unique filenames. The default is either \file{@\var{pid}.} where unique filenames. The default is either \file{@\var{pid}.} where
\var{pid} is the current process ID (on \UNIX{}), or \file{tmp} (all \var{pid} is the current process ID (on \UNIX{}), or \file{tmp} (all
other systems). other systems).
\end{datadesc} \end{datadesc}
Warning: if a \UNIX{} process uses \code{mktemp()}, then calls \strong{Warning:} if a \UNIX{} process uses \code{mktemp()}, then
\code{fork()} and both parent and child continue to use calls \function{fork()} and both parent and child continue to use
\code{mktemp()}, the processes will generate conflicting temporary \function{mktemp()}, the processes will generate conflicting temporary
names. To resolve this, the child process should assign \code{None} names. To resolve this, the child process should assign \code{None}
to \code{template}, to force recomputing the default on the next call to \code{template}, to force recomputing the default on the next call
to \code{mktemp()}. to \function{mktemp()}.