summaryrefslogtreecommitdiff
path: root/fonts/newtx/doc/newtxdoc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'fonts/newtx/doc/newtxdoc.tex')
-rw-r--r--fonts/newtx/doc/newtxdoc.tex27
1 files changed, 23 insertions, 4 deletions
diff --git a/fonts/newtx/doc/newtxdoc.tex b/fonts/newtx/doc/newtxdoc.tex
index e7c72ca40d..735a929122 100644
--- a/fonts/newtx/doc/newtxdoc.tex
+++ b/fonts/newtx/doc/newtxdoc.tex
@@ -82,6 +82,25 @@
%
\section{Introduction}
This package is meant to be a replacement for Young Ryu's {\tt txfonts}. It is a complete text ({\tt newtxtext}) and math ({\tt newtxmath}) package with roman text font provided by a Times clone, sans serif based on a \textsf{Helvetica} clone, typewriter faces, plus math symbol fonts whose math italic letters are from a Times Italic clone. As of version 1.4, {\tt newtxtext} no longer depends on {\tt txfonts} but is based on the richer source \textsf{TeXGyre Termes}, but {\tt newtxmath} continues to use the {\tt txfonts} math glyphs with many metric adjustments and some wholesale modifications.
+\textsc{Changes as of version 1.735}
+\begin{itemize}
+\item
+If {\tt newtx} or {\tt newtxtext} detects that a prior package loaded {\tt fontspec}, then it avoids trying to reload it. While this reduces the risk of an {\tt option clash error}, it means that the prior package will have complete reposibility for loading {\tt fontspec} with an option to control its math handling, specifically {\tt no-math}. For example, if using the {\tt xeCJK} package together with {\tt newtxtext.sty} and {\tt newtxmath.sty}, a minimal preamble could be something like:
+\begin{verbatim}
+\PassOptionsToPackage{no-math}{xeCJK}
+\documentclass{ctexart}
+\setCJKmainfont{SimSun}
+\usepackage{newtx}
+\end{verbatim}
+or
+\begin{verbatim}
+\documentclass{article}
+\usepackage[no-math]{xeCJK}
+\setCJKmainfont{SimSun}
+\usepackage{newtx}
+\end{verbatim}
+\item Because options {\tt no-math} and {\tt otfmath} were mentioned in previous versions of the documentation, I've kept both in the current version even though not logically necessary as one is the negation of the other. In fact, if both are specified, or, equivalently, both are set equal to {\tt true}, then {\tt otfmath wins}.
+\end{itemize}
\textsc{Changes as of version 1.73}
\begin{itemize}
@@ -166,7 +185,7 @@ Supports specially prepared text font packages with {\tt newtxmath}.
\usepackage[no-math]{fontspec}
\usepackage{} % the chosen otf text font package, or fontspec \setmainfont, etc
% or, using newtx
- \usepackage[]{newtx} % options will be passed to text font package and newtxmath
+ \usepackage[]{newtx} % options will be passed to text font package and newtxmath---option no-math can be specified here
\end{verbatim}
\textsc{Notes:}
\begin{itemize}
@@ -247,7 +266,7 @@ Aside from options that are passed along to the text and math packages, {\tt new
\begin{itemize}
\item
You may set the scale for both text and math by setting {\tt scale} or, equivalently, {\tt scaled}. Alternatively, you may scale text and math separately by means of the options {\tt textscale[d]}, {\tt mathscale[d]}.
-\item Option {otfmath} is acted upon only under a unicode engine, and specifies unicode math rather than the default---type1 math using {\tt newtxmath}.
+\item Option {otfmath} is acted upon only under a unicode engine, and specifies unicode math rather than the default---type1 math using {\tt newtxmath}. The effect is the exact opposite to {\tt no-math}, which would specify math no controlled by {\tt fontspec}.
\item Option {\tt subscriptcorrectionfile} allows you to set your own file specifying subscript corrections.
\item You may specify as an option to {\tt newtx} the name of any supported text package and any options other than scale[d] that are understood by that package. The default text package is {\tt newtxtext}, which need not be specified explicitly. Other valid options as of early May, 2022, are:
\begin{verbatim}
@@ -372,7 +391,7 @@ For example:
\setotherlanguages{french,russian}
\usepackage[]{hyperref}
\end{verbatim}
-If you process with a unicode engine, {\tt fontspec} will be loaded by {\tt newtxtext}.
+If you process with a unicode engine, {\tt fontspec} will be loaded by {\tt newtxtext}, adding the {\tt no-math} option if option {\tt no-math} was specified to {\tt newtxtext} or {\tt newtx}.
\subsection{Notes}
%\section{Usage with Lua\LaTeX\ and Xe\LaTeX}
%As far as I can tell, \textsf{newtxmath} works with both, but requires a very specific loading order and choice of options. Briefly, the math options must all be loaded prior to loading and using {\tt fontspec}. As of version 1.5, {\tt newtxtext} will load fontspec when processing with XeLaTeX or LuaLaTeX unless one or more of the options {\tt nofontspec}, {\tt type1} is specified. (If you specify the option {\tt no-otfmath} to {\tt newtxtext}, it will pass the option {\tt no-math}to the {\tt fontspec} call. This should be done if {\tt fontspec} will not be expected to load an Opentype package or install math support using {\tt mathspec}.)
@@ -1185,7 +1204,7 @@ The {\tt operators} font is essentially the Roman text font, used for names of o
\item if space is tight, do not call bold versions of the fonts listed above where the bold version is not already loaded, to avoid loading a new mathgroup;
\item if you absolutely need a letter (not a math symbol) from some math font that would normally cost you another mathgroup, you might consider using as if it were text, with something like
\begin{verbatim}
-\mbox{{\usefont{U}{ntxmia}{b}{n} X}}
+\mbox{{\usefont{U}{ntxmia}{b}{n}X}}
\end{verbatim}
which allows you to use letter X from {\tt boldlettersA} but without any math features;
\item there is a macro \verb|\ShowMathFonts| in {\tt newtxmath} which may be called at any point in your document, which will provide you a list of the mathgroups currently in use. This can be helpful in figuring out where problems occur. The output lines take the form