From f6b069c5441e2ba598b97c269ac8d00977606ef6 Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Sat, 30 Oct 2021 03:00:57 +0000
Subject: CTAN sync 202110300300

---
 fonts/bboldx/doc/Bboldx-doc.tex | 76 ++++++++++++++++++++++++++++++++++-------
 1 file changed, 63 insertions(+), 13 deletions(-)

(limited to 'fonts/bboldx/doc/Bboldx-doc.tex')

diff --git a/fonts/bboldx/doc/Bboldx-doc.tex b/fonts/bboldx/doc/Bboldx-doc.tex
index 7a5cecca5d..3a39613844 100644
--- a/fonts/bboldx/doc/Bboldx-doc.tex
+++ b/fonts/bboldx/doc/Bboldx-doc.tex
@@ -1,23 +1,25 @@
 % !TEX TS-program = pdflatexmk
 % Template file for TeXShop by Michael Sharpe, LPPL
-\documentclass[11pt]{article}
+\documentclass[11pt]{amsart}
 \usepackage[margin=1in]{geometry} 
 \usepackage[parfill]{parskip}% Begin paragraphs with an empty line rather than an indent
-\pdfmapfile{+bboldx.map}
-\usepackage{graphicx}
+%\pdfmapfile{+bboldx.map}
+%\usepackage{graphicx}
 %\usepackage{amssymb}% don't use with newtxmath
 %SetFonts
 % libertine+newtxmath
+\usepackage{trace}
 \usepackage{newpxtext} % use sb in place of bold
 \usepackage[T1]{fontenc}
 \usepackage{textcomp}
 \usepackage[varqu,varl]{zi4}% inconsolata
 \usepackage[vvarbb]{newpxmath}
+%\usepackage[symbols]{bboldx}
 \usepackage{bboldx}
 % option vvarbb gives you stix blackboard bold
 \useosf % use oldstyle figures except in math
 %\usepackage[cal=boondoxo]{mathalfa}% less slanted than STIX cal
-\usepackage{bm}
+%\usepackage{bm}
 %SetFonts
 \usepackage{fonttable}
 \title{{\tt BBOLDX}---an extension of {\tt BBOLD}}
@@ -26,6 +28,9 @@
 
 \begin{document}
 \maketitle
+%\[\mathbb{0123456789}\text{\txtbbGamma \txtbfbbGamma}\]
+%\[\mathbb{0123456[](),.!\#\$:;<>?/}\]
+%\end{document}
 In the 1990's, Alan Jeffrey developed an extensive Blackboard Bold font with weight a good match to Computer Modern, with upper and lower case Latin and Greek letters as well as punctuation and a number of symbols. The font was the property of Y\&{}Y, and, after their dissolution, the copyright was gifted to TUG in 2007, with the freest license imaginable. This package extends the original by adding a couple of glyphs and, more important, adding two new weights. Where the original stem widths were 40 units, the additions have stem widths of 56 units and 90 units respectively. For a comparison, here are the three, labelled {\tt Thin}, {\tt Regular} and {\tt Bold} respectively.
 
 Thin: {\usefont{U}{bboldx}{l}{n} \char"06\char"0C Hk1234567890}\\
@@ -35,27 +40,70 @@ Bold: {\usefont{U}{bboldx}{b}{n} \char"06\char"0C Hk1234567890}
 \textsc{Font Table for BBOLDX-Regular}:\\
 \fonttable{BBOLDX-Regular}
 \newpage
-There are two ways these may be used.\\
-\textsc{1: Load the bboldx package.}\\
+This package creates two basic commands, \verb|\bbxfamily| and \verb|\bbbxfamily| to identify the fonts that should be considered regular and bold, and uses them to define  macros \verb|\textbb| and \verb|\textbfbb| by which you may access any character, though not necessarily by convenient means as the fonts do not completely follow any standard encoding. Nonetheless, it does understand Roman letters and digits, as well as some punctuation and symbols: e.g., \verb|\textbb{(A)b[1].,!?<>-}| renders as \textbb{(A)b[1].,!?<>-}. Characters may also be accessed by consulting the above table for the position of the character. For example, lowercase psi is in slot 32 decimal={"20} (HEX), so \verb|\textbb{\char32}| or \verb|\textbb{\char"20}| yields \textbb{\char"20}. It also creates macros \verb|\mathbb|, \verb|\mathbfbb| that are specific to math mode but are more limited in scope but work as expected for all Roman alphabetic arguments.
+
+There are two ways this package may be used.\\
+\textsc{1: Load the bboldx package directly.}\\
 To do this, place one of the lines
 \begin{verbatim}
 \usepackage{bboldx} % for Regular and Bold weights
 \usepackage[light]{bboldx} % for Thin and Regular weights
 \end{verbatim}
-in your document preamble following any other lines that may load math alphabets. This package creates two basic commands, \verb|\bbxfamily| and \verb|\bbbxfamily| to identify the fonts that should be considered regular and bold, and uses them to define  macros \verb|\textbb| and \verb|\textbbb| by which you may access any character, though not necessarily by convenient means as the fonts do not completely follow any standard encoding. Nonetheless, it does understand Roman letters and digits, as well as some punctuation and symbols---\textbb{(A)b[1].,!?<>-}. Other characters may be accessed by consulting the above table for the position of the character. For example, lowercase psi is in slot 32 decimal={"20} (HEX), so \verb|\textbb{\char32}| or \verb|\textbb{\char"20}| yields \textbb{\char"20}. As a convenience, the package defines (as math symbols only) the following macros for use with the Greek letters as well as {\tt dotlessi} and {\tt dotlessj}.
+in your document preamble following any other lines that may load math alphabets. Other options are available:
+\begin{itemize}
+\item
+{\tt scaled} (or {\tt scale}) controls the relative size, as in
+\begin{verbatim}
+\usepackage[scaled=1.03]{bboldx}
+\end{verbatim}
+which results in scaling up {\tt bboldx} fonts by 3\%.
+\item
+{\tt bbsymbols} (or {\tt symbols}) controls whether the  font is set up as a symbol font. (The default is to set it up as a MathAlphabet, which handles with greater efficacy the [La]TeX limitation to just 16 math families.)
+\item {\tt bfbb} forces the package to not load the regular and light weights, but use \verb|\mathbb| as if bold were the regular weight. 
+\end{itemize}
+%The macros \verb|\mathbb| and its bold counterpart \verb|\mathbfbb| understand all alphanumeric arguments but no others, at least directly. 
+
+\textsc{Usage as a symbol font}\\
+With a symbol font, each character may be defined as a math symbol, but, unlike one created as a MathAlphabet, it uses up one of your 16 math families even if never used in the document. In symbol font mode, \verb|\mathbb| and its bold counterpart \verb|\mathbfbb| work as expected for digits as well as Roman alphabetic arguments.
+The symbols defined with special names are the Greek and dotless characters with names
 \begin{verbatim}
 \bbdotlessi, \bbdotlessj or \imathbb, \jmathbb
 \bbGamma ... \bbOmega
 \bbalpha ... \bbomega
 \end{verbatim}
-The package also [re]defines the macros \verb|\mathbb| and \verb|\mathbbb| to point the same glyphs as \verb|\textbb| and \verb|\textbbb|, but for use in math mode. 
+and the delimiter symbols
+\begin{verbatim}
+\bbLbrack
+\bbRbrack
+\bbLangle
+\bbRangle
+\bbLparen
+\bbRparen
+\end{verbatim}
 
-There is also a {\tt scaled} (or {\tt scale}) option you may use to adjust the relative size of the {\tt bboldx} glyphs. For example,
+\textsc{Usage as a MathAlphabet}\\
+The package defines (as text symbols only) the following macros for use with the Greek letters as well as {\tt dotlessi} and {\tt dotlessj}.
+\begin{verbatim}
+\txtbbdotlessi, \txtbbdotlessj
+\txtbbGamma ... \txtbbOmega
+\txtbbalpha ... \txtbbomega
+\txtbbLparen \txtbbRparen \txtbbLbrack \txtbbRbrack \txtbbLangle \txtbbRangle
+\end{verbatim}
+as well as their ``bold'' counterparts
 \begin{verbatim}
-\usepackage[scale=.98]{bboldx} 
+\txtbfbbdotlessi, \txtbfbbdotlessj
+\txtbfbbGamma ... \txtbfbbOmega
+\txtbfbbalpha ... \txtbfbbomega
+\txtbfbbLparen \txtbfbbRparen \txtbfbbLbrack \txtbfbbRbrack \txtbfbbLangle \txtbfbbRangle
 \end{verbatim}
-will lead to a 2\% reduction of the size of the rendered {\tt bboldx} characters.\
+There are no special macros for digits because they are easily handled with \verb|\textbb{0}| through \verb|\textbb{9}| and \verb|\textbfbb{0}| through \verb|\textbfbb{9}|. (In this mode, \verb|\mathbb| and \verb|\mathbfbb| don't work as expected with numeric arguments.)
 
+To use these in math you could use the \verb|\text| command from {\tt amsmath}, like
+\begin{verbatim}
+\[\text{\txtbbalpha}+\text{\textbb{1}}\{\text{\txtbbbeta}>\delta\}}\]
+\end{verbatim}
+which renders in MathAlphabet mode as
+\[\text{\txtbbalpha}+\text{\textbb{1}}_{\{\text{\txtbbbeta}>\delta\}}\]
 \textsc{2: Through the {\tt mathalpha} package}\\
 Place one of the lines
 \begin{verbatim}
@@ -70,5 +118,7 @@ has the same effect as
 \begin{verbatim}
 \usepackage[light,scale=.97]{bboldx} 
 \end{verbatim}
-({\tt Mathalpha} does of course allow you to set many other math alphabet options.)
-\end{document}  
\ No newline at end of file
+The options {\tt bbsymbols} and {\tt bfbb} to {\tt mathalpha} are simply passed through to the {\tt bboldx} package for processing.
+({\tt Mathalpha} does of course allow you to set many other options for other math alphabets.)
+\end{document}
+ 
\ No newline at end of file
-- 
cgit v1.2.3

