diff options
author | Karl Berry <karl@freefriends.org> | 2019-08-14 17:09:49 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2019-08-14 17:09:49 +0000 |
commit | f2f886b0ea249d05bc13639975c9a84613b9a387 (patch) | |
tree | 8010dfc44ccec855a36e8ee7f9010997c5e7b7c7 /Master | |
parent | a4b43152d5703323ccca16c553b1f4f49a24aadf (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')
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex | 24 |
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 |