summaryrefslogtreecommitdiff
path: root/fonts/newpx/doc/newpxdoc.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-10-25 03:01:25 +0000
committerNorbert Preining <norbert@preining.info>2023-10-25 03:01:25 +0000
commit241082cbe6f4fe8c38e91c38418ca828ac8d2f7c (patch)
tree206f7f6660cf81875a12824d3f7f92939c63b757 /fonts/newpx/doc/newpxdoc.tex
parent7fc03b60d145610ff8e62c3d3a0d5fe037f6597d (diff)
CTAN sync 202310250301
Diffstat (limited to 'fonts/newpx/doc/newpxdoc.tex')
-rw-r--r--fonts/newpx/doc/newpxdoc.tex52
1 files changed, 38 insertions, 14 deletions
diff --git a/fonts/newpx/doc/newpxdoc.tex b/fonts/newpx/doc/newpxdoc.tex
index d4e9e978fe..df34eebde1 100644
--- a/fonts/newpx/doc/newpxdoc.tex
+++ b/fonts/newpx/doc/newpxdoc.tex
@@ -2,6 +2,7 @@
\documentclass[11pt]{article}
\usepackage[margin=1in]{geometry}
\usepackage[parfill]{parskip}% Begin paragraphs with an empty line rather than an indent
+\usepackage{graphicx}
%\pdfmapfile{=newtx.map}
%\pdfcompresslevel=0
%\pdfgentounicode=1
@@ -57,6 +58,7 @@
\makeatletter
\ifzpl@otf
\def\pcf{\addfontfeatures{Letters=PetiteCaps}}
+ \def\pcf{\addfontfeatures{Letters=SmallCaps}}
\else
\font\pcf=zpl-Regular-osf-sc-t1 at 10.95pt
\font\scf=zpl-Regular-osf-scl-t1 at 10.95pt
@@ -106,14 +108,29 @@
%\scalefont{5}{\vrule width.04pt\char"2044\vrule width.04pt}%\addfontfeatures{RawFeature=+ss20;+dnom}\color{red}\char"2044\vrule width.04pt{}4}
-%\textsu{23} \textde{45} \textnu{78} \textinf{90}
+%{23\textsu} \textde{45} \textnu{78} \textinf{90}
%X{\sufigures 8Abc}
%\end{document}
%\show\slshape
\section{Introduction}
This package is meant to be a replacement for Young Ryu's {\tt pxfonts}---a complete text and math package with roman text font provided by a Palatino clone, sans serif based on a \textsf{Helvetica} clone, typewriter faces, plus math symbol fonts whose math italic letters are from a Palatino Italic clone. As with the related {\tt txfonts} (though not as severe) the math metrics in {\tt pxfonts} seem overly tight.
-\textsc{Changes as of version 1.51}\\
+\textsc{Changes as of version 1.53}
+\begin{itemize}
+\item
+Superior letters and figures distinct from numerators have been added along with some special features. The text switch \verb|\sustyle| (or \verb|\sufigures|) or the commands \verb|\textsu|, \verb|\textsup|, \verb|\textsups| may be used to invoke ordinary superiors. The command \verb|\textsuperior| is reserved for a form of superiors that respond to adjustments you may specify in the package options, and which are used for footnote marker placement: \verb|supscale| rescales them, \verb|supsraised| specifies an amount to move them vertically, and \verb|supLspaced|, \verb|supRspaced| specify additional kerning to be applied at the left and right. These changes are applied in the order: scaling, raising, kerning. All except \verb|supscale| should be dimensions with units like {\tt em} which will scale properly. Their relative vertical positions stack up like this: X\textinf{12}X\textde{345}X\textnu{678}X\textsu{90}.
+\item
+Unless you specify the option {\tt defaultsups}, the package will use the superior letters and numbers for footnote markers. These will work in all LaTeX engines, and with all standard LaTeX classes, as well a the KOMA classes. With {\tt defaultsups}, you get scaled-down glyphs which may not match the color of other text and may be more difficult to find on a page.
+\item
+There are now characters in the superiors which may be useful in displaying symbolic footnote markers: \textsu{\textsection, \textparagraph, \textdagger, \textdaggerdbl, \textbardbl, \textasteriskcentered}. See the documentation to the {\tt footmisc} package for more details of their usage. A usage example is appended as the last page of this document.
+\item Option {\tt scosf}, which specifies oldstyle figure within small caps, has been extended and now works in all LaTeX engines with both the \verb|\scshape| switch and the macro \verb|\textsc{}|.
+\item
+The stacked fraction macro is now available: see the documentation in the {\tt newtx} package.
+\item
+Version 1.53 brings {\tt newpxtext} essentially up to parity with {\tt newtxtext}, version 1.73.
+\end{itemize}
+
+\textsc{Changes as of version 1.51}
\begin{itemize}
\item
There is a new {\tt newpx.sty} that offers simplifications in the use of {\tt newpxtext} and {\tt newpxmath} under [pdf]latex, xelatex and lualatex. With {\tt newpx}, you can pass options to {\tt newpxtext} and {\tt newpxmath} as appropriate. For example
@@ -122,7 +139,7 @@ There is a new {\tt newpx.sty} that offers simplifications in the use of {\tt n
\end{verbatim}
would send {\tt scale=.98} to both text and math packages, {\tt varbb} to {\tt newpxmath} and the rest to {\tt newpxtext}. Later sections have more usage examples.
\item
-{Newpxtext.sty} now has a stacked fraction macro: \verb|\textsfrac[2]{17}{32}| produces \textsfrac[2]{17}{32}.
+{Newpxtext.sty} now has a stacked fraction macro: \verb|\textsfrac[2]{17}{32}| produces \textsfrac[2]{17}{32}.
\item
Version 1.51 brings {\tt newpxmath} essentially up to parity with {\tt newtxmath}, version 1.723.
\end{itemize}
@@ -170,22 +187,23 @@ braces and other delimiters are now larger and, I believe, more pleasing to olde
\section{Text mode options and macros}
+
\textsc{Important changes as of version 1.5}
\begin{itemize}
\item
- 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 5.33\%, approximating the size of Linotype Palatino Small Caps. IMO, this is a better match in terms of weight and size: {\pcf Petite Caps}, \textsc{Small Caps}. The two sizes of small caps are now implemented in the Opentype fonts as Petite Caps and Small Caps ({\tt pcap} and {\tt smcp}). The option {\tt largesc} changes the default rendering of \verb|\scshape| and \verb|\textsc| to Small Caps instead of the default Petite Caps.
+ Small caps are available in all weights and styles, and are offered in two sizes. The default small caps supplied by TeXGyrePagella are really {\pcf Petite Caps}, having xheights approximately the same x-heights (sometimes smaller) as lowercase letters. Option \texttt{largesc} increases the size of small caps by 5.33\%, approximating the size of Linotype Palatino Small Caps. IMO, this is a better match in terms of weight and size: {\pcf Petite Caps}, \textsc{Small Caps}. The two sizes of small caps are now implemented in the Opentype fonts as Petite Caps and Small Caps ({\tt pcap} and {\tt smcp}). The option {\tt largesc} changes the default rendering of \verb|\scshape| and \verb|\textsc| to Small Caps instead of the default Petite Caps.
-\item The last versions were missing the switches \verb|\tlfstyle|, \verb|\lfstyle|, \verb|\tosfstyle| and \verb|\osfstyle| as well as their command forms \verb|\texttlf|, \verb|\textlf|, \verb|\texttosf| and \verb|\textosf|, which allowed you to get any figure alignment and style, no matter what the default figure style. For example, though we the main text is proportional oldstyle, \verb|\texttlf{123}| gives the tabular lining form \texttlf{123}, as does \verb|{\tlfstyle123}|.
+\item The last versions were missing the switches \verb|\tlfstyle|, \verb|\lfstyle|, \verb|\tosfstyle| and \verb|\osfstyle| as well as their command forms \verb|\texttlf|, \verb|\textlf|, \verb|\texttosf| and \verb|\textosf|, which allowed you to get any figure alignment and style, no matter what the default figure style. For example, though the main text is proportional oldstyle, \verb|\texttlf{123}| gives the tabular lining form \texttlf{123}, as does \verb|{\tlfstyle123}|.
\item There are also the commands \verb|\oldstylenums|, \verb|\liningnums|, \verb|\tabularnums| and \verb|\proportionalnums|, which change only the alignment and the style.
-\item Two additional figure styles have been added---denominators and subscripts (inferiors), each the same size as superiors, with denominators having the same baseline as text and subscripts below the text baseline. These may be specified respectively by the text switches \verb|\defigures| (\textsc{aka} \verb|\destyle|) and \verb|\infigures| (\textsc{aka} \verb|\instyle|) or the corresponding macros \verb|\textde| and \verb|\textinf|. For example, \verb|{\defigures 123}| gives {\defigures 123}, as would \verb|\textde{123}|, and \verb|{\infigures 123}| gives {\infigures 123}, as would \verb|\textinf{123}|.
+\item Two additional figure styles have been added---denominators and subscripts (inferiors), each the same size as superiors, with denominators having the same baseline as text and subscripts below the text baseline. These may be specified respectively by the text switches \verb|\defigures| (\textsc{aka} \verb|\destyle|) and \verb|\infigures| (\textsc{aka} \verb|\instyle|) or the corresponding macros \verb|\textde| and \verb|\textinf|. For example, \verb|{\defigures 123}| gives {\defigures 123}, as would \verb|\textde{123}|, and \verb|{\infigures 123}| gives {\infigures 123}, as would \verb|\textinf{123}| or \verb|\textsub{123}|.
\item There is a numerators figure style normally used only in the construction of fractions. It may be called by any one of \verb|{\nustyle 123}|, \verb|{\nufigures 123}|, \verb|\textnum{123}|, \verb|\textnumerator{123}|. There is also an equivalent named \verb|\textnu{123}|, but this is problematic since it conflicts with a command in the Greek variant of the {\tt babel} package. If you use the latter, there is an option {\tt notextnu} to {\tt newtxtext} that will prevent the redefinition of \verb|\textnu|.
\item There is a new version of \verb|\textfrac| that provides better kerning around the division solidus than the default command. The integer part may be specified as an optional argument. E.g., \verb|\textfrac{7}{8}| gives \textfrac{7}{8}, while \verb|\textfrac[2]{31}{32}| gives \textfrac[2]{31}{32}.
\item There is a new \verb|\textcircled| which works with both letters and numbers.\\
E.g., \verb|\textcircled{X}\textcircled{2}| gives \textcircled{X}\textcircled{2}.
-\item A new option {\tt slashedzero} is provided for XeLaTeX and LaLaTeX only. It replaces the zero in lining style only to a zero with a reverse slash.
+\item A new option {\tt slashedzero} is provided for XeLaTeX and LuaLaTeX only. It replaces the zero in lining style only to a zero with a reverse slash.
\end{itemize}
\textsc{Important changes as of version 1.42}\\
@@ -205,7 +223,7 @@ has several options: you may write
\begin{verbatim}
\usepackage[scaled=.95]{newpxtext}
\end{verbatim}
-to load the roman and typewriter text fonts at 95\% of normal size, and the sans serif (\textsf{Helvetica} clone) at scale $0.95*0.94$. This is not of much utility if the package is used with the math package {\tt newpxmath} to which it is already matched, but may be with other math packages. The options
+to load the roman and typewriter text fonts at 95\% of normal size, and the sans serif (\textsf{Helvetica} clone) at scale 0.95\textasteriskcentered0.94. This is not of much utility if the package is used with the math package {\tt newpxmath} to which it is already matched, but may be with other math packages. The options
\begin{verbatim}
\usepackage[scaled=.95,helvratio=.96]{newpxtext}
\end{verbatim}
@@ -454,11 +472,10 @@ With {\tt newpx}, there is a little simplification:
\begin{itemize}
\item The {\tt no-math} option to {\tt newpxtext} causes {\tt fontspec} to load with option {\tt no-math}, preventing the package from loading any unicode math font.
\item
-You do not need to load {\tt amsmath}: it is loaded by {\tt newpxmath} Option {\tt amsthm} will cause {\tt amsmath} to load before {\tt amsthm}.
+You do not need to load {\tt amsmath}: it is loaded by {\tt newpxmath}. Option {\tt amsthm} will cause {\tt amsmath} to load before {\tt amsthm}.
\item Babel, if used, must be specified before {\tt newpxtext}.
\item Polyglossia, if used, must be specified after loading {\tt newpxtext}.
-\item The {\tt type1} option to {\tt cabin} is important, preventing it from loading {\tt fontspec}, which would lead to an {\tt option clash} error. (This does seem to work properly in the version of {\tt cabin.sty} dated 12/25/2022.)
-\end{itemize}
+\item The {\tt type1} option to {\tt cabin} is important, preventing it from loading {\tt fontspec}, which would lead to an {\tt option clash} error. \end{itemize}
With {\tt newpx}, the above is equivalent to:
\begin{verbatim}
%\renewcommand{\rmdefault}{zplTLF}% Roman and Bold PagellaX for math mode
@@ -578,14 +595,14 @@ Previous to version 1.5, the preceding pages of this document were processed usi
\item
\verb|\textfrac| works more precisely under unicode tex because it is possible to adjust kerning between all characters. The effect should not be very noticeable, at least in regular style.
\item {\tt sups}: the package treats this differently in unicode LaTeX and pdflatex, with handling in the unicode case passed off to the {\tt realscripts} package where the footnote marker font is set to \verb|\normalfont|, meaning that superiors from the current (TeXGyrePagellaX) text font are employed.
-\item The \verb|\footnote| macro has been changed and appears to function correctly in KOMA based packages, though for proper handling of multiple footnote markers it may be necessary to add the following line to your preamble:
+%\item The \verb|\footnote| macro has been changed and appears to function correctly in KOMA based packages, though for proper handling of multiple footnote markers it may be necessary to add the following line to your preamble:
\begin{verbatim}
\usepackage[multiple]{fontmisc}
\end{verbatim}
\item {\tt theoremfont}, {\tt thmtabular}, {\tt thmlining} all function in a manner similar to that in {\tt pdflatex}.
\item {\tt swashQ} operates as before.
\item {\tt foresolidus, aftsolidus} are not used in unicode tex.
-\item {\tt scosf} operates more effectively than in [pdf]latex---in the latter, it seems now very difficult to modify the definition of \verb|\scshape|, and this option works only for \verb|\textsc|.
+%\item {\tt scosf} operates more effectively than in [pdf]latex---in the latter, it seems now very difficult to modify the definition of \verb|\scshape|, and this option works only for \verb|\textsc|.
%you have the choice of font to render footnote markers. The differences are as follows.
%\begin{itemize}
%\item
@@ -741,7 +758,7 @@ causes no error, unlike the same combination with {\tt pxfonts}, but does nothin
\section{Some recent additions to \texttt{newpxmath}}
Because a number of the standard math accents appeared to be too close to the symbols they accented, a number of the problem accents have been reworked as additions to the {\tt symbols} font, along with a number of vertically doubled symbols. (The doubled symbols are described in the documentation to newtx.) The new accents are flatter and stand higher above their accentees than the old versions.
-Another addition to {\tt symbols} may be used to signify matrix \emph{transpose}. In fact, the glyph is just the {\tt intercal} glyph (from the txfonts rendition of the AMS symbols) raised and narrowed considerable. Here is an example comparing its use to a number of other common constructions:
+Another addition to {\tt symbols} may be used to signify matrix \emph{transpose}. In fact, the glyph is just the {\tt intercal} glyph (from the txfonts rendition of the AMS symbols) raised and narrowed considerably. Here is an example comparing its use to a number of other common constructions:
\[\mathbf{M}^{\transp}, \mathbf{M}^{\mathsf{T}}, \mathbf{M}^{\mathrm{T}}, \mathbf{M}^{\intercal},\]
are produced respectively by
\begin{verbatim}
@@ -944,6 +961,8 @@ The AMS fonts replacement, {\tt zplsym} corrects the former misplacement of \ver
\section{Changed Font Tables}
\subsection{letters}
\fonttable{zplmi}
+
+Note that either of the script P glyphs in the above table would be suitable for rendering \verb|\powerset|, though this is not a standard math macro.
\newpage
\subsection{lettersA}
\fonttable{zplmia}
@@ -976,4 +995,9 @@ and pasting it into the top of your document before the \verb|\documentclass...|
{\mu}{-1}
\end{filecontents*}
\end{verbatim}
+
+\section{Footnote markers}
+The following page displays some of the ways that footnote markers may be modified.
+\newpage
+\includegraphics{footsnippet-crop}
\end{document}