summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Master/texmf-dist/doc/latex/isomath/README.html16
-rw-r--r--Master/texmf-dist/doc/latex/isomath/README.txt15
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath-test.pdfbin137429 -> 137549 bytes
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath-test.tex38
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath.sty.html375
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath.sty.pdfbin192005 -> 198265 bytes
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath.sty.txt245
-rw-r--r--Master/texmf-dist/tex/latex/isomath/isomath.sty247
-rwxr-xr-xMaster/tlpkg/bin/ctan2tds1
9 files changed, 549 insertions, 388 deletions
diff --git a/Master/texmf-dist/doc/latex/isomath/README.html b/Master/texmf-dist/doc/latex/isomath/README.html
index a965f58f931..4ef137e6460 100644
--- a/Master/texmf-dist/doc/latex/isomath/README.html
+++ b/Master/texmf-dist/doc/latex/isomath/README.html
@@ -5,7 +5,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.6: http://docutils.sourceforge.net/" />
<title>isomath: Math for scientists</title>
-<meta name="date" content="2008-09-26" />
+<meta name="date" content="2008-10-02" />
<meta name="copyright" content="© 2008 Günter Milde &lt;milde&#64;users.berlios.de&gt;" />
<style type="text/css">
@@ -292,7 +292,7 @@ ul.auto-toc {
<col class="docinfo-content" />
<tbody valign="top">
<tr><th class="docinfo-name">Date:</th>
-<td>2008-09-26</td></tr>
+<td>2008-10-02</td></tr>
<tr><th class="docinfo-name">Copyright:</th>
<td>© 2008 Günter Milde &lt;<a class="reference external" href="mailto:milde&#64;users.berlios.de">milde&#64;users.berlios.de</a>&gt;</td></tr>
<tr class="field"><th class="docinfo-name">Licence:</th><td class="field-body">Released under the terms of the GNU General Public License
@@ -349,9 +349,9 @@ bold italic</em> fonts matching with Computer Modern and derivatives.</p>
<div class="section" id="installation">
<h1>Installation</h1>
<ul class="simple">
-<li>Unpack isomath.zip (preferabely in a TDS documentation folder).</li>
+<li>Unpack isomath.zip (preferabely in a <a class="reference external" href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">TDS</a> documentation folder).</li>
<li>Make sure LaTeX can find isomath.sty:<ul>
-<li>Copy/Move it to a suitable place in the TDS and run texhash,</li>
+<li>Copy/Move/Link it to a suitable place in the <a class="reference external" href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">TDS</a> and run texhash,</li>
<li>or place it in the current working directory (e.g. for testing).</li>
</ul>
</li>
@@ -365,10 +365,10 @@ bold italic</em> fonts matching with Computer Modern and derivatives.</p>
\usepackage[sfdefault=cmbr]{isomath}
\renewcommand{\vec}{\vectorsym}
</pre>
-<p>More examples and usage hints are in the literate source and documentation
-files.</p>
-<!-- References
-========== -->
+<p>More examples and usage hints are in the documentation files.</p>
+</div>
+<div class="section" id="references">
+<h1>References</h1>
<table class="docutils citation" frame="void" id="typefaces" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
diff --git a/Master/texmf-dist/doc/latex/isomath/README.txt b/Master/texmf-dist/doc/latex/isomath/README.txt
index 0c83147af4f..77d479962e9 100644
--- a/Master/texmf-dist/doc/latex/isomath/README.txt
+++ b/Master/texmf-dist/doc/latex/isomath/README.txt
@@ -1,7 +1,7 @@
isomath: Math for scientists
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-:Date: 2008-09-26
+:Date: 2008-10-02
:Copyright: © 2008 Günter Milde <milde@users.berlios.de>
:Licence: Released under the terms of the GNU General Public License
(v. 2 or later)
@@ -47,11 +47,11 @@ All required packages are part of TeXLive and MikTeX.
Installation
============
-* Unpack isomath.zip (preferabely in a TDS documentation folder).
+* Unpack isomath.zip (preferabely in a TDS_ documentation folder).
* Make sure LaTeX can find isomath.sty:
- + Copy/Move it to a suitable place in the TDS and run texhash,
+ + Copy/Move/Link it to a suitable place in the TDS_ and run texhash,
+ or place it in the current working directory (e.g. for testing).
@@ -64,12 +64,11 @@ Use cmbright for the sans-serif math alphabets and redefine the
\usepackage[sfdefault=cmbr]{isomath}
\renewcommand{\vec}{\vectorsym}
-More examples and usage hints are in the literate source and documentation
-files.
+More examples and usage hints are in the documentation files.
-.. References
- ==========
+References
+==========
.. [typefaces] `Typefaces for Symbols in Scientific Manuscripts`:
http://physics.nist.gov/Document/typefaces.pdf
@@ -81,3 +80,5 @@ files.
.. _cmbright: http://dante.ctan.org/CTAN/help/Catalogue/entries/cmbright.html
.. _fixmath: http://dante.ctan.org/CTAN/help/Catalogue/entries/fixmath.html
.. _kvoptions: http://dante.ctan.org/CTAN/help/Catalogue/entries/kvoptions.html
+
+.. _TDS: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds
diff --git a/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf b/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf
index 02656102374..3d95a73d963 100644
--- a/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf
+++ b/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/isomath/isomath-test.tex b/Master/texmf-dist/doc/latex/isomath/isomath-test.tex
index a4ce766ae2d..ce6ab3fa5b6 100644
--- a/Master/texmf-dist/doc/latex/isomath/isomath-test.tex
+++ b/Master/texmf-dist/doc/latex/isomath/isomath-test.tex
@@ -33,7 +33,7 @@
% gfsneohellenic% (use option [default]) no bold
% hfoldsty% bitmap fonts
% iwona% sets cmss as sans font (use iwona)
-% kpfonts% no sans serif italic, needs reuseMathalphabets
+% kpfonts% no sans serif italic, needs reuseMathAlphabets
% kerkis% no bold math, no sans serif (use iwona or arev?)
% cmlgc% \sfdefault is cmss (use cmbr)
% lmodern% \sfdefault is cmss (use cmbr)
@@ -42,7 +42,7 @@
mathdesign% \sfdefault is cmss (use cmbr?) provides roman and roman bold in OML :-)
% mbtimes% \sfdefault is cmss (use cmbr?)
% mathpazo% \sfdefault is cmss (use cmbr?)
-% pxfonts% needs reuseMathalphabets, no sans-serif
+% pxfonts% needs reuseMathAlphabets, no sans-serif
% tgpagella,qpxmath% \sfdefault is cmss (use cmbr?)
% tgtermes,qtxmath% \sfdefault is cmss (use cmbr?)
% txfonts% no sans-serif
@@ -51,9 +51,10 @@ mathdesign% \sfdefault is cmss (use cmbr?) provides roman and roman bold in
% Options
% -------
-% ::
+% Uncomment the line(s) with the required options!
+
+% Options for the font package call::
-% Options for the font package call:
\newcommand*{\fontpackageoptions}{}
\renewcommand*{\fontpackageoptions}{%
% default% {gfsneohellenic}
@@ -62,16 +63,18 @@ mathdesign% \sfdefault is cmss (use cmbr?) provides roman and roman bold in
utopia% {mathdesign} % \sfdefault is cmss (use cmbr?)
}
-% Options for
+% Isomath options::
+
\newcommand*{\isomathoptions}{}
\renewcommand*{\isomathoptions}{%
-% reuseMathalphabets%
-% OMLmathsans%
-OMLmathsans,OMLmathbf,sfdefault=cmbr%
-% OMLmathsans,sfdefault=cmbr% CM-Bright
-% OMLmathsans,sfdefault=iwona% Iwona sans
-% sfdefault=zavm% Arew sans (larger than normal)
-% sfdefault=llcmm% LX sans (larger than normal)
+% reuseMathAlphabets,%
+OMLmathsans,%
+OMLmathbf,%
+% OMLmathsf,
+sfdefault=cmbr% CM-Bright
+% sfdefault=iwona% Iwona sans (some glyphs too close to roman)
+% sfdefault=zavm% Arew sans (larger than normal)
+% sfdefault=llcmm% LX sans (larger than normal)
}
% Load customisable packages
@@ -111,8 +114,9 @@ Default font families:
\subsection{Math alphabets}
-If there are ligatures (ff, fi, ...) instead of small Greek letters in a
-math alphabet, T1 or OT1 encoding is used instead of OML.
+If there are ligatures (ff, fi, ...) or other "strange" symbols instead of
+small Greek letters in a math alphabet, it uses T1 or OT1 encoding instead
+of OML.
% Define a teststring with Latin and Greek letters
\newcommand{\teststring}{%
@@ -147,7 +151,8 @@ a,g,
\subsection{Vector symbols}
-Symbols for vectors are boldface italic $\vec{\alpha}=\vec{e}_{1}\cdot\vec{a}$
+Symbols for vectors are boldface italic:
+$\vec{\alpha}=\vec{e}_{1}\cdot\vec{a}$
\subsection{Matrix symbols}
@@ -157,7 +162,8 @@ face as vectors:%
\footnote{However, matrix symbols are usually capital letters whereas vectors
are small ones. Exceptions are physical Quantities like the force
vector $\vec{F}$ or the electrical field $\vec{E}$.%
-} $\matrixsym{\Gamma}=\matrixsym{E}\cdot\matrixsym{A}.$
+}
+$\matrixsym{\Gamma}=\matrixsym{E}\cdot\matrixsym{A}.$
\subsection{Tensor symbols}
diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.sty.html b/Master/texmf-dist/doc/latex/isomath/isomath.sty.html
index 87bbd7ff324..e715047ab01 100644
--- a/Master/texmf-dist/doc/latex/isomath/isomath.sty.html
+++ b/Master/texmf-dist/doc/latex/isomath/isomath.sty.html
@@ -308,64 +308,75 @@ and a <em>sans-serif bold italic</em> math alphabet are defined.</p>
<div class="contents topic" id="contents">
<p class="topic-title first">Contents</p>
<ul class="simple">
-<li><a class="reference internal" href="#introduction" id="id13">Introduction</a><ul>
-<li><a class="reference internal" href="#motivation" id="id14">Motivation</a></li>
-<li><a class="reference internal" href="#features" id="id15">Features</a></li>
-<li><a class="reference internal" href="#examples" id="id16">Examples</a></li>
-<li><a class="reference internal" href="#related-packages" id="id17">Related packages</a><ul>
-<li><a class="reference internal" href="#conflicts" id="id18">Conflicts</a></li>
+<li><a class="reference internal" href="#introduction" id="id11">Introduction</a><ul>
+<li><a class="reference internal" href="#motivation" id="id12">Motivation</a></li>
+<li><a class="reference internal" href="#features" id="id13">Features</a></li>
+<li><a class="reference internal" href="#usage" id="id14">Usage</a><ul>
+<li><a class="reference internal" href="#examples" id="id15">Examples</a></li>
</ul>
</li>
-<li><a class="reference internal" href="#oml-font-encoding" id="id19">OML font encoding</a></li>
-<li><a class="reference internal" href="#conclusions-and-outlook" id="id20">Conclusions and outlook</a></li>
+<li><a class="reference internal" href="#related-packages" id="id16">Related packages</a><ul>
+<li><a class="reference internal" href="#conflicts" id="id17">Conflicts</a></li>
</ul>
</li>
-<li><a class="reference internal" href="#implementation" id="id21">Implementation</a><ul>
-<li><a class="reference internal" href="#identification" id="id22">Identification</a></li>
-<li><a class="reference internal" href="#requirements" id="id23">Requirements</a><ul>
-<li><a class="reference internal" href="#fixmath" id="id24">fixmath</a></li>
-<li><a class="reference internal" href="#kvoptions" id="id25">kvoptions</a></li>
+<li><a class="reference internal" href="#greek-in-math" id="id18">Greek in Math</a><ul>
+<li><a class="reference internal" href="#unicode-math-support" id="id19">Unicode Math Support</a></li>
+<li><a class="reference internal" href="#oml-font-encoding" id="id20">OML font encoding</a><ul>
+<li><a class="reference internal" href="#definition" id="id21">Definition</a></li>
+<li><a class="reference internal" href="#support" id="id22">Support</a></li>
</ul>
</li>
-<li><a class="reference internal" href="#options" id="id26">Options</a><ul>
-<li><a class="reference internal" href="#rmdefault" id="id27">rmdefault</a></li>
-<li><a class="reference internal" href="#sfdefault" id="id28">sfdefault</a></li>
-<li><a class="reference internal" href="#reusemathalphabets" id="id29">reuseMathalphabets</a></li>
-<li><a class="reference internal" href="#oml-math-alphabets" id="id30">OML math alphabets</a></li>
+<li><a class="reference internal" href="#conclusions-and-outlook" id="id23">Conclusions and outlook</a></li>
</ul>
</li>
-<li><a class="reference internal" href="#declarations" id="id31">Declarations</a><ul>
-<li><a class="reference internal" href="#math-alphabets" id="id32">Math alphabets</a><ul>
-<li><a class="reference internal" href="#mathbold" id="id33">mathbold</a></li>
-<li><a class="reference internal" href="#mathsans" id="id34">mathsans</a></li>
-<li><a class="reference internal" href="#mathboldsans" id="id35">mathboldsans</a></li>
-<li><a class="reference internal" href="#redefine-standard-alphabets" id="id36">Redefine standard alphabets</a></li>
</ul>
</li>
-<li><a class="reference internal" href="#command-aliases" id="id37">Command aliases</a><ul>
-<li><a class="reference internal" href="#vectorsym" id="id38">\vectorsym</a></li>
-<li><a class="reference internal" href="#matrixsym" id="id39">\matrixsym</a></li>
-<li><a class="reference internal" href="#tensorsym" id="id40">\tensorsym</a></li>
+<li><a class="reference internal" href="#implementation" id="id24">Implementation</a><ul>
+<li><a class="reference internal" href="#identification" id="id25">Identification</a></li>
+<li><a class="reference internal" href="#requirements" id="id26">Requirements</a><ul>
+<li><a class="reference internal" href="#fixmath-sty" id="id27">fixmath.sty</a></li>
+<li><a class="reference internal" href="#kvoptions-sty" id="id28">kvoptions.sty</a></li>
</ul>
</li>
-<li><a class="reference internal" href="#font-mappings" id="id41">Font mappings</a></li>
+<li><a class="reference internal" href="#options" id="id29">Options</a><ul>
+<li><a class="reference internal" href="#rmdefault" id="id30">rmdefault</a></li>
+<li><a class="reference internal" href="#sfdefault" id="id31">sfdefault</a></li>
+<li><a class="reference internal" href="#reusemathalphabets" id="id32">reuseMathAlphabets</a></li>
+<li><a class="reference internal" href="#oml-math-alphabets" id="id33">OML math alphabets</a></li>
</ul>
</li>
+<li><a class="reference internal" href="#declarations" id="id34">Declarations</a><ul>
+<li><a class="reference internal" href="#math-alphabets" id="id35">Math alphabets</a><ul>
+<li><a class="reference internal" href="#mathbold" id="id36">mathbold</a></li>
+<li><a class="reference internal" href="#mathsans" id="id37">mathsans</a></li>
+<li><a class="reference internal" href="#mathboldsans" id="id38">mathboldsans</a></li>
+<li><a class="reference internal" href="#redefine-standard-alphabets" id="id39">Redefine standard alphabets</a></li>
</ul>
</li>
-<li><a class="reference internal" href="#references" id="id42">References</a></li>
+<li><a class="reference internal" href="#command-aliases" id="id40">Command aliases</a><ul>
+<li><a class="reference internal" href="#vectorsym" id="id41">\vectorsym</a></li>
+<li><a class="reference internal" href="#matrixsym" id="id42">\matrixsym</a></li>
+<li><a class="reference internal" href="#tensorsym" id="id43">\tensorsym</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#font-mappings" id="id44">Font mappings</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a class="reference internal" href="#references" id="id45">References</a></li>
</ul>
</div>
<div class="section" id="introduction">
-<h1><a class="toc-backref" href="#id13">Introduction</a></h1>
+<h1><a class="toc-backref" href="#id11">Introduction</a></h1>
<div class="section" id="motivation">
-<h2><a class="toc-backref" href="#id14">Motivation</a></h2>
+<h2><a class="toc-backref" href="#id12">Motivation</a></h2>
<!-- Did you ever manage to write the stress tensor ``$\sigma$`` in a
*sans-serif bold italic* typeface, as recommended by [typefaces]_? -->
<p>Scientific organisations like <a class="reference external" href="http://www.iupap.org/">IUPAP</a>, <a class="reference external" href="http://iupac.org/">IUPAC</a>, <a class="reference external" href="http://physics.nist.gov/">NIST</a>, <a class="reference external" href="http://www.bipm.org/">BIPM</a>, and others
-recommend typesetting math according to International Standard <a class="reference external" href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_tc_browse.htm?commid=46202">ISO 31</a>
-<cite>Quantities and units</cite> (ISO 31-0:1992 to ISO 31-14:1992).<a class="footnote-reference" href="#id3" id="id1"><sup>1</sup></a></p>
-<p>The traditional <cite>LaTeX-style</cite> deviates in some points from this rules:</p>
+recommend typesetting math according to the International Standard ISO 31
+<cite>Quantities and units</cite> <a class="citation-reference" href="#iso-31" id="id1">[ISO-31]</a>.<a class="footnote-reference" href="#id3" id="id2"><sup>1</sup></a></p>
+<p>The traditional <cite>LaTeX math style</cite> deviates in some points from this rules:</p>
<ul class="simple">
<li>The <tt class="docutils literal"><span class="pre">\vec</span></tt> command produces an array accent, while ISO 31 recommends
a <em>bold italic</em> typeface for vector symbols.</li>
@@ -373,61 +384,39 @@ a <em>bold italic</em> typeface for vector symbols.</li>
while the ISO 31 rules apply equally to letters from both the Greek
and the Latin alphabet.</li>
<li>There is no provision for typesetting of Greek letters in <em>bold italic</em>
-style recommended for vectors (even though the required fonts are
-available).</li>
+style recommended for vectors.</li>
<li>There is no provision for typesetting letters in <em>sans-serif bold italic</em>
recommended for typesetting tensor symbols.</li>
</ul>
-<p>Also, the Unicode Standard defines the block <a class="reference external" href="http://www.unicode.org/charts/PDF/U1D400.pdf">mathematical alphanumeric
-symbols</a> — <em>To be used for mathematical variables where style variations
-are important semantically</em> — which contains Latin and Greek letters in
-bold, italic, bold italic, sans-serif bold, and sans-serif bold italic
-typeface.<a class="footnote-reference" href="#id7" id="id2"><sup>2</sup></a></p>
-<p>Some of these points are already adressed by <a class="reference internal" href="#related-packages">related packages</a>, however
+<p>Some of these points are adressed by <a class="reference internal" href="#related-packages">related packages</a>, however
there is currently no package (known to the author) that defines the
<em>sans-serif bold italic</em> math alphabet needed for tensor symbols.</p>
<table class="docutils footnote" frame="void" id="id3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>A summary of these rules is free available <a class="citation-reference" href="#typefaces" id="id4">[typefaces]</a>. See also
-<a class="citation-reference" href="#fonts-for-symbols" id="id5">[fonts-for-symbols]</a> and <a class="citation-reference" href="#si-brochure" id="id6">[SI-brochure]</a>.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id7" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td>Plus Number variants and Latin letters in script, bold script,
-fraktur, bold fraktur, double-struck, sans-serif and monospace;
-alltogether 1023 codepoints.</td></tr>
+<tr><td class="label"><a class="fn-backref" href="#id2">[1]</a></td><td>Summaries of these rules are free available, see <a class="citation-reference" href="#typefaces" id="id4">[typefaces]</a>,
+<a class="citation-reference" href="#fonts-for-symbols" id="id5">[fonts-for-symbols]</a>, and <a class="citation-reference" href="#si-brochure" id="id6">[SI-brochure]</a>.</td></tr>
</tbody>
</table>
</div>
<div class="section" id="features">
-<h2><a class="toc-backref" href="#id15">Features</a></h2>
+<h2><a class="toc-backref" href="#id13">Features</a></h2>
<p>The <tt class="docutils literal"><span class="pre">isomath.sty</span></tt> package facilitates the task to abide with ISO 31 when
typesetting math with LaTeX:</p>
<ul>
-<li><p class="first">It utilises <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/fixmath.html">fixmath</a> to re-define Greek letters as <tt class="docutils literal"><span class="pre">\mathalpha</span></tt>, taking
-them from the &quot;letters&quot; symbol fonts (as opposed to &quot;operators&quot; in
-<tt class="docutils literal"><span class="pre">fontmath.ltx</span></tt>). This ensures that</p>
+<li><p class="first">Equal treatment of Latin and <a class="reference internal" href="#greek-in-math">Greek in math</a> via <a class="reference internal" href="#fixmath-sty">fixmath.sty</a>:</p>
<ul class="simple">
<li>Greek letters change shape together with Latin letters if a different
math alphabet is used.</li>
<li>Uppercase Greek letters are typeset in italic style by default.</li>
-<li>Upright Greek letters are available through the <tt class="docutils literal"><span class="pre">\mathrm</span></tt> and
-<tt class="docutils literal"><span class="pre">\mathbf</span></tt> alphabets, if the corresponding fonts are OML encoded.</li>
+<li>Upright Greek letters can be made available through the <tt class="docutils literal"><span class="pre">\mathrm</span></tt>
+and <tt class="docutils literal"><span class="pre">\mathbf</span></tt> alphabets, if the corresponding fonts support the
+<a class="reference internal" href="#oml-font-encoding">OML font encoding</a>.</li>
</ul>
-<dl class="docutils">
-<dt>Caution: small Greek letters in a math alphabet command can lead to garbage.</dt>
-<dd><p class="first last">Use the options for <a class="reference internal" href="#oml-math-alphabets">OML math alphabets</a> (if the used font supports the
-<a class="reference internal" href="#oml-font-encoding">OML font encoding</a>) or place Greek letters outside the math alphabet
-command. Some packages (including <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/fixmath.html">fixmath</a>) provide <tt class="docutils literal"><span class="pre">\up*</span></tt> or
-<tt class="docutils literal"><span class="pre">\var*</span></tt> macros for upright Greek letters, e.g. <tt class="docutils literal"><span class="pre">\mathrm{k}\upOmega</span></tt>.</p>
-</dd>
-</dl>
</li>
<li><p class="first">The <a class="reference internal" href="#command-aliases">command aliases</a> <tt class="docutils literal"><span class="pre">\vectorsym</span></tt>, <tt class="docutils literal"><span class="pre">\matrixsym</span></tt>, and <tt class="docutils literal"><span class="pre">\tensorsym</span></tt>
-allow semantic markup selecting an ISO-conforming typeface.</p>
+allow semantic markup. They print the argument in an ISO-conforming
+typeface.</p>
</li>
<li><p class="first">For this, new <a class="reference internal" href="#math-alphabets">math alphabets</a> are defined:</p>
<table class="docutils field-list" frame="void" rules="none">
@@ -447,13 +436,17 @@ allow semantic markup selecting an ISO-conforming typeface.</p>
<tt class="docutils literal"><span class="pre">sfdefault=&lt;family&gt;</span></tt> <a class="reference internal" href="#options">options</a> can be used to override the defaults.</p>
</li>
<li><p class="first">Missing <a class="reference internal" href="#font-mappings">font mappings</a> are defined for font families which have an OML
-encoded counterpart but miss the substitution definition in their <tt class="docutils literal"><span class="pre">*.fd</span></tt>
+encoded counterpart but no substitution definition in their <tt class="docutils literal"><span class="pre">*.fd</span></tt>
files.</p>
</li>
</ul>
</div>
+<div class="section" id="usage">
+<h2><a class="toc-backref" href="#id14">Usage</a></h2>
+<p>Make sure that LaTeX can find <tt class="docutils literal"><span class="pre">isomath.sty</span></tt> and insert the command
+<tt class="docutils literal"><span class="pre">\usepackage{isomath}</span></tt> in the document preamble.</p>
<div class="section" id="examples">
-<h2><a class="toc-backref" href="#id16">Examples</a></h2>
+<h3><a class="toc-backref" href="#id15">Examples</a></h3>
<ul>
<li><p class="first">In many cases (e.g. when <tt class="docutils literal"><span class="pre">\sfdefault</span></tt> expands to &quot;cmss&quot;), the
<tt class="docutils literal"><span class="pre">\mathboldsans</span></tt> alphabet is neither bold nor sans, as &quot;cmss&quot; has no OML
@@ -476,14 +469,15 @@ not set it up for <tt class="docutils literal"><span class="pre">\mathbf</span><
\usepackage[charter]{mathdesign}
\usepackage[OMLmathbf,sfdefault=cmbr]{isomath}
</pre>
-<p>Now, <tt class="docutils literal"><span class="pre">\mathbf{\pi}</span></tt> works as expected.</p>
+<p>Now, <tt class="docutils literal"><span class="pre">\mathbf{\pi}</span></tt> produces a bold upright pi symbol.</p>
</li>
</ul>
</div>
+</div>
<div class="section" id="related-packages">
-<h2><a class="toc-backref" href="#id17">Related packages</a></h2>
-<p>Some packages already define Greek letters as <tt class="docutils literal"><span class="pre">\mathalpha</span></tt> and provide the
-<tt class="docutils literal"><span class="pre">\mathbold</span></tt> alphabet (in OML):</p>
+<h2><a class="toc-backref" href="#id16">Related packages</a></h2>
+<p>A set of packages at CTAN also defines Greek letters as <tt class="docutils literal"><span class="pre">\mathalpha</span></tt> and
+provide the <tt class="docutils literal"><span class="pre">\mathbold</span></tt> alphabet (in OML):</p>
<ul class="simple">
<li><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/arev.html">arev</a> (Arev/Vera Sans)</li>
<li><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/cmbright.html">cmbright</a> (CM Bright)</li>
@@ -493,33 +487,53 @@ not set it up for <tt class="docutils literal"><span class="pre">\mathbf</span><
<li><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/mathpazo.html">mathpazo</a> (Palatino)</li>
<li><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/tmmath.html">tmmath</a> (TM-Math/Times)</li>
</ul>
-<p>This package builds on and extends <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/fixmath.html">fixmath</a> by Walter Schmidt
-(see <a class="reference internal" href="#requirements">Requirements</a>).</p>
-<p>The <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/cmbright.html">cmbright</a> package provides fonts for <tt class="docutils literal"><span class="pre">\mathsans</span></tt> and
-<tt class="docutils literal"><span class="pre">\mathboldsans</span></tt> matching with Computer Modern and derivatives.</p>
+<p>This package requires and extends <a class="reference internal" href="#fixmath-sty">fixmath.sty</a>.</p>
+<p>The <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/cmbright.html">cmbright</a> package provides <em>sans serif</em> and <em>sans-serif bold</em> fonts for
+the <tt class="docutils literal"><span class="pre">\mathsans</span></tt> and <tt class="docutils literal"><span class="pre">\mathboldsans</span></tt> alphabets that match with Computer
+Modern and derivatives.</p>
<div class="section" id="conflicts">
-<h3><a class="toc-backref" href="#id18">Conflicts</a></h3>
+<h3><a class="toc-backref" href="#id17">Conflicts</a></h3>
<p>The <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/fourier.html">fourier</a> package for math typesetting with Utopia defines its own,
incompatible math font encodings. It cannot be used with <tt class="docutils literal"><span class="pre">isomath</span></tt> but
provides other means to typeset upright or italic Greek (see its
documentation).</p>
<p>The <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/kpfonts.html">kpfonts</a>, <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/pxfonts.html">pxfonts</a>, and <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/txfonts.html">txfonts</a> packages define many additional
math alphabets and can only be combined with <tt class="docutils literal"><span class="pre">isomath</span></tt>, if the
-<a class="reference internal" href="#reusemathalphabets">reuseMathalphabets</a> option is used.</p>
+<a class="reference internal" href="#reusemathalphabets">reuseMathAlphabets</a> option is used.</p>
+</div>
</div>
+<div class="section" id="greek-in-math">
+<h2><a class="toc-backref" href="#id18">Greek in Math</a></h2>
+<div class="section" id="unicode-math-support">
+<h3><a class="toc-backref" href="#id19">Unicode Math Support</a></h3>
+<p>The technical report <cite>Unicode Support for Mathematics</cite> <a class="citation-reference" href="#tr25" id="id7">[tr25]</a> lists
+<em>alphanumeric symbols encountered in mathematics</em> in Table 2.1 <cite>Mathematical
+Alphabets</cite>. It includes Latin and Greek letters in the bold, italic, bold
+italic, sans-serif bold, and sans-serif bold italic math styles.</p>
+<p>The Unicode block <a class="reference external" href="http://www.unicode.org/charts/PDF/U1D400.pdf">mathematical alphanumeric symbols</a> provides style
+variants for Latin and Greek letters and digits. It is &quot;to be used for
+mathematical variables where style variations are important semantically&quot;.</p>
</div>
<div class="section" id="oml-font-encoding">
-<h2><a class="toc-backref" href="#id19">OML font encoding</a></h2>
-<p>The <cite>LaTeX font encodings</cite> guide <a class="citation-reference" href="#encguide" id="id8">[encguide]</a> defines:</p>
+<h3><a class="toc-backref" href="#id20">OML font encoding</a></h3>
+<p>The OML font encoding is the only established encoding providing
+Latin and Greek letters in one font:</p>
+<ul class="simple">
+<li>LGR is Greek-only,</li>
+<li>T7 is just a &quot;reserved name&quot; for a standard Greek encoding.</li>
+</ul>
+<div class="section" id="definition">
+<h4><a class="toc-backref" href="#id21">Definition</a></h4>
+<p>The <cite>LaTeX font encodings</cite> guide <a class="citation-reference" href="#encguide" id="id8">[encguide]</a> names OML <cite>TeX math italic</cite> and
+defines:</p>
<blockquote>
The OML encoding contains italic Latin and Greek letters for use in
mathematical formulas (typically used for variables) together with some
symbols.</blockquote>
-<p>and names it <cite>TeX math italic</cite>. However, the reference to <em>italic</em> seems to
-be a description of the <em>state of the art</em> rather than a necessary
-restriction:</p>
+<p>However, the reference to <strong>italic</strong> seems to be a description of the <em>state
+of the art</em> rather than a necessary restriction:</p>
<ul class="simple">
-<li>The only OML encoded CM font is &quot;Computer Modern Math Italic&quot; (cmmi),</li>
+<li>The only OML encoded CM font is <cite>Computer Modern Math Italic</cite> (cmmi),</li>
<li>but generally, font encodings (T1, OT1) are not specific to the font shape.</li>
<li>Both, <tt class="docutils literal"><span class="pre">\DeclareSymbolFont</span></tt> and <tt class="docutils literal"><span class="pre">\DeclareMathAlphabet</span></tt> require a
{&lt;shape&gt;} argument. Thus it is possible to define OML encoded math
@@ -527,12 +541,9 @@ alphabets in roman {n} as well as italic {it} shape without conflicts.</li>
<li>A more suitable public name would be <cite>TeX math letters</cite> or <cite>Original/Old
Math Letters</cite>. The latter would also explain the acronym OML.</li>
</ul>
-<p>The OML font encoding is the only established encoding providing
-Latin and Greek letters in one font:</p>
-<ul class="simple">
-<li>LGR is Greek-only,</li>
-<li>T7 is just a &quot;reserved name&quot; for a standard Greek encoding.</li>
-</ul>
+</div>
+<div class="section" id="support">
+<h4><a class="toc-backref" href="#id22">Support</a></h4>
<p>Unfortunately, support for the OML encoding is missing for many font
families even if the base font contains all Greek letters.
Supported font families can be found searching for <tt class="docutils literal"><span class="pre">oml*.fd</span></tt> files and by
@@ -883,16 +894,16 @@ substitution can be set with the <a class="reference internal" href="#rmdefault"
</tbody>
</table>
</div>
+</div>
<div class="section" id="conclusions-and-outlook">
-<h2><a class="toc-backref" href="#id20">Conclusions and outlook</a></h2>
+<h3><a class="toc-backref" href="#id23">Conclusions and outlook</a></h3>
<p>It is hoped, that in the future more fonts families will support the OML
encoding in normal and bold weight as well as upright and italic shape.
-This would be a major step towards the full support of the <a class="reference external" href="http://www.unicode.org/charts/PDF/U1D400.pdf">Mathematical
+This would be a major step towards a LaTeX equivalent of the <a class="reference external" href="http://www.unicode.org/charts/PDF/U1D400.pdf">Mathematical
Alphanumeric Symbols</a> Unicode block.</p>
-<p>This is (relatively) easy to achieve via virtual fonts when the glyphs for
-the Greek letters already exist (this is the case for many fonts where the
-primary version is Unicode encoded). Examples are Latin Modern, Kerkis,
-GFS-Neohellenic, LX-Fonts and KP-Serif.</p>
+<p>This should be (relatively) easy to achieve via virtual fonts when the
+glyphs for the Greek letters already exist. Examples are Latin Modern,
+Kerkis, GFS-Neohellenic, LX-Fonts and KP-Serif.</p>
<p>Alternatively, T7 could be used for math alphabets (if it ever happens to
materialise).</p>
<p>Upright small Greek letters in <tt class="docutils literal"><span class="pre">\mathrm</span></tt> would enable the specification of
@@ -900,31 +911,63 @@ Myons, Pions, alpha-particles, photons, and neutrinos without special
packages. (With <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/mathdesign.html">mathdesign</a>, this is already possible today.)</p>
</div>
</div>
+</div>
<div class="section" id="implementation">
-<h1><a class="toc-backref" href="#id21">Implementation</a></h1>
+<h1><a class="toc-backref" href="#id24">Implementation</a></h1>
<div class="section" id="identification">
-<h2><a class="toc-backref" href="#id22">Identification</a></h2>
+<h2><a class="toc-backref" href="#id25">Identification</a></h2>
<pre class="literal-block">
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{isomath}
-[2008/06/23 v0.1 typeset math according to International Standard ISO 31]
+[2008/10/02 v0.2 typeset math according to International Standard ISO 31]
</pre>
+<table border="1" class="borderless docutils">
+<colgroup>
+<col width="7%" />
+<col width="14%" />
+<col width="79%" />
+</colgroup>
+<tbody valign="top">
+<tr><td>0.1</td>
+<td>2008-09-25</td>
+<td>first public version.</td>
+</tr>
+<tr><td>0.2</td>
+<td>2008-10-02</td>
+<td>bugfix: a usage example was uncommented;
+updated documentation;
+define mathsans only if OMLmathsans is true;
+option reuseMathalphabets -&gt; reuseMathAlphabets.</td>
+</tr>
+</tbody>
+</table>
</div>
<div class="section" id="requirements">
-<h2><a class="toc-backref" href="#id23">Requirements</a></h2>
-<div class="section" id="fixmath">
-<h3><a class="toc-backref" href="#id24">fixmath</a></h3>
-<p><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/fixmath.html">fixmath</a> by Walter Schmidt defines Greek letters as symbols of type
-<tt class="docutils literal"><span class="pre">\mathalpha</span></tt> and takes them from the &quot;letters&quot; SymbolFont in
-<tt class="docutils literal"><span class="pre">\mathnormal</span></tt>. (It also defines the <tt class="docutils literal"><span class="pre">\mathbold</span></tt> alphabet, setting it to
-<tt class="docutils literal"><span class="pre">cmm</span></tt>. This definition will be overwritten with a configurable value for
+<h2><a class="toc-backref" href="#id26">Requirements</a></h2>
+<div class="section" id="fixmath-sty">
+<h3><a class="toc-backref" href="#id27">fixmath.sty</a></h3>
+<p>The package <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/fixmath.html">fixmath</a> by Walter Schmidt defines Greek letters as symbols
+of type <tt class="docutils literal"><span class="pre">\mathalpha</span></tt> and takes them from the &quot;letters&quot; SymbolFont in
+<tt class="docutils literal"><span class="pre">\mathnormal</span></tt> (as opposed to &quot;operators&quot; in <tt class="docutils literal"><span class="pre">fontmath.ltx</span></tt>).</p>
+<p><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/fixmath.html">fixmath</a> also defines the <tt class="docutils literal"><span class="pre">\mathbold</span></tt> alphabet, setting it to <tt class="docutils literal"><span class="pre">cmm</span></tt>.
+However, this definition will be overwritten with a configurable value for
the font family below.)</p>
<pre class="literal-block">
\RequirePackage{fixmath}
</pre>
+<div class="caution">
+<p class="first admonition-title">Caution!</p>
+<p>Placing small Greek letters in a math alphabet, e.g.
+<tt class="docutils literal"><span class="pre">\mathrm{k\Omega}</span></tt>, can lead to garbage.</p>
+<p>If the chosen font supports the <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>, you can use the
+options for <a class="reference internal" href="#oml-math-alphabets">OML math alphabets</a>. Otherwise, place Greek letters
+outside the math alphabet command.</p>
+<p class="last">Some packages provide <tt class="docutils literal"><span class="pre">\up*</span></tt> or <tt class="docutils literal"><span class="pre">\var*</span></tt> macros for upright Greek
+letters, e.g. <tt class="docutils literal"><span class="pre">\mathrm{k}\upOmega</span></tt>.</p>
+</div>
</div>
-<div class="section" id="kvoptions">
-<h3><a class="toc-backref" href="#id25">kvoptions</a></h3>
+<div class="section" id="kvoptions-sty">
+<h3><a class="toc-backref" href="#id28">kvoptions.sty</a></h3>
<p>The <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/kvoptions.html">kvoptions</a> package in the <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/oberdiek.html">oberdiek</a> bundle facilitates the setup of
package options and provides a key=value interface (based on <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/keyval.html">keyval</a>):</p>
<pre class="literal-block">
@@ -933,9 +976,9 @@ package options and provides a key=value interface (based on <a class="reference
</div>
</div>
<div class="section" id="options">
-<h2><a class="toc-backref" href="#id26">Options</a></h2>
+<h2><a class="toc-backref" href="#id29">Options</a></h2>
<div class="section" id="rmdefault">
-<h3><a class="toc-backref" href="#id27">rmdefault</a></h3>
+<h3><a class="toc-backref" href="#id30">rmdefault</a></h3>
<p>Alternative family for roman math fonts. The default is to use the
corresponding text font family (<tt class="docutils literal"><span class="pre">\rmdefault</span></tt>) in OMS encoding.
<a class="reference internal" href="#table-2">Table 2</a> lists some fonts where a different setting is advised.</p>
@@ -944,7 +987,7 @@ corresponding text font family (<tt class="docutils literal"><span class="pre">\
</pre>
</div>
<div class="section" id="sfdefault">
-<h3><a class="toc-backref" href="#id28">sfdefault</a></h3>
+<h3><a class="toc-backref" href="#id31">sfdefault</a></h3>
<p>Alternative family for sans-serif math fonts. The default is to use the
corresponding text font family (<tt class="docutils literal"><span class="pre">\sfdefault</span></tt>) in OMS encoding.</p>
<p>Computer Modern Sans Serif (cmss) has no OMS encoded variant. Nor have many
@@ -977,29 +1020,40 @@ recommended setting.</p>
</dl>
</div>
<div class="section" id="reusemathalphabets">
-<h3><a class="toc-backref" href="#id29">reuseMathalphabets</a></h3>
+<h3><a class="toc-backref" href="#id32">reuseMathAlphabets</a></h3>
<p>The definition of new <a class="reference internal" href="#math-alphabets">math alphabets</a> can lead to a &quot;too many math
alphabets used in version normal&quot; error.</p>
<p>As a workaround, this option tells <tt class="docutils literal"><span class="pre">isomath</span></tt> to re-use the existing
<tt class="docutils literal"><span class="pre">\mathbf</span></tt> and <tt class="docutils literal"><span class="pre">\mathsf</span></tt> alphabets for italic bold and sans-serif bold.</p>
<p>To access the upright shapes, the corresponding <tt class="docutils literal"><span class="pre">\textbf</span></tt> and <tt class="docutils literal"><span class="pre">\textsf</span></tt>
-commands might be used (however, that this toggles the math-mode off and
+commands might be used (however, this toggles the math-mode off and
might use a different font).</p>
<pre class="literal-block">
-\DeclareBoolOption{reuseMathalphabets}
+\DeclareBoolOption{reuseMathAlphabets}
</pre>
-<p>Caution: Do not use <tt class="docutils literal"><span class="pre">reuseMathalphabets</span></tt> together with <tt class="docutils literal"><span class="pre">OMLmathbf</span></tt> or
-<tt class="docutils literal"><span class="pre">OMLmathsf</span></tt>.</p>
+<div class="caution">
+<p class="first admonition-title">Caution!</p>
+<p class="last">Do not use <tt class="docutils literal"><span class="pre">reuseMathAlphabets</span></tt> together with the <tt class="docutils literal"><span class="pre">OMLmathbf</span></tt> or
+<tt class="docutils literal"><span class="pre">OMLmathsf</span></tt> options.</p>
+</div>
</div>
<div class="section" id="oml-math-alphabets">
-<h3><a class="toc-backref" href="#id30">OML math alphabets</a></h3>
-<p>The following options cause isomath to (re)define <a class="reference internal" href="#math-alphabets">math alphabets</a> in OML
-encoding.</p>
+<h3><a class="toc-backref" href="#id33">OML math alphabets</a></h3>
<p>With Greek letters defined as <tt class="docutils literal"><span class="pre">\mathalpha</span></tt>, the math alphabets are
-expected to be in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a> as OT1 encoded fonts have ligatures
-and non-alpha symbols in place of the small Greek letters.</p>
+expected to be in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>. Unfortunately, the standard math
+alphabets are usually taken from OT1 encoded fonts that have ligatures and
+non-alpha symbols in place of the small Greek letters.</p>
+<p>The following options cause isomath to (re)define <a class="reference internal" href="#math-alphabets">math alphabets</a> in OML
+encoding:</p>
+<pre class="literal-block">
+\DeclareBoolOption{OMLmathrm}
+\DeclareBoolOption{OMLmathbf}
+\DeclareBoolOption{OMLmathsf}
+\DeclareBoolOption{OMLmathsans}
+\DeclareBoolOption{OMLmathtt}
+</pre>
<p>Setting these options enables access to small Greek letters in different
-shapes with e.g. <tt class="docutils literal"><span class="pre">\mathrm{\pi}</span></tt> <strong>if an OML encoded font is available</strong>.
+shapes with e.g. <tt class="docutils literal"><span class="pre">\mathrm{\pi}</span></tt> — <em>if an OML encoded font is available</em>.
Currently, support for the <a class="reference internal" href="#oml-font-encoding">OML font encoding</a> is rather limited:</p>
<ul class="simple">
<li>only the <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/mathdesign.html">mathdesign</a> fonts support <em>bold roman</em> in OML encoding, while</li>
@@ -1008,13 +1062,6 @@ font.</li>
</ul>
<p>With some packages, these options can result in a &quot;too many math alphabets
used in version normal&quot; error.</p>
-<pre class="literal-block">
-\DeclareBoolOption{OMLmathrm}
-\DeclareBoolOption{OMLmathbf}
-\DeclareBoolOption{OMLmathsf}
-\DeclareBoolOption{OMLmathsans}
-\DeclareBoolOption{OMLmathtt}
-</pre>
<hr class="docutils" />
<p>Process the options with <tt class="docutils literal"><span class="pre">kvoptions</span></tt> extensions:</p>
<pre class="literal-block">
@@ -1023,23 +1070,26 @@ used in version normal&quot; error.</p>
</div>
</div>
<div class="section" id="declarations">
-<h2><a class="toc-backref" href="#id31">Declarations</a></h2>
+<h2><a class="toc-backref" href="#id34">Declarations</a></h2>
<div class="section" id="math-alphabets">
-<h3><a class="toc-backref" href="#id32">Math alphabets</a></h3>
+<h3><a class="toc-backref" href="#id35">Math alphabets</a></h3>
<p>In math, LaTeX uses &quot;absolute&quot; fontnames instead of a selection by family,
-shape, and weight (see the <a class="citation-reference" href="#fntguide" id="id9">[fntguide]</a> for the rationale).</p>
-<p>We define a math alphabet for every required font variant and optionally
-re-define the standard math alphabets in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>.
+shape, and weight because typefaces have a semantic meaning <a class="citation-reference" href="#fntguide" id="id9">[fntguide]</a>.
+This correlates with the <a class="reference internal" href="#unicode-math-support">Unicode math support</a> where the
+<a class="reference external" href="http://www.unicode.org/charts/PDF/U1D400.pdf">mathematical alphanumeric symbols</a> block defines distinct Unicode
+characters for in Greek and Latin letters in different typefaces.</p>
+<p>Isomath defines a math alphabet for every required font variant and
+optionally re-defines the standard math alphabets in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>.
Unfortunately, the number of math alphabets in one math version is limited
to 16, so we have to be carefull not to exceed this.</p>
<div class="section" id="mathbold">
-<h4><a class="toc-backref" href="#id33">mathbold</a></h4>
-<p>For the <em>`italic bold</em> math alphabet we use the name <tt class="docutils literal"><span class="pre">\mathbold</span></tt>
-established in <a class="reference internal" href="#related-packages">related packages</a>. With the <a class="reference internal" href="#reusemathalphabets">reuseMathalphabets</a> option,
-<tt class="docutils literal"><span class="pre">\mathfb</span></tt> is redefined and <tt class="docutils literal"><span class="pre">\mathbold</span></tt> made an alias (overwriting
-existing definitions).</p>
+<h4><a class="toc-backref" href="#id36">mathbold</a></h4>
+<p>The <em>italic bold</em> math alphabet is named <tt class="docutils literal"><span class="pre">\mathbold</span></tt> like in
+<a class="reference internal" href="#related-packages">related packages</a>. With the <a class="reference internal" href="#reusemathalphabets">reuseMathAlphabets</a> option, <tt class="docutils literal"><span class="pre">\mathfb</span></tt>
+is redefined and <tt class="docutils literal"><span class="pre">\mathbold</span></tt> made an alias (overwriting existing
+definitions):</p>
<pre class="literal-block">
-\ifisomath&#64;reuseMathalphabets
+\ifisomath&#64;reuseMathAlphabets
\DeclareMathAlphabet{\mathbf}{OML}{\isomath&#64;rmdefault}{bx}{it}
\def\mathbold{\mathbf}
\else
@@ -1048,7 +1098,7 @@ existing definitions).</p>
</pre>
</div>
<div class="section" id="mathsans">
-<h4><a class="toc-backref" href="#id34">mathsans</a></h4>
+<h4><a class="toc-backref" href="#id37">mathsans</a></h4>
<p>For <em>italic sans-serif</em>, we define a new alphabet named <tt class="docutils literal"><span class="pre">\mathsans</span></tt> (in
analogy to <tt class="docutils literal"><span class="pre">\mathbold</span></tt>). As this typeface is not required by ISO 31, it is
only defined if the <tt class="docutils literal"><span class="pre">OMLmathsans</span></tt> option is set:</p>
@@ -1059,12 +1109,12 @@ only defined if the <tt class="docutils literal"><span class="pre">OMLmathsans</
</pre>
</div>
<div class="section" id="mathboldsans">
-<h4><a class="toc-backref" href="#id35">mathboldsans</a></h4>
+<h4><a class="toc-backref" href="#id38">mathboldsans</a></h4>
<p>A <em>sans serif slanted bold</em> alphabet is needed for tensor symbols. With the
-<a class="reference internal" href="#reusemathalphabets">reuseMathalphabets</a> option, <tt class="docutils literal"><span class="pre">\mathsf</span></tt> is redefined and <tt class="docutils literal"><span class="pre">\mathboldsans</span></tt>
+<a class="reference internal" href="#reusemathalphabets">reuseMathAlphabets</a> option, <tt class="docutils literal"><span class="pre">\mathsf</span></tt> is redefined and <tt class="docutils literal"><span class="pre">\mathboldsans</span></tt>
made an alias:</p>
<pre class="literal-block">
-\ifisomath&#64;reuseMathalphabets
+\ifisomath&#64;reuseMathAlphabets
\DeclareMathAlphabet{\mathsf}{OML}{\isomath&#64;sfdefault}{bx}{it}
\def\mathboldsans{\mathsf}
\else
@@ -1073,9 +1123,9 @@ made an alias:</p>
</pre>
</div>
<div class="section" id="redefine-standard-alphabets">
-<h4><a class="toc-backref" href="#id36">Redefine standard alphabets</a></h4>
+<h4><a class="toc-backref" href="#id39">Redefine standard alphabets</a></h4>
<p>Redefine standard alphabets in <a class="reference internal" href="#oml-font-encoding">OML font encoding</a>
-(if the corresponding <a class="reference internal" href="#oml-math-alphabets">OML math alphabets</a> option is true).</p>
+if the corresponding <a class="reference internal" href="#oml-math-alphabets">OML math alphabets</a> option is true:</p>
<pre class="literal-block">
\ifisomath&#64;OMLmathrm
\SetMathAlphabet{\mathrm}{normal}{OML}{\isomath&#64;rmdefault}{n}{n}
@@ -1093,11 +1143,11 @@ made an alias:</p>
</div>
</div>
<div class="section" id="command-aliases">
-<h3><a class="toc-backref" href="#id37">Command aliases</a></h3>
+<h3><a class="toc-backref" href="#id40">Command aliases</a></h3>
<p>The following macros allow semantic markup of mathematical symbols.
-The symbols argument is typeset as proposed by ISO 31 and <a class="citation-reference" href="#typefaces" id="id10">[typefaces]</a>.</p>
+The argument is typeset as proposed by ISO 31 and <a class="citation-reference" href="#typefaces" id="id10">[typefaces]</a>.</p>
<div class="section" id="vectorsym">
-<h4><a class="toc-backref" href="#id38">\vectorsym</a></h4>
+<h4><a class="toc-backref" href="#id41">\vectorsym</a></h4>
<p>Symbols for vectors are typeset <em>boldface italic</em>:</p>
<pre class="literal-block">
\newcommand{\vectorsym}{\mathbold}
@@ -1107,7 +1157,7 @@ you might want to re-define the standard <tt class="docutils literal"><span clas
package (cf. the <a class="reference internal" href="#examples">Examples</a> section).</p>
</div>
<div class="section" id="matrixsym">
-<h4><a class="toc-backref" href="#id39">\matrixsym</a></h4>
+<h4><a class="toc-backref" href="#id42">\matrixsym</a></h4>
<p>Symbols for matrices are typeset <em>boldface italic</em>, i. e. in the same face
as vectors.</p>
<pre class="literal-block">
@@ -1115,7 +1165,7 @@ as vectors.</p>
</pre>
</div>
<div class="section" id="tensorsym">
-<h4><a class="toc-backref" href="#id40">\tensorsym</a></h4>
+<h4><a class="toc-backref" href="#id43">\tensorsym</a></h4>
<p>Symbols for tensors are <em>sans-serif bold italic</em>:</p>
<pre class="literal-block">
\newcommand{\tensorsym}{\mathboldsans}
@@ -1123,7 +1173,7 @@ as vectors.</p>
</div>
</div>
<div class="section" id="font-mappings">
-<h3><a class="toc-backref" href="#id41">Font mappings</a></h3>
+<h3><a class="toc-backref" href="#id44">Font mappings</a></h3>
<p>Some font packages provide a matching math font but do not define a
substitution in their <tt class="docutils literal"><span class="pre">*.fd</span></tt> files.</p>
<p>We define the substitutions needed for the math alphabet definitions in this
@@ -1160,7 +1210,15 @@ definitions in the package's <tt class="docutils literal"><span class="pre">*.fd
</div>
</div>
<div class="section" id="references">
-<h1><a class="toc-backref" href="#id42">References</a></h1>
+<h1><a class="toc-backref" href="#id45">References</a></h1>
+<table class="docutils citation" frame="void" id="iso-31" rules="none">
+<colgroup><col class="label" /><col /></colgroup>
+<tbody valign="top">
+<tr><td class="label"><a class="fn-backref" href="#id1">[ISO-31]</a></td><td>International Standard 31 <cite>Quantities and units</cite>,
+(ISO 31-0:1992 to ISO 31-14:1992):
+<a class="reference external" href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_tc_browse.htm?commid=46202">http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_tc_browse.htm?commid=46202</a></td></tr>
+</tbody>
+</table>
<table class="docutils citation" frame="void" id="typefaces" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
@@ -1197,6 +1255,13 @@ scientific text</cite>, (Revised December 1999):
<a class="reference external" href="http://dante.ctan.org/CTAN/macros/latex/doc/fntguide.pdf">http://dante.ctan.org/CTAN/macros/latex/doc/fntguide.pdf</a></td></tr>
</tbody>
</table>
+<table class="docutils citation" frame="void" id="tr25" rules="none">
+<colgroup><col class="label" /><col /></colgroup>
+<tbody valign="top">
+<tr><td class="label"><a class="fn-backref" href="#id7">[tr25]</a></td><td><cite>Unicode Support for Mathematics</cite>, Unicode Technical Report #25:
+<a class="reference external" href="http://www.unicode.org/reports/tr25/">http://www.unicode.org/reports/tr25/</a></td></tr>
+</tbody>
+</table>
<!-- see also
[koma-mail] Custom font substitution: http://www.komascript.de/node/823
diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.sty.pdf b/Master/texmf-dist/doc/latex/isomath/isomath.sty.pdf
index a7bd54414f2..662fea4dab0 100644
--- a/Master/texmf-dist/doc/latex/isomath/isomath.sty.pdf
+++ b/Master/texmf-dist/doc/latex/isomath/isomath.sty.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt b/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt
index eb407f37486..aa082fdd79c 100644
--- a/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt
+++ b/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt
@@ -23,10 +23,10 @@ Motivation
*sans-serif bold italic* typeface, as recommended by [typefaces]_?
Scientific organisations like IUPAP_, IUPAC_, NIST_, BIPM_, and others
-recommend typesetting math according to International Standard `ISO 31`_
-`Quantities and units` (ISO 31-0:1992 to ISO 31-14:1992).\ [#]_
+recommend typesetting math according to the International Standard ISO 31
+`Quantities and units` [ISO-31]_.\ [#]_
-The traditional `LaTeX-style` deviates in some points from this rules:
+The traditional `LaTeX math style` deviates in some points from this rules:
* The ``\vec`` command produces an array accent, while ISO 31 recommends
a *bold italic* typeface for vector symbols.
@@ -36,28 +36,17 @@ The traditional `LaTeX-style` deviates in some points from this rules:
and the Latin alphabet.
* There is no provision for typesetting of Greek letters in *bold italic*
- style recommended for vectors (even though the required fonts are
- available).
+ style recommended for vectors.
* There is no provision for typesetting letters in *sans-serif bold italic*
recommended for typesetting tensor symbols.
-Also, the Unicode Standard defines the block `mathematical alphanumeric
-symbols`_ — *To be used for mathematical variables where style variations
-are important semantically* — which contains Latin and Greek letters in
-bold, italic, bold italic, sans-serif bold, and sans-serif bold italic
-typeface.\ [#]_
-
-Some of these points are already adressed by `related packages`_, however
+Some of these points are adressed by `related packages`_, however
there is currently no package (known to the author) that defines the
*sans-serif bold italic* math alphabet needed for tensor symbols.
-.. [#] A summary of these rules is free available [typefaces]_. See also
- [fonts-for-symbols]_ and [SI-brochure]_.
-
-.. [#] Plus Number variants and Latin letters in script, bold script,
- fraktur, bold fraktur, double-struck, sans-serif and monospace;
- alltogether 1023 codepoints.
+.. [#] Summaries of these rules are free available, see [typefaces]_,
+ [fonts-for-symbols]_, and [SI-brochure]_.
Features
@@ -66,26 +55,20 @@ Features
The ``isomath.sty`` package facilitates the task to abide with ISO 31 when
typesetting math with LaTeX:
-* It utilises fixmath_ to re-define Greek letters as ``\mathalpha``, taking
- them from the "letters" symbol fonts (as opposed to "operators" in
- ``fontmath.ltx``). This ensures that
+* Equal treatment of Latin and `Greek in math`_ via fixmath.sty_:
+ Greek letters change shape together with Latin letters if a different
math alphabet is used.
+ Uppercase Greek letters are typeset in italic style by default.
- + Upright Greek letters are available through the ``\mathrm`` and
- ``\mathbf`` alphabets, if the corresponding fonts are OML encoded.
-
- Caution: small Greek letters in a math alphabet command can lead to garbage.
- Use the options for `OML math alphabets`_ (if the used font supports the
- `OML font encoding`_) or place Greek letters outside the math alphabet
- command. Some packages (including fixmath_) provide ``\up*`` or
- ``\var*`` macros for upright Greek letters, e.g. ``\mathrm{k}\upOmega``.
+ + Upright Greek letters can be made available through the ``\mathrm``
+ and ``\mathbf`` alphabets, if the corresponding fonts support the
+ `OML font encoding`_.
* The `command aliases`_ ``\vectorsym``, ``\matrixsym``, and ``\tensorsym``
- allow semantic markup selecting an ISO-conforming typeface.
+ allow semantic markup. They print the argument in an ISO-conforming
+ typeface.
* For this, new `math alphabets`_ are defined:
@@ -98,13 +81,18 @@ typesetting math with LaTeX:
``sfdefault=<family>`` options_ can be used to override the defaults.
* Missing `font mappings`_ are defined for font families which have an OML
- encoded counterpart but miss the substitution definition in their ``*.fd``
+ encoded counterpart but no substitution definition in their ``*.fd``
files.
-Examples
-========
+Usage
+=====
+Make sure that LaTeX can find ``isomath.sty`` and insert the command
+``\usepackage{isomath}`` in the document preamble.
+
+Examples
+--------
* In many cases (e.g. when ``\sfdefault`` expands to "cmss"), the
``\mathboldsans`` alphabet is neither bold nor sans, as "cmss" has no OML
@@ -126,13 +114,13 @@ Examples
\usepackage[charter]{mathdesign}
\usepackage[OMLmathbf,sfdefault=cmbr]{isomath}
- Now, ``\mathbf{\pi}`` works as expected.
+ Now, ``\mathbf{\pi}`` produces a bold upright pi symbol.
Related packages
================
-Some packages already define Greek letters as ``\mathalpha`` and provide the
-``\mathbold`` alphabet (in OML):
+A set of packages at CTAN also defines Greek letters as ``\mathalpha`` and
+provide the ``\mathbold`` alphabet (in OML):
* arev_ (Arev/Vera Sans)
* cmbright_ (CM Bright)
@@ -142,11 +130,11 @@ Some packages already define Greek letters as ``\mathalpha`` and provide the
* mathpazo_ (Palatino)
* tmmath_ (TM-Math/Times)
-This package builds on and extends fixmath_ by Walter Schmidt
-(see Requirements_).
+This package requires and extends fixmath.sty_.
-The cmbright_ package provides fonts for ``\mathsans`` and
-``\mathboldsans`` matching with Computer Modern and derivatives.
+The cmbright_ package provides *sans serif* and *sans-serif bold* fonts for
+the ``\mathsans`` and ``\mathboldsans`` alphabets that match with Computer
+Modern and derivatives.
Conflicts
---------
@@ -158,22 +146,47 @@ documentation).
The `kpfonts`_, `pxfonts`_, and `txfonts`_ packages define many additional
math alphabets and can only be combined with ``isomath``, if the
-reuseMathalphabets_ option is used.
+reuseMathAlphabets_ option is used.
+
+Greek in Math
+=============
+
+Unicode Math Support
+--------------------
+
+The technical report `Unicode Support for Mathematics` [tr25]_ lists
+*alphanumeric symbols encountered in mathematics* in Table 2.1 `Mathematical
+Alphabets`. It includes Latin and Greek letters in the bold, italic, bold
+italic, sans-serif bold, and sans-serif bold italic math styles.
+
+The Unicode block `mathematical alphanumeric symbols`_ provides style
+variants for Latin and Greek letters and digits. It is "to be used for
+mathematical variables where style variations are important semantically".
+
OML font encoding
-=================
+-----------------
-The `LaTeX font encodings` guide [encguide]_ defines:
+The OML font encoding is the only established encoding providing
+Latin and Greek letters in one font:
+
+* LGR is Greek-only,
+* T7 is just a "reserved name" for a standard Greek encoding.
+
+Definition
+""""""""""
+
+The `LaTeX font encodings` guide [encguide]_ names OML `TeX math italic` and
+defines:
The OML encoding contains italic Latin and Greek letters for use in
mathematical formulas (typically used for variables) together with some
symbols.
-and names it `TeX math italic`. However, the reference to *italic* seems to
-be a description of the *state of the art* rather than a necessary
-restriction:
+However, the reference to **italic** seems to be a description of the *state
+of the art* rather than a necessary restriction:
-* The only OML encoded CM font is "Computer Modern Math Italic" (cmmi),
+* The only OML encoded CM font is `Computer Modern Math Italic` (cmmi),
* but generally, font encodings (T1, OT1) are not specific to the font shape.
@@ -184,11 +197,8 @@ restriction:
* A more suitable public name would be `TeX math letters` or `Original/Old
Math Letters`. The latter would also explain the acronym OML.
-The OML font encoding is the only established encoding providing
-Latin and Greek letters in one font:
-
-* LGR is Greek-only,
-* T7 is just a "reserved name" for a standard Greek encoding.
+Support
+"""""""
Unfortunately, support for the OML encoding is missing for many font
families even if the base font contains all Greek letters.
@@ -283,17 +293,16 @@ substitution can be set with the rmdefault_ option.
============= ===============================
Conclusions and outlook
-=======================
+-----------------------
It is hoped, that in the future more fonts families will support the OML
-encoding in normal and bold weight as well as upright and italic shape.
-This would be a major step towards the full support of the `Mathematical
+encoding in normal and bold weight as well as upright and italic shape.
+This would be a major step towards a LaTeX equivalent of the `Mathematical
Alphanumeric Symbols`_ Unicode block.
-This is (relatively) easy to achieve via virtual fonts when the glyphs for
-the Greek letters already exist (this is the case for many fonts where the
-primary version is Unicode encoded). Examples are Latin Modern, Kerkis,
-GFS-Neohellenic, LX-Fonts and KP-Serif.
+This should be (relatively) easy to achieve via virtual fonts when the
+glyphs for the Greek letters already exist. Examples are Latin Modern,
+Kerkis, GFS-Neohellenic, LX-Fonts and KP-Serif.
Alternatively, T7 could be used for math alphabets (if it ever happens to
materialise).
@@ -311,25 +320,52 @@ Identification
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{isomath}
- [2008/06/23 v0.1 typeset math according to International Standard ISO 31]
+ [2008/10/02 v0.2 typeset math according to International Standard ISO 31]
+
+.. class:: borderless
+
+===== ========== ========================================================
+0.1 2008-09-25 first public version.
+0.2 2008-10-02 bugfix: a usage example was uncommented;
+ updated documentation;
+ define \mathsans only if OMLmathsans is true;
+ option reuseMathalphabets -> reuseMathAlphabets.
+===== ========== ========================================================
+
Requirements
============
-fixmath
--------
+fixmath.sty
+-----------
+
+The package fixmath_ by Walter Schmidt defines Greek letters as symbols
+of type ``\mathalpha`` and takes them from the "letters" SymbolFont in
+``\mathnormal`` (as opposed to "operators" in ``fontmath.ltx``).
-fixmath_ by Walter Schmidt defines Greek letters as symbols of type
-``\mathalpha`` and takes them from the "letters" SymbolFont in
-``\mathnormal``. (It also defines the ``\mathbold`` alphabet, setting it to
-``cmm``. This definition will be overwritten with a configurable value for
+fixmath_ also defines the ``\mathbold`` alphabet, setting it to ``cmm``.
+However, this definition will be overwritten with a configurable value for
the font family below.)
+
::
\RequirePackage{fixmath}
-kvoptions
----------
+.. caution::
+
+ Placing small Greek letters in a math alphabet, e.g.
+ ``\mathrm{k\Omega}``, can lead to garbage.
+
+ If the chosen font supports the `OML font encoding`_, you can use the
+ options for `OML math alphabets`_. Otherwise, place Greek letters
+ outside the math alphabet command.
+
+ Some packages provide ``\up*`` or ``\var*`` macros for upright Greek
+ letters, e.g. ``\mathrm{k}\upOmega``.
+
+
+kvoptions.sty
+-------------
The kvoptions_ package in the oberdiek_ bundle facilitates the setup of
package options and provides a key=value interface (based on keyval_)::
@@ -377,7 +413,7 @@ TODO
Allow scaling?
-reuseMathalphabets
+reuseMathAlphabets
------------------
The definition of new `math alphabets`_ can lead to a "too many math
@@ -387,29 +423,37 @@ As a workaround, this option tells ``isomath`` to re-use the existing
``\mathbf`` and ``\mathsf`` alphabets for italic bold and sans-serif bold.
To access the upright shapes, the corresponding ``\textbf`` and ``\textsf``
-commands might be used (however, that this toggles the math-mode off and
+commands might be used (however, this toggles the math-mode off and
might use a different font).
::
- \DeclareBoolOption{reuseMathalphabets}
+ \DeclareBoolOption{reuseMathAlphabets}
-Caution: Do not use ``reuseMathalphabets`` together with ``OMLmathbf`` or
-``OMLmathsf``.
+.. caution::
+ Do not use ``reuseMathAlphabets`` together with the ``OMLmathbf`` or
+ ``OMLmathsf`` options.
OML math alphabets
------------------
-The following options cause isomath to (re)define `math alphabets`_ in OML
-encoding.
-
With Greek letters defined as ``\mathalpha``, the math alphabets are
-expected to be in `OML font encoding`_ as OT1 encoded fonts have ligatures
-and non-alpha symbols in place of the small Greek letters.
+expected to be in `OML font encoding`_. Unfortunately, the standard math
+alphabets are usually taken from OT1 encoded fonts that have ligatures and
+non-alpha symbols in place of the small Greek letters.
+
+The following options cause isomath to (re)define `math alphabets`_ in OML
+encoding::
+ \DeclareBoolOption{OMLmathrm}
+ \DeclareBoolOption{OMLmathbf}
+ \DeclareBoolOption{OMLmathsf}
+ \DeclareBoolOption{OMLmathsans}
+ \DeclareBoolOption{OMLmathtt}
+
Setting these options enables access to small Greek letters in different
-shapes with e.g. ``\mathrm{\pi}`` **if an OML encoded font is available**.
+shapes with e.g. ``\mathrm{\pi}`` — *if an OML encoded font is available*.
Currently, support for the `OML font encoding`_ is rather limited:
* only the mathdesign_ fonts support *bold roman* in OML encoding, while
@@ -418,13 +462,6 @@ Currently, support for the `OML font encoding`_ is rather limited:
With some packages, these options can result in a "too many math alphabets
used in version normal" error.
-::
-
- \DeclareBoolOption{OMLmathrm}
- \DeclareBoolOption{OMLmathbf}
- \DeclareBoolOption{OMLmathsf}
- \DeclareBoolOption{OMLmathsans}
- \DeclareBoolOption{OMLmathtt}
---------------------------------------------------
@@ -439,22 +476,25 @@ Math alphabets
--------------
In math, LaTeX uses "absolute" fontnames instead of a selection by family,
-shape, and weight (see the [fntguide]_ for the rationale).
+shape, and weight because typefaces have a semantic meaning [fntguide]_.
+This correlates with the `Unicode math support`_ where the
+`mathematical alphanumeric symbols`_ block defines distinct Unicode
+characters for in Greek and Latin letters in different typefaces.
-We define a math alphabet for every required font variant and optionally
-re-define the standard math alphabets in `OML font encoding`_.
+Isomath defines a math alphabet for every required font variant and
+optionally re-defines the standard math alphabets in `OML font encoding`_.
Unfortunately, the number of math alphabets in one math version is limited
to 16, so we have to be carefull not to exceed this.
mathbold
""""""""
-For the *`italic bold* math alphabet we use the name ``\mathbold``
-established in `related packages`_. With the reuseMathalphabets_ option,
-``\mathfb`` is redefined and ``\mathbold`` made an alias (overwriting
-existing definitions). ::
+The *italic bold* math alphabet is named ``\mathbold`` like in
+`related packages`_. With the reuseMathAlphabets_ option, ``\mathfb``
+is redefined and ``\mathbold`` made an alias (overwriting existing
+definitions)::
- \ifisomath@reuseMathalphabets
+ \ifisomath@reuseMathAlphabets
\DeclareMathAlphabet{\mathbf}{OML}{\isomath@rmdefault}{bx}{it}
\def\mathbold{\mathbf}
\else
@@ -476,10 +516,10 @@ mathboldsans
""""""""""""
A *sans serif slanted bold* alphabet is needed for tensor symbols. With the
-reuseMathalphabets_ option, ``\mathsf`` is redefined and ``\mathboldsans``
+reuseMathAlphabets_ option, ``\mathsf`` is redefined and ``\mathboldsans``
made an alias::
- \ifisomath@reuseMathalphabets
+ \ifisomath@reuseMathAlphabets
\DeclareMathAlphabet{\mathsf}{OML}{\isomath@sfdefault}{bx}{it}
\def\mathboldsans{\mathsf}
\else
@@ -490,7 +530,7 @@ Redefine standard alphabets
"""""""""""""""""""""""""""
Redefine standard alphabets in `OML font encoding`_
-(if the corresponding `OML math alphabets`_ option is true). ::
+if the corresponding `OML math alphabets`_ option is true::
\ifisomath@OMLmathrm
\SetMathAlphabet{\mathrm}{normal}{OML}{\isomath@rmdefault}{n}{n}
@@ -509,7 +549,7 @@ Command aliases
---------------
The following macros allow semantic markup of mathematical symbols.
-The symbols argument is typeset as proposed by ISO 31 and [typefaces]_.
+The argument is typeset as proposed by ISO 31 and [typefaces]_.
\\vectorsym
"""""""""""
@@ -580,6 +620,10 @@ No declarations below this point::
References
**********
+.. [ISO-31] International Standard 31 `Quantities and units`,
+ (ISO 31-0:1992 to ISO 31-14:1992):
+ http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_tc_browse.htm?commid=46202
+
.. [typefaces] `Typefaces for Symbols in Scientific Manuscripts`:
http://physics.nist.gov/Document/typefaces.pdf
@@ -596,6 +640,9 @@ References
.. [fntguide] `LaTeX 2e font selection`:
http://dante.ctan.org/CTAN/macros/latex/doc/fntguide.pdf
+.. [tr25] `Unicode Support for Mathematics`, Unicode Technical Report #25:
+ http://www.unicode.org/reports/tr25/
+
.. see also
[koma-mail] Custom font substitution: http://www.komascript.de/node/823
@@ -610,8 +657,6 @@ References
.. _IUPAC: http://iupac.org/
.. _IUPAP: http://www.iupap.org/
.. _NIST: http://physics.nist.gov/
-.. _ISO 31:
- http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_tc_browse.htm?commid=46202
.. _mathematical alphanumeric symbols:
http://www.unicode.org/charts/PDF/U1D400.pdf
.. _arev: http://dante.ctan.org/CTAN/help/Catalogue/entries/arev.html
diff --git a/Master/texmf-dist/tex/latex/isomath/isomath.sty b/Master/texmf-dist/tex/latex/isomath/isomath.sty
index 7dc97ec2e45..89353a74869 100644
--- a/Master/texmf-dist/tex/latex/isomath/isomath.sty
+++ b/Master/texmf-dist/tex/latex/isomath/isomath.sty
@@ -23,10 +23,10 @@
% *sans-serif bold italic* typeface, as recommended by [typefaces]_?
%
% Scientific organisations like IUPAP_, IUPAC_, NIST_, BIPM_, and others
-% recommend typesetting math according to International Standard `ISO 31`_
-% `Quantities and units` (ISO 31-0:1992 to ISO 31-14:1992).\ [#]_
+% recommend typesetting math according to the International Standard ISO 31
+% `Quantities and units` [ISO-31]_.\ [#]_
%
-% The traditional `LaTeX-style` deviates in some points from this rules:
+% The traditional `LaTeX math style` deviates in some points from this rules:
%
% * The ``\vec`` command produces an array accent, while ISO 31 recommends
% a *bold italic* typeface for vector symbols.
@@ -36,28 +36,17 @@
% and the Latin alphabet.
%
% * There is no provision for typesetting of Greek letters in *bold italic*
-% style recommended for vectors (even though the required fonts are
-% available).
+% style recommended for vectors.
%
% * There is no provision for typesetting letters in *sans-serif bold italic*
% recommended for typesetting tensor symbols.
%
-% Also, the Unicode Standard defines the block `mathematical alphanumeric
-% symbols`_ — *To be used for mathematical variables where style variations
-% are important semantically* — which contains Latin and Greek letters in
-% bold, italic, bold italic, sans-serif bold, and sans-serif bold italic
-% typeface.\ [#]_
-%
-% Some of these points are already adressed by `related packages`_, however
+% Some of these points are adressed by `related packages`_, however
% there is currently no package (known to the author) that defines the
% *sans-serif bold italic* math alphabet needed for tensor symbols.
%
-% .. [#] A summary of these rules is free available [typefaces]_. See also
-% [fonts-for-symbols]_ and [SI-brochure]_.
-%
-% .. [#] Plus Number variants and Latin letters in script, bold script,
-% fraktur, bold fraktur, double-struck, sans-serif and monospace;
-% alltogether 1023 codepoints.
+% .. [#] Summaries of these rules are free available, see [typefaces]_,
+% [fonts-for-symbols]_, and [SI-brochure]_.
%
%
% Features
@@ -66,26 +55,20 @@
% The ``isomath.sty`` package facilitates the task to abide with ISO 31 when
% typesetting math with LaTeX:
%
-% * It utilises fixmath_ to re-define Greek letters as ``\mathalpha``, taking
-% them from the "letters" symbol fonts (as opposed to "operators" in
-% ``fontmath.ltx``). This ensures that
+% * Equal treatment of Latin and `Greek in math`_ via fixmath.sty_:
%
% + Greek letters change shape together with Latin letters if a different
% math alphabet is used.
%
% + Uppercase Greek letters are typeset in italic style by default.
%
-% + Upright Greek letters are available through the ``\mathrm`` and
-% ``\mathbf`` alphabets, if the corresponding fonts are OML encoded.
-%
-% Caution: small Greek letters in a math alphabet command can lead to garbage.
-% Use the options for `OML math alphabets`_ (if the used font supports the
-% `OML font encoding`_) or place Greek letters outside the math alphabet
-% command. Some packages (including fixmath_) provide ``\up*`` or
-% ``\var*`` macros for upright Greek letters, e.g. ``\mathrm{k}\upOmega``.
+% + Upright Greek letters can be made available through the ``\mathrm``
+% and ``\mathbf`` alphabets, if the corresponding fonts support the
+% `OML font encoding`_.
%
% * The `command aliases`_ ``\vectorsym``, ``\matrixsym``, and ``\tensorsym``
-% allow semantic markup selecting an ISO-conforming typeface.
+% allow semantic markup. They print the argument in an ISO-conforming
+% typeface.
%
% * For this, new `math alphabets`_ are defined:
%
@@ -98,13 +81,18 @@
% ``sfdefault=<family>`` options_ can be used to override the defaults.
%
% * Missing `font mappings`_ are defined for font families which have an OML
-% encoded counterpart but miss the substitution definition in their ``*.fd``
+% encoded counterpart but no substitution definition in their ``*.fd``
% files.
%
%
-% Examples
-% ========
+% Usage
+% =====
%
+% Make sure that LaTeX can find ``isomath.sty`` and insert the command
+% ``\usepackage{isomath}`` in the document preamble.
+%
+% Examples
+% --------
%
% * In many cases (e.g. when ``\sfdefault`` expands to "cmss"), the
% ``\mathboldsans`` alphabet is neither bold nor sans, as "cmss" has no OML
@@ -126,13 +114,13 @@
% \usepackage[charter]{mathdesign}
% \usepackage[OMLmathbf,sfdefault=cmbr]{isomath}
%
-% Now, ``\mathbf{\pi}`` works as expected.
+% Now, ``\mathbf{\pi}`` produces a bold upright pi symbol.
%
% Related packages
% ================
%
-% Some packages already define Greek letters as ``\mathalpha`` and provide the
-% ``\mathbold`` alphabet (in OML):
+% A set of packages at CTAN also defines Greek letters as ``\mathalpha`` and
+% provide the ``\mathbold`` alphabet (in OML):
%
% * arev_ (Arev/Vera Sans)
% * cmbright_ (CM Bright)
@@ -142,11 +130,11 @@
% * mathpazo_ (Palatino)
% * tmmath_ (TM-Math/Times)
%
-% This package builds on and extends fixmath_ by Walter Schmidt
-% (see Requirements_).
+% This package requires and extends fixmath.sty_.
%
-% The cmbright_ package provides fonts for ``\mathsans`` and
-% ``\mathboldsans`` matching with Computer Modern and derivatives.
+% The cmbright_ package provides *sans serif* and *sans-serif bold* fonts for
+% the ``\mathsans`` and ``\mathboldsans`` alphabets that match with Computer
+% Modern and derivatives.
%
% Conflicts
% ---------
@@ -158,22 +146,47 @@
%
% The `kpfonts`_, `pxfonts`_, and `txfonts`_ packages define many additional
% math alphabets and can only be combined with ``isomath``, if the
-% reuseMathalphabets_ option is used.
+% reuseMathAlphabets_ option is used.
+%
+% Greek in Math
+% =============
+%
+% Unicode Math Support
+% --------------------
+%
+% The technical report `Unicode Support for Mathematics` [tr25]_ lists
+% *alphanumeric symbols encountered in mathematics* in Table 2.1 `Mathematical
+% Alphabets`. It includes Latin and Greek letters in the bold, italic, bold
+% italic, sans-serif bold, and sans-serif bold italic math styles.
+%
+% The Unicode block `mathematical alphanumeric symbols`_ provides style
+% variants for Latin and Greek letters and digits. It is "to be used for
+% mathematical variables where style variations are important semantically".
+%
%
% OML font encoding
-% =================
+% -----------------
+%
+% The OML font encoding is the only established encoding providing
+% Latin and Greek letters in one font:
+%
+% * LGR is Greek-only,
+% * T7 is just a "reserved name" for a standard Greek encoding.
%
-% The `LaTeX font encodings` guide [encguide]_ defines:
+% Definition
+% """"""""""
+%
+% The `LaTeX font encodings` guide [encguide]_ names OML `TeX math italic` and
+% defines:
%
% The OML encoding contains italic Latin and Greek letters for use in
% mathematical formulas (typically used for variables) together with some
% symbols.
%
-% and names it `TeX math italic`. However, the reference to *italic* seems to
-% be a description of the *state of the art* rather than a necessary
-% restriction:
+% However, the reference to **italic** seems to be a description of the *state
+% of the art* rather than a necessary restriction:
%
-% * The only OML encoded CM font is "Computer Modern Math Italic" (cmmi),
+% * The only OML encoded CM font is `Computer Modern Math Italic` (cmmi),
%
% * but generally, font encodings (T1, OT1) are not specific to the font shape.
%
@@ -184,11 +197,8 @@
% * A more suitable public name would be `TeX math letters` or `Original/Old
% Math Letters`. The latter would also explain the acronym OML.
%
-% The OML font encoding is the only established encoding providing
-% Latin and Greek letters in one font:
-%
-% * LGR is Greek-only,
-% * T7 is just a "reserved name" for a standard Greek encoding.
+% Support
+% """""""
%
% Unfortunately, support for the OML encoding is missing for many font
% families even if the base font contains all Greek letters.
@@ -283,17 +293,16 @@
% ============= ===============================
%
% Conclusions and outlook
-% =======================
+% -----------------------
%
% It is hoped, that in the future more fonts families will support the OML
-% encoding in normal and bold weight as well as upright and italic shape.
-% This would be a major step towards the full support of the `Mathematical
+% encoding in normal and bold weight as well as upright and italic shape.
+% This would be a major step towards a LaTeX equivalent of the `Mathematical
% Alphanumeric Symbols`_ Unicode block.
%
-% This is (relatively) easy to achieve via virtual fonts when the glyphs for
-% the Greek letters already exist (this is the case for many fonts where the
-% primary version is Unicode encoded). Examples are Latin Modern, Kerkis,
-% GFS-Neohellenic, LX-Fonts and KP-Serif.
+% This should be (relatively) easy to achieve via virtual fonts when the
+% glyphs for the Greek letters already exist. Examples are Latin Modern,
+% Kerkis, GFS-Neohellenic, LX-Fonts and KP-Serif.
%
% Alternatively, T7 could be used for math alphabets (if it ever happens to
% materialise).
@@ -311,25 +320,52 @@
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{isomath}
-[2008/06/23 v0.1 typeset math according to International Standard ISO 31]
+[2008/10/02 v0.2 typeset math according to International Standard ISO 31]
+% .. class:: borderless
+%
+% ===== ========== ========================================================
+% 0.1 2008-09-25 first public version.
+% 0.2 2008-10-02 bugfix: a usage example was uncommented;
+% updated documentation;
+% define \mathsans only if OMLmathsans is true;
+% option reuseMathalphabets -> reuseMathAlphabets.
+% ===== ========== ========================================================
+%
+%
% Requirements
% ============
%
-% fixmath
-% -------
+% fixmath.sty
+% -----------
%
-% fixmath_ by Walter Schmidt defines Greek letters as symbols of type
-% ``\mathalpha`` and takes them from the "letters" SymbolFont in
-% ``\mathnormal``. (It also defines the ``\mathbold`` alphabet, setting it to
-% ``cmm``. This definition will be overwritten with a configurable value for
+% The package fixmath_ by Walter Schmidt defines Greek letters as symbols
+% of type ``\mathalpha`` and takes them from the "letters" SymbolFont in
+% ``\mathnormal`` (as opposed to "operators" in ``fontmath.ltx``).
+%
+% fixmath_ also defines the ``\mathbold`` alphabet, setting it to ``cmm``.
+% However, this definition will be overwritten with a configurable value for
% the font family below.)
+%
% ::
\RequirePackage{fixmath}
-% kvoptions
-% ---------
+% .. caution::
+%
+% Placing small Greek letters in a math alphabet, e.g.
+% ``\mathrm{k\Omega}``, can lead to garbage.
+%
+% If the chosen font supports the `OML font encoding`_, you can use the
+% options for `OML math alphabets`_. Otherwise, place Greek letters
+% outside the math alphabet command.
+%
+% Some packages provide ``\up*`` or ``\var*`` macros for upright Greek
+% letters, e.g. ``\mathrm{k}\upOmega``.
+%
+%
+% kvoptions.sty
+% -------------
%
% The kvoptions_ package in the oberdiek_ bundle facilitates the setup of
% package options and provides a key=value interface (based on keyval_)::
@@ -377,7 +413,7 @@
% Allow scaling?
%
%
-% reuseMathalphabets
+% reuseMathAlphabets
% ------------------
%
% The definition of new `math alphabets`_ can lead to a "too many math
@@ -387,29 +423,37 @@
% ``\mathbf`` and ``\mathsf`` alphabets for italic bold and sans-serif bold.
%
% To access the upright shapes, the corresponding ``\textbf`` and ``\textsf``
-% commands might be used (however, that this toggles the math-mode off and
+% commands might be used (however, this toggles the math-mode off and
% might use a different font).
%
% ::
-\DeclareBoolOption{reuseMathalphabets}
+\DeclareBoolOption{reuseMathAlphabets}
-% Caution: Do not use ``reuseMathalphabets`` together with ``OMLmathbf`` or
-% ``OMLmathsf``.
+% .. caution::
+% Do not use ``reuseMathAlphabets`` together with the ``OMLmathbf`` or
+% ``OMLmathsf`` options.
%
%
% OML math alphabets
% ------------------
%
-% The following options cause isomath to (re)define `math alphabets`_ in OML
-% encoding.
-%
% With Greek letters defined as ``\mathalpha``, the math alphabets are
-% expected to be in `OML font encoding`_ as OT1 encoded fonts have ligatures
-% and non-alpha symbols in place of the small Greek letters.
+% expected to be in `OML font encoding`_. Unfortunately, the standard math
+% alphabets are usually taken from OT1 encoded fonts that have ligatures and
+% non-alpha symbols in place of the small Greek letters.
%
+% The following options cause isomath to (re)define `math alphabets`_ in OML
+% encoding::
+
+\DeclareBoolOption{OMLmathrm}
+\DeclareBoolOption{OMLmathbf}
+\DeclareBoolOption{OMLmathsf}
+\DeclareBoolOption{OMLmathsans}
+\DeclareBoolOption{OMLmathtt}
+
% Setting these options enables access to small Greek letters in different
-% shapes with e.g. ``\mathrm{\pi}`` **if an OML encoded font is available**.
+% shapes with e.g. ``\mathrm{\pi}`` — *if an OML encoded font is available*.
% Currently, support for the `OML font encoding`_ is rather limited:
%
% * only the mathdesign_ fonts support *bold roman* in OML encoding, while
@@ -418,14 +462,7 @@
%
% With some packages, these options can result in a "too many math alphabets
% used in version normal" error.
-% ::
-
-\DeclareBoolOption{OMLmathrm}
-\DeclareBoolOption{OMLmathbf}
-\DeclareBoolOption{OMLmathsf}
-\DeclareBoolOption{OMLmathsans}
-\DeclareBoolOption{OMLmathtt}
-
+%
% ---------------------------------------------------
%
% Process the options with ``kvoptions`` extensions::
@@ -439,22 +476,25 @@
% --------------
%
% In math, LaTeX uses "absolute" fontnames instead of a selection by family,
-% shape, and weight (see the [fntguide]_ for the rationale).
+% shape, and weight because typefaces have a semantic meaning [fntguide]_.
+% This correlates with the `Unicode math support`_ where the
+% `mathematical alphanumeric symbols`_ block defines distinct Unicode
+% characters for in Greek and Latin letters in different typefaces.
%
-% We define a math alphabet for every required font variant and optionally
-% re-define the standard math alphabets in `OML font encoding`_.
+% Isomath defines a math alphabet for every required font variant and
+% optionally re-defines the standard math alphabets in `OML font encoding`_.
% Unfortunately, the number of math alphabets in one math version is limited
% to 16, so we have to be carefull not to exceed this.
%
% mathbold
% """"""""
%
-% For the *`italic bold* math alphabet we use the name ``\mathbold``
-% established in `related packages`_. With the reuseMathalphabets_ option,
-% ``\mathfb`` is redefined and ``\mathbold`` made an alias (overwriting
-% existing definitions). ::
+% The *italic bold* math alphabet is named ``\mathbold`` like in
+% `related packages`_. With the reuseMathAlphabets_ option, ``\mathfb``
+% is redefined and ``\mathbold`` made an alias (overwriting existing
+% definitions)::
-\ifisomath@reuseMathalphabets
+\ifisomath@reuseMathAlphabets
\DeclareMathAlphabet{\mathbf}{OML}{\isomath@rmdefault}{bx}{it}
\def\mathbold{\mathbf}
\else
@@ -476,10 +516,10 @@
% """"""""""""
%
% A *sans serif slanted bold* alphabet is needed for tensor symbols. With the
-% reuseMathalphabets_ option, ``\mathsf`` is redefined and ``\mathboldsans``
+% reuseMathAlphabets_ option, ``\mathsf`` is redefined and ``\mathboldsans``
% made an alias::
-\ifisomath@reuseMathalphabets
+\ifisomath@reuseMathAlphabets
\DeclareMathAlphabet{\mathsf}{OML}{\isomath@sfdefault}{bx}{it}
\def\mathboldsans{\mathsf}
\else
@@ -490,7 +530,7 @@
% """""""""""""""""""""""""""
%
% Redefine standard alphabets in `OML font encoding`_
-% (if the corresponding `OML math alphabets`_ option is true). ::
+% if the corresponding `OML math alphabets`_ option is true::
\ifisomath@OMLmathrm
\SetMathAlphabet{\mathrm}{normal}{OML}{\isomath@rmdefault}{n}{n}
@@ -509,7 +549,7 @@
% ---------------
%
% The following macros allow semantic markup of mathematical symbols.
-% The symbols argument is typeset as proposed by ISO 31 and [typefaces]_.
+% The argument is typeset as proposed by ISO 31 and [typefaces]_.
%
% \\vectorsym
% """""""""""
@@ -580,6 +620,10 @@
% References
% **********
%
+% .. [ISO-31] International Standard 31 `Quantities and units`,
+% (ISO 31-0:1992 to ISO 31-14:1992):
+% http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_tc_browse.htm?commid=46202
+%
% .. [typefaces] `Typefaces for Symbols in Scientific Manuscripts`:
% http://physics.nist.gov/Document/typefaces.pdf
%
@@ -596,6 +640,9 @@
% .. [fntguide] `LaTeX 2e font selection`:
% http://dante.ctan.org/CTAN/macros/latex/doc/fntguide.pdf
%
+% .. [tr25] `Unicode Support for Mathematics`, Unicode Technical Report #25:
+% http://www.unicode.org/reports/tr25/
+%
% .. see also
% [koma-mail] Custom font substitution: http://www.komascript.de/node/823
%
@@ -610,8 +657,6 @@
% .. _IUPAC: http://iupac.org/
% .. _IUPAP: http://www.iupap.org/
% .. _NIST: http://physics.nist.gov/
-% .. _ISO 31:
-% http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_tc_browse.htm?commid=46202
% .. _mathematical alphanumeric symbols:
% http://www.unicode.org/charts/PDF/U1D400.pdf
% .. _arev: http://dante.ctan.org/CTAN/help/Catalogue/entries/arev.html
diff --git a/Master/tlpkg/bin/ctan2tds b/Master/tlpkg/bin/ctan2tds
index 61bac01019c..b36ed2c7e13 100755
--- a/Master/tlpkg/bin/ctan2tds
+++ b/Master/tlpkg/bin/ctan2tds
@@ -291,7 +291,6 @@ chdir $startdir || die "chdir($startdir) failed: $!"; # back to raw
'mxedruli', "&MAKEflatten",
'nbaskerv', "die 'skipping, requires nonfree font'",
'ncctools', "&MAKEflatten",
- 'newalg', "die 'skipping, nonfree license'",
'newsletr', "&MAKEnewsletr",
'newthm', "die 'skipping, obsolete, no longer on ctan'",
'niceframe', "die 'skipping, nosell license'",