From 54592d609e44d5cff9e5d940befbcb3330d92b10 Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Sun, 17 Oct 2021 03:01:02 +0000
Subject: CTAN sync 202110170301

---
 fonts/newpx/doc/newpxdoc.tex | 97 ++++++++++++++++++++------------------------
 1 file changed, 45 insertions(+), 52 deletions(-)

(limited to 'fonts/newpx/doc/newpxdoc.tex')

diff --git a/fonts/newpx/doc/newpxdoc.tex b/fonts/newpx/doc/newpxdoc.tex
index e30c210123..c9cd0c8472 100644
--- a/fonts/newpx/doc/newpxdoc.tex
+++ b/fonts/newpx/doc/newpxdoc.tex
@@ -3,7 +3,6 @@
 \usepackage[margin=1in]{geometry} 
 \usepackage[parfill]{parskip}% Begin paragraphs with an empty line rather than an indent
 \pdfmapfile{=newtx.map}
-\pdfmapfile{=newpx.map}
 \pdfcompresslevel=0
 \pdfgentounicode=1
 \input glyphtounicode.tex
@@ -32,7 +31,7 @@
 % newpx text and math
 \linespread{1.05}
 %\usepackage[largesc,theoremfont]{newpxtext}
-\usepackage[theoremfont,trueslanted]{newpxtext}
+\usepackage[theoremfont,trueslanted,largesc]{newpxtext}
 \usepackage[scaled=1.05]{nimbusmononarrow}
 %\usepackage[scaled=1.05,zerostyle=a]{newtxtt}
 \usepackage{textcomp}
@@ -87,7 +86,7 @@ the new package is split into separate text and math packages that do not need t
 \item \verb|\coloneq| and \verb|\eqcolon| now point to the correct glyphs;
 \item The problem with the {\tt ogonek} accent  and tabular environments (bad definition of \verb|\k|) is fixed;
 \item The default encoding for \textsf{newpxtext} is now T$1$, but support is offered also for OT$1$ and LY$1$. As some add-on packages are available only in T$1$, that seems the best current choice.
-\item The font collection used for rendering text is based on TeXGyrePagella with a number of additions, denoted by TeXGyrePagellaX. The superior figures in this addition are set by default to render footnote markers. (It is also possible customize footnote markers by redefining \verb|\thefootnote| after loading {\tt newpxtext.sty}.) Small caps are available in all weights and styles, and are offered in two sizes. The default small caps supplied by TeXGyrePagella are really \textsc{Petite Caps}, having xheights approximately the same x-heights (sometimes smaller) as lowercase letters. Option \texttt{largesc} increases the size of small caps by about 8\%, approximating the size of Adobe Palatino Small Caps. IMO, this is a better match in terms of weight and size. For a side by side comparison: {\pcf Petite Caps}, \textsc{Small Caps}.
+\item The font collection used for rendering text is based on TeXGyrePagella with a number of additions, denoted by TeXGyrePagellaX. The superior figures in this addition are set by default to render footnote markers. (It is also possible customize footnote markers by redefining \verb|\thefootnote| after loading {\tt newpxtext.sty}.) Small caps are available in all weights and styles, and are offered in two sizes. The default small caps supplied by TeXGyrePagella are really \textsc{Petite Caps}, having xheights approximately the same x-heights (sometimes smaller) as lowercase letters. Option \texttt{largesc} increases the size of small caps by nearly 8\%, approximating the size of Adobe Palatino Small Caps. IMO, this is a better match in terms of weight and size. For a side by side comparison: {\pcf Petite Caps}, \textsc{Small Caps}.
 \item Sans serif is by default taken from TeXGyreHeros, a Helvetica clone, and by default at 94\% of the scale factor (set by {\tt scaled}, default value {\tt1}). The option {\tt helvratio=.98} will change that to 98\%. As of newpx version 1.415, there is an option {\tt nohelv} that prevents this loading.
 \item New math accents such as \verb|\widearc| have been introduced in tandem with the {\tt newtx} package, where they are documented.
 \end{itemize}
@@ -198,16 +197,16 @@ While the math font options must be specified before {\tt fontspec}, be aware of
 
 \textsc{Example:}
 \begin{verbatim}
-%load LaTeX text components before math math
-\usepackage[T1]{fontenc}
+%load LaTeX text components before math
+\usepackage[T1]{fontenc} % affects only \mathrm, \mathbf etc
 \renewcommand{\rmdefault}{zpltlf}% Roman font for use in math mode
-\usepackage[scaled=.85]{beramono}% used only by \mathtt
-\usepackage[type1]{cabin}% used only by \mathsf
+\usepackage[scaled=.85]{beramono}% used only by \mathtt, optional
+\usepackage[type1]{cabin}% used only by \mathsf, optional
 \usepackage{amsmath} % must be loaded before amsthm
 \usepackage{amsthm}% load before newpxmath
-\usepackage[bigdelims,vvarbb]{newpxmath}
-\usepackage[scr=rsfso]{mathalfa}
-\usepackage{bm}% load after all math to give access to bold math
+\usepackage[vvarbb]{newpxmath}
+\usepackage[scr=rsfso]{mathalfa}, optional
+\usepackage{bm}% load after all math to give access to bold math, optional
 %Now load the otf text fonts using fontspec---won't affect math
 \usepackage[no-math]{fontspec} % process with XeLaTeX or LuaLaTeX
 \setmainfont{TeXGyrePagellaX} % this reads in TeXGyrePagellaX.fontspec
@@ -252,22 +251,16 @@ Don't use these unless you know what you're doing.
 \item 
 \begin{itemize}
 \item{\tt varg} causes the math italic letter $g$ to be replaced by $\varg$;
-\item Option {\tt cmintegrals} is now useless---the original ugly integral sign have been replaced.%instructs \textsf{newpxmath} to load a thicker version of the Computer Modern integral in place of the \textsf{newpxmath} default---the pxfonts integral (identical to the integral in the Wolfram fonts), which is not to everyone's taste---a consequence is that none of the special forms of \textsf{pxfonts} integrals are available; \textbf{As of version 1.3, this option does nothing, as the new default is slanted integrals.}
-%\item The option {\tt cmbraces} instructs {\tt newpxmath} to ignore the brace collections from {\tt pxfonts}, substituting a collection based on thickened versions of the Computer Modern braces, which I find much easier to distinguish from other delimiters. This works quite well in regular weight but looks a bit clunky in bold.
-\item The options {\tt cmbraces} and  {\tt bigdelims} now have no effect but do no harm---it is now the default behavior to use a larger size of delimiters than in the original package.
+\item{\tt cmintegrals} instructs \textsf{newpxmath} to load a thicker version of the Computer Modern integral in place of the \textsf{newpxmath} default---the pxfonts integral (identical to the integral in the Wolfram fonts), which is not to everyone's taste---a consequence is that none of the special forms of \textsf{pxfonts} integrals are available; \textbf{As of version 1.3, this option does nothing, as the new default is slanted integrals.}
+\item The option {\tt cmbraces} instructs {\tt newpxmath} to ignore the brace collections from {\tt pxfonts}, substituting a collection based on thickened versions of the Computer Modern braces, which I find much easier to distinguish from other delimiters. This works quite well in regular weight but looks a bit clunky in bold.
+\item [NEW] The new option {\tt bigdelims} offers delimiters which are a bit larger than the standard delimiters and the normal and {\tt big} sizes, with more distinction between the two than in the standard package. With {\tt bigdelims}, the option {\tt cmbraces} is ignored.
 \end{itemize}
 \item the combination
 \begin{verbatim}
 \usepackage{amsmath}% loads amstext, amsbsy, amsopn but not amssymb
 \usepackage{newpxmath}
 \end{verbatim}
-causes no error, unlike the same combination with {\tt pxfonts}, but does nothing significant. The package {\tt newpxmath} loads the package {\tt amsmath} if it was not previously loaded. Options to {\tt amsmath} such as {\tt leqno,intlimits} may be passed to {\tt amsmath} via options to the documentclass. It is useful if you want to load {\tt amsthm} because the required order of loading is
-\begin{verbatim}
-\usepackage{amsmath}
-\usepackage{amsthm} % amsmath must be loaded before amsthm
-\usepackage{newpxmath} % amsthm must be loaded before newpxmath
-\end{verbatim}
-
+causes no error, unlike the same combination with {\tt pxfonts}, but does nothing significant. The package {\tt newpxmath} loads the package {\tt amsmath} if it was not previously loaded. Options to {\tt amsmath} such as {\tt leqno,intlimits} may be passed to {\tt amsmath} via options to the documentclass. 
 %The integrals are as defined in {\tt pxfonts}. %With
 %\begin{verbatim}
 %\usepackage[cmintegrals]{newpxmath}
@@ -276,7 +269,7 @@ causes no error, unlike the same combination with {\tt pxfonts}, but does nothin
 \item {\tt uprightGreek} and {\tt slantedGreek} determine the form of Greek alphabet loaded---the default is {\tt uprightGreek}, which loads upright uppercase and slanted lowercase Greek symbols, as is customary in Anglo-American mathematical typesetting. With the option {\tt slantedGreek}, which you might want to use if you cared about ISO standards, all Greek symbols are slanted. No matter which is set, \verb|\Gammaup| (or \verb|\upGamma|) gives you upright \verb|\Gamma|, etc, and \verb|\Deltait|, \verb|zetait| give you italic (i.e., slanted) versions of those letters, and \verb|\mathnormal{\Omega}| etc will always produce the slanted version of uppercase Greek letters. (The macro \verb|\mathnormal| means essentially ``use the version of the symbol in {\tt letters}''---i.e., the math italic form. This did not always work as expected in versions prior to 1.27.)
 \item The \textsf{newpxmath} package contains three different Blackboard Bold alphabets, where original \textsf{pxfonts} contained one. The default, triggered by \verb|\mathbb{}|, takes its glyphs from the font which replaces {\tt msbm} and has the same overall appearance of a hollowed-out text font, which I find neither bold nor blackboard-like. The second option, taken from \textsf{pxfonts}, is triggered by \verb|\varmathbb{}|, is more geometric and, in my opinion, preferable but not optimal. The option {\tt varbb} makes \verb|\mathbb{}| synonymous with \verb|\varmathbb{}|. The third option is the double-struck glyphs from the STIX collection. See the expanded discussion below.
 \item {\tt nosymbolsc} causes the package to not load the {\tt symbolsC} fonts, saving  a math family. (This font contains mostly exotic symbols, along with some very useful, commonly used symbols like \verb|\coloneq| $\coloneq$, \verb|\eqcolon| $\eqcolon$, \verb|\notin| $\notin$, \verb|\notni| $\notni$, \verb|\neq| $\neq$, \verb|\nsubset| $\nsubset$ and \verb|\nsupset| $\nsupset$, but these have been moved (virtually) to {\tt lettersA} so they may continue to be used even if you use the option {\tt nosymbolsc}.)
-\item {\tt amssymbols} (the default) and {\tt noamssymbols} determine whether the {\tt pxfonts} versions of the \textsc{ams} symbols ({\tt msam}, {\tt msbm}) are loaded---if so, they override previous settings in {\tt amsmath}. If you use the option {\tt noamssymbols}, then \verb|\mathbb{}| is set to mean the same as \verb|\varmathbb{}|. (One advantage of {\tt noamssymbols} is that you save one of your precious math families for other purposes, such as setting a couple of external math alphabets by means of the \textsf{mathalpha} package.)
+\item {\tt amssymbols} (the default) and {\tt noamssymbols} determine whether the {\tt pxfonts} versions of the \textsc{ams} symbols ({\tt msam}, {\tt msbm}) are loaded---if so, they override previous settings in {\tt amsmath}. If you use the option {\tt noamssymbols}, then \verb|\mathbb{}| is set to mean the same as \verb|\varmathbb{}|. (One advantage of {\tt noamssymbols} is that you save one of your precious math families for other purposes, such as setting a couple of external math alphabets by means of the \textsf{mathalfa} package.)
 \end{itemize}
 
 \textsc{Example:}
@@ -284,7 +277,7 @@ causes no error, unlike the same combination with {\tt pxfonts}, but does nothin
 \documentclass[leqno]{article}
 \usepackage[osf,theoremfont]{newpxtext} % T1, lining figures in math, osf in text
 \usepackage{textcomp} % required for special glyphs
-\usepackage[varg]{newpxmath}
+\usepackage[varg,bigdelims]{newpxmath}
 \usepackage[scr=rsfso]{mathalfa}% \mathscr is fancier than \mathcal
 \usepackage{bm} % load after all math to give access to bold math
 %\useosf %no longer needed unless using babel
@@ -439,6 +432,7 @@ Here is a sample  preamble showing the elements you will need to specify to gene
 \usepackage{newpxtext} %T1 is default encoding
 \usepackage[scaled=0.95]{inconsolata}  % typewriter
 %\usepackage[leqno]{amsmath} 
+\usepackage{amsmath} % must be loaded before amsthm
 \usepackage{amsthm}
 \usepackage[vvarbb]{newpxmath} % vvarbb gives STIX Bbb
 \end{verbatim}
@@ -454,39 +448,11 @@ Version 1.6.3 of {\tt pdfx} from February 2019  mishandles math accents. A fix i
 \end{verbatim}
 and then use \verb|$x_{\jj}$| instead of \verb|$x_j$|, turning $x_j$ into $x_{\jj}$.
 
-If you do enable {\tt subscriptcorrection}, there is a default correction table in the {\tt sty} file, but the sty file also looks for a file named,  {\tt newpx-subs.tex}. There is already such a file located in the {\tt newpx} distribution in the \verb|tex/latex/newpx| folder. 
-
-(New as of version $1.426$:) If you wish to make changes to {\tt newpx-subs.tex}, it is possible though not wise to copy the file to your home TeX folder where it will be found by TeX before the one in the distribution. The problem is that it is easy to forget where the file is located when you want to make changes. For the moment, my advice is to place the file contents with your changes inside a {\tt filecontents} environment at the top of your source file, as shown below. The effect will be to write that file in the same folder as your source, overwriting any existing copy. Version $1.426$ also offers you a new option {\tt subscriptcorrectionfile} that lets you specify a file name other than the default {\tt newpx-subs.tex} that can be used to specify a subscript correction file for some special use.
-
-\textbf{A sample newpx-subs.tex:}\\
-Copy the entire block below, starting with the line \verb|\begin{...| and ending after the line beginning \verb|\end{|
-and pasting it into the top of your document before the \verb|\documentclass...| line, which will allow for easy editing and will write the file to the same folder as your document.
-\begin{verbatim}
-\begin{filecontents*}[force,nosearch]{newpx-subs.tex}
-{f}{-2.5}
-{j}{-1.5}
-{p}{-1}
-{y}{-1}
-{A}{-1.5}
-{B}{-1}
-{D}{-1}
-{H}{-1}
-{I}{-1}
-{K}{-1}
-{L}{-1}
-{M}{-1}
-{N}{-0.5}
-{P}{-1}
-{X}{-1}
-{\rho}{-1.5}
-{\mu}{-1}
-\end{filecontents*}
-\end{verbatim}
-The entries in the file are lines like
+If you do enable {\tt subscriptcorrection}, there is a default correction table in the {\tt sty} file, but the sty file also looks for a file named,  {\tt newpx-subs.tex}. There is already such a file located in the {\tt newpx} distribution in the \verb|tex/latex/newpx| folder. (The contents of this file are also listed at the end of this appendix, from which they may be more easily copied.) If you wish to make changes to this file, copy the file to your home TeX folder where it will be found by TeX before the one in the distribution. (The contents of this file are also listed at the end of this appendix, from which they may be more easily copied.) The entries in the file are lines like
 \begin{verbatim}
 {j}{-3}
 \end{verbatim}
-each of which will have the same effect as the above macro \verb|\jj| if the first item in the subscript is {\tt j}. You can also specify Greek letters with lines like
+each of which will have the same effect as the above macro if the first item in the subscript is {\tt j}. You can also specify Greek letters with lines like
 \begin{verbatim}
 {\beta}{-1.5}
 \end{verbatim}
@@ -530,4 +496,31 @@ The AMS fonts replacement, {\tt zplsym} corrects the former misplacement of \ver
 \newpage  
 \subsection{symbols}
 \fonttable{zplsy}
+\newpage 
+\subsection{A sample newpx-subs.tex}
+You may either copy the entire block below, starting with the line \verb|\begin{...| and ending after the line beginning \verb|\end{|
+and pasting it into the top of your document before the \verb|\documentclass...| line, which will allow for easy editing and will write the file to the same folder as your document, or make your own file, omitting those outer two lines.
+
+\begin{verbatim}
+\begin{filecontents*}{newpx-subs.tex}
+{f}{-2.5}
+{j}{-1.5}
+{p}{-1}
+{y}{-1}
+{A}{-1.5}
+{B}{-1}
+{D}{-1}
+{H}{-1}
+{I}{-1}
+{K}{-1}
+{L}{-1}
+{M}{-1}
+{N}{-0.5}
+{P}{-1}
+{X}{-1}
+{\rho}{-1.5}
+{\mu}{-1}
+\end{filecontents*}
+
+\end{verbatim}
 \end{document}  
\ No newline at end of file
-- 
cgit v1.2.3

