Debian Codegraph @

texmf-dist/doc/latex/base/ltnews23.tex

raw
1 % \iffalse meta-comment
2 %
3 % Copyright (C) 2015-2025
4 % The LaTeX Project and any individual authors listed elsewhere
5 % in this file.
6 %
7 % This file is part of the LaTeX base system.
8 % -------------------------------------------
9 %
10 % It may be distributed and/or modified under the
11 % conditions of the LaTeX Project Public License, either version 1.3c
12 % of this license or (at your option) any later version.
13 % The latest version of this license is in
14 % http://www.latex-project.org/lppl.txt
15 % and version 1.3c or later is part of all distributions of LaTeX
16 % version 2008 or later.
17 %
18 % This file has the LPPL maintenance status "maintained".
19 %
20 % The list of all files belonging to the LaTeX base distribution is
21 % given in the file `manifest.txt'. See also `legal.txt' for additional
22 % information.
23 %
24 % The list of derived (unpacked) files belonging to the distribution
25 % and covered by LPPL is defined by the unpacking scripts (with
26 % extension .ins) which are part of the distribution.
27 %
28 % \fi
29 % Filename: ltnews23.tex
30 %
31 % This is issue 23 of LaTeX News.
32
33 \documentclass{ltnews}
34 \usepackage[T1]{fontenc}
35
36 \usepackage{lmodern,url,hologo}
37
38 \makeatletter % -- provide command introduced in new release
39 % so this typesets with an old format
40
41 % Check we are not in the preamble of a composite document
42 \def\@tempa{\@latex@error{Can be used only in preamble}\@eha}
43 \ifx\DeclareTextCommandDefault\@tempa
44 \else
45 \DeclareTextCommandDefault\textcommabelow[1]
46 {\hmode@bgroup\ooalign{\null#1\crcr\hidewidth\raise-.31ex
47 \hbox{\check@mathfonts\fontsize\ssf@size\z@
48 \math@fontsfalse\selectfont,}\hidewidth}\egroup}
49 \fi
50 \makeatother
51
52 \publicationmonth{October}
53 \publicationyear{2015}
54
55 \publicationissue{23}
56
57 \providecommand\pkg[1]{\texttt{#1}}
58 \providecommand\cls[1]{\texttt{#1}}
59 \providecommand\option[1]{\texttt{#1}}
60 \providecommand\env[1]{\texttt{#1}}
61 \providecommand\file[1]{\texttt{#1}}
62
63 \begin{document}
64
65 \maketitle
66
67 \tableofcontents
68
69 \section{Enhanced support for \hologo{LuaTeX}}
70
71 As noted in \LaTeX\ News 22, the 2015/01/01 release of \LaTeX{}
72 introduced built-in support for extended \TeX\ systems.
73
74 The range of allocated register numbers (for example, for count
75 registers) is now set according to the underlying engine capabilities
76 to 256, 32768 or 65536. Additional allocators were also added for the
77 facilities added by \hologo{eTeX} (\verb|\newmark|) and \hologo{XeTeX}
78 (\verb|\newXeTeXintercharclass|). At that time, however, the work to
79 incorporate additional allocators for \hologo{LuaTeX} was not ready for
80 distribution.
81
82 The main feature of this release is that by default it includes
83 allocators for \hologo{LuaTeX}-provided features, such as Lua
84 functions, bytecode registers, catcode tables and Lua callbacks.
85 Previously these features have been provided by the contributed
86 \pkg{luatex} (Heiko Oberdiek) and \pkg{luatexbase}
87 (\'{E}lie Roux,
88 Manuel P\'{e}gouri\'{e}-Gonnard and Philipp Gesang)
89 packages. However, just as
90 noted with the \pkg{etex} package in the previous release, it is
91 better if allocation is handled by the format to avoid problems with
92 conflicts between different allocation schemes, or definitions made
93 before a package-defined allocation scheme is enabled.
94
95 The facilities incorporated into the format with this release, and
96 described below, are closely modelled on the \pkg{luatexbase}
97 package and we thank the authors, and especially \'{E}lie Roux, for
98 help in arranging this transition.
99
100 The implementation of these \hologo{LuaTeX} features has been
101 redesigned to match the allocation system introduced in the 2015/01/01
102 \LaTeX\ release, and there are some other differences from the previous
103 \pkg{luatexbase} package. However, as noted below,
104 \pkg{luatexbase} is being updated in line with this \LaTeX\ release
105 to provide the previous interface as a wrapper around the new
106 implementation, so we expect the majority of documents using
107 \pkg{luatexbase} to work without change.
108
109 \subsection{Names of \hologo{LuaTeX} primitive commands}
110
111 The 2015/01/01 \LaTeX\ release for the first time initialised
112 \hologo{LuaTeX} in \file{latex.ltx} if \hologo{LuaTeX} is being
113 used. Following the convention used in the contributed
114 \file{lualatex.ini} file used to set up the format for earlier
115 releases, most \hologo{LuaTeX}-specific primitives were defined with
116 names prefixed by \texttt{luatex}. This was designed to minimize name
117 clashes but had the disadvantage that names did not match the
118 \hologo{LuaTeX} manual, or the names used in other formats, and
119 produced some awkward command names such as \verb|\luatexluafunction|.
120 From this release the names are enabled without the \texttt{luatex}
121 prefix.
122
123 In practice this change should not affect many documents; relatively
124 few packages access the primitive commands, and many of those are
125 already set up to work with prefixed or unprefixed names, so that they
126 work with multiple formats.
127
128 For package writers, if you want to ensure that your code works with
129 this and earlier releases, use unprefixed names in the package and
130 ensure that they are defined by using code such as:
131 \begin{verbatim}
132 \directlua{tex.enableprimitives("",
133 tex.extraprimitives(
134 "omega", "aleph", "luatex"))}
135 \end{verbatim}
136 Conversely if your document uses a package relying on prefixed names
137 then you can add:
138 \begin{verbatim}
139 \directlua{tex.enableprimitives("luatex",
140 tex.extraprimitives(
141 "omega", "aleph", "luatex"))}
142 \end{verbatim}
143 to your document.
144
145 Note the compatibility layer offered by the \pkg{luatexbase} package
146 described below makes several commands available under both names.
147
148 As always, this change can be reverted using:\\
149 \verb|\RequirePackage[2015/01/01]{latexrelease}|\\
150 at the start of the document.
151
152
153
154 \subsection{\TeX\ commands for allocation in \hologo{LuaTeX}}
155 For detailed descriptions of the new allocation commands see the
156 documented sources in \file{ltluatex.dtx} or chapter N of
157 \file{source2e}; however, the following new allocation commands are
158 defined by default in \hologo{LuaTeX}:
159 \verb|\newattribute|,
160 \verb|\newcatcodetable|,
161 \verb|\newluafunction| and
162 \verb|\newwhatsit|.
163 In addition, the commands \verb|\setattribute| and
164 \verb|\unsetattribute| are defined to set and unset Lua attributes
165 (integer values similar to counters, but attached to nodes). Finally
166 several catcode tables are predefined:
167 \verb|\catcodetable@initex|,
168 \verb|\catcodetable@string|,
169 \verb|\catcodetable@latex|,
170 \verb|\catcodetable@atletter|.
171
172 \subsection{Predefined Lua functions}
173 If used with \hologo{LuaTeX}, \LaTeX\ will initialise a Lua table,
174 \texttt{luatexbase}, with functions supporting allocation and also
175 the registering of Lua callback functions.
176
177 \subsection{Support for older releases and plain \TeX}
178 The \hologo{LuaTeX} allocation functionality made available in this
179 release is also available in plain \TeX\ and older \LaTeX\ releases
180 in the files \file{ltluatex.tex} and \file{ltluatex.lua} which may be
181 used simply by including the \TeX\ file: \verb|\input{ltluatex}|.
182 An alternative for old \LaTeX\ releases is to use:\\
183 \verb|\RequirePackage[2015/10/01]{latexrelease}|\\
184 which will update the kernel to the current release, including
185 \hologo{LuaTeX} support.
186
187 \subsection{Additional \hologo{LuaTeX} support packages}
188 In addition to the base \LaTeX\ release two packages have been
189 contributed to the \textsf{contrib} area on CTAN. The
190 \pkg{ctablestack} package offers some commands to help package
191 writers control the \hologo{LuaTeX} \texttt{catcodetable}
192 functionality, and the \pkg{luatexbase} package replaces the
193 previously available package of the same name, providing a compatible
194 interface but implemented over the \pkg{ltluatex} code.
195
196 \section{More Floats and Inserts}
197 If \hologo{eTeX} is available, the number of registers allocated in
198 the format to hold floats such as figures is increased from 18 to 52.
199
200 The extended allocation system introduced in 2015/01/01 means that in
201 most cases it is no longer necessary to load the \pkg{etex}
202 package. Many classes and packages that previously loaded this package
203 no longer do so. Unfortunately in some circumstances where a package
204 or class previously used the \pkg{etex} \verb|\reserveinserts|
205 command, it is possible for a document that previously worked to
206 generate an error ``no room for a new insert''. In practice this error
207 can always be avoided by declaring inserts earlier, before the
208 registers below 256 are all allocated. However, it is better not
209 to require packages to be re-ordered and in some cases the re-ordering
210 is complicated due to delayed allocations in \verb|\AtBeginDocument|.
211
212 In this release, a new implementation of
213 \verb|\newinsert| is used which allocates inserts from the previously
214 allocated float lists once the classical register allocation has run
215 out. This allows an extra 52 (or in \hologo{LuaTeX}, 64~thousand)
216 insert allocations which is more than enough for practical documents
217 (by default, \LaTeX\ only uses two insert allocations).
218
219 \section{Updated Unicode data}
220
221
222 The file \file{unicode-letters.def} recording catcodes, upper and
223 lower case mappings and other properties for Unicode characters has
224 been regenerated using the data files from Unicode~8.0.0.
225
226 \section{Support for Comma Accent}
227 The command \verb|\textcommabelow| has been added to the format.
228 This is mainly used for the Romanian letters
229 \textcommabelow{S}\textcommabelow{s}\textcommabelow{T}\textcommabelow{t}.
230 This was requested in latex/4414 in the \LaTeX\ bug tracker.
231
232 \section{Extended \pkg{inputenc}}
233 The \option{utf8} option for \pkg{inputenc} has been extended to support
234 the letters s and t with comma accent,
235 U+0218\,--\,U+021b. Similarly circumflex w and y U+0174\,--\,U+0177 are defined.
236 Also U+00a0 and U+00ad are declared by default, and defined to be
237 \verb|\nobreakspace| and \verb|\-| respectively.
238
239 The error message given on undefined UTF-8 input characters
240 now displays the Unicode number
241 in U+\textit{hex} format in addition
242 to showing the character.
243
244 \section{Pre-release Releases}
245 The patch level mechanism has been used previously to identify \LaTeX\
246 releases that have small patches applied to the main release, without
247 changing the main format date.
248
249 The mechanism has now been extended to allow identification of
250 pre-release versions of the software (which may or may not be released
251 via CTAN) but can be identified with a banner such as\\
252 {\catcode`\<=13 \def<{\string<} \catcode`\>=13 \def>{\string>}%
253 \verb|LaTeX2e <2015/10/01> pre-release-1|}\\
254 Internally this is identified as a patch release with a negative patch
255 level.
256
257 \section{Updates in tools}
258
259 The \pkg{multicol} package has been updated to fix the interaction
260 with ``here'' floats that land on the same page as the start or end of
261 a \env{multicols} environment.
262
263 \end{document}