From 97eca13a92a0b8ad423b606c8970c9ce64d9b2bf Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Tue, 18 May 2021 03:01:12 +0000
Subject: CTAN sync 202105180301

---
 fonts/newtx/doc/newtxdoc.tex | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

(limited to 'fonts/newtx/doc/newtxdoc.tex')

diff --git a/fonts/newtx/doc/newtxdoc.tex b/fonts/newtx/doc/newtxdoc.tex
index de9603b1c3..e11ca22200 100644
--- a/fonts/newtx/doc/newtxdoc.tex
+++ b/fonts/newtx/doc/newtxdoc.tex
@@ -63,7 +63,13 @@ This package is meant to be a replacement for Young Ryu's {\tt txfonts}. It is
 
 Version 1.60 likewise has many additions and changes that are summarized in Appendix 2. Most important is that {\tt newtx} is now able to output a PDF/A-1b compliant pdf using {\tt pdflatex}.
 
-
+Another important change took place in version 1.65, where  {\tt theoremfont} was reimplemented using a new font family, {\tt ntxth} instead of abusing \verb|\textsl|. By default,  users of {\tt theoremfont} will see no change in its functionality, including the use of the macro \verb|\textsl| to output italics with upright punctuation. A new option, {\tt trueslanted}, to {\tt newtxtext} has the following effects:
+\begin{itemize}
+\item
+\verb|\textsl| now outputs slanted text rather than italics with upright punctuation text, but not affecting the usage of the {\tt theoremfont} option to {\tt newtxtext}.
+\item the former behavior of \verb|\textsl| is now available through the new macro \verb|\textth|, \textsc{aka} \verb|\textthit|.
+\item \verb|\pagestyle{headings}| now functions as intended with slanted rather than upright figures in the headers.
+\end{itemize}
 
 This math package works, after possibly replacing its math Roman and Greek letters, with fonts other than Times that are intermediate in weight between Computer Modern and Times. The free font Linux Libertine is one particular target---it is of nearly the same x-height as Computer Modern, but, not being a \emph{modern} font, does not have a high contrast ratio, and so appears  denser than Computer Modern but not as much so as Times. It is meant as a replacement for Times, but  differs from it in many characteristics, more similar to MinionPro than Times, and provides a better range of variants than Times---three weights (regular, semi-bold and bold) rather than just two, and has expert features in all weights: old-style figures, more extensive and more interesting ligatures,  and  small caps. In my opinion, material typeset in Linux Libertine looks better than the corresponding material typeset in Times. This seems especially true on the screen. As of version 1.0, the package also offers support for MinionPro as a math font, but with limitations described in detail below. More recently, an option to provide math support for the \textsf{garamondx} text font package was added. Version 1.55 adds support for the {SticksToo} text fonts, a reworking of the {\tt STIX2} text fonts.
 
@@ -104,6 +110,7 @@ load roman and typewriter text fonts at 95\% of normal size, and the sans serif
 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} changes the default to old-style figures in text at the very end of the preamble, forcing the use of old-style figures in text, but not math. In earlier versions, it was necessary to run 
 \verb|\useosf| after loading {\tt newtxmath}. This is no longer required. 
 
+(New in version $1.65$.) Slanted text is now provided as part of the {\tt newtxtext} package, but requires that you specify the new option {\tt trueslanted}. Without this option, \verb|\textsl| will continue to behave as in earlier versions, outputting italic text with upright punctuation.
 If you use the {\tt babel} package, you should load it before {\tt newtxtext}---for example:
 \begin{verbatim}
 \usepackage[<babel options>]{babel}
@@ -128,6 +135,7 @@ As an example of a {\tt theoremstyle} definition,
 {0pt}   % ABOVESPACE, extra space above
 {0pt}   % BELOWSPACE, extra space below
 {\slshape}  % BODYFONT, italic with upright figures and punctuation
+% Change previous line if using option trueslanted---\thfamily, not \slshape
 {}       % INDENT (empty value is the same as 0pt)
 {\bfseries} % HEADFONT
 {.}         % HEADPUNCT
@@ -171,7 +179,7 @@ Compare this to traditional {\tt plain} theoremstyle with the same text:
 This is Theorem Italic: text numbers are upright---12345; punctuation is in many cases upright (also, parens, braces \{\} and brackets []). What about question marks and exclamations? Also upright! [These fit better with math mode punctuation and figures, like: for all $x\in[0,1]$, let $f(x)\coloneq \exp(\alpha x)$].
 \end{oldthm}
 
-If you are using another theorem package (e.g., ntheorem, theorem) you will have to add your own descriptors as specified in its documentation and set the body font to \verb|\slshape|.
+If you are using another theorem package (e.g., ntheorem, theorem) you will have to add your own descriptors as specified in its documentation and set the body font family to \verb|\thfamily|.
 
 \section{Spacing issues}
 This new version of {\tt newtxtext} has spacing that is a little different, in its default state, from that of the old {\tt newtxtext}. In small part this is due to the finer kerning of TeXGyre Termes, but mostly because the three parameters that govern inter-word spacing are not the same.
@@ -259,13 +267,11 @@ Option {\tt cochf} replaces the default short math italic f with the long italic
 \item
 {\tt cmintegrals} instructs \textsf{newtxmath} to load a thicker version of the Computer Modern integral in place of the \textsf{newtxmath} default---the txfonts 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{txfonts} integrals are available;
 \textbf{as of version 1.5, this option does nothing, as the new default is slanted integrals.}
-\item the combination
-\begin{verbatim}
+\item 
 % The next line is no longer needed, as newtxmath Requires it
 %\usepackage{amsmath}% loads amstext, amsbsy, amsopn but not amssymb
-\usepackage{newtxmath}
-\end{verbatim}
-causes no error, unlike the same combination with {\tt txfonts}, but does nothing significant. (Recall that {\tt amsmath} is loaded automatically if you use an \textsc{ams} document class such as {\tt amsart} or {\tt amsbook}, as is {\tt amsthm}.) 
+\verb|\usepackage{newtxmath}|
+requires  {\tt amsmath}---there is no need to load it separately.
 %On the other hand,
 %\begin{verbatim}
 %%\usepackage{amsmath} % no longer needed
-- 
cgit v1.2.3

