diff options
author | Karl Berry <karl@freefriends.org> | 2024-03-01 21:38:53 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2024-03-01 21:38:53 +0000 |
commit | 8499fd001092b7f9d2f9f092cb080e9afe648ae8 (patch) | |
tree | 2a35c0070157b248ad96b4b070a5568cd48b5576 /Master/texmf-dist | |
parent | 4fdfe08815088c7fecc5f5c327b4e8dffabe451b (diff) |
xetexref (1mar24)
git-svn-id: svn://tug.org/texlive/trunk@70299 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r-- | Master/texmf-dist/doc/xetex/xetexref/Makefile | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/xetex/xetexref/xetex-reference.pdf | bin | 150069 -> 150779 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex | 29 |
3 files changed, 23 insertions, 10 deletions
diff --git a/Master/texmf-dist/doc/xetex/xetexref/Makefile b/Master/texmf-dist/doc/xetex/xetexref/Makefile index b1b75d22b3c..b8c640f0d54 100644 --- a/Master/texmf-dist/doc/xetex/xetexref/Makefile +++ b/Master/texmf-dist/doc/xetex/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/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.pdf b/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.pdf Binary files differindex d78c6a59886..faf730ef480 100644 --- a/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.pdf +++ b/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.pdf diff --git a/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex b/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex index 2f2e50aab28..e034026aa1c 100644 --- a/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex +++ b/Master/texmf-dist/doc/xetex/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} |