summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-03-22 17:27:36 +0000
committerKarl Berry <karl@freefriends.org>2008-03-22 17:27:36 +0000
commit6bfc0e71a5131b53f895ee5daba4dbe08e62ee65 (patch)
tree56b7fc1128873d0f0b89d67980fb6b9f26b893c5
parentd37171ba3b27520dc0cc1f0d9cd1191791c53e5e (diff)
some documentation of ~
git-svn-id: svn://tug.org/texlive/trunk@7073 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-doc/source/english/texlive-en/live.tex34
1 files changed, 21 insertions, 13 deletions
diff --git a/Master/texmf-doc/source/english/texlive-en/live.tex b/Master/texmf-doc/source/english/texlive-en/live.tex
index 855a037cc6f..044892ca4c5 100644
--- a/Master/texmf-doc/source/english/texlive-en/live.tex
+++ b/Master/texmf-doc/source/english/texlive-en/live.tex
@@ -683,8 +683,8 @@ collection.) In addition, installing a language collection will alter
the \filename{language.dat} configuration file controlling which
hyphenation patterns are loaded.
-\textbf{\optname{d} -- Installation directories}. Three directories can
-be changed here:
+\textbf{\optname{d} -- Installation directories}. The following
+directories can be changed here:
\label{text:instdir}
\begin{ttdescription}
@@ -693,26 +693,34 @@ everything else will be installed. The default value is
\dirname{/usr/local/texlive/2007}, and is often changed. We recommend
including the year in the name, to keep different releases of \TL{}
separate. (You may wish to make a version-independent name such
-\dirname{/usr/local/texlive} via a symbolic link, which you can then
+\dirname{/usr/local/texlive-cur} via a symbolic link, which you can then
update after testing the new release.)
Under \MacOSX, the usual frontends look for \TeX{} in
\dirname{/usr/local/teTeX}, so you may wish to install \TL{} there.
-\item [TEXMFLOCAL] This tree is where the \TeX{} system (not as part of
-the initial installation, but rather as time goes by) puts
-non-version-specific files, primarily fonts. The default value is
-\dirname{/usr/local/texlive/texmf-local}, independent of the current
-\TL{} release, because it's also the recommended location to put any
-local packages or configuration settings.
+If you use a \path|~| in this value, it is immediately expanded to your
+home directory (and this is reflected in the prompt). The expanded
+value is also used in the custom configuration files written by the
+installer.
+
+\item [TEXMFLOCAL] This tree is the recommended location to for any
+locally-created or installed packages or configuration files. The
+default value is \dirname{/usr/local/texlive/texmf-local}, independent
+of the current \TL{} release.
\item [TEXMFSYSVAR] This tree is where \cmdname{texconfig-sys} puts
files that \emph{are} version-specific. The default value is
\dirname{TEXDIR/texmf-var}, and there's generally no reason to change
-it. There is also \envname{TEXMFSYSCONFIG}, which is where
-\cmdname{texconfig} looks for modified configuration data. See
-section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig} for more
-information.
+it. See section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig} for
+more information.
+
+\item [TEXMFHOME] This tree is the recommended location for personal
+macro files or packages. The default value is \dirname{~/texmf}. In
+contrast to \dirname{TEXDIR}, here a \path|~| is preserved in the
+newly-written configuration files, since it usefully refers to the home
+directory of each individual running \TeX. It expands to
+\filename{$HOME} on Unix and \filename{%USERPROFILE%} on Windows.
\end{ttdescription}