summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/texlive
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-08-14 17:09:49 +0000
committerKarl Berry <karl@freefriends.org>2019-08-14 17:09:49 +0000
commitf2f886b0ea249d05bc13639975c9a84613b9a387 (patch)
tree8010dfc44ccec855a36e8ee7f9010997c5e7b7c7 /Master/texmf-dist/doc/texlive
parenta4b43152d5703323ccca16c553b1f4f49a24aadf (diff)
mention environment variables for user settings; no extra space after \samp
git-svn-id: svn://tug.org/texlive/trunk@51878 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/texlive')
-rw-r--r--Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty4
-rw-r--r--Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex24
2 files changed, 22 insertions, 6 deletions
diff --git a/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty b/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty
index 0a49f6813aa..a8ebccf1694 100644
--- a/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty
+++ b/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty
@@ -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}}}
%
diff --git a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
index e8d5fa2094a..fad2f54510e 100644
--- a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
+++ b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
@@ -17,7 +17,7 @@
\url{https://tug.org/texlive/}
}
-\date{April 2019}
+\date{August 2019}
\begin{document}
\maketitle
@@ -1953,9 +1953,10 @@ page~\pageref{sec:debugging}).
\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 @@ configuration file is in \file{.../2019/texmf-dist/web2c/texmf.cnf}.
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 @@ example, with a search path of \verb|.:$TEXMF|, values from
\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