mirror of
https://github.com/python/cpython.git
synced 2025-07-23 11:15:24 +00:00
Logical markup.
This commit is contained in:
parent
a44d74086c
commit
92f31f1260
2 changed files with 22 additions and 24 deletions
|
@ -4,7 +4,6 @@
|
|||
\indexii{temporary}{file name}
|
||||
\indexii{temporary}{file}
|
||||
|
||||
\setindexsubitem{(in module tempfile)}
|
||||
|
||||
This module generates temporary file names. It is not \UNIX{} specific,
|
||||
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
|
||||
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}
|
||||
When set to a value other than \code{None}, this variable defines the
|
||||
directory in which filenames returned by \code{mktemp()} reside. The
|
||||
default is taken from the environment variable \code{TMPDIR}; if this
|
||||
is not set, either \file{/usr/tmp} is used (on \UNIX{}), or the current
|
||||
working directory (all other systems). No check is made to see
|
||||
whether its value is valid.
|
||||
directory in which filenames returned by \function{mktemp()} reside.
|
||||
The default is taken from the environment variable \code{TMPDIR}; if
|
||||
this is not set, either \file{/usr/tmp} is used (on \UNIX{}), or the
|
||||
current working directory (all other systems). No check is made to
|
||||
see whether its value is valid.
|
||||
\end{datadesc}
|
||||
\ttindex{TMPDIR}
|
||||
|
||||
\begin{datadesc}{template}
|
||||
When set to a value other than \code{None}, this variable defines the
|
||||
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
|
||||
\var{pid} is the current process ID (on \UNIX{}), or \file{tmp} (all
|
||||
other systems).
|
||||
\end{datadesc}
|
||||
|
||||
Warning: if a \UNIX{} process uses \code{mktemp()}, then calls
|
||||
\code{fork()} and both parent and child continue to use
|
||||
\code{mktemp()}, the processes will generate conflicting temporary
|
||||
\strong{Warning:} if a \UNIX{} process uses \code{mktemp()}, then
|
||||
calls \function{fork()} and both parent and child continue to use
|
||||
\function{mktemp()}, the processes will generate conflicting temporary
|
||||
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{mktemp()}.
|
||||
to \function{mktemp()}.
|
||||
|
|
|
@ -4,7 +4,6 @@
|
|||
\indexii{temporary}{file name}
|
||||
\indexii{temporary}{file}
|
||||
|
||||
\setindexsubitem{(in module tempfile)}
|
||||
|
||||
This module generates temporary file names. It is not \UNIX{} specific,
|
||||
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
|
||||
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}
|
||||
When set to a value other than \code{None}, this variable defines the
|
||||
directory in which filenames returned by \code{mktemp()} reside. The
|
||||
default is taken from the environment variable \code{TMPDIR}; if this
|
||||
is not set, either \file{/usr/tmp} is used (on \UNIX{}), or the current
|
||||
working directory (all other systems). No check is made to see
|
||||
whether its value is valid.
|
||||
directory in which filenames returned by \function{mktemp()} reside.
|
||||
The default is taken from the environment variable \code{TMPDIR}; if
|
||||
this is not set, either \file{/usr/tmp} is used (on \UNIX{}), or the
|
||||
current working directory (all other systems). No check is made to
|
||||
see whether its value is valid.
|
||||
\end{datadesc}
|
||||
\ttindex{TMPDIR}
|
||||
|
||||
\begin{datadesc}{template}
|
||||
When set to a value other than \code{None}, this variable defines the
|
||||
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
|
||||
\var{pid} is the current process ID (on \UNIX{}), or \file{tmp} (all
|
||||
other systems).
|
||||
\end{datadesc}
|
||||
|
||||
Warning: if a \UNIX{} process uses \code{mktemp()}, then calls
|
||||
\code{fork()} and both parent and child continue to use
|
||||
\code{mktemp()}, the processes will generate conflicting temporary
|
||||
\strong{Warning:} if a \UNIX{} process uses \code{mktemp()}, then
|
||||
calls \function{fork()} and both parent and child continue to use
|
||||
\function{mktemp()}, the processes will generate conflicting temporary
|
||||
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{mktemp()}.
|
||||
to \function{mktemp()}.
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue