[latex3-commits] [git/LaTeX3-latex3-latex2e] develop: Document \DeclareFontFamilySubstitution (#349) (221041f3)

[GitHub]

Repository : https://github.com/latex3/latex2e
On branch  : develop
Link       : https://github.com/latex3/latex2e/commit/221041f34d0d4668c569e70d03f1dbf0bb62e015

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

commit 221041f34d0d4668c569e70d03f1dbf0bb62e015
Author: dr-scsi <59777257+dr-scsi at users.noreply.github.com>
Date:   Wed Jul 1 13:14:45 2020 +0200

    Document \DeclareFontFamilySubstitution (#349)
    
    * base/doc/fntguide.tex (subsection{Providing font family
    substitutions}): Document new declaration
    \DeclareFontFamilySubstitution.
    (subsection{Font series defaults per document family}): Use \m for
    description of macro arguments.


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

221041f34d0d4668c569e70d03f1dbf0bb62e015
 base/doc/fntguide.tex | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/base/doc/fntguide.tex b/base/doc/fntguide.tex
index 59d61e1f..c99e2c56 100644
--- a/base/doc/fntguide.tex
+++ b/base/doc/fntguide.tex
@@ -1924,7 +1924,7 @@ This declaration takes three arguments:
   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.
+  combination of \m{meta family} and \m{meta series} is requested.
 \end{description}
 For example,
 \begin{verbatim}
@@ -1954,6 +1954,25 @@ than provided, declarations stored in |\emreset| (by default
 |\ulcshape\upshape|) are used for the next level and then the list
 restarts.
 
+\subsection{Providing font family substitutions}
+
+\begin{decl}
+  |\DeclareFontFamilySubstitution| \arg{encoding}
+                                   \arg{family}
+                                   \arg{new-family}
+\end{decl}
+
+\NEWfeature{2020/02/02}
+This declaration selects the font family \m{new-family} as replacement
+for \m{family} in the font encoding \m{encoding}.  For example,
+\begin{verbatim}
+   \DeclareFontFamilySubstitution{LGR}
+           {Montserrat-LF}{IBMPlexSans-TLF}
+\end{verbatim}
+tells \LaTeX{} to substitute the sans serif font |Montserrat-LF| in the
+Greek encoding |LGR| with |IBMPlexSans-TLF| once requested in a
+document.
+
 \section{If you need to know more \ldots}
 
 \NEWdescription{1996/06/01}