summaryrefslogtreecommitdiff
path: root/fonts/etbb/doc/ETbb-doc.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-02-05 03:00:59 +0000
committerNorbert Preining <norbert@preining.info>2022-02-05 03:00:59 +0000
commit08ccf305ee79ab8e5ba9d1a8f3d22e74dccedd80 (patch)
tree814254dfa55b15022a4361ba4e12cccdcdac1f2a /fonts/etbb/doc/ETbb-doc.tex
parentb7a48c5e229d2c195b6a32bfd73a1036a31f2df3 (diff)
CTAN sync 202202050300
Diffstat (limited to 'fonts/etbb/doc/ETbb-doc.tex')
-rw-r--r--fonts/etbb/doc/ETbb-doc.tex53
1 files changed, 36 insertions, 17 deletions
diff --git a/fonts/etbb/doc/ETbb-doc.tex b/fonts/etbb/doc/ETbb-doc.tex
index 1746dd93b6..bec5cc3c62 100644
--- a/fonts/etbb/doc/ETbb-doc.tex
+++ b/fonts/etbb/doc/ETbb-doc.tex
@@ -12,6 +12,7 @@
\usepackage{xcolor}
\usepackage{upquote}
\usepackage{fancyvrb}
+\usepackage{trace}
\def\yellow#1{\setlength{\fboxrule}{0pt}%
\setlength{\fboxsep}{0pt}%
\colorbox{yellow}{#1}}
@@ -29,7 +30,6 @@
\usepackage{pgffor}
\usepackage{etoolbox}
%\usepackage{lipsum}
-\usepackage{trace}
\makeatletter
\long\def\thegrid#1#2{\edef\scanp@gcmd{\noexpand\put(0,0){\noexpand\line(1,0){#1}}
\noexpand\put(0,0){\noexpand\line(0,1){#2}}
@@ -45,7 +45,7 @@
\put(-100,\y){\color{red!50}\line(1,0){4100}}%
\put(-200,\y){\y}
}
-\foreach\x in {0,500,...,4000}{%
+\foreach\x in {0,500,...,4000}{%
\put(\x,-500){\color{red!50}\line(0,1){1500}}%
\put(\x,-150){\x}}
}
@@ -59,14 +59,12 @@
%\pagestyle{empty}
\begin{document}
%\SS \ss \textsc{\ss} \MakeUppercase{\ss}
-%\fonttable{ETbb1-Regular-tlf-sc-t1}
-%\end{document}
\maketitle
\section*{Background}
+
The fonts in this package were derived ultimately from the collection of fonts commissioned by Edward Tufte for his own books, and released in 2015 as {\tt ET-Bembo} under the MIT license. (The sources for that collection were fonts using the family name ET-book.) That collection was enhanced in 2019 under the name {\tt XETBook} by Daniel Benjamin Miller, and it is his package which was the starting point for {\tt ETbb}, where the {\tt bb} denotes the Berry abbreviation for Bembo. The final section of this document makes a detailed comparison with the earlier {\tt fbb} package, which is also Bembo-like, derived from {\tt Cardo.} The most significant differences are that {\tt ETbb} has a regular upright that is about 20\% darker than the corresponding {\tt fbb}, and its ascender height is noticeably less. These differences make {\tt ETbb} have a less spindly appearance that is closer in spirit to the print produced by traditional metal versions of Bembo.
-%\fonttable{ETbb1-Regular-tlf-t1}
\section*{Package properties}
@@ -88,15 +86,16 @@ The scale has been increased by 3.36\% so that the x-height of the upright regul
\url{https://ia601405.us.archive.org/34/items/ita-bnc-ald-00000673-001/ita-bnc-ald-00000673-001.pdf}.\\
(A higher resolution rendering of a two-page sample is available from \url{https://upload.wikimedia.org/wikipedia/commons/8/89/De_Aetna_1495.jpg.})
\end{itemize}
-%\fonttable{ETbb-Regular-tlf-t1}
-%\end{document}
+
\section*{Package options and macros}
+
This package has most of the same features and options as the {\tt fbb} package and even includes the {\tt altP} option, though that has no effect because the alternate P shapes in {\tt fbb} are the default in {\tt ETbb}.
In the original {\tt XETBook}, the dollar and cent currency symbols were oldstyle. I've added the new style symbols and made them the default, but option {\tt osdollar} to {\tt ETbb} changes back to the oldstyle symbols.
-\textbf{New in version $1.05$:} A swash version of Q has been added to all faces. You may enable it globally using option {\tt swashQ} to {\tt ETbb}, or specify it locally with the macro \verb|\Qswash|, which renders as \Qswash. If you had enabled it globally, you have access to the ordinary Q with the macro \verb|\Qnoswash|.
+
+\textbf{New in version $1.05$:} A swash version of Q has been added to all faces. You may enable it globally using option {\tt swashQ} to {\tt ETbb}, or specify it locally with the macro \verb|\Qswash|, which renders as \Qswash. This document did not specify option {\tt swashQ}. If you had enabled it globally, you have access to the ordinary Q with the macro \verb|\Qnoswash|. You may find it simpler to use the macro \verb|\altQ| which renders Q as ordinary Q if you had specified option {\tt swashQ} and as \altQ\ if not.
Text figures may be selected from four types:
\begin{itemize}
@@ -127,17 +126,17 @@ The package also defines macros that allow you use alternate figure styles local
\end{tabular}
\end{center}
The macro \verb|\textlf{123}| is identical in effect to \verb|{\lfstyle 123}|, and similarly for the other lining and oldstyle macros, while \verb|\textsu{123}| has the same effect as \verb|{\sufigures 123}|
-and \verb|\textin{123}| has the same effect as \verb|{\infigures 123}|.
-If you prefer typing longer names, you may use \verb|\textinferior| as a synonym for \verb|\textin|, and similarly for \verb|\textsu|. Likewise,
+and \verb|\textinf{123}| has the same effect as \verb|{\infigures 123}|.
+If you prefer typing longer names, you may use \verb|\textinferior| as a synonym for \verb|\textinf|, and similarly for \verb|\textsu|. Likewise,
\verb|\textde{123}| has the same effect as \verb|{\defigures 123}| or \verb|{\denomfigures 123}|, and you may use \verb|\textdenom| as a synonym for \verb|\textde|. Note the difference in baseline between \verb|\textinf| and \verb|\textde|: \textinf{123} versus \textde{123}.
The \verb|\textfrac| macro constructs fractions using \verb|\textsu| and \verb|\textde| with baseline aligned with the text baseline. The behavior is somewhat configurable, there being two parameters available to control the kerns before and after the fraction solidus. The two parameters are passed as options to {\tt ETbb}, named
\begin{verbatim}
-foresolidus % default value -.04em
-aftsolidus % default value -.04em
+foresolidus % default value -.05em
+aftsolidus % default value -.05em
\end{verbatim}
%raisefrac % default value 0em
-(The values should always be {\tt em} units in order to behave correctly with respect to scaling.)
+(The values should always be {\tt em} or {\tt ex} units in order to behave correctly with respect to scaling.)
%If you were to change the default behavior with the option
%\begin{verbatim}
%raisefrac=-112em
@@ -150,7 +149,10 @@ aftsolidus % default value -.04em
%All the above have to do with globally defined settings for \verb|\textfrac|, but that macro allows one optional argument that can override the effect of {\tt raisefrac}, with, e.g., \verb|\textfrac[.1em][6}{11}| raising the fraction 6/11 by {\tt .1em} instead of the default specified in the original options.
\textsc{Example:}\\
-$\bullet$ \verb|\textfrac[2]{17}{32}| renders as \textfrac[2]{17}{32} with default settings. (The optional argument 2 will always print in lining figres, not matter the choice of the text figure style.)\\
+$\bullet$ \verb|\textfrac[2]{17}{32}| renders as \textfrac[2]{17}{32} with default settings. (The optional argument 2 will always print in lining figures, no matter the choice of the text figure style.)\\
+
+If you load the {\tt ETbb} package by means of option {\tt etbb} to the {\tt newtx} package, version 1.71 or higher, there is a stacked fraction construction available using the macro \verb|\textsfrac| which behaves like \verb|\textfrac| except with the fractional part stacked vertically rather than diagonally. See the {\tt newtx} documentation for details and examples.
+
%$\bullet$ \verb|2\textfrac[.053em]{17}{32}| produces a fraction centered on the mid-height of lining figures: 2\textfrac[.053em]{17}{32}.\\
%$\bullet$ \verb|2\textfrac[0em]{17}{32}| produces a fraction with numerator and denominator at the normal heights of superior and inferior figures: 2\textfrac[0em]{17}{32}.\\
@@ -230,7 +232,7 @@ The layout of the TS1 encoded Text Companion font, which is rendered \emph{in re
\fonttable{ETbb-Regular-tosf-ts1}
-\newpage
+
\textbf{List of macros to access the TS1 symbols in text mode:}\\
%(Note that slots 0--12 and 26--29 are accents, used like \verb|\t{a}| for a tie accent over the letter a. Slots 23 and 31 do not contain visible glyphs, but have heights indicated by their names.)
(The commented lines are in {\tt fbb} but not {\tt ETbb}.)
@@ -373,7 +375,9 @@ Because the package supplies a file named {\tt ETbb.fontspec} whose contents lis
Other than the usual choices of figure style, the only remaining choice available is through {\tt StylisticSet=2}, which substitutes the new Sharp S glyphs in place of the familiar \ss, \SS\ and \textsc{\ss}. See the table in the next section for details.
\section*{Selection of the new Sharp S in LaTeX}
-The following table summarizes the behavior of the text macros \verb|\SS|, \verb|\ss| and the macro \verb|\MakeUppercase|.
+There is now an {\tt ETbb} option {\tt sharpS} whose effect in legacy LaTeX is summarized below.
+
+Behavior of the text macros \verb|\SS|, \verb|\ss| and the macro \verb|\MakeUppercase|.
\begin{center}
\begin{tabular}{@{} ccccc @{}}
@@ -385,7 +389,7 @@ The following table summarizes the behavior of the text macros \verb|\SS|, \verb
\hline
\end{tabular}
\end{center}
-In unicode TeX, the behavior laid out in the table above is achieved using {\tt StylisticSet=2}.
+In unicode TeX, the behavior laid out in the table above is achieved using {\tt StylisticSet=2}.
%\begin{center}
% \begin{tabular}{@{} lcl @{}}
@@ -468,6 +472,21 @@ Non tellus orci ac auctor augue mauris augue neque gravida. Bibendum at varius v
}
\end{multicols}
+\textbf{ETbb-Regular-tlf-t1}
+
+\fonttable{ETbb-Regular-tlf-t1}
+\newpage
+\textbf{ETbb1-Regular-tlf-t1}
+
+\fonttable{ETbb1-Regular-tlf-t1}
+\newpage
+\textbf{ETbb-Regular-tlf-sc-t1}
+
+\fonttable{ETbb-Regular-tlf-sc-t1}
+\newpage
+\textbf{ETbb1-Regular-tlf-sc-t1}
+
+\fonttable{ETbb1-Regular-tlf-sc-t1}
%This is a fraction \textfrac{23}{52}, \textfrac{71}{12}, \textfrac{17}{75}, \textfrac{34}{43}.