summaryrefslogtreecommitdiff
path: root/fonts/etbb/doc/ETbb-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'fonts/etbb/doc/ETbb-doc.tex')
-rw-r--r--fonts/etbb/doc/ETbb-doc.tex200
1 files changed, 111 insertions, 89 deletions
diff --git a/fonts/etbb/doc/ETbb-doc.tex b/fonts/etbb/doc/ETbb-doc.tex
index 470b89e411..a46a8bb5ff 100644
--- a/fonts/etbb/doc/ETbb-doc.tex
+++ b/fonts/etbb/doc/ETbb-doc.tex
@@ -2,7 +2,7 @@
\documentclass[11pt]{article}
\usepackage[margin=1in]{geometry}
\usepackage[parfill]{parskip}% Begin paragraphs with an empty line, no indent
-%\pdfmapfile{+ETbb.map}
+\pdfmapfile{=ETbb.map}
\usepackage{multicol}
\usepackage{enumitem}
\setlist[description]{style=sameline,font=\mdseries\scshape}
@@ -78,8 +78,10 @@ The scale has been increased by 3.36\% so that the x-height of the upright regul
\item The lining figures in some faces were reduced so as to be a bit less than the cap-heights.
\item The lining figures in {\tt XETBook} were proportional rather than tabular. I've added new tabular lining and old-style figures.
\item Added superior letters and figures to all faces. E.g., \verb|\textsu{ABCabc123}| renders as \textsu{ABCabc123}.
-\item Added inferior figures to all faces.
+\item Added inferior figures to all faces with baseline at -112{\tt em}.
+\item Added denominator figures to all faces with baseline at 0{\tt em}.
\item The originals comprised glyphs in the Adobe Standard Encoding, forming a rather sparse subset of the T1 encoding. I've added accented and composite glyphs that provide complete coverage of the T1 encoding as well as many glyphs required in the orthography of a number Eastern European countries.
+\item Prior to version 1.02, coverage of TS$1$ encoding was meager. The coverage is now close to full. (See the table at the end of this document.)
\item Small caps have been added to all faces.
\item There is a new glyph for the German capital sharp S ({\altr\char223}, \textit{gro\ss es eszett}, {\tt U+1E9E}), approved in 2017 for optional use in German orthography. Small cap versions are also provided.
\item The glyph capital P has been changed from its default closed shape, as used in almost all modern digital renderings of Bembo, to the more historically accurate open shape. See, for example, the reproduction of Pietro Bembo's \textit{De Aetna} at \\
@@ -92,6 +94,7 @@ The scale has been increased by 3.36\% so that the x-height of the upright regul
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.
Text figures may be selected from four types:
@@ -104,6 +107,7 @@ Tabular lining (TLF), selected by options {\tt lining [or lf], tabular [or t]};
Proportional oldstyle (OsF), selected by option {\tt oldstyle [or osf], proportional [or p]};
\item
Tabular oldstyle (TOsF), selected by options {\tt oldstyle [or osf], tabular [or t]}.
+\item
\end{itemize}
The package also defines macros that allow you use alternate figure styles locally:
@@ -118,35 +122,53 @@ The package also defines macros that allow you use alternate figure styles local
\verb|\texttosf{0123456789}| &\texttosf{0123456789}& print 0123456789 in tabular oldstyle figures\\
\verb|\textsu{0123456789}| &\textsu{0123456789}& print 0123456789 in superior figures\\
\verb|\textin{0123456789}| &\textin{0123456789}& print 0123456789 in inferior figures\\
+\verb|\textde{0123456789}| &\textde{0123456789}& print 0123456789 in denominator figures\\
\bottomrule
\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|.
+If you prefer typing longer names, you may use \verb|\textinferior| as a synonym for \verb|\textin|, 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|\textin| and \verb|\textde|: \textin{123} versus \textde{123}.
-The \verb|\textfrac| macro constructs fractions using \verb|\textsu| and \verb|\textin|, raising the result to align with the text baseline. The behavior is quite configurable, there being three parameters available to control the kerns before and after the fraction solidus, and the amount to raise the resulting box. The three parameters are passed as options to {\tt ETbb}, named
+The \verb|\textfrac| macro constructs fractions using \verb|\textsu| and \verb|\textde| with baseline aligned with the text baseline. The behavior is quite configurable, there being three parameters available to control the kerns before and after the fraction solidus, and the amount to raise the resulting box. The three parameters are passed as options to {\tt ETbb}, named
\begin{verbatim}
-foresolidus % default value -.03em
-aftsolidus % default value .02em
-raisefrac % default value .111em
+foresolidus % default value -.05em
+aftsolidus % default value -.08em
+raisefrac % default value 0em
\end{verbatim}
(The values should always be {\tt em} units in order to behave correctly with respect to scaling.)
If you were to change the default behavior with the option
\begin{verbatim}
-raisefrac=0em
-\end{verbatim}
-you would get a fraction with the denominator's baseline at the baseline of the \verb|\textin| figures, namely {\tt -.111em}. Those who wish the fractional part to be vertically centered with respect to lining figures should specify
-\begin{verbatim}
-raisefrac=.053em
+raisefrac=-112em
\end{verbatim}
+you would get a fraction with the denominator's baseline at the baseline of the \verb|\textin| figures, namely {\tt -.112em}.
+%Those who wish the fractional part to be vertically centered with respect to lining figures should specify
+%\begin{verbatim}
+%raisefrac=-.056em
+%\end{verbatim}
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{Examples:}\\
+\textsc{Example:}\\
$\bullet$ \verb|2\textfrac{17}{32}| renders as 2\textfrac{17}{32} with default settings.\\
-$\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}.\\
+%$\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}.\\
+The \verb|\textfrac| macro uses spacing control for each individual digit, one for the numerator and one for the denominator. It is optimized for regular weight, upright shape, but works satisfactorily in bold weight, upright shape. Italic shapes are not handled with any precision. Currently, the spacing settings are specified by two macros in {\tt ETbb.sty}: \verb|\tx@addNkern| and \verb|\tx@addDkern| for numerator and denominator respectively. These may be redefined in your preamble after loading the {\tt ETbb} package with a block like
+\begin{verbatim}
+\makeatletter
+\renewcommand*{\tx@addNkern}[1]{%
+.
+.
+.
+}
+\renewcommand*{\tx@addDkern}[1]{%
+.
+.
+.
+}
+\end{verbatim}
+following the pattern of the definitions in {|tt ETbb.sty}. You should be careful to follow those patterns precisely, as it is very easy to introduce inadvertent space characters in the output.
Option {\tt sups} changes the form of footnote markers to use {\tt ETbb}'s superior figures, unless you have redefined the meaning of \verb|\thefootnote| prior to loading {\tt ETbb}. For more control over size, spacing and position of footnote markers, use the \textsf{superiors} package: E.g.,
@@ -213,17 +235,17 @@ The layout of the TS1 encoded Text Companion font, which is rendered \emph{in re
%(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}.)
\begin{verbatim}
-% 0 \capitalgrave
-% 1 \capitalacute
-% 2 \capitalcircumflex
-% 3 \capitaltilde
-% 4 \capitaldieresis
-% 5 \capitalhungarumlaut
-% 6 \capitalring
-% 7 \capitalcaron
-% 8 \capitalbreve
-% 9 \capitalmacron
-% 10 \capitaldotaccent
+ 0 \capitalgrave
+ 1 \capitalacute
+ 2 \capitalcircumflex
+ 3 \capitaltilde
+ 4 \capitaldieresis
+ 5 \capitalhungarumlaut
+ 6 \capitalring
+ 7 \capitalcaron
+ 8 \capitalbreve
+ 9 \capitalmacron
+ 10 \capitaldotaccent
11 \capitalcedilla
12 \capitalogonek
13 \textquotestraightbase
@@ -231,50 +253,50 @@ The layout of the TS1 encoded Text Companion font, which is rendered \emph{in re
21 \texttwelveudash
22 \textthreequartersemdash
23 \textcapitalcompwordmark
-% 24 \textleftarrow
-% 25 \textrightarrow
-% 26 \t % tie accent, skewed right
-% 27 \capitaltie % skewed right
-% 28 \newtie % tie accent centered
-% 29 \capitalnewtie % ditto
-% 31 \textascendercompwordmark
+ 24 \textleftarrow
+ 25 \textrightarrow
+ 26 \t % tie accent, skewed right
+ 27 \capitaltie % skewed right
+ 28 \newtie % tie accent centered
+ 29 \capitalnewtie % ditto
+ 31 \textascendercompwordmark
32 \textblank
36 \textdollar
39 \textquotesingle
42 \textasteriskcentered
-% 45 \textdblhyphen
+ 45 \textdblhyphen
47 \textfractionsolidus
-% 48 \textzerooldstyle
-% 49 \textoneoldstyle
-% 50 \texttwooldstyle
-% 49 \textthreeoldstyle
-% 50 \textfouroldstyle
-% 51 \textfiveoldstyle
-% 52 \textsixoldstyle
-% 53 \textsevenoldstyle
-% 54 \texteightoldstyle
-% 55 \textnineoldstyle
-% 60 \textlangle
+ 48 \textzerooldstyle
+ 49 \textoneoldstyle
+ 50 \texttwooldstyle
+ 49 \textthreeoldstyle
+ 50 \textfouroldstyle
+ 51 \textfiveoldstyle
+ 52 \textsixoldstyle
+ 53 \textsevenoldstyle
+ 54 \texteightoldstyle
+ 55 \textnineoldstyle
+ 60 \textlangle
61 \textminus
-% 62 \textrangle
-% 77 \textmho
+ 62 \textrangle
+ 77 \textmho
79 \textbigcircle
-% 87 \textohm
-% 91 \textlbrackdbl
-% 93 \textrbrackdbl
-% 94 \textuparrow
-% 95 \textdownarrow
-% 96 \textasciigrave
-% 98 \textborn
-% 99 \textdivorced
-%100 \textdied
-%108 \textleaf
-%109 \textmarried
+ 87 \textohm
+ 91 \textlbrackdbl
+ 93 \textrbrackdbl
+ 94 \textuparrow
+ 95 \textdownarrow
+ 96 \textasciigrave
+ 98 \textborn
+ 99 \textdivorced
+100 \textdied
+108 \textleaf
+109 \textmarried
%110 \textmusicalnote
-%126 \texttildelow
-%127 \textdblhyphenchar
-%128 \textasciibreve
-%129 \textasciicaron
+126 \texttildelow
+127 \textdblhyphenchar
+128 \textasciibreve
+129 \textasciicaron
%130 \textacutedbl
%131 \textgravedbl
132 \textdagger
@@ -283,56 +305,56 @@ The layout of the TS1 encoded Text Companion font, which is rendered \emph{in re
135 \textperthousand
136 \textbullet
137 \textcelsius
-%138 \textdollaroldstyle
-%139 \textcentoldstyle
+138 \textdollaroldstyle
+139 \textcentoldstyle
140 \textflorin
-%141 \textcolonmonetary
-%142 \textwon
-%143 \textnaira
-%144 \textguarani
-%145 \textpeso
-%146 \textlira
-%147 \textrecipe
+141 \textcolonmonetary
+142 \textwon
+143 \textnaira
+144 \textguarani
+145 \textpeso
+146 \textlira
+147 \textrecipe
148 \textinterrobang
149 \textinterrobangdown
-%150 \textdong
+150 \textdong
151 \texttrademark
-%152 \textpertenthousand
-%153 \textpilcrow
-%154 \textbaht
-%155 \textnumero
-%156 \textdiscount
-%157 \textestimated
-%158 \textopenbullet
-%159 \textservicemark
-%160 \textlquill
-%161 \textrquill
+152 \textpertenthousand
+153 \textpilcrow
+154 \textbaht
+155 \textnumero
+156 \textdiscount
+157 \textestimated
+158 \textopenbullet
+159 \textservicemark
+160 \textlquill
+161 \textrquill
162 \textcent
163 \textsterling
164 \textcurrency
165 \textyen
166 \textbrokenbar
167 \textsection
-%168 \textasciidieresis
+168 \textasciidieresis
169 \textcopyright
170 \textordfeminine
-%171 \textcopyleft
+171 \textcopyleft
172 \textlnot
-%173 \textcircledP
+173 \textcircledP
174 \textregistered
-%175 \textasciimacron
+175 \textasciimacron
176 \textdegree
177 \textpm
178 \texttwosuperior
179 \textthreesuperior
-%180 \textasciiacute
+180 \textasciiacute
181 \textmu
182 \textparagraph
183 \textperiodcentered
-%184 \textreferencemark
+184 \textreferencemark
185 \textonesuperior
186 \textordmasculine
-%187 \textsurd
+187 \textsurd
188 \textonequarter
189 \textonehalf
190 \textthreequarters