newpx (11mar15)

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

1 files changed, 45 insertions, 6 deletions

diff --git a/Master/texmf-dist/doc/fonts/newpx/newpxdoc.tex b/Master/texmf-dist/doc/fonts/newpx/newpxdoc.tex
index c05dd1ae20a..4e13a35d6de 100644
--- a/Master/texmf-dist/doc/fonts/newpx/newpxdoc.tex
+++ b/Master/texmf-dist/doc/fonts/newpx/newpxdoc.tex
@@ -18,7 +18,6 @@
 \newtheorem{thm}{Theorem}[section]  
 \usepackage{graphicx}
 \usepackage{url}
-\pdfmapfile{=newpx.map}
 %SetFonts
 % newpx text and math
 \linespread{1.05}
@@ -28,6 +27,7 @@
 \usepackage{bm}
 \useosf
 %SetFonts
+\usepackage{upquote}
 \font\pcf=zpl-Regular-osf-sc-t1 at 10.95pt
 \usepackage{booktabs}\title{New PX font package}
 \author{Michael Sharpe}
@@ -73,7 +73,7 @@ the new package is split into separate text and math packages that do not need t
 \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) than 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 Sans serif is by default taken from TeXGyreHeros, 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\%.
-\item New math accents such as \verb|\widearc| have been introduced in tandem with the newtx package, where they are documented.
+\item New math accents such as \verb|\widearc| have been introduced in tandem with the {\tt newtx} package, where they are documented.
 \end{itemize}
 \section{Text mode options and macros}
 The text mode environment invoked by
@@ -90,10 +90,10 @@ to load the roman and typewriter text fonts at 95\% of normal size, and the sans
 \end{verbatim}
 load roman and typewriter text fonts at 95\% of normal size, and the sans serif (\textsf{Helvetica} clone) at scale $0.95*0.96$.
 
-The option \texttt{osf} instructs the text fonts to use old-style figures \oldstylenums{1234567890} rather than the default lining figures $1234567890$. As of version $1.23$, {\tt newtxtext} loads initially with lining figures so the math package uses lining figures in math mode. The option {\tt osf} switches to old-style figures in text at the very end of the preamble, forcing the use of oldstyle figures in text, but not math. In previous versions, it was necessary to run 
-\verb|\useosf| after loading math. This is no longer required, but does no harm.
+The option \texttt{osf} instructs the text fonts to use old-style figures \oldstylenums{1234567890} rather than the default lining figures $1234567890$. As of version $1.23$, {\tt newpxtext} loads initially with lining figures so the math package uses lining figures in math mode. The option {\tt osf} switches to old-style figures in text at the very end of the preamble, forcing the use of oldstyle figures in text, but not math. In previous versions, it was necessary to run 
+\verb|\useosf| after loading math. This is no longer required unless the {\tt babel} package is loaded, but does no harm. See the discussion in section 4 for further details.
+
 
-Option \texttt{babel} should be used only if you run into problems with the {\tt babel} package, which seems to be caused by an incompatibility between parts of {\tt babel} and \verb|AtEndPreamble|. If you use the {\tt babel} option, you have to omit the {\tt osf} option and use the macro \verb|\useosf| after loading the math package.
 
 As described above, option {\tt largesc} increases the size of small caps by about 8\%.
 
@@ -112,6 +112,45 @@ This is Theorem Italic: text numbers are upright---12345; punctuation is in many
 
 Superior letters and figures may be called with either \verb|{\sustyle ...}| or \verb|\textsu{...}|, so you can emulate $18$\textsu{th} century orthography such as J\textsu{os} W\textsu{m} Smith, or print French style with , e.g., $1$\textsu{i\`ere}, M\textsu{me} Dubois or M\textsu{lle} D'Orleans.
 
+The next two sections describe options to {\tt newpxtext} of more specialized nature.
+
+\section{Spacing issues}
+This new version of {\tt newpxtext} has spacing that is a little different, in its default state, from that of the old {\tt newpxtext}. In small part this is due to the finer kerning of TeXGyre Pagella, but mostly because the three parameters that govern inter-word spacing are not the same.
+\begin{verbatim}
+                               pxfonts     Pagella
+fontdimen2 (interword space)   .25em       .25em
+fontdimen3 (interword stretch) .125em      .2em
+fontdimen4 (interword shrink)  .08333em    .1em
+\end{verbatim}
+That is, {\tt Pagella} has the same normal spacing as {\tt pxfonts} but its spacing is more flexible in terms of both stretch and shrink. More frequently than not, a paragraph built with {\tt Pagella} will occupy more space than the same built with {\tt pxfonts}. For this reason, the package offers some ways to change the spacing parameters. This may be important if you are trying to imitate the pagination of a document built using~{\tt pxfonts}.
+
+Option {\tt tighter} sets the three fontdimen values to those of {\tt pxfonts}, except with a little more shrink. This should make it unlikely that text will occupy more space than it would have using~{\tt pxfonts}. 
+
+Option {\tt looser} sets the three fontdimen values to \verb|{.3em,.2em,.1em}| respectively. 
+
+If you want full control, the options {\tt spacing, stretch, shrink} allow you to modify one or more of the above fontdimens. For example,
+\begin{verbatim}
+\usepackage[stretch=.15em,shrink=.095em]{newpxtext}
+\end{verbatim}
+
+
+
+\section{Usage with {\tt babel}}
+You should normally load {\tt babel} before loading {\tt newpxtext} in order for {\tt babel} to function as expected. {\tt Newpxtext} will set an internal flag to indicate that {\tt babel} is being used. Option \texttt{babel} should be used only if you are forced to load {\tt babel} after {\tt newpxtext}. There appears  to be  an incompatibility between parts of {\tt babel} and \verb|\AtEndPreamble|. If you use {\tt babel}, and a math package, you have to omit the {\tt osf} option and use the macro \verb|\useosf| after loading the math package if you want oldstyle figures in text mode and lining figures in math mode. For example:
+\begin{verbatim}
+\usepackage[greek.polutonico,english]{babel}
+\usepackage[theoremfont,largesc,tighter]{newpxtext}
+\usepackage[T1]{fontenc}
+\usepackage{textcomp}
+\usepackage[varqu,varl]{inconsolata}
+\usepackage{amsmath,amsthm}
+\usepackage[bigdelims,vvarbb]{newpxmath}
+% option vvarbb gives you stix blackboard bold
+\useosf
+\linespread{1.05}
+\end{verbatim}
+
+
 \section{Math mode options}
 The package invoked by
 \begin{verbatim}
@@ -150,7 +189,7 @@ you may use the forms \verb|\iint|, \verb|\iiint|, \verb|\iiiint| and \verb|\ido
 \usepackage[varg,cmintegrals,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 forced to use babel option
+%\useosf %no longer needed unless using babel
 \linespread{1.05}% Give Palatino more leading (space between lines)
 \end{verbatim}