[Cvs-cvs] Changes to ccvs/doc/cvs.texinfo

[Derek Robert Price]

Index: ccvs/doc/cvs.texinfo
diff -u ccvs/doc/cvs.texinfo:1.658 ccvs/doc/cvs.texinfo:1.659
--- ccvs/doc/cvs.texinfo:1.658  Tue Sep  6 00:46:11 2005
+++ ccvs/doc/cvs.texinfo        Tue Sep  6 04:11:24 2005
@@ -8310,16 +8310,39 @@
 programs; for compatibility this option is accepted,
 but it does nothing.
 
address@hidden TMPDIR, overriding
address@hidden Overriding TMPDIR
address@hidden TMPDIR, environment variable
address@hidden temporary file directory, set via command line
address@hidden temporary file directory, set via environment variable
address@hidden temporary file directory, set via config
address@hidden temporary files, location of
 @item -T @var{tempdir}
 Use @var{tempdir} as the directory where temporary files are
-located.  Overrides the setting of the @code{$TMPDIR} environment
-variable and any precompiled directory.  This parameter should be
-specified as an absolute pathname.
-(When running client/server, @samp{-T} affects only the local process;
+located.
+
+The @sc{cvs} client and server store temporary files in a temporary directory.
+The path to this temporary directory is set via, in order of precedence:
+
address@hidden @bullet
address@hidden
+The argument to the global @samp{-T} option.
+
address@hidden
+The value set for @code{TmpDir} in the config file (server only -
address@hidden).
+
address@hidden
+The contents of the @code{$TMPDIR} environment variable (@code{%TMPDIR%} on
+Windows - @pxref{Environment variables}).
+
address@hidden
+/tmp
+
address@hidden itemize
+
+Temporary directories should always be specified as an absolute pathname.
+When running a CVS client, @samp{-T} affects only the local process;
 specifying @samp{-T} for the client has no effect on the server and
-vice versa.)
+vice versa.
 
 @cindex CVSROOT, overriding
 @cindex Overriding CVSROOT
@@ -14701,14 +14724,13 @@
 substitution mode, lock revisions, unlock revisions, and
 replace the log message, use @samp{UserAdminOptions=klum}.
 
address@hidden temporary directory, in CVSROOT/config
address@hidden TmpDir, in CVSROOT/config
address@hidden temporary files, location of
address@hidden temporary directory, set in config
address@hidden TmpDir, in config
 @item address@hidden
-Specify @var{path} as the directory to create temporary files in.  This
-takes precedence over the @code{$TMPDIR} environment variable
-(@pxref{Environment variables}), but not the @samp{-T} global command line
-option (@pxref{Global options}).  This option first appeared with @sc{cvs}
-release 1.12.13.
+Specify @var{path} as the directory to create temporary files in.
address@hidden options} for more on setting the path to the temporary
+directory.  This option first appeared with @sc{cvs} release 1.12.13.
 
 @cindex format strings, config admin file
 @cindex config (admin file), updating legacy repositories
@@ -14815,7 +14837,8 @@
 @cindex Reference manual for variables
 
 This is a complete list of all environment variables
-that affect @sc{cvs}.
+that affect @sc{cvs} (Windows users, please bear with this list;
+$VAR is equivalent to %VAR% at the Windows command prompt).
 
 @table @code
 @cindex CVSIGNORE, environment variable
@@ -14978,34 +15001,11 @@
 command interpreter and defaults to @sc{cmd.exe}.
 
 @cindex TMPDIR, environment variable
address@hidden temporary file directory, set via environment variable
address@hidden temporary files, location of
 @item $TMPDIR
address@hidden TMP, environment variable
address@hidden $TMP
address@hidden TEMP, environment variable
address@hidden $TEMP
address@hidden Temporary files, location of
address@hidden This is quite nuts.  We don't talk about tempnam
address@hidden or mkstemp which we sometimes use.  The discussion
address@hidden of "Global options" is semi-incoherent.
address@hidden I'm not even sure those are the only inaccuracies.
address@hidden Furthermore, the conventions are
address@hidden pretty crazy and they should be simplified.
-Directory in which temporary files are located.
-The @sc{cvs} server uses
address@hidden  @xref{Global options}, for a
-description of how to specify this.
-Some parts of @sc{cvs} will always use @file{/tmp} (via
-the @code{tmpnam} function provided by the system).
-
-On Windows NT, @code{TMP} is used (via the @code{_tempnam}
-function provided by the system).
-
-The @code{patch} program which is used by the @sc{cvs}
-client uses @code{TMPDIR}, and if it is not set, uses
address@hidden/tmp} (at least with GNU patch 2.1).  Note that
-if your server and client are both running @sc{cvs}
-1.9.10 or later, @sc{cvs} will not invoke an external
address@hidden program.
+Directory in which temporary files are located.  @xref{Global options} for
+more on setting the temporary directory.
 
 @cindex CVS_PID, environment variable
 @item $CVS_PID