[latex3-commits] [git/LaTeX3-latex3-latex2e] develop: more documentation in ltnews30 (c52ff33a)
Frank Mittelbach
frank.mittelbach at latex-project.org
Thu Sep 12 15:51:30 CEST 2019
Repository : https://github.com/latex3/latex2e
On branch : develop
Link : https://github.com/latex3/latex2e/commit/c52ff33a1562e772bdad2f720a2b9c1553c36663
>---------------------------------------------------------------
commit c52ff33a1562e772bdad2f720a2b9c1553c36663
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date: Thu Sep 12 15:51:30 2019 +0200
more documentation in ltnews30
>---------------------------------------------------------------
c52ff33a1562e772bdad2f720a2b9c1553c36663
base/classes.dtx | 3 ++-
base/doc/ltnews30.tex | 65 +++++++++++++++++++++++++++++++++++++++++----------
2 files changed, 55 insertions(+), 13 deletions(-)
diff --git a/base/classes.dtx b/base/classes.dtx
index 3255fde7..9fed94df 100644
--- a/base/classes.dtx
+++ b/base/classes.dtx
@@ -221,7 +221,8 @@
%
% \author{%
% Copyright (C) 1992 by Leslie Lamport \and
-% Copyright (C) 1994-97 by Frank Mittelbach \and Johannes Braams
+% Copyright (C) 1994-2019 by Frank Mittelbach \and Johannes Braams \and
+% \LaTeX3 Project Team
% }
% \date{\filedate}
% \MaintainedByLaTeXTeam{latex}
diff --git a/base/doc/ltnews30.tex b/base/doc/ltnews30.tex
index 3f3420a5..e0a6ee78 100644
--- a/base/doc/ltnews30.tex
+++ b/base/doc/ltnews30.tex
@@ -47,6 +47,7 @@
\providecommand\LuaTeX{\hologo{LuaTeX}}
\providecommand\pdfTeX{\hologo{pdfTeX}}
\providecommand\MiKTeX{\hologo{MiKTeX}}
+\providecommand\CTAN{\textsc{ctan}}
\providecommand\TL{\TeX{}Live}
\providecommand\githubissue[2][]{\ifhmode\unskip\fi
@@ -145,7 +146,7 @@ further development to continue, we now have a development branch of
\LaTeX{} on GitHub containing development code for the upcoming
release. When this code is ready for wider consumption and testing, we
generate a pre-release of \LaTeX{} from this development branch and make
-it available on CTAN.
+it available on \CTAN.
For users of the \TL{} and \MiKTeX{} distributions it is therefore now
straightforward to test their documents and code against the upcoming
@@ -200,7 +201,7 @@ the process is available in an upcoming TUGboat article: \enquote{The
\subsection{Setting up menu items}
While the command line call works out of the box if you have a recent
-uptodate \TL{} or \MiKTeX{} installation, the use within an integrated
+up-to-date \TL{} or \MiKTeX{} installation, the use within an integrated
editing environment doesn’t at this point in time (maybe the
developers of these editors will include it in the future). However,
it is normally fairly simple to enable it as most (or even all?) of
@@ -269,7 +270,7 @@ could still overwrite it (there is no way to test for that).
With the option \option{nosearch} only the current directory is
examined not the \TeX{} tree. This is useful if you want to write a
-local copy of an standard system file.
+local copy of a standard system file.
Finally, \option{noheader} prevents writing a preamble to the file
(which is the same as using the star form of the environment.
@@ -466,21 +467,29 @@ What is most appropriate really depends on the circumstances, but this
now gives you the tools to make local or global adjustments.
-\subsection{\pkg{varioref}: }
+\subsection{\pkg{varioref}: better support for \pkg{cleveref}}
-\option{nospace}
+The \pkg{varioref} package has been internally updated to provide
+better interfaces for packages such as \pkg{hyperref} and
+\pkg{cleveref}.
-\option{arabic} added
+It now has a new package option \option{nospace} that stops
+\pkg{varioref} from meddling with space in front it its commands. The
+original behavior was always somewhat problematical and it is
+suggested that for new documents to always use this option (which
+should really have been the default).
-\emph{write}
+Also added was support for the Arabic language through the option
+\option{arabic}.
-\subsection{\pkg{xr}: Support citations to bibiographies in external documents}
+
+\subsection{\pkg{xr}: Support citations to bibliographies in external documents}
The \pkg{xr} package can be used to reference labels in external
document, e.g., when a work is split over different documents that
-need to be processed separateley, but has \cs{ref} or \cs{pageref}
+need to be processed separately, but has \cs{ref} or \cs{pageref}
links between each other. With this update \cs{cite} commands and
their cousins can now also reference bibliographies in external
documents, a feature that was originally made available by the package
@@ -495,20 +504,48 @@ package.
\subsection{\pkg{amsmath}: Introduce \texttt{overunderset} command}
-\emph{describe}
+The \pkg{amsmath} package always offer the commands \cs{overset} and
+\cs{underset} to produce binary operators with something set above or
+below. But sometimes one needs to put something on both side and that
+required some gymnastics. With the newly added \cs{overunderset} this
+is now easily possible.
\section{Documentation updates}
+There are a number of smaller documentation updates in different files
+found on the documentation page of the \LaTeX{} Project
+website~\cite{30:site-doc}.
+
\subsection{High-lighting the standard NFSS codes for series}
-\emph{describe}
+The font selection scheme uses a number of standard codes for
+\cs{fontseries} and \cs{fontshape} to ensure that different fonts are
+comparable, e.g., that you get a \enquote{light} weight if you specify
+\texttt{l} and \enquote{extra bold} when you write \texttt{eb},
+etc. Over the years people came up with a number of other creative
+short codes like \texttt{k}, \texttt{j}, \texttt{t} and others with
+the result that changing a font family required different codes and
+thus prevented user from easily mixing and matching different
+families. The \emph{Font Selection Guide}~\cite{fntguide} has been
+updated to strongly recommend that the standard codes should be used
+when providing font support.
+
+Some work has been undertaken to get back to a coherent scheme and
+all the font families supported through the program \texttt{autoinst}
+are now producing the standard codes again.
\subsection{\LaTeX{} \texttt{base} and \texttt{doc} distribution reunited}
-\emph{describe}
+For a long time the \LaTeX{} distribution available from \CTAN{} was
+split into several parts to allow them to be uploaded or downloaded
+separately. As this is these days more confusing than helpful we have
+recombined the base part with the documentation part (as both are
+anyway always updated jointly. Thus the package \texttt{latex-doc}
+is no longer separately available from \CTAN{} but contained in the
+\texttt{latex-base} distribution.
\begin{thebibliography}{9}
@@ -525,6 +562,10 @@ package.
In: TUGboat, 40\#2, 2019.
\url{https://latex-project.org/publications/}
+\bibitem{fntguide} \LaTeX{} Project Team:
+ \emph{\LaTeXe{} font selection}.\\
+ \url{https://latex-project.org/documentation/}
+
\bibitem{30:site-doc}
\emph{\LaTeX{} documentation on the \LaTeX{} Project Website}.\\
\url{https://latex-project.org/documentation/}
More information about the latex3-commits
mailing list