From 6bfc0e71a5131b53f895ee5daba4dbe08e62ee65 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 22 Mar 2008 17:27:36 +0000 Subject: some documentation of ~ git-svn-id: svn://tug.org/texlive/trunk@7073 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-doc/source/english/texlive-en/live.tex | 34 +++++++++++++--------- 1 file changed, 21 insertions(+), 13 deletions(-) (limited to 'Master/texmf-doc') 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} -- cgit v1.2.3