lato (22oct17)

git-svn-id: svn://tug.org/texlive/trunk@45576 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 283 insertions, 94 deletions

diff --git a/Master/texmf-dist/doc/fonts/lato/lato.tex b/Master/texmf-dist/doc/fonts/lato/lato.tex
index f5cc4e9a687..705a6efbc59 100644
--- a/Master/texmf-dist/doc/fonts/lato/lato.tex
+++ b/Master/texmf-dist/doc/fonts/lato/lato.tex
@@ -1,5 +1,5 @@
 %% lato.tex
-%% Copyright 2011 Mohamed El Morabity
+%% Copyright 2017 Mohamed El Morabity
 %
 % This work may be distributed and/or modified under the conditions of the LaTeX
 % Project Public License, either version 1.3 of this license or (at your option)
@@ -13,13 +13,16 @@
 %
 % This work consists of all files listed in manifest.txt.
 
-\documentclass{article}
+
+\documentclass{ltxdoc}
 
 \usepackage[american]{babel}
 \usepackage{booktabs}
-\usepackage[default]{lato}
+\usepackage[T1]{fontenc}
+\usepackage{hologo}
+\usepackage[scale=1.12808,mono]{inconsolata}
+\usepackage[default,type1]{lato}
 \usepackage{microtype}
-\usepackage{multirow}
 \usepackage{path}
 \usepackage{varioref}
 \usepackage[colorlinks]{hyperref}
@@ -29,16 +32,22 @@
   pdfauthor={Mohamed El Morabity}%
 }%
 
-\newcommand{\acronym}[1]{\textsc{\lowercase{#1}}}
+\newcommand{\version}{3.0}
+
+\newcommand{\acronym}[1]{\mbox{\liningfigures{#1}}}
 \newcommand{\code}{\texttt}
 \newcommand{\command}{\texttt}
+\newcommand{\option}{\texttt}
 \newcommand{\email}[1]{\href{mailto:#1}{\nolinkurl{#1}}}
 \newcommand{\name}{}
-\newcommand{\package}{\texttt}
+\newcommand{\pkg}{\texttt}
 \newcommand{\parameter}[1]{\textnormal{\textit{#1}}}
 \newcommand{\program}{}
 
-\title{\LaTeX{} support for Lato\\Version~2.2}
+\newcommand{\figuresampleone}{+142\,521\,458.11~\texteuro}
+\newcommand{\figuresampletwo}{\textminus 21\,173.91~\$}
+
+\title{\LaTeX{} support for Lato\\Version~\version}
 
 \author{Mohamed \name{El~Morabity}\\\email{melmorabity@fedoraproject.org}}
 
@@ -50,33 +59,24 @@
 
 \section{Introduction}
 
-Lato is a sanserif typeface family designed in the Summer~2010 by Warsaw-based
-designer Łukasz \name{Dziedzic} for the tyPoland foundry (see
-figure~\vref{styles}). This font is available at its web site~\cite{lato} as
-TrueType files licensed under the \acronym{OFL} version~1.1.
+Lato is a sans-serif typeface family designed in the Summer~2010 by
+Warsaw-based designer \L ukasz \name{Dziedzic}~\cite{dziedzic} for the
+tyPoland foundry.
 
-\begin{figure}
-  \centering
-  {%
-    \flafamily%
-    {\fontseries{el}\selectfont Lato Hairline}\\
-    {\fontseries{el}\selectfont\itshape Lato Hairline Italic}\\
-    {\fontseries{l}\selectfont Lato Light}\\
-    {\fontseries{l}\selectfont\itshape Lato Light Italic}\\
-    Lato Regular\\
-    {\itshape Lato Italic}\\
-    {\bfseries Lato Bold}\\
-    {\bfseries\itshape Lato Bold Italic}\\
-    {\fontseries{eb}\selectfont Lato Black}\\
-    {\fontseries{eb}\selectfont\itshape Lato Black Italic}%
-  }
-  \caption{Available styles for Lato}
-  \label{styles}
-\end{figure}
-
-This package provides support for this font in \LaTeX{}. It includes the
-original TrueType fonts, as well as Type~1 versions, converted for this package
-using \program{FontForge} for full support with \program{Dvips}.
+Lato consists of nine weights (plus corresponding italics) and
+supports more than 100~Latin-based languages, more than
+50~Cyrillic-based languages as well as Greek and IPA phonetics.
+
+The font is available at its web site~\cite{lato} as
+\acronym{TTF}-flavored OpenType files licensed under the \acronym{OFL}
+version~1.1~\cite{ofl}.
+
+This package provides support for this font in \LaTeX, including
+\hologo{XeLaTeX} and \hologo{LuaLaTeX}. It includes the original
+OpenType fonts, as well as Type~1 versions, converted for this package
+using \program{FontForge}~\cite{fontforge} and
+\program{cfftot1}~\cite{cfftot1} for full support with \LaTeX{} and
+\program{Dvips}.
 
 \section{Installation}
 
@@ -85,18 +85,26 @@ These directions assume that your \TeX{} distribution is
 
 Once the \path|lato.zip| archive extracted:
 \begin{enumerate}
-\item Copy \path|doc/|, \path|fonts/|, \path|source/|, and \path|tex/|
-  directories to your \path|texmf/| directory (either your local or global
+\item Copy \path|doc/|, \path|fonts/|, and \path|tex/| directories to
+  your \path|texmf/| directory (either your local or global
   \path|texmf/| directory).
-\item Run \command{mktexlsr} to refresh the file name database and make \TeX{}
-  aware of the new files.
-\item Run \command{updmap --enable Map lato.map} to make \program{Dvips},
-  \program{dvipdf} and \program{pdf\TeX} aware of the new fonts.
+\item Run \command{mktexlsr} to refresh the file name database and
+  make \TeX{} aware of the new files.
+\item Run \command{updmap --enable Map lato.map}\footnote{Starting
+  with \TeX Live~2017, use \command{updmap-user} for a local
+  installation, or \command{updmap-sys} for a global one.} to make
+  \program{Dvips}, \program{dvipdf} and \program{\TeX} aware of the
+  new fonts.
 \end{enumerate}
 
-Note that this package requires the \package{keyval}~\cite{keyval} and
-\package{slantsc}~\cite{slantsc} (to handle italic/slanted small caps) ones to
-work.
+Note that this package requires the following packages to work:
+\begin{itemize}
+\item \pkg{fontaxes}
+\item \pkg{fontspec} (for \hologo{XeLaTeX}/\hologo{LuaLaTeX} support)
+\item \pkg{ifluatex}
+\item \pkg{ifxetex}
+\item \pkg{xkeyval}
+\end{itemize}
 
 \section{Usage}
 
@@ -106,116 +114,297 @@ You can use the Lato font in a \LaTeX{} document by adding the command
 \begin{verbatim}
 \usepackage{lato}
 \end{verbatim}
-to the preamble. The package supplies the \code{\char`\\flafamily} command to
+to the preamble. The package supplies the \cmd{\lato} command to
 switch the current font to Lato.
 
 \subsection{Options}
 
 \subsubsection{Lato as default (sans-serif) font}
 
-You can set \LaTeX{} to use Lato as standard font throughout the whole document
-by passing the \code{default} option to the package:
+You can set \LaTeX{} to use Lato as standard font throughout the whole
+document by passing the \option{default} option to the package:
 \begin{verbatim}
 \usepackage[default]{lato}
 \end{verbatim}
-To set Lato as default sans-serif only:
+To set Lato as default sans-serif only, use the \option{defaultsans}
+option:
 \begin{verbatim}
 \usepackage[defaultsans]{lato}
 \end{verbatim}
 
+\subsubsection{OpenType vs. Type~1}
+
+Depending on the \LaTeX{} rendering engine used, the package will
+automatically use:
+\begin{itemize}
+\item OpenType fonts with \program{\hologo{XeLaTeX}} and
+  \program{\hologo{LuaLaTeX}} (the \pkg{fontspec} package will be
+  therefore loaded)
+\item Type~1 fonts with all other \LaTeX{} rendering engines
+  (especially \program{\hologo{pdfLaTeX}})
+\end{itemize}
+
+The package was written to provide same functionalities whatever the
+\TeX{} rendering engine used. Notice that OpenType fonts supply more
+typographic features like additional ligatures or stylistic
+alternatives. The table~\vref{tab:features} describes all OpenType
+features supported by the Lato font family. Please refer to the
+\pkg{fontspec} package documentation~\cite{fontspecdoc} to enable such
+features in your documents with \hologo{XeLaTeX} or \hologo{LuaLaTeX}.
+
+\begin{table}
+  \centering
+    \begin{tabular}{ccc}
+      \toprule
+      Feature & Description & \pkg{fontspec} option\\
+      \midrule
+      \code{calt} & Contextual Alternates & \code{Contextuals=Alternate}\\
+      \code{case} & Case-Sensitive Forms & \code{Letters=Uppercase}\\
+      \code{dlig} & Discretionary Ligatures & \code{Ligatures=Rare}\\
+      \code{dnom} & Denominators & \code{VerticalPosition=Denominator}\\
+      \code{frac} & Fractions & \code{Fractions=On}\\
+      \code{kern} & Kerning & \code{Kerning=On}\\
+      \code{liga} & Standard Ligatures & \code{Ligatures=Common}\\
+      \code{lnum} & Lining Figures & \code{Numbers=Uppercase}\\
+      \code{mark} & Mark Positioning & \code{Diacritics=MarkToBase}\\
+      \code{numr} & Numerators & \code{VerticalPosition=Numerator}\\
+      \code{onum} & Oldstyle Figures & \code{Numbers=Lowercase}\\
+      \code{ordn} & Ordinals & \code{VerticalPosition=Ordinal}\\
+      \code{pnum} & Proportional Figures & \code{Numbers=Proportional}\\
+      \code{salt} & Stylistic Alternates & \code{Style=Alternate}\\
+      \code{sinf} & Scientific Inferiors & \code{VerticalPosition=ScientificInferior}\\
+      \code{ss01} & Stylistic Set 1 & \code{Alternate=1}\\
+      \code{ss02} & Stylistic Set 2 & \code{Alternate=2}\\
+      \code{ss03} & Stylistic Set 3 & \code{Alternate=3}\\
+      \code{ss04} & Stylistic Set 4 & \code{Alternate=4}\\
+      \code{subs} & Subscript & \code{VerticalPosition=Inferior}\\
+      \code{sups} & Superscript & \code{VerticalPosition=Superior}\\
+      \code{tnum} & Tabular Figures & \code{Numbers=Monospaced}\\
+      \bottomrule
+    \end{tabular}
+    \caption{OpenType font features supported by Lato fonts}
+    \label{tab:features}
+\end{table}
+
+To force Type~1 fonts with \program{\hologo{XeLaTeX}} or
+\program{\hologo{LuaLaTeX}}, use the \option{type1} option. This may
+be useful to avoid loading the \pkg{fontspec} package.
+
 \subsubsection{Font scaling}
 
-The font can be up- and downscale by any factor. This can be used to make Lato
-more friendly when used in company with other type faces, e.g., to adapt the
-x-height. The package option \code{scale=\parameter{ratio}} will scale the font
-according to \parameter{ratio} (1.0 by default), for example:
+The font can be up- and downscale by any factor. This can be used to
+make Lato more friendly when used in company with other type faces,
+e.g., to adapt the x-height. The package option
+\option{scale=\parameter{ratio}} will scale the font according to
+\parameter{ratio} (1.0 by default), for example:
 \begin{verbatim}
 \usepackage[scale=0.95]{lato}
 \end{verbatim}
 
-\subsection{Encodings}
+\subsubsection{Figure versions}
+
+Lato provides two figure styles (see table~\vref{tab:figures}):
+
+\begin{itemize}
+  \item \emph{Lining figures}, designed to match the uppercase letters
+    in size and color
+  \item \emph{Old style figures} (also known as text figures),
+    designed to match lowercase letters
+\end{itemize}
+
+The \pkg{lato} package uses lining figures by default
+(\option{lining} option). To select old style figures, use the
+\option{oldstyle} option.
+
+Two figure widths are also available:
+\begin{itemize}
+  \item \emph{Tabular figures}, which each have the same width
+  \item \emph{Proportional figures}, which vary in width according to
+    their shape
+\end{itemize}
+
+The \pkg{lato} package uses tabular figures by default
+(\option{tabular} option). To select proportional figures, use the
+\option{proportional} option.
+
+\begin{table}
+  \centering
+  \begin{tabular}{crr}
+    \toprule
+     & \multicolumn{1}{c}{Lining figures} & \multicolumn{1}{c}{Old style figures}\\
+    \midrule
+    Tabular figures& \lato\tabularfigures{\liningfigures{\figuresampleone}} & \lato\tabularfigures{\textfigures{\figuresampleone}}\\
+     & \lato\tabularfigures{\liningfigures{\figuresampletwo}} & \lato\tabularfigures{\textfigures{\figuresampletwo}}\\
+    \midrule
+    Proportional figures& \lato\proportionalfigures{\liningfigures{\figuresampleone}} & \lato\proportionalfigures{\textfigures{\figuresampleone}}\\
+     & \lato\proportionalfigures{\liningfigures{\figuresampletwo}} & \lato\proportionalfigures{\textfigures{\figuresampletwo}}\\
+    \bottomrule
+  \end{tabular}
+  \caption{Figure styles}
+  \label{tab:figures}
+\end{table}
 
-The following encodings are supported:
-\begin{center}
-  OT1, T1, TS1 (partial)
-\end{center}
-To use one or another encoding, give the \LaTeX{} name to the \package{fontenc}
-package as usual, as in
+Notice that some characters, like math operators in text mode and
+currency units, will adapt to the select figure width and style
+combination.
+
+The package also supports and loads the
+\pkg{fontaxes}~\cite{fontaxes} package. This package supplies
+macros to individually select figure style and width
+locally~\cite{fontaxesdoc}.
+
+\subsubsection{Encodings}
+
+The following \LaTeX{} encodings are supported:
+\begin{description}
+\item[Latin] \acronym{OT1}, \acronym{T1}, \acronym{TS1} (partial)
+\item[Cyrillic] \acronym{T2A}, \acronym{T2B}, \acronym{T2C}, \acronym{X2}
+\item[Greek] \acronym{LGR} (monotonic and polytonic)
+\end{description}
+To use one or another encoding, give the \LaTeX{} name to the
+\pkg{fontenc} package as usual, as in
 \begin{verbatim}
 \usepackage[T1]{fontenc}
 \usepackage{lato}
 \end{verbatim}
 
-Note that, as usual with OT1 encoded fonts, kerning with accented characters is
-treated poorly, if at all. Note difference in kerning between these two encoding
-in table~\vref{kerning}.
+As usual with \acronym{OT1} encoded fonts, kerning with accented
+characters is treated poorly, if at all. Note difference in kerning
+between these two encoding in table~\vref{tab:kerning}. It is
+therefore advised to always use the Lato font family in any encoding
+than \acronym{OT1} when typing diacritics.
+
 \begin{table}
   \centering
   \begin{tabular}{ll}
     \toprule
-    OT1-encoded&{\flafamily To Ta T\'e}\\
+    OT1-encoded & {\lato\fontencoding{OT1}\selectfont To Ta T\'e}\\
     \midrule
-    T1-encoded&{\flafamily\fontencoding{T1}\selectfont To Ta T\'e}\\
+    T1-encoded & {\lato\fontencoding{T1}\selectfont To Ta T\'e}\\
     \bottomrule
   \end{tabular}
   \caption{Kerning with OT1 and T1 encodings}
-  \label{kerning}
+  \label{tab:kerning}
+\end{table}
+
+\subsection{Available weights, shapes and variants}
+
+Table~\vref{tab:fonts} lists the available font series and shapes with
+their \acronym{NFSS} classification. Parenthesized combinations are
+provided via substitutions.
+
+\begin{table}
+  \centering
+    \begin{tabular}{cccc}
+      \toprule
+      Font & Series & Shape & OpenType font file\\
+      \midrule
+      {\lato\fontseries{ul}\selectfont Lato Hairline} & \code{ul} & \code{n} & \path|Lato-Hairline.ttf|\\
+      {\lato\fontseries{ul}\selectfont\itshape Lato Hairline Italic} & \code{ul} & \code{it} (\code{sl}) & \path|Lato-HairlineItalic.ttf|\\
+      {\lato\fontseries{el}\selectfont Lato Thin} & \code{el} & \code{n} & \path|Lato-Thin.ttf|\\
+      {\lato\fontseries{el}\selectfont\itshape Lato Light Thin} & \code{el} & \code{it} (\code{sl}) & \path|Lato-ThinItalic.ttf|\\
+      {\lato\fontseries{l}\selectfont Lato Light} & \code{l} & \code{n} & \path|Lato-Light.ttf|\\
+      {\lato\fontseries{l}\selectfont\itshape Lato Light Italic} & \code{l} & \code{it} (\code{sl}) & \path|Lato-LightItalic.ttf|\\
+      {\lato\mdseries Lato Regular} & \code{m} & \code{n} & \path|Lato-Regular.ttf|\\
+      {\lato\mdseries\itshape Lato Italic} & \code{m} & \code{it} (\code{sl}) & \path|Lato-Italic.ttf|\\
+      {\lato\fontseries{mb}\selectfont Lato Medium} & \code{mb} & \code{n} & \path|Lato-Medium.ttf|\\
+      {\lato\fontseries{mb}\selectfont\itshape Lato Medium Italic} & \code{mb} & \code{it} (\code{sl}) & \path|Lato-MediumItalic.ttf|\\
+      {\lato\fontseries{sb}\selectfont Lato Semibold} & \code{sb} & \code{n} & \path|Lato-Semibold.ttf|\\
+      {\lato\fontseries{sb}\selectfont\itshape Lato Semibold Italic} & \code{sb} & \code{it} (\code{sl}) & \path|Lato-SemiboldItalic.ttf|\\
+      {\lato\bfseries Lato Bold} & \code{b} (\code{bx}) & \code{n} & \path|Lato-Bold.ttf|\\
+      {\lato\bfseries\itshape Lato Bold Italic} & \code{b} (\code{bx}) & \code{it} (\code{sl}) & \path|Lato-BoldItalic.ttf|\\
+      {\lato\fontseries{eb}\selectfont Lato Heavy} & \code{eb} & \code{n} & \path|Lato-Heavy.ttf|\\
+      {\lato\fontseries{eb}\selectfont\itshape Lato Heavy Italic} & \code{eb} & \code{it} (\code{sl}) & \path|Lato-HeavyItalic.ttf|\\
+      {\lato\fontseries{ub}\selectfont Lato Black} & \code{ub} & \code{n} & \path|Lato-Black.ttf|\\
+      {\lato\fontseries{ub}\selectfont\itshape Lato Black Italic} & \code{ub} & \code{it} (\code{sl}) & \path|Lato-BlackItalic.ttf|\\
+      \bottomrule
+    \end{tabular}
+    \caption{Available font styles}
+    \label{tab:fonts}
 \end{table}
-It is therefore advised to always use the Lota fonts in any encoding than OT1
-when typing diacritics.
 
-\subsection{Available weights and variants}
+In addition, each font variant combination (figure width/figure style)
+corresponds to a \acronym{NFSS} family (see
+table~\vref{tab:families}).
 
-Table~\vref{nfss} lists the available font series and shapes with their
-\acronym{NFSS} classification. Parenthesized combinations are provided via
-substitutions.
 \begin{table}
   \centering
-  \begin{tabular}{llll}
+  \begin{tabular}{ccc}
     \toprule
-    family&encoding&series&shape\\
+     & Lining figures & Old style figures\\
+    \midrule
+    Tabular figures & \code{lato-TLF} & \code{lato-TOsF}\\
     \midrule
-    \multirow{2}{*}{fla}&OT1, T1&\multirow{2}{*}{el, l, m, b (bx), eb}&n, it (sl), sc, scit (scsl)\\
-    \cmidrule{2-2}
-    \cmidrule{4-4}
-    &TS1&&n, it (sl)\\
+    Proportional figures & \code{lato-LF} & \code{lato-OsF}\\
     \bottomrule
   \end{tabular}
-  \caption{Available font series and shapes for Lato}
-  \label{nfss}
+  \caption{Available \acronym{NFSS} families}
+  \label{tab:families}
 \end{table}
-Notice that the small capitals are faked ones (reduced to 80\%).
 
 Samples of the font are available in the
 \href{run:lato-samples.pdf}{\path|lato-samples.pdf|} file.
 
+\subsection{Math support}
+
+The \pkg{lato} package doesn't provide math support. However the
+\pkg{mdsymbol} package~\cite{mdsymbol} provides mathematical symbol
+fonts which fit very well with Lato. In addition, the
+\pkg{mathspec}~\cite{mathspec} package (for \hologo{XeLaTeX} or
+\hologo{LuaLaTeX} engines) or the
+\pkg{mathastext}~\cite{mathastext}\footnote{In particular with the
+  \code{LGR} option to get Greek letters from the Lato fonts} package
+(for other \LaTeX{} engines) can be called to use Lato as math font.
+
 \section{Known bugs and improvements}
 
-Please send bug reports and suggestions about the Lato \LaTeX{} support to
-\href{mailto:melmorabity@fedoraproject.org}{Mohamed \name{El~Morabity}}.
+Please send bug reports and suggestions about the Lato \LaTeX{}
+support to \href{mailto:melmorabity@fedoraproject.org}{Mohamed
+  \name{El~Morabity}}.
+
+\subsection{Compatibility with previous versions}
 
-\subsection{Small dotless ``j''}
+\subsubsection{Legacy \code{fla} family}
 
-The Lato font files do not provide any dotless ``j'' glyph. This \LaTeX{}
-support provides a faked one ({\flafamily\j}), available by typing
-\code{\char`\\j}, and built using the \command{t1dotlessj} command (from
-LCDF~Typetools~\cite{lcdf}).
+Previous versions of the package used to provide \code{fla} as default
+\acronym{NFSS} family for Lato, and the corresponding \cmd{\flafamily}
+switch command. Such family and macro are still available in newer
+package versions. In particular, the \code{fla} family is now an alias
+for the \code{lato-TLF} one.
+
+\subsubsection{Smallcaps}
+
+Since the Lato font family doesn't provide yet ``real'' smallcaps,
+faked ones were supplied by previous versions of the \pkg{lato}
+package (by scaling down uppercase letters), with a very poor
+result. Furthermore, there's no convenient way to generate fake
+smallcaps with \hologo{XeTeX} or \hologo{LuaTeX} engines and native
+OpenType fonts.
+
+For these reasons, faked small caps are no longer provided, starting
+with version~3.0 of the \pkg{lato} package. Anyway \LaTeX{} should
+automatically substitute missing smallcap shapes by normal ones.
 
 \section{License}
 
-This package is released under the \LaTeX{} project public license, either
-version~1.3c or above~\cite{lppl}. Anyway both the TrueType and Type~1 files are
-delivered under the Open Font License version~1.1~\cite{ofl}.
+This package is released under the \LaTeX{} project public license,
+either version~1.3c or above~\cite{lppl}. Anyway both OpenType and
+Type~1 files are delivered under the Open Font License
+version~1.1~\cite{ofl}.
 
 \begin{thebibliography}{9}
+\bibitem{dziedzic} \url{http://www.lukaszdziedzic.eu/}
 \bibitem{lato} \url{http://www.latofonts.com/}
-\bibitem{keyval}
-  \url{http://www.ctan.org/tex-archive/macros/latex/required/graphics/}
-\bibitem{slantsc}
-  \url{http://www.ctan.org/tex-archive/macros/latex/contrib/slantsc/}
-\bibitem{lcdf} \url{http://www.lcdf.org/type/}
-\bibitem{lppl} \url{http://www.latex-project.org/lppl/lppl-1-3c.html}
 \bibitem{ofl} \url{http://scripts.sil.org/OFL_web}
+\bibitem{fontforge} \url{https://fontforge.github.io/}
+\bibitem{cfftot1} \url{https://www.lcdf.org/type/cfftot1.1.html}
+\bibitem{fontspecdoc} \url{https://mirrors.ctan.org/macros/xetex/latex/fontspec/fontspec.pdf}
+\bibitem{fontaxes} \url{https://www.ctan.org/pkg/fontaxes}
+\bibitem{fontaxesdoc} \url{http://mirrors.ctan.org/macros/latex/contrib/fontaxes/fontaxes.pdf}
+\bibitem{mdsymbol} \url{https://www.ctan.org/pkg/mdsymbol}
+\bibitem{mathspec} \url{https://www.ctan.org/pkg/mathspec}
+\bibitem{mathastext} \url{https://www.ctan.org/pkg/mathastext}
+\bibitem{lppl} \url{http://www.latex-project.org/lppl/lppl-1-3c.html}
 \end{thebibliography}
 
 \end{document}