summaryrefslogtreecommitdiff
path: root/info
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2024-03-02 03:04:21 +0000
committerNorbert Preining <norbert@preining.info>2024-03-02 03:04:21 +0000
commitb7323fe884f378851ee661babaa5bd644271f348 (patch)
tree8891732393826e5c5893d00fa39cf9a5eb0a3a90 /info
parent19a826b6e3a0d2ea6bbd1bf733a8e590463275ed (diff)
CTAN sync 202403020304
Diffstat (limited to 'info')
-rw-r--r--info/xetexref/Makefile4
-rw-r--r--info/xetexref/xetex-reference.pdfbin150069 -> 150779 bytes
-rw-r--r--info/xetexref/xetex-reference.tex29
3 files changed, 23 insertions, 10 deletions
diff --git a/info/xetexref/Makefile b/info/xetexref/Makefile
index b1b75d22b3..b8c640f0d5 100644
--- a/info/xetexref/Makefile
+++ b/info/xetexref/Makefile
@@ -13,9 +13,8 @@ spell:
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 @@ dist:
mkdir $(pkg)
ln -s ../Makefile ../README.txt ../$(doc) ../xetex-reference.pdf $(pkg)
zip -r $(pkg).zip $(pkg)
+ rm -rf $(pkg)
diff --git a/info/xetexref/xetex-reference.pdf b/info/xetexref/xetex-reference.pdf
index d78c6a5988..faf730ef48 100644
--- a/info/xetexref/xetex-reference.pdf
+++ b/info/xetexref/xetex-reference.pdf
Binary files differ
diff --git a/info/xetexref/xetex-reference.tex b/info/xetexref/xetex-reference.tex
index 2f2e50aab2..e034026aa1 100644
--- a/info/xetexref/xetex-reference.tex
+++ b/info/xetexref/xetex-reference.tex
@@ -238,14 +238,14 @@ This distinction between file name lookups and system font name lookups
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
|\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 @@ $2^{31} − 1$ will be returned.}
\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 @@ it is available in all engines. ASCII double quote characters
(\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 @@ methods of recognizing filenames are explicitly mentioned in
\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,15 +1527,19 @@ suppressed and the font control sequence being defined is set to
\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}