[latex3-commits] [git/LaTeX3-latex3-latex2e] develop: Track some changes in 2020/02/02 release (#347) (cc176eb6)
GitHub
noreply at github.com
Sat Jun 27 12:05:11 CEST 2020
Repository : https://github.com/latex3/latex2e
On branch : develop
Link : https://github.com/latex3/latex2e/commit/cc176eb668406f9bcb875fbaeb6a11bc040d37e0
>---------------------------------------------------------------
commit cc176eb668406f9bcb875fbaeb6a11bc040d37e0
Author: dr-scsi <59777257+dr-scsi at users.noreply.github.com>
Date: Sat Jun 27 12:05:11 2020 +0200
Track some changes in 2020/02/02 release (#347)
* Track some changes in 2020/02/02 release
* base/doc/fntguide.tex (subsection{Text font attributes}):
Document new font shapes and their respective author commands.
(subsection{Parameters for author commands}): Describe the default
values for the new font shapes.
(subsection{Font series defaults per document family}): Add
section for new kernel commands replacing mweights.sty.
(subsection{Handling of nested emphasis}): Add section for new
emphasis handling.
* Track some changes in 2020/02/02 release
* base/doc/fntguide.tex (subsection{Text font attributes}):
Document new font shapes and their respective author commands.
(subsection{Parameters for author commands}): Describe the default
values for the new font shapes.
(subsection{Font series defaults per document family}): Add
section for new kernel commands replacing mweights.sty.
(subsection{Handling of nested emphasis}): Add section for new
emphasis handling.
>---------------------------------------------------------------
cc176eb668406f9bcb875fbaeb6a11bc040d37e0
base/doc/fntguide.tex | 101 ++++++++++++++++++++++++++++++++++++++++++++------
1 file changed, 90 insertions(+), 11 deletions(-)
diff --git a/base/doc/fntguide.tex b/base/doc/fntguide.tex
index 8610bc99..59d61e1f 100644
--- a/base/doc/fntguide.tex
+++ b/base/doc/fntguide.tex
@@ -35,10 +35,10 @@
\title{\LaTeXe{} font selection}
-\author{\copyright~Copyright 1995--2019, \LaTeX3 Project Team.\\
+\author{\copyright~Copyright 1995--2020, \LaTeX3 Project Team.\\
All rights reserved.}
-\date{October 2019}
+\date{February 2020}
\begin{document}
@@ -284,14 +284,26 @@ naming scheme to allow for sensible default substitutions if necessary,
e.g., ``demi-bold'' is normally just another name for ``semi-bold'', so
should get |sb| assigned, etc.
+\NEWdescription{2020/02/02}
The most common values for the font shape are:
\begin{center}
\begin{minipage}{.7\linewidth}
\begin{tabular}{rl}
- |n| & Normal (that is `upright' or `roman') \\
- |it| & Italic \\
- |sl| & Slanted (or `oblique') \\
- |sc| & Caps and small caps
+ |n| & Normal (that is `upright' or `roman') \\
+ |it| & Italic \\
+ |sl| & Slanted (or `oblique') \\
+ |sc| & Caps and small caps \\
+ |scit| & Caps and small caps italic \\
+ |scsl| & Caps and small caps slanted \\
+ |sw| & Swash
+ \end{tabular}
+ \end{minipage}
+\end{center}
+A less common value for font shape is:
+\begin{center}
+ \begin{minipage}{.7\linewidth}
+ \begin{tabular}{rl}
+ |ssc| & Spaced caps and small caps
\end{tabular}
\end{minipage}
\end{center}
@@ -337,6 +349,9 @@ The author commands for fonts set the five attributes:
|\textit{..}| or |\itshape| & shape & |it| \\
|\textsl{..}| or |\slshape| & shape & |sl| \\
|\textsc{..}| or |\scshape| & shape & |sc| \\
+ |\textssc{..}| or |\sscshape| & shape & |ssc| \\
+ |\textsw{..}| or |\swshape| & shape & |sw| \\
+ |\textulc{..}| or |\ulcshape| & shape & |ulc| \\
|\tiny| & size & |5pt| \\
|\scriptsize| & size & |7pt| \\
|\footnotesize| & size & |8pt| \\
@@ -489,14 +504,27 @@ the fonts provided by |psnfss|) is to define silent substitutions from
and the |ssub| size function, see Section~\ref{sec:sizefunct}.
\begin{decl}
- |\itdefault| \\
- |\sldefault| \\
- |\scdefault| \\
+ |\itdefault| \\
+ |\sldefault| \\
+ |\scdefault| \\
+ |\sscdefault| \\
+ |\swdefault| \\
+ |\ulcdefault| \\
|\updefault|
\end{decl}
+\NEWfeature{2020/02/02}
The shapes selected by |\textit|, |\itshape|, |\textsl|, |\slshape|,
-|\textsc|, |\scshape|, |\textup| and |\upshape|. By default these are
-|it|, |sl|, |sc| and |n|.
+|\textsc|, |\scshape|, |\textssc|, |\sscshape|, |\textsw|, |\swshape|,
+|\textulc|, |\ulcshape|, |\textup| and |\upshape|. By default these are
+|it|, |sl|, |sc|, |ssc|, |sw|, |ulc| and |n|. |ulc| is special here
+since it is a virtual one; it doesn't exist as a real shape. The
+respective macros |\textulc| or |\ulcshape| change small capitals back
+to upper/lower case but will not change the font with respect to
+italics, slanted or swash. |\upshape| or |\textup| in contrast will
+switch italics or slanted back to upright but not alter the state of
+upper/lower case, e.g., keep small capitals if present. Finally, the
+command |\normalshape| is provided to reset the shape back to normal
+which is a shorthand for |\upshape\ulcshape|.
Note that there are no parameters for the size commands. These should
be defined directly in class files, for example:
@@ -1874,6 +1902,57 @@ dependencies that you have to obey:
declarations.
\end{itemize}
+\subsection{Font series defaults per document family}
+
+\NEWfeature{2020/02/02}
+With additional weights and widths being available in many font families
+nowadays, it is more likely that somebody will want to match, say, a
+medium weight serif family with a semi-light sans serif family, or that
+with one family one wants to use the bold-extended face when |\textbf|
+is used, while with another it should be bold (not extended) or
+semi-bold, etc. The default values can be altered using the
+|\DeclareFontSeriesDefault| declaration in packages or document
+preambles:
+\begin{decl}
+ |\DeclareFontSeriesDefault| \oarg{meta family}
+ \arg{meta series} \arg{series value}
+\end{decl}
+This declaration takes three arguments:
+\begin{description}
+\item[Meta family interface:] Can be either |rm|, |sf| or |tt|. This is
+ optional and if not present the next two arguments apply to the
+ overall default.
+\item[Meta series interface:] Can be |md| or |bf|.
+\item[Series value:] This is the value that is going to be used when the
+ combination of \oarg{meta family} and \arg{meta series} is requested.
+\end{description}
+For example,
+\begin{verbatim}
+ \DeclareFontSeriesDefault[rm]{bf}{sb}
+\end{verbatim}
+would use |sb| (semi-bold) when |\rmfamily\bfseries| is requested in
+document.
+
+\subsection{Handling of nested emphasis}
+
+\begin{decl}
+ |\DeclareEmphSequence| \arg{list of font declarations}
+\end{decl}
+
+\NEWfeature{2020/02/02}
+This declaration takes a comma separated list of font declarations each
+specifying how increasing levels of emphasis should be handled. For
+example:
+\begin{verbatim}
+ \DeclareEmphSequence{\itshape,%
+ \upshape\scshape,%
+ \itshape}
+\end{verbatim}
+uses italics for the first, small capitals for the second, and italic
+small capitals for the third level. If there are more nesting levels
+than provided, declarations stored in |\emreset| (by default
+|\ulcshape\upshape|) are used for the next level and then the list
+restarts.
\section{If you need to know more \ldots}
More information about the latex3-commits
mailing list.