texlive[70299] Master/texmf-dist/doc/xetex/xetexref: xetexref

[commits+karl at tug.org]

Revision: 70299
          https://tug.org/svn/texlive?view=revision&revision=70299
Author:   karl
Date:     2024-03-01 22:38:53 +0100 (Fri, 01 Mar 2024)
Log Message:
-----------
xetexref (1mar24)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/xetex/xetexref/Makefile
    trunk/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.pdf
    trunk/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex

Modified: trunk/Master/texmf-dist/doc/xetex/xetexref/Makefile
===================================================================
--- trunk/Master/texmf-dist/doc/xetex/xetexref/Makefile	2024-03-01 21:38:43 UTC (rev 70298)
+++ trunk/Master/texmf-dist/doc/xetex/xetexref/Makefile	2024-03-01 21:38:53 UTC (rev 70299)
@@ -13,9 +13,8 @@
 	dw <$(doc) | grep -v ': a$$' || true
 	myspell $(doc)
 
-diff dif:
 reldir = /usr/local/texlive/dev/texmf-dist/doc/xetex/xetexref/
-diff dif:
+diff dif df:
 	-diff -u0 $(reldir)/xetex-reference.tex .
 
 pkg = xetexref
@@ -24,3 +23,4 @@
 	mkdir $(pkg)
 	ln -s ../Makefile ../README.txt ../$(doc) ../xetex-reference.pdf $(pkg)
 	zip -r $(pkg).zip $(pkg)
+	rm -rf $(pkg)

Modified: trunk/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex
===================================================================
--- trunk/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex	2024-03-01 21:38:43 UTC (rev 70298)
+++ trunk/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex	2024-03-01 21:38:53 UTC (rev 70299)
@@ -238,7 +238,7 @@
 is crucial to understanding \xetex's behavior and to writing portable
 documents (in short: don't use system fonts).
 
-System font name lookups use (except on Mac~OS~X) the
+System font name lookups use, except on mac~OS, the
 |fontconfig| library; running |fc-list| should show you the font names
 available.  \Eg,
 \begin{quote}\small
@@ -245,7 +245,7 @@
 |\font\1="Liberation Serif"| \hfill \emph{look for OS-installed font}
 \end{quote}
 
-Fonts have many internal names, and XeTeX does the system font lookups
+Fonts have many internal names, and \xetex\ does the system font lookups
 in the following order:
 \vskip1ex
 \begin{itemize}
@@ -1414,6 +1414,10 @@
 
 \subsection{File handling}
 
+In general: \xetex\ supports Unicode filenames. Before the 2024 release,
+characters in filenames were restricted to be on the Basic Multilingual
+Plane (character codes $\le$ U+FFFF).
+
 \cmd|\creationdate|
 \desc{Expands to the date string \xetex\ uses in the \texttt{/Info}
 dictionary of the output PDF document. This corresponds to the date and
@@ -1465,6 +1469,11 @@
 (\texttt{"}) are removed from the filename, but it is otherwise left
 unchanged after tokenization.
 
+We say ``group-delimited'' because, as usual with \TeX\ arguments, the
+beginning and ending delimiters are any characters of catcode 1 and 2,
+respectively; they don't define a group that affects the semantic
+nesting level.
+
 This extension is unlike most others in that it affects a primitive in
 standard \TeX\ (\cs{input}), rather than being related to a new
 primitive, command line option, etc. This is allowed because additional
@@ -1472,7 +1481,7 @@
 \texttt{tex.web} as acceptable system-dependent extensions.
 
 Incidentally, this does not directly affect \LaTeX's \cs{input} command
-(which takes a group-delimited argument), as that is a macro
+(which also takes a group-delimited argument), as that is a macro
 redefinition of the \cs{input} primitive.}
 \endcmd
 
@@ -1518,16 +1527,20 @@
 
 \subsection{Invoking \xetex}
 
-\xetex\ has many command line options. They are almost all inherited
-from the common framework for \TeX\ engines as implemented in Web2C
-(its manual is available at \url{https://tug.org/web2c}).
+\xetex\ has many command line options and can use many environment
+variables and configuration file settings. They are almost all inherited
+from the common framework for \TeX\ engines as implemented in Web2C and
+Kpathsea. Their documentation is available at
+\url{https://tug.org/web2c} and \url{https://tug.org/kpathsea}.
 
-The main exceptions are \verb|-no-pdf|, which tells \xetex\ to output
-its XDV (extended DVI) without further processing, and
+The main \xetex-specific options are \verb|-no-pdf|, which tells \xetex\
+to output its XDV (extended DVI) without further processing, and
 \verb|-output-driver=|\xarg{cmd}, which processes the XDV output with
 \xarg{cmd}; the default is \texttt{xdvipdfmx}.
 
+% doc FONTCONFIG_FILE etc in texmf.cnf
 
+
 \section{Engine version}
 
 \cmd|\XeTeXversion|