diff options
author | Will Robertson <wspr81@gmail.com> | 2010-05-20 18:48:36 +0930 |
---|---|---|
committer | Will Robertson <wspr81@gmail.com> | 2010-05-20 18:50:34 +0930 |
commit | abf841c406a2971e53d04b02d07e6863df0636e3 (patch) | |
tree | af7188608922c5d87b09ce1378105505beb47fee | |
parent | 3e48b77d3e17d9efd573b2027656f75acc1983d3 (diff) | |
download | luaotfload-abf841c406a2971e53d04b02d07e6863df0636e3.tar.gz |
add a mkluatexfontdb section to the docs
closes #5
-rw-r--r-- | luaotfload.dtx | 45 |
1 files changed, 37 insertions, 8 deletions
diff --git a/luaotfload.dtx b/luaotfload.dtx index d3432be..6627094 100644 --- a/luaotfload.dtx +++ b/luaotfload.dtx @@ -154,9 +154,7 @@ and the derived files % % \tableofcontents % -% \section{Documentation} -% -% \subsection{Introduction} +% \section{Introduction} % % Font management and installation has always been painful with \TeX. % A lot of files are needed for one font (tfm, pfb, map, fd, vf), and as @@ -176,7 +174,7 @@ and the derived files % \TeX\ processing; for instance, we can improve the font loading system, and % text procession, which what this package is about. % -% \subsection{Loading fonts} +% \section{Loading fonts} % % \textsf{luaotfload} supports an extended font loading syntax which looks % like: @@ -200,8 +198,7 @@ and the derived files % % Accessing fonts by fontname allows loading system installed fonts as well as % \textsc{texmf} ones, and requires a font names database that must be -% pre-generated using the bundled |mkluatexfontdb.lua| script.^^A -% \footnote{Run |mkluatexfontdb.lua --help| for help and usage information} +% pre-generated; see Section~\ref{sec:fontdb} for more information. % % \paragraph{Font name} % @@ -306,7 +303,39 @@ and the derived files % (For \XeTeX\ users: these last two are the equivalent of writing % \texttt{mapping=text-tex} using \XeTeX's input remapping feature.) % -% \subsection{Required \ConTeXt\ files} +% +% \section{Maintaining the font database} +% \label{sec:fontdb} +% +% As introduced in the previous section, \textsf{luaotfload} uses a database +% to keep track of fonts available to \LuaTeX. Using this database, fonts can +% be loaded by font name as well as filename. +% +% This font database must be maintained as you add (and remove) fonts to your +% system. To update the database, run the script |mkluatexfontdb.lua| that is +% included with this package. If you have not run it before, it may take quite +% some time to process every font on your computer. Subsequent runs to update +% the database will be quite fast, however. +% +% In \TeX~Live~2010, there will be a button in the \TeX~Live package manager +% to run |mkluatexfontdb.lua|. +% +% The script will parse standard places for fonts in your system to build the +% font database. On Windows and Linus, it will use |fc-list| to find the +% fonts; on Mac~OS~X, it will search in the standard font locations +% |~/Library/Fonts|, |/Library/Fonts|, |/System/Library/Fonts|, and +% |/Network/Library/Fonts|, +% +% If you do not wish the script to locate fonts automatically but would rather +% specify the exact locations in which to find your fonts, set the |OSFONTDIR| +% environment variable instead. When this variable is set, the script will +% only search in those directories. +% +% |mkluatexfontdb.lua --help| provides a brief summary of the functionality of +% the script and includes some advanced options that we have not mentioned +% here. +% +% \section{Required \ConTeXt\ files} % % This package is a wrapper for several files taken from the \ConTeXt\ macro % package. The philosophy is to let \ConTeXt\ do all the implementation and @@ -354,7 +383,7 @@ and the derived files % \end{itemize*} % \end{multicols} % -% \subsection{Troubleshooting} +% \section{Troubleshooting} % % If you encounter problems with some fonts, please first update to the latest % version of this package before reporting a bug, as this package is under |