texlive[65369]

Tue Dec 27 00:52:25 CET 2022

Revision: 65369
          http://tug.org/svn/texlive?view=revision&revision=65369
Author:   karl
Date:     2022-12-27 00:52:24 +0100 (Tue, 27 Dec 2022)
Log Message:
-----------
(sysfontconfig): update to something closer to
current reality. See thread both before and after:
https://tug.org/pipermail/tex-live/2022-December/048733.html

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex

Modified: trunk/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
===================================================================

--- trunk/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex	2022-12-26 21:08:33 UTC (rev 65368)
+++ trunk/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex	2022-12-26 23:52:24 UTC (rev 65369)
@@ -17,7 +17,7 @@
         \url{https://tug.org/texlive/}
        }
 
-\date{August 2022}
+\date{December 2022}
 
 \begin{document}
 \maketitle
@@ -473,8 +473,8 @@
 
 \item[Net installer, Windows .exe:] Download from \CTAN{} as above,
 and double-click. This starts up a first-stage installer and unpacker;
-see figure~\ref{fig:nsis}. It gives two choices: ``Install''
-and``Unpack only''.
+see figure~\ref{fig:nsis}. It gives two choices: `Install'
+and `Unpack only'.
 
 \item [\TeX{} Collection \DVD:] go to the \DVD's \dirname{texlive}
 subdirectory. Under Windows, the installer normally starts automatically
@@ -1124,24 +1124,32 @@
 \label{sec:font-conf-sys}
 
 \XeTeX\ and Lua\TeX\ can use any font installed on the system, not just
-those in the \TeX\ trees.  They do these via related but not identical
-methods.
+those in the \TeX\ trees. Such system fonts (not part of \TL) are
+usually accessed by giving the font name, e.g., `\code{Liberation
+Serif}', although the system filename can also be used.
 
-On Windows, fonts shipped with \TL\ are automatically made available to
-\XeTeX\ by font name.  On \MacOSX, supporting font name lookups requires
-additional steps; please see the Mac\TeX\ web pages
-(\url{https://tug.org/mactex}).  For other Unix systems, the procedure to
-be able to find the fonts shipped with \TL\ via font name follows.
+A related issue is making the fonts from the \TL\ distribution available
+as system fonts, which will in turn make them available by font name.
 
-To facilitate this, when the \pkgname{xetex} package is installed
-(either at initial installation or later), the necessary configuration
-file is created in
-\filename{TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf}.
+For Lua\TeX: for access by font name, nothing special need be done. All
+fonts in \TL\ should be equally accessible by either font name or
+filename to Lua\TeX, via the \pkgname{luaotfload} package, which
+supports both \LaTeX\ and plain \TeX. The \pkgname{luaotfload} font name
+index may need to be rebuilt for new fonts; this is triggered
+automatically when trying to load a font which isn't known yet.
 
-To set up the \TL{} fonts for system-wide use (assuming you have
-suitable privileges), proceed as follows:
+For \XeTeX: on Windows, fonts shipped with \TL\ are automatically made
+available (by running the \cmdname{fc-cache} program provided for
+Windows as part of \TL). For the Mac, you'll need to consult other
+documentation. For Unix systems other than \MacOSX, the procedure is the
+following.
+
+When the \pkgname{xetex} package is installed (either at initial
+installation or later), the necessary configuration file is created in
+\filename{TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf}. To make the
+\TL\ fonts available as system fonts,
 \begin{enumerate*}
-\item Copy the \filename{texlive-fontconfig.conf} file to
+\item Copy that \filename{texlive-fontconfig.conf} file to (typically)
 \dirname{/etc/fonts/conf.d/09-texlive.conf}.
 \item Run \Ucom{fc-cache -fsv}.
 \end{enumerate*}
@@ -1150,14 +1158,16 @@
 or if you want to make the \TL{} fonts available to only one user,
 you can do the following:
 \begin{enumerate*}
-\item Copy the \filename{texlive-fontconfig.conf} file to
-      \filename{~/.fonts.conf}, where \filename{~} is your home directory.
+\item Copy the \filename{texlive-fontconfig.conf} file to (typically)
+      \filename{~/.fonts.conf.d/09-texlive.conf}, where \filename{~} is
+      your home directory.
 \item Run \Ucom{fc-cache -fv}.
 \end{enumerate*}
 
-You can run \code{fc-list} to see the names of the system fonts.  The
-incantation \code{fc-list : family style file spacing} (all arguments
-are literal strings) shows some generally interesting information.
+You can run \code{fc-list} to see the names of the available system
+fonts. The incantation \code{fc-list : family style file spacing} (all
+those arguments are literal strings) shows some generally interesting
+information.
 
 
 \subsubsection{\protect\ConTeXt{} Mark IV}
@@ -1792,11 +1802,11 @@
   \cmdname{unzip}, and the utilities from the \cmdname{poppler} suite
   (\cmdname{pdfinfo}, \cmdname{pdffonts}, \ldots).
 
-\item[fc-list, fc-cache, \ldots] The tools from the fontconfig library allow
-  \XeTeX{} to handle system fonts on Windows.  You can use
+\item[fc-list, fc-cache, \ldots] The tools from the \pkgname{fontconfig}
+  library allow \XeTeX{} to find system fonts on Windows. You can use
   \prog{fc-list} to determine the font names to pass to \XeTeX's
-  extended \cs{font} command. If necessary, run \prog{fc-cache}
-  first to update font information.
+  extended \cs{font} command. If necessary, run \prog{fc-cache} first to
+  update font information.
 
 \end{description}
 
@@ -2761,7 +2771,7 @@
 abilities.
 
 \item Hartmut Henkel, for significant development contributions to
-pdf\TeX\, Lua\TeX, and more.
+pdf\TeX, Lua\TeX, and more.
 
 \item Shunshaku Hirata, for much original and continuing work on DVIPDFM$x$.
 
@@ -3048,7 +3058,7 @@
 considered printable and not translated.  The exceptions are plain \TeX\
 (only 32--126 printable), \ConTeXt\ (0--255 printable), and the
 \OMEGA-related formats.  This default behavior is almost the same as in
-\TL\,2003, but it's implemented more cleanly, with more possibilities
+\TL\ 2003, but it's implemented more cleanly, with more possibilities
 for customization.  See \CDref{texmf-dist/doc/web2c/web2c.html\#TCX-files}
 {\texttt{texmf-dist/doc/web2c/web2c.html\#TCX-files}}.
 (By the way, with Unicode input, \TeX\ may output partial character

