texlive[51878] Master/texmf-dist/doc/texlive/texlive-en: mention

[commits+karl at tug.org]

Revision: 51878
          http://tug.org/svn/texlive?view=revision&revision=51878
Author:   karl
Date:     2019-08-14 19:09:49 +0200 (Wed, 14 Aug 2019)
Log Message:
-----------
mention environment variables for user settings; no extra space after \samp

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty
    trunk/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex

Modified: trunk/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty
===================================================================
--- trunk/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty	2019-08-13 23:53:26 UTC (rev 51877)
+++ trunk/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty	2019-08-14 17:09:49 UTC (rev 51878)
@@ -3,7 +3,7 @@
 % Public domain.
 %
 \NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesPackage{tex-live}[2015/04/28 TeX Live Guide style]
+\ProvidesPackage{tex-live}[2019/08/14 TeX Live Guide style]
 %
 % colortbl and other packages otherwise make the default be letter, it seems.
 \RequirePackage[a4paper,hscale=0.75,lines=60,vmarginratio=10:8]{geometry}
@@ -108,7 +108,7 @@
 \newcommand{\code}[1]{\texttt{#1}}
 \newcommand{\file}[1]{\texttt{#1}}
 \newcommand{\prog}[1]{\textsf{#1}}% same as \cmdname
-\newcommand{\samp}[1]{`\texttt{#1}'}
+\newcommand{\samp}[1]{`\texttt{#1}'\@}
 \newcommand{\var}[1]{{\sl #1}}% not \textsl, for roman not typewriter slanted.
 \newcommand{\ttvar}[1]{\texttt{\var{#1}}}
 %

Modified: trunk/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
===================================================================
--- trunk/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex	2019-08-13 23:53:26 UTC (rev 51877)
+++ trunk/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex	2019-08-14 17:09:49 UTC (rev 51878)
@@ -17,7 +17,7 @@
         \url{https://tug.org/texlive/}
        }
 
-\date{April 2019}
+\date{August 2019}
 
 \begin{document}
 \maketitle
@@ -1953,9 +1953,10 @@
 \subsubsection{Config files}
 
 \KPS{} reads \emph{runtime configuration files} named \file{texmf.cnf}
-for search path and other definitions.  The search path used to look
-for these files is named \envname{TEXMFCNF}, but we do not recommend
-setting this (or any) environment variable.
+for search path and other definitions.  The search path
+\envname{TEXMFCNF} is used to look for these files, but we do not
+recommend setting this (or any) environment variable to override the
+system directories.
 
 Instead, normal installation results in a file
 \file{.../2019/texmf.cnf}.  If you must make changes to the defaults
@@ -1964,6 +1965,18 @@
 You should not edit this latter file, as your changes will be lost when
 the distributed version is updated.
 
+As an aside, if you merely wish to add a personal directory to a
+particular search path, setting an environment variable is a reasonable
+method:
+\begin{verbatim}
+  TEXINPUTS=.:/my/macro/dir:
+\end{verbatim}
+To keep the setting maintainable and portable over the years, use a
+trailing \samp{:} (\samp{;} on Windows) to insert the system paths,
+instead of trying to write them all out explicitly (see
+section~\ref{sec:default-expansion}). Another option is to use the
+\envname{TEXMFHOME} tree (see section~\ref{sec:directories}).
+
 \emph{All} \file{texmf.cnf} files in the search path will be read and
 definitions in earlier files override those in later files.  For
 example, with a search path of \verb|.:$TEXMF|, values from
@@ -1984,6 +1997,9 @@
   \var{variable}[.\var{progname}] [=] \var{value}
 \end{alltt}%
   where the \samp{=} and surrounding whitespace are optional.
+  (But if \var{value} begins with \samp{.}, it is simplest to use the
+  \samp{=} to avoid the period being interpreted as the program name
+  qualifier.)
 \item
   The \ttvar{variable} name may contain any character other
   than whitespace, \samp{=}, or \samp{.}, but sticking to