[latex3-commits] [git/LaTeX3-latex3-latex2e] develop: documentation for 2 bugs (few more remaining); multicol used to shorten primitive list (3179a2d8)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : develop
Link       : https://github.com/latex3/latex2e/commit/3179a2d871bd4a46f0bcabd517c095e417c3dcdc

>---------------------------------------------------------------

commit 3179a2d871bd4a46f0bcabd517c095e417c3dcdc
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Thu Jan 9 19:06:39 2020 +0100

    documentation for 2 bugs (few more remaining); multicol used to shorten primitive list


>---------------------------------------------------------------

3179a2d871bd4a46f0bcabd517c095e417c3dcdc
 .gitignore            |  1 +
 base/doc/ltnews.tex   | 11 ++++++++---
 base/doc/ltnews31.tex | 27 ++++++++++++++++++++++-----
 3 files changed, 31 insertions(+), 8 deletions(-)

diff --git a/.gitignore b/.gitignore
index afc5e7f7..7dd7f2de 100644
--- a/.gitignore
+++ b/.gitignore
@@ -14,3 +14,4 @@ build/
 install-new-tlg-versions.sh
 replace-string.sh
 required/*/*.pdf
+*.toc31
diff --git a/base/doc/ltnews.tex b/base/doc/ltnews.tex
index 9f8a1a71..a771dc37 100644
--- a/base/doc/ltnews.tex
+++ b/base/doc/ltnews.tex
@@ -1,7 +1,7 @@
 % \iffalse meta-comment
 %
 % Copyright 2006, 2009, 2011, 2014 Heiko Oberdiek
-% Copyright (C) 2014-2019 The LaTeX3 Project
+% Copyright (C) 2014-2020 The LaTeX3 Project
 % 
 % This file is part of the LaTeX base system.
 % -------------------------------------------
@@ -32,7 +32,7 @@
 
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesFile{ltnews.tex}%
-  [2015/02/16 v1.4b Master file for ltnews*.tex (LaTeX Project)]
+  [2020/01/09 v1.4c Master file for ltnews*.tex (LaTeX Project)]
 
 \providecommand*{\lastissue}{31}
 
@@ -83,6 +83,7 @@
 \RequirePackage{hyperref}
 \hypersetup{colorlinks}
 \RequirePackage{bookmark}
+\RequirePackage{multicol}
 
 \makeatletter
 
@@ -189,7 +190,11 @@
               \def\y{|graphicx}%
               \ifx\x\y
               \else
-                \@latex at error{ltnews.tex: \string\usepackage[#1]{#2} found}\@ehc
+                \def\y{|multicol}%
+                \ifx\x\y
+                \else
+                  \@latex at error{ltnews.tex: \string\usepackage[#1]{#2} found}\@ehc
+                \fi
               \fi
             \fi
           \fi
diff --git a/base/doc/ltnews31.tex b/base/doc/ltnews31.tex
index 321dd947..be63ecc7 100644
--- a/base/doc/ltnews31.tex
+++ b/base/doc/ltnews31.tex
@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %
-% Copyright 2019
+% Copyright 2019-2020
 % The LaTeX3 Project and any individual authors listed elsewhere
 % in this file.
 %
@@ -36,6 +36,7 @@
 \usepackage{lmodern,url,hologo}
 
 \usepackage{csquotes}
+\usepackage{multicol}
 
 \providecommand\acro[1]{\textsc{#1}}
 \providecommand\meta[1]{$\langle$\textit{#1}$\rangle$}
@@ -491,9 +492,13 @@ typesetting was used.
 \githubissue{203}
 
 
-\subsection{Allow more write streams with   \texttt{filecontents} in \LuaTeX}
+\subsection{Allow more write streams with \texttt{filecontents} in \LuaTeX}
 
-\emph{write}
+Most \TeX{} engines only support a maximum of sixteen concurrently
+open write streams and if those have been used up, then
+\texttt{filecontents} or any other code trying to upen another one
+will fail. In \LuaTeX{} more write streams are available and those can
+now be utilized as well.
 %
 \githubissue{238}
 
@@ -502,9 +507,13 @@ typesetting was used.
 
 \section{Changes to packages in the \pkg{graphics} category}
 
-\subsection{Make color/graphics user-level commands robust}
+\subsection[Make \pkg{color}/\pkg{graphics} user-level commands robust]
+           {Make \pkg{color} \& \pkg{graphics} user-level commands robust}
 
-\emph{write}
+Some of the user-level commands of \pkg{color}, \pkg{graphics} and
+\pkg{graphicx} such as \cs{textcolor} or \cs{includegraphics} were
+still fragile, so didn't work in moving arguments without extra
+protection. All of them have now been made robust.
 %
 \githubissue{208}
 
@@ -573,6 +582,8 @@ functionality in \LaTeX{}. This is seen for example in improved UTF-8 handling,
 which uses \cs{ifincsname}. The following primitive functionality (which in
 \LuaTeX{} may be achieved using Lua code) will therefore be \emph{required} by
 the \LaTeX{} kernel after [INSERT DATE HERE]:
+\begingroup\setlength\columnsep{0pt}
+\begin{multicols}{2}
 \begin{itemize}
   \item \cs{expanded}
   \item \cs{ifincsname}
@@ -597,16 +608,22 @@ the \LaTeX{} kernel after [INSERT DATE HERE]:
   \item \cs{pdfstrcmp}
   \item \cs{pdfuniformdeviate}
 \end{itemize}
+\end{multicols}
+\endgroup
 For ease of reference, these primitives will be referred to as the
 `\pdfTeX{} utilities'.
 
 Engines which are fully Unicode-capable must all provide the following
 primitives
+\begingroup\setlength\columnsep{0pt}
+\begin{multicols}{2}
 \begin{itemize}
   \item \cs{Uchar}
   \item \cs{Ucharcat}
   \item \cs{Umathcode}
 \end{itemize}
+\end{multicols}
+\endgroup
 Note that it has become standard practice to check for Unicode-aware engines
 with the existence of the \cs{Umathcode} primitive.