summaryrefslogtreecommitdiff
path: root/info
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-08-27 03:01:10 +0000
committerNorbert Preining <norbert@preining.info>2023-08-27 03:01:10 +0000
commit7c84f6395cab83b2390f4dc08fdfe235413de4d9 (patch)
treec8a8ef3a12bf62e3ba324febf32b4a123a294bc9 /info
parent2c6f7db39402a9980f7423ed3266ad1d18936bcc (diff)
CTAN sync 202308270301
Diffstat (limited to 'info')
-rw-r--r--info/xetexref/Makefile26
-rw-r--r--info/xetexref/xetex-reference.pdfbin148484 -> 150069 bytes
-rw-r--r--info/xetexref/xetex-reference.tex69
3 files changed, 81 insertions, 14 deletions
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
--- 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 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|