texlive[68072] Master: xetexref (26aug23)
commits+karl at tug.org
commits+karl at tug.org
Sat Aug 26 22:18:11 CEST 2023
Revision: 68072
http://tug.org/svn/texlive?view=revision&revision=68072
Author: karl
Date: 2023-08-26 22:18:11 +0200 (Sat, 26 Aug 2023)
Log Message:
-----------
xetexref (26aug23)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.pdf
trunk/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex
trunk/Master/tlpkg/libexec/ctan2tds
Added Paths:
-----------
trunk/Master/texmf-dist/doc/xetex/xetexref/Makefile
Added: trunk/Master/texmf-dist/doc/xetex/xetexref/Makefile
===================================================================
--- trunk/Master/texmf-dist/doc/xetex/xetexref/Makefile (rev 0)
+++ trunk/Master/texmf-dist/doc/xetex/xetexref/Makefile 2023-08-26 20:18:11 UTC (rev 68072)
@@ -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)
Property changes on: trunk/Master/texmf-dist/doc/xetex/xetexref/Makefile
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
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 2023-08-26 20:16:17 UTC (rev 68071)
+++ trunk/Master/texmf-dist/doc/xetex/xetexref/xetex-reference.tex 2023-08-26 20:18:11 UTC (rev 68072)
@@ -706,7 +706,7 @@
\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 @@
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 @@
\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 @@
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 @@
\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 @@
\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$.}
\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 @@
\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 @@
\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 @@
\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|
Modified: trunk/Master/tlpkg/libexec/ctan2tds
===================================================================
--- trunk/Master/tlpkg/libexec/ctan2tds 2023-08-26 20:16:17 UTC (rev 68071)
+++ trunk/Master/tlpkg/libexec/ctan2tds 2023-08-26 20:18:11 UTC (rev 68072)
@@ -3055,6 +3055,7 @@
'translation-tabbing-fr', 'NULL', # doc
'tkz-orm', 'NULL', # no gain ...
'velthuis', 'NULL',
+ 'xetexref', 'NULL',
'xindex', 'NULL',
'xlop', 'manual.sty|' . $standardsource,
);
More information about the tex-live-commits
mailing list.