| 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} |