From 7c84f6395cab83b2390f4dc08fdfe235413de4d9 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Sun, 27 Aug 2023 03:01:10 +0000 Subject: CTAN sync 202308270301 --- info/xetexref/Makefile | 26 ++++++++++++++ info/xetexref/xetex-reference.pdf | Bin 148484 -> 150069 bytes info/xetexref/xetex-reference.tex | 69 ++++++++++++++++++++++++++++++-------- 3 files changed, 81 insertions(+), 14 deletions(-) create mode 100644 info/xetexref/Makefile (limited to 'info') diff --git a/info/xetexref/Makefile b/info/xetexref/Makefile new file mode 100644 index 0000000000..b1b75d22b3 --- /dev/null +++ b/info/xetexref/Makefile @@ -0,0 +1,26 @@ +# Public domain. Simple Makefile for xetex-reference. + +doc = xetex-reference.tex +default: pdf + +pdf xetex-reference.pdf: $(doc) + texfot xelatex --file-line-error -no-mktex=tfm '\nonstopmode\input $<' + +tryfonts: + xetex -no-mktex=tfm '\nonstopmode\input tryxefonts.tex' + +spell: + dw <$(doc) | grep -v ': a$$' || true + myspell $(doc) + +diff dif: +reldir = /usr/local/texlive/dev/texmf-dist/doc/xetex/xetexref/ +diff dif: + -diff -u0 $(reldir)/xetex-reference.tex . + +pkg = xetexref +dist: + rm -rf $(pkg) $(pkg).zip + mkdir $(pkg) + ln -s ../Makefile ../README.txt ../$(doc) ../xetex-reference.pdf $(pkg) + zip -r $(pkg).zip $(pkg) diff --git a/info/xetexref/xetex-reference.pdf b/info/xetexref/xetex-reference.pdf index 1877be914f..d78c6a5988 100644 Binary files a/info/xetexref/xetex-reference.pdf and b/info/xetexref/xetex-reference.pdf differ diff --git a/info/xetexref/xetex-reference.tex b/info/xetexref/xetex-reference.tex index ae859e3b32..2f2e50aab2 100644 --- a/info/xetexref/xetex-reference.tex +++ b/info/xetexref/xetex-reference.tex @@ -706,7 +706,7 @@ of a font is on by default.} \cmd|\XeTeXfindselectorbyname| \xarg{font} -\xarg{feature name} +\xarg{feature code} \xarg{selector name} \desc{This command provides a method to query whether a feature selector name corresponds to a selector of a specific feature contained in the @@ -787,6 +787,20 @@ used to error-check that a specified variation name exists before attempting to use it.} \endcmd +\subsection{Contextual adjustment space handling} +\cmd|\XeTeXinterwordspaceshaping| +\xarg{integer} +\desc{Controls the shaping of space characters in context when using +native fonts. Defaults to 0 (disabled). Set to 1 for contextual +adjustment of space width only, and 2 for full cross-space shaping +(e.g., multi-word ligatures). + +When set to 2, each run of text (words and intervening spaces) in a +single font will be re-shaped as a unit as a page is shipped out, so +setting this register to 2 affects the whole page, not respecting \TeX\ +grouping.} +\endcmd + \subsection{Maths fonts} The primitives described following are extensions of \tex’s 8-bit primitives. @@ -992,8 +1006,8 @@ useful for diacritics so I’m told.} \XeTeXinterchartoks \mycharclassA \mycharclassa = {\upshape]} % between " " and "B": -\XeTeXinterchartoks 255 \mycharclassB = {\bgroup\color{blue}} -\XeTeXinterchartoks \mycharclassB 255 = {\egroup} +\XeTeXinterchartoks 4095 \mycharclassB = {\bgroup\color{blue}} +\XeTeXinterchartoks \mycharclassB 4095 = {\egroup} % between "B" and "B": \XeTeXinterchartoks \mycharclassB \mycharclassB = {.} @@ -1062,6 +1076,13 @@ allowed. Off, 0, by default.} etc.) will be stacked upwards instead of downwards.} \endcmd + +\cmd|\XeTeXhyphenatablelength| +\xarg{integer} +\desc{Sets the maximum hyphenatable word length; + the default is 63, for compatibility with classic \TeX.} +\endcmd + \section{Graphics} Thanks to Heiko Oberdiek, Paul Isambert, and William Adams for their @@ -1154,7 +1175,7 @@ box. \cmd|\XeTeXprotrudechars| \xarg{integer} -\desc{Equivalent to \cs{pdfprotrudechars} in pdf\TeX{} for controlling +\desc{Equivalent to \cs{pdfprotrudechars} in \pdftex\ for controlling character protrusion or ‘margin kerning’. When set to zero (default), character protrusion is turned off. When set to one, it is activated but will not affect line-breaking. When set to two, line-breaking decisions will change as a result @@ -1167,7 +1188,7 @@ of the character protrusion.} \hsize=20mm a a a a a a a a a a abbabbabb aabbabbabb abbabb \end{example} -See the pdf\TeX{} documentation for further details. +See the \pdftex\ documentation for further details. \endcmd \cmd|\rpcode| \xarg{font} \xarg{char slot} (integer, $n$) @@ -1180,14 +1201,24 @@ the specified \xarg{font} to $n/1000$\,em. $n$ is clipped to $\pm1000$.} the specified \xarg{font} to $n/1000$\,em. $n$ is clipped to $\pm1000$.} \endcmd +\cmd|\rightmarginkern| \xarg{box number} +\desc{Expands to the width of the margin kerning at the right side of +the horizontal list stored in \cs{box} \xarg{box number}.} +\endcmd + +\cmd|\leftmarginkern| \xarg{box number} +\desc{Expands to the width of the margin kerning at the left side of +the horizontal list stored in \cs{box} \xarg{box number}.} +\endcmd + \section{Cross-compatibility with other \TeX\ engines} All of the major (non-frozen) \TeX\ engines support most of the functionality described in this section, in one way or another, so that macro formats (e.g., \LaTeX) can make use of it. Please see the -pdf\TeX{} manual for details (where all these primitive names begin with -\verb|\pdf...|). +\pdftex\ manual for details (in \pdftex, all these primitive names +begin with \verb|\pdf...|). \subsection{Geometry} @@ -1360,12 +1391,11 @@ reproducible builds of documents.} \cmd|FORCE_SOURCE_DATE| (environment variable) -\par\noindent % no \desc because of _'s -If this is set to~\texttt{1}, \xetex's time-related primitives are also -initialized from the value of \verb|SOURCE_DATE_EPOCH|. These primitives +\desc{If this is set to~\texttt{1}, \xetex's time-related primitives are also +initialized from the value of \texttt{SOURCE\_DATE\_EPOCH}. These primitives are \cs{year}, \cs{month}, \cs{day}, and \cs{time}. If -\verb|SOURCE_DATE_EPOCH| is not set, setting \verb|FORCE_SOURCE_DATE| -has no effect. (See the \pdftex\ manual for pathological cases.) +\texttt{SOURCE\_DATE\_EPOCH} is not set, setting \texttt{FORCE\_SOURCE\_DATE} +has no effect. (See the \pdftex\ manual for pathological cases.)} \endcmd \subsection{Timing} @@ -1384,6 +1414,14 @@ $2^{31} − 1$ will be returned.} \subsection{File handling} +\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 +time when \xetex\ engine started, \eg\ \creationdate\ for this file. If +\texttt{SOURCE\_DATE\_EPOCH} is set, its value is used for +\cs{creationdate}.} +\endcmd + \cmd|\filedump| \texttt{[offset]} \xarg{number} \texttt{[length]} \xarg{number} @@ -1395,8 +1433,11 @@ offset or length are given.} \cmd|\filemoddate| \barg{\xarg{filename}} -\desc{Expands to the date the file was last modified in the format -\texttt{D:YYYYMMDDHHMMSS+ZZZZ} as a string.} +\desc{Expands to the date the file was last modified in the same format +as for \cs{creationdate} as a string. If both \texttt{SOURCE\_DATE\_EPOCH} +and \texttt{FORCE\_SOURCE\_DATE} are set, \cs{filemoddate} returns a value +in UTC, ending in \texttt{Z}, regardless of the values of environment +variables.} \endcmd \cmd|\filesize| -- cgit v1.2.3