bboldx (30oct21)

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

3 files changed, 69 insertions, 14 deletions

diff --git a/Master/texmf-dist/doc/fonts/bboldx/Bboldx-doc.pdf b/Master/texmf-dist/doc/fonts/bboldx/Bboldx-doc.pdf
index 89161889ee6..a382abfe1b9 100644
--- a/Master/texmf-dist/doc/fonts/bboldx/Bboldx-doc.pdf
+++ b/Master/texmf-dist/doc/fonts/bboldx/Bboldx-doc.pdf
diff --git a/Master/texmf-dist/doc/fonts/bboldx/Bboldx-doc.tex b/Master/texmf-dist/doc/fonts/bboldx/Bboldx-doc.tex
index 7a5cecca5df..3a396138443 100644
--- a/Master/texmf-dist/doc/fonts/bboldx/Bboldx-doc.tex
+++ b/Master/texmf-dist/doc/fonts/bboldx/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
diff --git a/Master/texmf-dist/doc/fonts/bboldx/README b/Master/texmf-dist/doc/fonts/bboldx/README
index 353112cc8fd..0b5a62e3ddc 100644
--- a/Master/texmf-dist/doc/fonts/bboldx/README
+++ b/Master/texmf-dist/doc/fonts/bboldx/README
@@ -7,7 +7,12 @@ The files are Copyright 2007 TeX Users Group, with license:
 
 BBOLDX extends the original to a set of three weights with the original, whose weight was a good match to Computer Modern with stem of width 40 em units, now identified as the light member, with regular and bold having stem-widths of 56 em units and 90 em units respectively. The extension is Copyright (c) Michael Sharpe 2021 and the license continues to be as before.
 
-Current version 1.02 2021-10-21
+Current version 1.03 2021-10-29
+
+Changes in version 1.03
+1. New options, including one to force handling as a Symbol Font rather than as a Math Alphabet.
+2. Expanded support macros particular to usage as a Symbol Font or a Math Alphabet.
+3. Expanded documentation.
 
 Changes in version 1.01
 bboldx.sty was modified so that the macro names followed the style of unicode names.