Debian Codegraph @

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

raw
1 % \iffalse meta-comment
2 %
3 % Copyright (C) 2019-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: ltnews21.tex
30 %
31 % This is issue 21 of LaTeX News.
32
33 \documentclass{ltnews}
34 \def\ConTeXt{C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt}
35 \usepackage[T1]{fontenc}
36
37 \usepackage{lmodern,url,hologo}
38
39 \publicationmonth{May}
40 \publicationyear{2014}
41
42 \publicationissue{21}
43
44 \providecommand\pkg[1]{\texttt{#1}}
45 \providecommand\cls[1]{\texttt{#1}}
46 \providecommand\option[1]{\texttt{#1}}
47 \providecommand\env[1]{\texttt{#1}}
48 \providecommand\file[1]{\texttt{#1}}
49
50 \begin{document}
51
52 \maketitle
53
54 \section{Scheduled \LaTeX\ bug-fix release}
55
56 This issue of \LaTeX~News marks the second bug-fix release of
57 \LaTeXe\ (standard \LaTeX) since shifting to a new build system in 2009.
58 Provided sufficient changes are made, we expect to
59 make such releases yearly or every two years, in sync with \TeX\ Live.
60
61
62
63 \subsection{Release notes}
64
65 This release makes no changes to the core code in the \LaTeXe\ format
66 but there are a small number of documentation fixes (not listed
67 here). In addition several packages in the \textsf{base} and
68 \textsf{required} areas have been updated as detailed below.
69
70
71 This has been done in accordance with the philosophy of minimising
72 problems in both forwards and backwards compatibility, so most of
73 these changes should not be noticed by the regular \LaTeX\ user.
74
75 References in the text below of the form ``graphics/3873'' are to
76 bug reports listed
77 at:\\ \url{http://latex-project.org/cgi-bin/ltxbugs2html}
78
79
80 \let\paragraph\subsubsection
81
82 \paragraph{\pkg{fixltx2e} updates}
83
84
85
86 There are a number of bugs and faulty design decisions in \LaTeXe{}
87 that should have been corrected long ago in the kernel code. However,
88 such corrections cannot be done as this would break backwards
89 compatibility in the following sense. A large number of documents
90 exist by now that have worked around the bug or have even made use of
91 a particular misfeature. Thus changing the kernel code would break
92 too many existing documents.
93
94 The corrections for these types of bug have therefore been collected together
95 in a package that can be loaded only when needed; its name is \pkg{fixltx2e}.
96 For this release we made the following changes to this package:
97 \begin{itemize}
98 \item
99 Misspelled float placement specifiers such as
100 \verb=\begin{figure}[tv]= instead of \texttt{tb} are silently
101 ignored by the kernel code. Now we test for such letters and issue
102 an error message.
103 \item
104 \LaTeX's float handling algorithm can get out of sync if you mix
105 single and double-column floats (as they are placed independently
106 of each other). This was corrected in \pkg{fixltx2e} a few years ago
107 but the fix was not perfect as one situation using
108 \verb=\enlargethispage= generated a low-level \TeX{} error.
109 This behaviour of the package is now improved.
110 \end{itemize}
111
112
113
114
115 \paragraph{New \pkg{fltrace} package}
116
117 For years the file \file{ltoutput.dtx} contained some hidden code to
118 trace the detailed behaviour of the float placement algorithm of
119 \LaTeX. Prompted by questions on StackExchange we now extract this
120 code into a new \pkg{fltrace} package. To see the float algorithm
121 in action (or to understand why it decides to place all your floats at
122 the very end of the document) use
123 \begin{verbatim}
124 \usepackage{fltrace} \tracefloats
125 \end{verbatim}
126 To stop tracing somewhere in the document use
127 \verb=\tracefloatsoff= and to see the current value of various float
128 parameters use \verb=\tracefloatvals=. As the package is identical to
129 the kernel code with tracing added, it may or may not work if you load any
130 other package that manipulates that part of the kernel code. In such a
131 case your best bet is to load \pkg{fltrace} first.
132
133 \paragraph{\pkg{inputenc} package updates}
134
135 The \pkg{inputenc} package allows different input encodings for
136 \LaTeX\ documents to be specified including the important
137 \option{utf8} option used to specify the Unicode UTF-8 encoding. A
138 common mistake in documents has been to also include this option when
139 using the Unicode-based \TeX\ engines \hologo{LuaTeX} and \hologo{XeTeX}
140 producing strange errors as these engines natively deal with UTF-8
141 characters.
142
143 If a document stored in an 8bit encoding is processed by
144 \hologo{pdfTeX}, it needs the \pkg{inputenc} package to work
145 correctly. However, if such a document is processed unchanged by
146 \hologo{LuaTeX} or \hologo{XeTeX}, then accented characters may
147 silently get dropped from the output.
148
149 The package has been modified so that if used with \hologo{LuaTeX} or
150 \hologo{XeTeX}, then it just issues a warning if \option{utf8} or
151 \option{ascii} is specified, and stops with an error for any other
152 encoding requested.
153
154
155
156 One further improvement has been made to the encoding definition files
157 (\texttt{.def}) used by \pkg{inputenc}: the catcode of \texttt{@}
158 is now saved and restored when reading them instead of always using
159 \verb=\makeatother= inside the files (latex/4192).
160
161
162
163 \paragraph{The tools directory}
164
165 In the past each of the sub-directories in the ``required'' section of
166 the \LaTeX{} distribution contained a single \texttt{.ins} file to
167 generate the code files from the source files. We have now
168 started to provide individual \texttt{.ins} files for each of those
169 packages that are likely to require updates outside a major
170 \LaTeX{} release.
171
172 \paragraph{\pkg{multicol} updates}
173
174 Version 1.8 of \pkg{multicol} implements some improvements/fixes
175 and one extension. In the past the balancing algorithm enlarged the
176 column height until it found a solution that satisfied all
177 constraints. If there were insufficient break points then the final
178 column height could have been much larger than expected and if that
179 happened near the end of the page it resulted in the text overflowing
180 into the bottom margin. This situation is now detected and in that
181 case a normal page is cut and balancing is resumed on the next
182 page. Some overflow is still allowed and controlled via the parameter
183 \verb=\maxbalancingoverflow=.
184
185 The use of \verb=\enlargethispage= is now properly supported within
186 the environment. Finally a new command \verb=\docolaction= was added
187 to allow the execution of code depending on the column in which the
188 command is executed. See the documentation for details.
189
190 Bug fixes: the new version fixes both a color leak that could happen
191 in certain situations and the problem that \pkg{multicols} could
192 mess up the positioning of \verb=\marginpar=s that followed the
193 environment.
194
195
196 \paragraph{\pkg{tabularx} updates}
197
198 The restrictions on embedding \verb|\tabularx| \verb|\endtabularx|
199 into the definition of a new environment have been relaxed
200 slightly. See the package documentation for details.
201
202 \paragraph{\pkg{showkeys} updates}
203
204 The \pkg{showkeys} package has been updated to fix problems if used
205 at the start of list items, and to work if brace groups (\verb|{| and
206 \verb|}|) are used in the optional argument of
207 \verb|\cite|. (tools/4162, tools/4173)
208
209
210 \paragraph{\pkg{color} updates}
211
212 The \verb|\nopagecolor| command suggested by Heiko Oberdiek,
213 available for some years in the \option{pdftex} option, has been
214 added to the core package as suggested in graphics/3873. Currently
215 this is supported in the driver files for \textsf{dvips} and
216 \textsf{pdftex}. Patches to support other drivers are welcome.
217
218 \paragraph{\pkg{graphicx} updates}
219
220 The \pkg{graphicx} version of \verb|\rotatebox| now allows
221 \verb|\par| (and blank lines) in values, to match the change made
222 to the \pkg{graphics} version some years ago. See graphics/4296.
223
224
225 \paragraph{\pkg{keyval} updates}
226
227 All parsing used in the \pkg{keyval} package has been changed
228 to allow \verb|\par| (and blank lines) in values.
229 (A second change, to parsing of brace groups
230 in a construct such as \texttt{key=\{\{\{value\}\}\}}, was reverted in v1.15.)
231 See graphics/3446.
232
233
234
235
236 \vfill
237
238 \section{Standard \LaTeX\ (\LaTeXe) and \textsf{expl3}}
239
240 The substantial collection of innovative code in \textsf{expl3}
241 implements a new programming language that has for a while now been
242 used by some writers of \LaTeXe\ packages. This code has recently
243 also been made available for use on top of plain \TeX\ or {\ConTeXt},
244 largely to support generic packages that are supposed to work with
245 different flavours of \TeX. These uses in no way affect authors of
246 \LaTeX\ documents and such \LaTeXe\ packages will continue to work as
247 advertised by their authors with standard \LaTeX.
248
249 This code base will also become an important foundation for the kernel
250 of \LaTeX3 and so the new programming language can be described as
251 `The \LaTeX3 Programming Language'. However, if you see or hear that a
252 package `uses \LaTeX3' then it remains very unlikely (as yet) to mean
253 that the package is part of some `new version of \LaTeX'.
254
255 News about the development and use of \textsf{expl3} and about other
256 developments in the \LaTeX3 code base is reported regularly in the
257 \LaTeX3~News series (\url{http://latex-project.org/l3news/}), the most
258 recent issue of which was published in March 2014.
259
260
261 \end{document}