From 71e57b1c98740d1fbb24981d390bd3ec8f2e967b Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Sun, 17 May 2020 03:03:04 +0000
Subject: CTAN sync 202005170303

---
 fonts/etbb/doc/ETbb-doc.tex | 200 ++++++++++++++++++++++++--------------------
 1 file changed, 111 insertions(+), 89 deletions(-)

(limited to 'fonts/etbb/doc/ETbb-doc.tex')

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
-- 
cgit v1.2.3

