summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/isomath
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-10-02 00:05:56 +0000
committerKarl Berry <karl@freefriends.org>2008-10-02 00:05:56 +0000
commit99a672a8703b248c022f3413c848e5506258a704 (patch)
treeb264a25bb0aa08f65015223a18c11ef3df69b9ff /Master/texmf-dist/doc/latex/isomath
parentffb53120e797221d41a46658ddbddfbac6cf3f9d (diff)
isomath update (1oct08)
git-svn-id: svn://tug.org/texlive/trunk@10818 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/isomath')
-rw-r--r--Master/texmf-dist/doc/latex/isomath/README78
-rw-r--r--Master/texmf-dist/doc/latex/isomath/README.html382
-rw-r--r--Master/texmf-dist/doc/latex/isomath/README.txt83
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath-test.pdfbin262731 -> 137429 bytes
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath-test.tex215
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath.sty.html426
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath.sty.pdfbin0 -> 192005 bytes
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath.sty.txt636
8 files changed, 1454 insertions, 366 deletions
diff --git a/Master/texmf-dist/doc/latex/isomath/README b/Master/texmf-dist/doc/latex/isomath/README
deleted file mode 100644
index 06c65512985..00000000000
--- a/Master/texmf-dist/doc/latex/isomath/README
+++ /dev/null
@@ -1,78 +0,0 @@
-isomath.sty: Math layout for scientists
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Copyright © 2008 Günter Milde <milde@users.berlios.de>
-Released under the terms of the GNU General Public License
-(v. 2 or later)
-
-Abstract
-========
-
-The isomath package enables formatting Greek and Latin letters as symbols
-for vectors, matrices, and tensors in the typefaces recommended for
-scientific papers by the International Standard ISO 31.
-
-
-Features
-========
-
-* Re-define Greek letters as \mathalpha, taking them from the "letters"
- symbol fonts.
-
-* The macros \vectorsym, \matrixsym, and \tensorsym select an
- ISO-conforming typeface.
-
-* For this, new math alphabets are defined:
-
- \mathbold: for *boldface italic* (vector and matrix symbols),
- \mathsans: for *sans-serif italic* ,
- \mathboldsans: for *sans-serif bold italic* (tensor symbols).
-
-
-Requirements
-============
-
-This package builds on and extends fixmath.sty by Walter Schmidt.
-It also requires ifthen.sty and kvoptions.sty.
-
-The cmbright package is recommended for \mathsans and \mathboldsans
-matching with Computer Modern and derivatives.
-
-
-Installation
-============
-
-Copy isomath.sty to a suitable place in your TDS and make sure LaTeX can
-find it.
-
-Optionally, copy the documentation to a place where texdoc can find it.
-
-Usage
-=====
-
-* \usepackage{isomath}
-
- In many cases (when \sfdefault expands to "cmss"), the \mathboldsans
- alphabet is neither bold nor sans, as "cmss" has no OML encoded
- variants and maps to "cmmi".
-
-* Use cmbright for the sans-serif math alphabets::
-
- \usepackage[sfdefault=cmbr]{isomath}
-
-* Redefine the standard \vec macro to typeset its argument in `bold
- italic`::
-
- \usepackage[sfdefault=cmbr]{isomath}
- \renewcommand{\vec}{\vectorsym}
-
-* The mathdesign package comes with an OML encoded bold roman font but does
- not use it for \mathbf in the default setting. With ::
-
- \usepackage[charter]{mathdesign}
- \usepackage[OMLmathbf,sfdefault=cmbr]{isomath}
-
- \mathbf{\pi} works as expected.
-
-
-2008-09-25
diff --git a/Master/texmf-dist/doc/latex/isomath/README.html b/Master/texmf-dist/doc/latex/isomath/README.html
new file mode 100644
index 00000000000..a965f58f931
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/isomath/README.html
@@ -0,0 +1,382 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<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="copyright" content="© 2008 Günter Milde &lt;milde&#64;users.berlios.de&gt;" />
+<style type="text/css">
+
+/*
+:Author: David Goodger (goodger@python.org)
+:Id: $Id: html4css1.css 5631 2008-08-24 13:01:23Z goodger $
+:Copyright: This stylesheet has been placed in the public domain.
+
+Default cascading style sheet for the HTML output of Docutils.
+
+See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+
+/* used to remove borders from tables and images */
+.borderless, table.borderless td, table.borderless th {
+ border: 0 }
+
+table.borderless td, table.borderless th {
+ /* Override padding for "table.docutils td" with "! important".
+ The right padding separates the table cells. */
+ padding: 0 0.5em 0 0 ! important }
+
+.first {
+ /* Override more specific margin styles with "! important". */
+ margin-top: 0 ! important }
+
+.last, .with-subtitle {
+ margin-bottom: 0 ! important }
+
+.hidden {
+ display: none }
+
+a.toc-backref {
+ text-decoration: none ;
+ color: black }
+
+blockquote.epigraph {
+ margin: 2em 5em ; }
+
+dl.docutils dd {
+ margin-bottom: 0.5em }
+
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+ font-weight: bold }
+*/
+
+div.abstract {
+ margin: 2em 5em }
+
+div.abstract p.topic-title {
+ font-weight: bold ;
+ text-align: center }
+
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+ margin: 2em ;
+ border: medium outset ;
+ padding: 1em }
+
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+ font-weight: bold ;
+ font-family: sans-serif }
+
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title {
+ color: red ;
+ font-weight: bold ;
+ font-family: sans-serif }
+
+/* Uncomment (and remove this text!) to get reduced vertical space in
+ compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+ margin-bottom: 0.5em }
+
+div.compound .compound-last, div.compound .compound-middle {
+ margin-top: 0.5em }
+*/
+
+div.dedication {
+ margin: 2em 5em ;
+ text-align: center ;
+ font-style: italic }
+
+div.dedication p.topic-title {
+ font-weight: bold ;
+ font-style: normal }
+
+div.figure {
+ margin-left: 2em ;
+ margin-right: 2em }
+
+div.footer, div.header {
+ clear: both;
+ font-size: smaller }
+
+div.line-block {
+ display: block ;
+ margin-top: 1em ;
+ margin-bottom: 1em }
+
+div.line-block div.line-block {
+ margin-top: 0 ;
+ margin-bottom: 0 ;
+ margin-left: 1.5em }
+
+div.sidebar {
+ margin: 0 0 0.5em 1em ;
+ border: medium outset ;
+ padding: 1em ;
+ background-color: #ffffee ;
+ width: 40% ;
+ float: right ;
+ clear: right }
+
+div.sidebar p.rubric {
+ font-family: sans-serif ;
+ font-size: medium }
+
+div.system-messages {
+ margin: 5em }
+
+div.system-messages h1 {
+ color: red }
+
+div.system-message {
+ border: medium outset ;
+ padding: 1em }
+
+div.system-message p.system-message-title {
+ color: red ;
+ font-weight: bold }
+
+div.topic {
+ margin: 2em }
+
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+ margin-top: 0.4em }
+
+h1.title {
+ text-align: center }
+
+h2.subtitle {
+ text-align: center }
+
+hr.docutils {
+ width: 75% }
+
+img.align-left {
+ clear: left }
+
+img.align-right {
+ clear: right }
+
+ol.simple, ul.simple {
+ margin-bottom: 1em }
+
+ol.arabic {
+ list-style: decimal }
+
+ol.loweralpha {
+ list-style: lower-alpha }
+
+ol.upperalpha {
+ list-style: upper-alpha }
+
+ol.lowerroman {
+ list-style: lower-roman }
+
+ol.upperroman {
+ list-style: upper-roman }
+
+p.attribution {
+ text-align: right ;
+ margin-left: 50% }
+
+p.caption {
+ font-style: italic }
+
+p.credits {
+ font-style: italic ;
+ font-size: smaller }
+
+p.label {
+ white-space: nowrap }
+
+p.rubric {
+ font-weight: bold ;
+ font-size: larger ;
+ color: maroon ;
+ text-align: center }
+
+p.sidebar-title {
+ font-family: sans-serif ;
+ font-weight: bold ;
+ font-size: larger }
+
+p.sidebar-subtitle {
+ font-family: sans-serif ;
+ font-weight: bold }
+
+p.topic-title {
+ font-weight: bold }
+
+pre.address {
+ margin-bottom: 0 ;
+ margin-top: 0 ;
+ font: inherit }
+
+pre.literal-block, pre.doctest-block {
+ margin-left: 2em ;
+ margin-right: 2em }
+
+span.classifier {
+ font-family: sans-serif ;
+ font-style: oblique }
+
+span.classifier-delimiter {
+ font-family: sans-serif ;
+ font-weight: bold }
+
+span.interpreted {
+ font-family: sans-serif }
+
+span.option {
+ white-space: nowrap }
+
+span.pre {
+ white-space: pre }
+
+span.problematic {
+ color: red }
+
+span.section-subtitle {
+ /* font-size relative to parent (h1..h6 element) */
+ font-size: 80% }
+
+table.citation {
+ border-left: solid 1px gray;
+ margin-left: 1px }
+
+table.docinfo {
+ margin: 2em 4em }
+
+table.docutils {
+ margin-top: 0.5em ;
+ margin-bottom: 0.5em }
+
+table.footnote {
+ border-left: solid 1px black;
+ margin-left: 1px }
+
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+ padding-left: 0.5em ;
+ padding-right: 0.5em ;
+ vertical-align: top }
+
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+ font-weight: bold ;
+ text-align: left ;
+ white-space: nowrap ;
+ padding-left: 0 }
+
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+ font-size: 100% }
+
+ul.auto-toc {
+ list-style-type: none }
+
+</style>
+</head>
+<body>
+<div class="document" id="isomath-math-for-scientists">
+<h1 class="title">isomath: Math for scientists</h1>
+<table class="docinfo" frame="void" rules="none">
+<col class="docinfo-name" />
+<col class="docinfo-content" />
+<tbody valign="top">
+<tr><th class="docinfo-name">Date:</th>
+<td>2008-09-26</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
+(v. 2 or later)</td>
+</tr>
+</tbody>
+</table>
+<div class="abstract topic">
+<p class="topic-title first">Abstract</p>
+<p>The isomath package enables formatting Greek and Latin
+letters as symbols for vectors, matrices, and tensors
+in the typefaces recommended for scientific papers
+by the International Standard ISO 31.
+For this, a <em>bold italic</em> and a <em>sans-serif bold italic</em>
+math alphabet are defined.</p>
+</div>
+<div class="section" id="files">
+<h1>Files</h1>
+<table class="docutils field-list" frame="void" rules="none">
+<col class="field-name" />
+<col class="field-body" />
+<tbody valign="top">
+<tr class="field"><th class="field-name">README.txt:</th><td class="field-body">Requirements, Installation, Usage</td>
+</tr>
+<tr class="field"><th class="field-name">README.html:</th><td class="field-body">browser friendly README</td>
+</tr>
+<tr class="field"><th class="field-name">isomath.sty:</th><td class="field-body">isomath LaTeX package</td>
+</tr>
+<tr class="field"><th class="field-name">isomath.sty.txt:</th><td class="field-body">Documentation (source)</td>
+</tr>
+<tr class="field"><th class="field-name">isomath.sty.html:</th><td class="field-body">Documentation (HTML)</td>
+</tr>
+<tr class="field"><th class="field-name">isomath.sty.pdf:</th><td class="field-body">Documentation (PDF)</td>
+</tr>
+<tr class="field"><th class="field-name">isomath-test.tex:</th><td class="field-body">Test example (source)</td>
+</tr>
+<tr class="field"><th class="field-name">isomath-test.pdf:</th><td class="field-body">Test example (PDF output)</td>
+</tr>
+</tbody>
+</table>
+<p>The bidirectional text &lt;-&gt; code converter <a class="reference external" href="http://pylit.berlios.de">PyLit</a> can convert between
+<tt class="docutils literal"><span class="pre">isomath.sty</span></tt> and <tt class="docutils literal"><span class="pre">isomath.sty.txt</span></tt>.</p>
+<p>The Python <a class="reference external" href="http://docutils.sourceforge.net/rst.html">docutils</a> and pdflatex were used to generate the HTML and PDF
+documentation.</p>
+</div>
+<div class="section" id="requirements">
+<h1>Requirements</h1>
+<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.
+It also requires <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/kvoptions.html">kvoptions</a>.</p>
+<p>The <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/cmbright.html">cmbright</a> package is recommended for <em>sans-serif italic</em> and <em>sans-serif
+bold italic</em> fonts matching with Computer Modern and derivatives.</p>
+<p>All required packages are part of TeXLive and MikTeX.</p>
+</div>
+<div class="section" id="installation">
+<h1>Installation</h1>
+<ul class="simple">
+<li>Unpack isomath.zip (preferabely in a TDS 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>or place it in the current working directory (e.g. for testing).</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="usage-example">
+<h1>Usage Example</h1>
+<p>Use cmbright for the sans-serif math alphabets and redefine the
+<tt class="docutils literal"><span class="pre">\vec</span></tt> macro to typeset its argument in <em>bold italic</em>:</p>
+<pre class="literal-block">
+\usepackage[sfdefault=cmbr]{isomath}
+\renewcommand{\vec}{\vectorsym}
+</pre>
+<p>More examples and usage hints are in the literate source and documentation
+files.</p>
+<!-- References
+========== -->
+<table class="docutils citation" frame="void" id="typefaces" rules="none">
+<colgroup><col class="label" /><col /></colgroup>
+<tbody valign="top">
+<tr><td class="label">[typefaces]</td><td><cite>Typefaces for Symbols in Scientific Manuscripts</cite>:
+<a class="reference external" href="http://physics.nist.gov/Document/typefaces.pdf">http://physics.nist.gov/Document/typefaces.pdf</a></td></tr>
+</tbody>
+</table>
+</div>
+</div>
+</body>
+</html>
diff --git a/Master/texmf-dist/doc/latex/isomath/README.txt b/Master/texmf-dist/doc/latex/isomath/README.txt
new file mode 100644
index 00000000000..0c83147af4f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/isomath/README.txt
@@ -0,0 +1,83 @@
+isomath: Math for scientists
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+:Date: 2008-09-26
+:Copyright: © 2008 Günter Milde <milde@users.berlios.de>
+:Licence: Released under the terms of the GNU General Public License
+ (v. 2 or later)
+:Abstract: The isomath package enables formatting Greek and Latin
+ letters as symbols for vectors, matrices, and tensors
+ in the typefaces recommended for scientific papers
+ by the International Standard ISO 31.
+ For this, a *bold italic* and a *sans-serif bold italic*
+ math alphabet are defined.
+
+Files
+=====
+
+:README.txt: Requirements, Installation, Usage
+:README.html: browser friendly README
+
+:isomath.sty: isomath LaTeX package
+:isomath.sty.txt: Documentation (source)
+:isomath.sty.html: Documentation (HTML)
+:isomath.sty.pdf: Documentation (PDF)
+
+:isomath-test.tex: Test example (source)
+:isomath-test.pdf: Test example (PDF output)
+
+The bidirectional text <-> code converter PyLit_ can convert between
+``isomath.sty`` and ``isomath.sty.txt``.
+
+The Python docutils_ and pdflatex were used to generate the HTML and PDF
+documentation.
+
+
+Requirements
+============
+
+This package builds on and extends fixmath_ by Walter Schmidt.
+It also requires kvoptions_.
+
+The cmbright_ package is recommended for *sans-serif italic* and *sans-serif
+bold italic* fonts matching with Computer Modern and derivatives.
+
+All required packages are part of TeXLive and MikTeX.
+
+Installation
+============
+
+* 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,
+ + or place it in the current working directory (e.g. for testing).
+
+
+Usage Example
+=============
+
+Use cmbright for the sans-serif math alphabets and redefine the
+``\vec`` macro to typeset its argument in *bold italic*::
+
+ \usepackage[sfdefault=cmbr]{isomath}
+ \renewcommand{\vec}{\vectorsym}
+
+More examples and usage hints are in the literate source and documentation
+files.
+
+
+.. References
+ ==========
+
+.. [typefaces] `Typefaces for Symbols in Scientific Manuscripts`:
+ http://physics.nist.gov/Document/typefaces.pdf
+
+.. _pylit: http://pylit.berlios.de
+.. _reStructured Text: http://docutils.sourceforge.net/rst.html
+.. _docutils: http://docutils.sourceforge.net/rst.html
+
+.. _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
diff --git a/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf b/Master/texmf-dist/doc/latex/isomath/isomath-test.pdf
index 5cdbfc2f5d4..02656102374 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 a9b18932979..a4ce766ae2d 100644
--- a/Master/texmf-dist/doc/latex/isomath/isomath-test.tex
+++ b/Master/texmf-dist/doc/latex/isomath/isomath-test.tex
@@ -1,92 +1,147 @@
-%% LyX 1.5.5 created this file. For more info, see http://www.lyx.org/.
-%% Do not edit unless you really know what you are doing.
-\documentclass[a4paper,british]{scrartcl}
+% isomath-test.tex: test and template for isomath.sty
+% ===================================================
+%
+% Copyright © 2008 Günter Milde
+% Released under the terms of the GNU General Public License (v. 2 or later)
+%
+% General settings
+% ----------------
+% ::
+
+\documentclass[a4paper,english]{article}
+\usepackage[LGR,T1]{fontenc}
% \usepackage[T1]{fontenc}
-% \usepackage[latin1]{inputenc}
+% \usepackage[utf8]{inputenc}
\pagestyle{empty}
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% User specified LaTeX commands.
-
-% Load a font package:
-
-% \usepackage{ae}
-% \usepackage{anttor}
-% \usepackage{arev} % normal and sans identic
-% \usepackage{beton} % bitmap fonts
-% \usepackage{concmath}
-% \usepackage{cmbright} % keeps \mathrm and \mathbf as CM (roman)
-\usepackage{fourier}
-% \usepackage[LGR,T1]{fontenc}\usepackage[default]{gfsneohellenic} % no bold
-% \usepackage{hfoldsty} % bitmap fonts
-% \usepackage{iwona} % uses cmss --- cmbr is bad match
-% \usepackage{kpfonts} % too many math alphabets used in version normal
-% \usepackage{kerkis} % no bold math, no sans serif (choose iwona or arev?)
-% \usepackage{lmodern}
-% \usepackage{lucidabr} % commercial, subset free as bitmap
-% \usepackage{lxfonts} % normal and sans identic, no \mathbold
-%% mathdesign: % cmbr too light (bold ok)
-%% % too many math alphabets without keepMathAlphabets
-% \usepackage[charter]{mathdesign} % bitmap?
-% \usepackage[garamond]{mathdesign} % bitmap?
-% \usepackage[utopia]{mathdesign} % bitmap?
-% \usepackage{mbtimes}
-% \usepackage{gfsneohellenic}
-% \usepackage{mathpazo} %
-% \usepackage{pxfonts} % too many math alphabets used in version normal
-% \usepackage{tgpagella}\usepackage{qpxmath} % cmbr too light (bold ok)
-% \usepackage{tgtermes}\usepackage{qtxmath} % cmbr too light (bold ok)
-% \usepackage{txfonts} % too many math alphabets used in version normal
-% \usepackage{zefonts} % CM based
-
-
-% load the isomath package with (or without) options
-% --------------------------------------------------
-
-\newcommand{\options}{}
-% \renewcommand{\options}{omlMathalphabets}
-% \renewcommand{\options}{reuseMathalphabets}
-% \renewcommand{\options}{sfdefault=iwona} % with Iwona sans
-% \renewcommand{\options}{sfdefault=zavm} % with Arew sans (larger than normal)
-% \renewcommand{\options}{sfdefault=llcmm} % with LX sans (doesn't work)
-
-\usepackage[\options]{isomath}
-
-
-% re-define \vec to comply with ISO 31::
-\renewcommand{\vec}{\vectorsym}
-
-\usepackage{babel}
+% Customisation
+% -------------------
+%
+% Font packages: Uncomment the package you want to test
+% (cmss maps to roman for italic and bold-italic OML version) ::
+
+\newcommand*{\fontpackage}{}
+\renewcommand*{\fontpackage}{%
+% ae% \sfdefault is cmss (use cmbr)
+% anttor% \sfdefault is cmss (use iwona)
+% arev% normal and sans identic (also in math)
+% beton% bitmap fonts
+% concmath%
+% cmbright% keeps \mathrm and \mathbf as CM (roman)
+% fourier% incompatible (uses private font encoding)
+% gfsneohellenic% (use option [default]) no bold
+% hfoldsty% bitmap fonts
+% iwona% sets cmss as sans font (use iwona)
+% 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)
+% lucidabr% commercial, subset (no math) free as bitmap
+% lxfonts% normal and sans identic,
+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
+% tgpagella,qpxmath% \sfdefault is cmss (use cmbr?)
+% tgtermes,qtxmath% \sfdefault is cmss (use cmbr?)
+% txfonts% no sans-serif
+% zefonts% use with sfdefault=cmbr
+}
+
+% Options
+% -------
+% ::
+
+% Options for the font package call:
+\newcommand*{\fontpackageoptions}{}
+\renewcommand*{\fontpackageoptions}{%
+% default% {gfsneohellenic}
+% charter% {mathdesign} %
+% garamond% {mathdesign} % no (free) bold, \sfdefault is cmss (use cmbr?)
+utopia% {mathdesign} % \sfdefault is cmss (use cmbr?)
+}
+
+% Options for
+\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)
+}
+
+% Load customisable packages
+% --------------------------
+% ::
+
+\usepackage[\fontpackageoptions]{\fontpackage}
+
+\usepackage[\isomathoptions]{isomath}
+
+% Re-define \vec to comply with ISO 31::
+
+\renewcommand*{\vec}{\vectorsym}
+
+% Fall-back definition for \mathsans::
+\providecommand*{\mathsans}[1]%
+{mathsans\ not\ defined,\ use\ \mathtt{OMLmathsans}\ option}
+
+
+% Now print a test sheet::
+
\begin{document}
\section{Test the isomath Package}
-\makeatletter
+Fontpackage: [\fontpackageoptions]\{\fontpackage\}\\
+Isomath called with options: [\isomathoptions]\\
Default font families:
- serif \texttt{\rmdefault},
- sans-serif \texttt{\sfdefault},
- isomath-serif \texttt{\isomath@rmdefault},
- isomath-sf \texttt{\isomath@sfdefault}.
-\makeatother
+\begin{tabular}[t]{rlrl}
+ serif & \texttt{\rmdefault} & sans-serif & \texttt{\sfdefault} \\
+ isomath-serif & \makeatletter \texttt{\isomath@rmdefault} \makeatother
+ &
+ isomath-sf &\makeatletter \texttt{\isomath@sfdefault} \makeatother
+ \\
+\end{tabular}
+
\subsection{Math alphabets}
-The math alphabets should work with greek letters too (thus access
-to upright greek is possible for both, small and capital letters).
-If there are ligatures (ff, fi, ...) instead of small Greek letters
-in a math alphabet, it uses T1 or OT1 encoding instead of OML. \begin{eqnarray*}
-\mbox{mathnormal} & & a,g,v,w,z,A,B,\Gamma,\Delta,E,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,\alpha,\beta,\nu,\omega\\
-\mbox{mathit} & & \mathit{a,g,v,w,z,A,B,\Gamma,\Delta,E,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,\alpha,\beta,\nu,\omega}\\
-\mbox{mathrm} & & \mathrm{\mathrm{a,g,v,w,z,A,B,\Gamma,\Delta,E,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,\alpha,\beta,\nu,\omega}}\\
-\mbox{mathbf} & & \mathbf{a,g,v,w,z,A,B,\Gamma,\Delta,E,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,\alpha,\beta,\nu,\omega}\\
-\mbox{mathsf} & & \mathsf{a,g,v,w,z,A,B,\Gamma,\Delta,E,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,\alpha,\beta,\nu,\omega}\\
-\mbox{mathtt} & & \mathtt{a,g,v,w,z,A,B,\Gamma,\Delta,E,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,\alpha,\beta,\nu,\omega}
+If there are ligatures (ff, fi, ...) instead of small Greek letters in a
+math alphabet, T1 or OT1 encoding is used instead of OML.
+
+% Define a teststring with Latin and Greek letters
+\newcommand{\teststring}{%
+% capital Latin letters
+A,B,C,
+% capital Greek letters
+\Gamma,\Delta,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,
+% small Greek letters
+\alpha,\beta,\nu,\omega,
+% small Latin letters:
+% compare \nu, \omega, v, and w
+v,w,
+% is there a true italic form of a and g?
+a,g,
+}
+
+\begin{eqnarray*}
+\mbox{mathnormal} & & \teststring \\
+\mbox{mathit} & & \mathit{\teststring}\\
+\mbox{mathrm} & & \mathrm{\teststring}\\
+\mbox{mathbf} & & \mathbf{\teststring}\\
+\mbox{mathsf} & & \mathsf{\teststring}\\
+\mbox{mathtt} & & \mathtt{\teststring}
\end{eqnarray*}
- New alphabets are defined for italic-bold, italic-sans, and italic-sans-bold.
+ New alphabets bold-italic, sans-serif-italic, and sans-serif-bold-italic.
\begin{eqnarray*}
-\mbox{mathbold} & & \mathbold{a,g,v,w,z,A,B,\Gamma,\Delta,E,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,\alpha,\beta,\nu,\omega}\\
-\mbox{mathsans} & & \mathsans{a,g,v,w,z,A,B,\Gamma,\Delta,E,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,\alpha,\beta,\nu,\omega}\\
-\mbox{mathboldsans} & & \mathboldsans{a,g,v,w,z,A,B,\Gamma,\Delta,E,\Theta,\Lambda,\Xi,\Pi,\Sigma,\Upsilon,\Phi,\Psi,\Omega,\alpha,\beta,\nu,\omega}
+\mbox{mathbold} & & \mathbold{\teststring}\\
+\mbox{mathsans} & & \mathsans{\teststring}\\
+\mbox{mathboldsans} & & \mathboldsans{\teststring}
\end{eqnarray*}
@@ -107,9 +162,13 @@ vector $\vec{F}$ or the electrical field $\vec{E}$.%
\subsection{Tensor symbols}
-Symbols for tensors are sans-serif bold italic, \begin{eqnarray*}
-\tensorsym{\alpha} & = & \tensorsym{e}\cdot\tensorsym{a}.\\
-\alpha_{ijl} & = & e_{ijk}\cdot a_{kl}\end{eqnarray*}
+Symbols for tensors are sans-serif bold italic,
+
+\[
+ \tensorsym{\alpha} = \tensorsym{e}\cdot\tensorsym{a}
+ \quad \Longleftrightarrow \quad
+ \alpha_{ijl} = e_{ijk}\cdot a_{kl}.
+\]
The permittivity tensor describes the coupling of electric field and
diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.sty.html b/Master/texmf-dist/doc/latex/isomath/isomath.sty.html
index 9dbe56f1413..87bbd7ff324 100644
--- a/Master/texmf-dist/doc/latex/isomath/isomath.sty.html
+++ b/Master/texmf-dist/doc/latex/isomath/isomath.sty.html
@@ -4,8 +4,8 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.6: http://docutils.sourceforge.net/" />
-<title>isomath.sty: Math for scientists</title>
-<meta name="copyright" content="© 2008 Günter Milde, Released under the terms of the GNU General Public License (v. 2 or later)" />
+<title>isomath: Math for scientists</title>
+<meta name="copyright" content="© 2008 Günter Milde" />
<style type="text/css">
/*
@@ -284,24 +284,26 @@ ul.auto-toc {
</style>
</head>
<body>
-<div class="document" id="isomath-sty-math-for-scientists">
-<h1 class="title">isomath.sty: Math for scientists</h1>
+<div class="document" id="isomath-math-for-scientists">
+<h1 class="title">isomath: Math for scientists</h1>
<table class="docinfo" frame="void" rules="none">
<col class="docinfo-name" />
<col class="docinfo-content" />
<tbody valign="top">
<tr><th class="docinfo-name">Copyright:</th>
-<td>© 2008 Günter Milde,
-Released under the terms of the GNU General Public License
-(v. 2 or later)</td></tr>
+<td>© 2008 Günter Milde</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
+(version 2 or later).</td>
+</tr>
</tbody>
</table>
<div class="abstract topic">
<p class="topic-title first">Abstract</p>
-<p>The isomath package enables formatting Greek and Latin letters
-as symbols for vectors, matrices, and tensors in the typefaces
-recommended for scientific papers by the International
-Standard ISO 31.</p>
+<p>The isomath package enables formatting Greek and Latin
+letters as symbols for vectors, matrices, and tensors
+in the typefaces recommended for scientific papers
+by the International Standard ISO 31. For this, a <em>bold italic</em>
+and a <em>sans-serif bold italic</em> math alphabet are defined.</p>
</div>
<div class="contents topic" id="contents">
<p class="topic-title first">Contents</p>
@@ -322,67 +324,83 @@ Standard ISO 31.</p>
<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="#ifthen" id="id25">ifthen</a></li>
-<li><a class="reference internal" href="#kvoptions" id="id26">kvoptions</a></li>
+<li><a class="reference internal" href="#kvoptions" id="id25">kvoptions</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>
</ul>
</li>
-<li><a class="reference internal" href="#options" id="id27">Options</a><ul>
-<li><a class="reference internal" href="#rmdefault" id="id28">rmdefault</a></li>
-<li><a class="reference internal" href="#sfdefault" id="id29">sfdefault</a></li>
-<li><a class="reference internal" href="#reusemathalphabets" id="id30">reuseMathalphabets</a></li>
-<li><a class="reference internal" href="#oml-math" id="id31">OML math*</a></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="#declarations" id="id32">Declarations</a><ul>
-<li><a class="reference internal" href="#new-math-alphabets" id="id33">New math alphabets</a></li>
-<li><a class="reference internal" href="#redefine-standard-alphabets" id="id34">Redefine standard alphabets</a></li>
-<li><a class="reference internal" href="#command-aliases" id="id35">Command aliases</a><ul>
-<li><a class="reference internal" href="#vector-symbols" id="id36">Vector symbols</a></li>
-<li><a class="reference internal" href="#matrix-symbols" id="id37">Matrix symbols</a></li>
-<li><a class="reference internal" href="#tensor-symbols" id="id38">Tensor symbols</a></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>
</ul>
</li>
-<li><a class="reference internal" href="#font-mappings" id="id39">Font mappings</a></li>
+<li><a class="reference internal" href="#font-mappings" id="id41">Font mappings</a></li>
</ul>
</li>
-<li><a class="reference internal" href="#the-end" id="id40">The end</a></li>
-<li><a class="reference internal" href="#todo" id="id41">TODO</a></li>
-<li><a class="reference internal" href="#about-this-file" id="id42">About this file</a></li>
-<li><a class="reference internal" href="#references" id="id43">References</a></li>
</ul>
</li>
+<li><a class="reference internal" href="#references" id="id42">References</a></li>
</ul>
</div>
<div class="section" id="introduction">
<h1><a class="toc-backref" href="#id13">Introduction</a></h1>
<div class="section" id="motivation">
<h2><a class="toc-backref" href="#id14">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 ISO 31
-<a class="reference external" href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_tc_browse.htm?commid=46202">Quantities and units</a> (ISO 31-0:1992 to ISO 31-14:1992).<a class="footnote-reference" href="#id2" id="id1">[1]</a></p>
-<table class="docutils footnote" frame="void" id="id2" 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="id3">[typefaces]</a>. See also
-<a class="citation-reference" href="#symbol-fonts" id="id4">[symbol-fonts]</a> and <a class="citation-reference" href="#si-brochure" id="id5">[SI-brochure]</a>.</td></tr>
-</tbody>
-</table>
+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>
<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 <cite>bold italic</cite> typeface for vector symbols.</li>
+a <em>bold italic</em> typeface for vector symbols.</li>
<li>Greek letters are excluded from font changes with the math alphabets,
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 <cite>bold italic</cite>
+<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>
-<li>There is no provision for typesetting letters in <cite>sans-serif bold italic</cite>
+<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
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>
+</tbody>
+</table>
</div>
<div class="section" id="features">
<h2><a class="toc-backref" href="#id15">Features</a></h2>
@@ -399,21 +417,28 @@ math alphabet is used.</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>
</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>
-select an ISO-conforming typeface.</p>
+allow semantic markup selecting an ISO-conforming typeface.</p>
</li>
-<li><p class="first">For this, <a class="reference internal" href="#new-math-alphabets">new math alphabets</a> are defined:</p>
+<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">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
-<tr class="field"><th class="field-name"><tt class="docutils literal"><span class="pre">\mathbold</span></tt>:</th><td class="field-body">for <em>boldface italic</em> (vector and matrix
-symbols),</td>
+<tr class="field"><th class="field-name"><tt class="docutils literal"><span class="pre">\mathbold</span></tt>:</th><td class="field-body"><em>boldface italic</em> (vector and matrix symbols),</td>
</tr>
-<tr class="field"><th class="field-name"><tt class="docutils literal"><span class="pre">\mathsans</span></tt>:</th><td class="field-body">for <em>sans-serif italic</em> ,</td>
+<tr class="field"><th class="field-name"><tt class="docutils literal"><span class="pre">\mathsans</span></tt>:</th><td class="field-body"><em>sans-serif italic</em> (optional),</td>
</tr>
-<tr class="field"><th class="field-name"><tt class="docutils literal"><span class="pre">\mathboldsans</span></tt>:</th><td class="field-body">for <em>sans-serif bold italic</em> (tensor symbols).</td>
+<tr class="field"><th class="field-name"><tt class="docutils literal"><span class="pre">\mathboldsans</span></tt>:</th><td class="field-body"><em>sans-serif bold italic</em> (tensor symbols).</td>
</tr>
</tbody>
</table>
@@ -421,33 +446,19 @@ symbols),</td>
<tt class="docutils literal"><span class="pre">\rmdefault</span></tt> and <tt class="docutils literal"><span class="pre">\sfdefault</span></tt> values. The <tt class="docutils literal"><span class="pre">rmdefault=&lt;family&gt;</span></tt> and
<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"><a class="reference internal" href="#font-mappings">Font mappings</a> are defined for families which have an OML encoded
-counterpart but miss the substitution definition.</p>
+<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>
+files.</p>
</li>
</ul>
-<!-- Now, it should be possible to typeset, e.g., the symbol for the tensor of
-dielectric permittivity ε according to the rules (i.e. sans-serif bold
-italic). -->
-<div class="caution">
-<p class="first admonition-title">Caution!</p>
-<p>Using small Greek letters in a math alphabet command (e.g.
-<tt class="docutils literal"><span class="pre">\mathrm{\pi}</span></tt>) can lead to garbage.</p>
-<p class="last">You can use the <a class="reference internal" href="#oml-math">OML math*</a> options (if the used font supports the
-<a class="reference internal" href="#oml-font-encoding">OML font encoding</a>) or place the Greek letter 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>
-</div>
</div>
<div class="section" id="examples">
<h2><a class="toc-backref" href="#id16">Examples</a></h2>
<ul>
-<li><p class="first"><tt class="docutils literal"><span class="pre">\usepackage{isomath}</span></tt></p>
-<p>In many cases (when <tt class="docutils literal"><span class="pre">\sfdefault</span></tt> expands to &quot;cmss&quot;), the
+<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
encoded variants and maps to &quot;cmmi&quot;.</p>
-</li>
-<li><p class="first">Use <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/cmbright.html">cmbright</a> for the sans-serif math alphabets:</p>
+<p>Use <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/cmbright.html">cmbright</a> for sans-serif math alphabets:</p>
<pre class="literal-block">
\usepackage[sfdefault=cmbr]{isomath}
</pre>
@@ -459,13 +470,13 @@ italic</cite>:</p>
\renewcommand{\vec}{\vectorsym}
</pre>
</li>
-<li><p class="first">The <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/mathdesign.html">mathdesign</a> package comes with an OML encoded bold roman font but does
-not use it for <tt class="docutils literal"><span class="pre">\mathbf</span></tt> in the default setting. With</p>
+<li><p class="first">The <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/mathdesign.html">mathdesign</a> package provides an OML encoded <em>bold roman</em> font but does
+not set it up for <tt class="docutils literal"><span class="pre">\mathbf</span></tt>:</p>
<pre class="literal-block">
\usepackage[charter]{mathdesign}
\usepackage[OMLmathbf,sfdefault=cmbr]{isomath}
</pre>
-<p><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> works as expected.</p>
</li>
</ul>
</div>
@@ -499,14 +510,7 @@ math alphabets and can only be combined with <tt class="docutils literal"><span
</div>
<div class="section" id="oml-font-encoding">
<h2><a class="toc-backref" href="#id19">OML font encoding</a></h2>
-<p>If a math alphabet shall support both, Greek and Latin letters, it must use
-the OML font encoding — no other established encoding provides 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>
-<p>The <cite>LaTeX font encodings</cite> guide <a class="citation-reference" href="#encguide" id="id6">[encguide]</a> defines:</p>
+<p>The <cite>LaTeX font encodings</cite> guide <a class="citation-reference" href="#encguide" id="id8">[encguide]</a> defines:</p>
<blockquote>
The OML encoding contains italic Latin and Greek letters for use in
mathematical formulas (typically used for variables) together with some
@@ -523,13 +527,19 @@ 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>
<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
grepping for &quot;DeclareFont.*OML&quot;, &quot;SymbolFont.*OML&quot; and &quot;MathAlphabet.*OML&quot;
in <tt class="docutils literal"><span class="pre">*.sty</span></tt> files.</p>
-<table border="1" class="booktab docutils">
-<caption>Table 1: Fonts supporting the OML font encoding</caption>
+<table border="1" class="booktab docutils" id="table-1">
+<caption>Fonts supporting the OML font encoding</caption>
<colgroup>
<col width="19%" />
<col width="40%" />
@@ -799,7 +809,7 @@ supporting {m}{n} or {bx}{n} here.</li>
<p>The following fonts define <tt class="docutils literal"><span class="pre">cmm</span></tt> as OML substitution. A better matching
substitution can be set with the <a class="reference internal" href="#rmdefault">rmdefault</a> option.</p>
<table border="1" class="booktab docutils" id="table-2">
-<caption>Table 2: Non-CM fonts with <tt class="docutils literal"><span class="pre">cmm</span></tt> as OML substitution</caption>
+<caption>Non-CM fonts with <tt class="docutils literal"><span class="pre">cmm</span></tt> as OML substitution</caption>
<colgroup>
<col width="30%" />
<col width="70%" />
@@ -913,16 +923,8 @@ the font family below.)</p>
\RequirePackage{fixmath}
</pre>
</div>
-<div class="section" id="ifthen">
-<h3><a class="toc-backref" href="#id25">ifthen</a></h3>
-<p>The standard LaTeX package <a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/ifthen.html">ifthen</a> provides the commands <tt class="docutils literal"><span class="pre">\ifthenelse</span></tt>,
-and <tt class="docutils literal"><span class="pre">\whiledo</span></tt>.</p>
-<pre class="literal-block">
-\RequirePackage{ifthen}
-</pre>
-</div>
<div class="section" id="kvoptions">
-<h3><a class="toc-backref" href="#id26">kvoptions</a></h3>
+<h3><a class="toc-backref" href="#id25">kvoptions</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">
@@ -931,10 +933,10 @@ 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="#id27">Options</a></h2>
+<h2><a class="toc-backref" href="#id26">Options</a></h2>
<div class="section" id="rmdefault">
-<h3><a class="toc-backref" href="#id28">rmdefault</a></h3>
-<p>Alternative math font family name for roman. The default is to use the
+<h3><a class="toc-backref" href="#id27">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>
<pre class="literal-block">
@@ -942,59 +944,62 @@ corresponding text font family (<tt class="docutils literal"><span class="pre">\
</pre>
</div>
<div class="section" id="sfdefault">
-<h3><a class="toc-backref" href="#id29">sfdefault</a></h3>
-<p>Alternative math font family name for sans-serif. The default is to use the
+<h3><a class="toc-backref" href="#id28">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 italic and bold variants in OMS
-encoding. Nor have many derivatives (lmss, aess, ...).
-Actually, there are only a few OML-encoded sans-serif fonts (all
-slanted/italic):</p>
+<p>Computer Modern Sans Serif (cmss) has no OMS encoded variant. Nor have many
+derivatives (lmss, aess, ...). Actually, there are only a few OML-encoded
+sans-serif fonts (all slanted/italic):</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
-<tr class="field"><th class="field-name">zavm:</th><td class="field-body"><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/arev.html">arev</a> (Vera Sans with math extension)</td>
+<tr class="field"><th class="field-name">zavm:</th><td class="field-body"><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/arev.html">arev</a> (Vera Sans with math extension, large x-hight)</td>
</tr>
<tr class="field"><th class="field-name">cmbr:</th><td class="field-body"><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/cmbright.html">cmbright</a> (Computer Modern Bright, slightly lighter than cmss)</td>
</tr>
-<tr class="field"><th class="field-name">iwona:</th><td class="field-body"><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/iwona.html">iwona</a> (Humanistic Sans Serif)</td>
+<tr class="field"><th class="field-name">iwona:</th><td class="field-body"><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/iwona.html">iwona</a> (Humanistic Sans Serif, some shapes very similar to roman)</td>
</tr>
<tr class="field"><th class="field-name">hvm:</th><td class="field-body"><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/hvmath.html">hvmath</a> (Helvetica Math, commercial, free bitmap version)</td>
</tr>
-<tr class="field"><th class="field-name">llcmm:</th><td class="field-body"><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/lxfonts.html">lxfonts</a> (LX Fonts, very wide and quite eccentric, new in 2008)</td>
+<tr class="field"><th class="field-name">llcmm:</th><td class="field-body"><a class="reference external" href="http://dante.ctan.org/CTAN/help/Catalogue/entries/lxfonts.html">lxfonts</a> (LX Fonts, very wide, excentric, large x-hight, new in 2008)</td>
</tr>
</tbody>
</table>
-<p>For many fonts (especially CM and related), <tt class="docutils literal"><span class="pre">[sfdefault=cmbr]</span></tt> is the
+<p>For most fonts (especially CM and related), <tt class="docutils literal"><span class="pre">[sfdefault=cmbr]</span></tt> is the
recommended setting.</p>
<pre class="literal-block">
\DeclareStringOption[\sfdefault]{sfdefault}
</pre>
+<dl class="docutils">
+<dt>TODO</dt>
+<dd>Allow scaling?</dd>
+</dl>
</div>
<div class="section" id="reusemathalphabets">
-<h3><a class="toc-backref" href="#id30">reuseMathalphabets</a></h3>
-<p>The definition of <a class="reference internal" href="#new-math-alphabets">new math alphabets</a> can lead to a &quot;too many math
+<h3><a class="toc-backref" href="#id29">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.</p>
+<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>
-command can be used (remember that this toggles the math-mode off and might
-use a different font).</p>
-<p>Both standard and <a class="reference internal" href="#new-math-alphabets">new math alphabets</a> are in upright shape, if this option
-is combined with the corresponding <a class="reference internal" href="#oml-math">OML math*</a> option.</p>
+commands might be used (however, that this toggles the math-mode off and
+might use a different font).</p>
<pre class="literal-block">
\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>
-<div class="section" id="oml-math">
-<h3><a class="toc-backref" href="#id31">OML math*</a></h3>
-<p>These options cause isomath to <a class="reference internal" href="#redefine-standard-alphabets">redefine standard alphabets</a> in OML
+<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>
<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>. 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> as OT1 encoded fonts have ligatures
+and non-alpha symbols in place of the small Greek letters.</p>
<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>.
+shapes with e.g. <tt class="docutils literal"><span class="pre">\mathrm{\pi}</span></tt> <strong>if an OML encoded font is available</strong>.
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>
@@ -1007,6 +1012,7 @@ used in version normal&quot; error.</p>
\DeclareBoolOption{OMLmathrm}
\DeclareBoolOption{OMLmathbf}
\DeclareBoolOption{OMLmathsf}
+\DeclareBoolOption{OMLmathsans}
\DeclareBoolOption{OMLmathtt}
</pre>
<hr class="docutils" />
@@ -1017,66 +1023,82 @@ used in version normal&quot; error.</p>
</div>
</div>
<div class="section" id="declarations">
-<h2><a class="toc-backref" href="#id32">Declarations</a></h2>
-<div class="section" id="new-math-alphabets">
-<h3><a class="toc-backref" href="#id33">New math alphabets</a></h3>
-<p>The <cite>italic bold</cite> math alphabet is named <tt class="docutils literal"><span class="pre">\mathbold</span></tt> in <a class="reference internal" href="#related-packages">related
-packages</a>. For letters, this is the same as the bold version of
-<tt class="docutils literal"><span class="pre">\mathnormal</span></tt>. 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>
+<h2><a class="toc-backref" href="#id31">Declarations</a></h2>
+<div class="section" id="math-alphabets">
+<h3><a class="toc-backref" href="#id32">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>.
+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>
<pre class="literal-block">
-\ifthenelse{\boolean{isomath&#64;reuseMathalphabets}}
-{
+\ifisomath&#64;reuseMathalphabets
\DeclareMathAlphabet{\mathbf}{OML}{\isomath&#64;rmdefault}{bx}{it}
\def\mathbold{\mathbf}
-}
-{
+\else
\DeclareMathAlphabet{\mathbold}{OML}{\isomath&#64;rmdefault}{bx}{it}
-}
+\fi
</pre>
-<p>For <cite>italic sans-serif</cite>, we either redefine <tt class="docutils literal"><span class="pre">\mathsf</span></tt> (with
-<a class="reference internal" href="#reusemathalphabets">reuseMathalphabets</a>) or, in analogy to <tt class="docutils literal"><span class="pre">\mathbold</span></tt>, we define the new
-alphabet <tt class="docutils literal"><span class="pre">\mathsans</span></tt>:</p>
+</div>
+<div class="section" id="mathsans">
+<h4><a class="toc-backref" href="#id34">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>
<pre class="literal-block">
-\ifthenelse{\boolean{isomath&#64;reuseMathalphabets}}
-{
- \DeclareMathAlphabet{\mathsf}{OML}{\isomath&#64;sfdefault}{m}{it}
- \def\mathsans{\mathsf}
-}
-{
+\ifisomath&#64;OMLmathsans
\DeclareMathAlphabet{\mathsans}{OML}{\isomath&#64;sfdefault}{m}{it}
-}
+\fi
</pre>
-<p>A <cite>sans serif slanted bold</cite> alphabet is needed for the tensor
-symbols. As there is no standard math alphabet to re-use, we define the new
-alphabet <tt class="docutils literal"><span class="pre">\mathboldsans</span></tt>:</p>
+</div>
+<div class="section" id="mathboldsans">
+<h4><a class="toc-backref" href="#id35">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>
+made an alias:</p>
<pre class="literal-block">
-\DeclareMathAlphabet{\mathboldsans}{OML}{\isomath&#64;sfdefault}{bx}{it}
+\ifisomath&#64;reuseMathalphabets
+ \DeclareMathAlphabet{\mathsf}{OML}{\isomath&#64;sfdefault}{bx}{it}
+ \def\mathboldsans{\mathsf}
+\else
+ \DeclareMathAlphabet{\mathboldsans}{OML}{\isomath&#64;sfdefault}{bx}{it}
+\fi
</pre>
</div>
<div class="section" id="redefine-standard-alphabets">
-<h3><a class="toc-backref" href="#id34">Redefine standard alphabets</a></h3>
+<h4><a class="toc-backref" href="#id36">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">OML math*</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">
-\ifthenelse{\boolean{isomath&#64;OMLmathrm}}
-{\SetMathAlphabet{\mathrm}{normal}{OML}{\isomath&#64;rmdefault}{n}{n}}{}
-\ifthenelse{\boolean{isomath&#64;OMLmathbf}}
-{\SetMathAlphabet{\mathbf}{normal}{OML}{\isomath&#64;rmdefault}{b}{n}}{}
-\ifthenelse{\boolean{isomath&#64;OMLmathbf}}
-{\SetMathAlphabet{\mathsf}{normal}{OML}{\isomath&#64;sfdefault}{n}{n}}{}
-\ifthenelse{\boolean{isomath&#64;OMLmathtt}}
-{\SetMathAlphabet{\mathtt}{normal}{OML}{\ttdefault}{n}{n}}{}
+\ifisomath&#64;OMLmathrm
+ \SetMathAlphabet{\mathrm}{normal}{OML}{\isomath&#64;rmdefault}{n}{n}
+\fi
+\ifisomath&#64;OMLmathbf
+ \SetMathAlphabet{\mathbf}{normal}{OML}{\isomath&#64;rmdefault}{b}{n}
+\fi
+\ifisomath&#64;OMLmathsf
+ \SetMathAlphabet{\mathsf}{normal}{OML}{\isomath&#64;sfdefault}{n}{n}
+\fi
+\ifisomath&#64;OMLmathtt
+ \SetMathAlphabet{\mathtt}{normal}{OML}{\ttdefault}{n}{n}
+\fi
</pre>
</div>
+</div>
<div class="section" id="command-aliases">
-<h3><a class="toc-backref" href="#id35">Command aliases</a></h3>
-<p>Define commands to typeset some symbol categories complying to
-the ISO standard.</p>
-<div class="section" id="vector-symbols">
-<h4><a class="toc-backref" href="#id36">Vector symbols</a></h4>
-<p>Symbols for vectors are <em>boldface italic</em>:</p>
+<h3><a class="toc-backref" href="#id37">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>
+<div class="section" id="vectorsym">
+<h4><a class="toc-backref" href="#id38">\vectorsym</a></h4>
+<p>Symbols for vectors are typeset <em>boldface italic</em>:</p>
<pre class="literal-block">
\newcommand{\vectorsym}{\mathbold}
</pre>
@@ -1084,24 +1106,16 @@ the ISO standard.</p>
you might want to re-define the standard <tt class="docutils literal"><span class="pre">\vec</span></tt> command after loading this
package (cf. the <a class="reference internal" href="#examples">Examples</a> section).</p>
</div>
-<div class="section" id="matrix-symbols">
-<h4><a class="toc-backref" href="#id37">Matrix symbols</a></h4>
-<p>Symbols for matrices are <em>boldface italic</em>, i. e. typeset in the same face as
-vectors (see <a class="citation-reference" href="#typefaces" id="id7">[typefaces]</a>). <a class="footnote-reference" href="#id9" id="id8">[2]</a></p>
+<div class="section" id="matrixsym">
+<h4><a class="toc-backref" href="#id39">\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">
\newcommand{\matrixsym}{\mathbold}
</pre>
-<table class="docutils footnote" frame="void" id="id9" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id8">[2]</a></td><td>However, matrix symbols are usually capital letters whereas vectors
-are small ones. Exceptions are physical Quantities like the force
-vector F or the electrical field E.</td></tr>
-</tbody>
-</table>
</div>
-<div class="section" id="tensor-symbols">
-<h4><a class="toc-backref" href="#id38">Tensor symbols</a></h4>
+<div class="section" id="tensorsym">
+<h4><a class="toc-backref" href="#id40">\tensorsym</a></h4>
<p>Symbols for tensors are <em>sans-serif bold italic</em>:</p>
<pre class="literal-block">
\newcommand{\tensorsym}{\mathboldsans}
@@ -1109,12 +1123,12 @@ vector F or the electrical field E.</td></tr>
</div>
</div>
<div class="section" id="font-mappings">
-<h3><a class="toc-backref" href="#id39">Font mappings</a></h3>
+<h3><a class="toc-backref" href="#id41">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
package. Ideally, these should become part of a more complete set of
-definitions in the package's fd file(s):</p>
+definitions in the package's <tt class="docutils literal"><span class="pre">*.fd</span></tt> files:</p>
<p>Mathpazo (Palatino) ppl -&gt; zplm</p>
<pre class="literal-block">
\DeclareFontFamily{OML}{ppl}{\skewchar\font127}
@@ -1129,77 +1143,69 @@ definitions in the package's fd file(s):</p>
</pre>
<p>LX Fonts (lxfonts): llcmss -&gt; llcmm</p>
<pre class="literal-block">
+% repeat font declarations from lxfonts.sty
+\DeclareFontFamily{OML}{llcmm}{\skewchar\font'177}
+\DeclareFontShape{OML}{llcmm}{m}{it}{&lt;-&gt; lcmmi8}{}
+\DeclareFontShape{OML}{llcmm}{bx}{it}{&lt;-&gt; lcmmib8}{}
+
\DeclareFontFamily{OML}{llcmss}{}
\DeclareFontShape{OML}{llcmss}{m}{it}{&lt;-&gt; ssub * llcmm/m/it}{}
\DeclareFontShape{OML}{llcmss}{bx}{it}{&lt;-&gt; ssub * llcmm/bx/it}{}
</pre>
-</div>
-</div>
-<div class="section" id="the-end">
-<h2><a class="toc-backref" href="#id40">The end</a></h2>
+<p>No declarations below this point:</p>
<pre class="literal-block">
\endinput
</pre>
</div>
-<div class="section" id="todo">
-<h2><a class="toc-backref" href="#id41">TODO</a></h2>
-<p>The <tt class="docutils literal"><span class="pre">\mathsans</span></tt> definition &quot;increases symmetry&quot;. However, it adds a math
-alphabet that is rarely (or not at all) used. Giving the limit of 16 math
-alphabets, it might be better not to define it. Make it an option?</p>
</div>
-<div class="section" id="about-this-file">
-<h2><a class="toc-backref" href="#id42">About this file</a></h2>
-<p>The package documentation is included in the source file.</p>
-<p>The bidirectional text &lt;-&gt; code converter <a class="reference external" href="http://pylit.berlios.de">PyLit</a> can be used to transform
-the LaTeX package <tt class="docutils literal"><span class="pre">isomath.sty</span></tt> to a <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructured Text</a> document
-<tt class="docutils literal"><span class="pre">isomath.sty.txt</span></tt> (and back again). To translate <tt class="docutils literal"><span class="pre">isomath.sty.txt</span></tt> to
-LaTeX or HTML, the Python <a class="reference external" href="http://docutils.sourceforge.net/rst.html">docutils</a> are required.</p>
</div>
<div class="section" id="references">
-<h2><a class="toc-backref" href="#id43">References</a></h2>
-<table class="docutils citation" frame="void" id="encguide" rules="none">
+<h1><a class="toc-backref" href="#id42">References</a></h1>
+<table class="docutils citation" frame="void" id="typefaces" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id6">[encguide]</a></td><td><cite>LaTeX font encodings</cite>:
-<a class="reference external" href="http://dante.ctan.org/CTAN/macros/latex/doc/encguide.pdf">http://dante.ctan.org/CTAN/macros/latex/doc/encguide.pdf</a></td></tr>
+<tr><td class="label">[typefaces]</td><td><em>(<a class="fn-backref" href="#id4">1</a>, <a class="fn-backref" href="#id10">2</a>)</em> <cite>Typefaces for Symbols in Scientific Manuscripts</cite>:
+<a class="reference external" href="http://physics.nist.gov/Document/typefaces.pdf">http://physics.nist.gov/Document/typefaces.pdf</a></td></tr>
</tbody>
</table>
-<table class="docutils citation" frame="void" id="symbol-fonts" rules="none">
+<table class="docutils citation" frame="void" id="fonts-for-symbols" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id4">[symbol-fonts]</a></td><td><cite>On the use of italic and roman fonts for symbols in
-scientific text</cite>, I.M. Mills and W.V. Metanomski (Revised December 1999):
+<tr><td class="label"><a class="fn-backref" href="#id5">[fonts-for-symbols]</a></td><td><cite>On the use of italic and roman fonts for symbols in
+scientific text</cite>, (Revised December 1999):
<a class="reference external" href="http://old.iupac.org/standing/idcns/fonts_for_symbols.html">http://old.iupac.org/standing/idcns/fonts_for_symbols.html</a></td></tr>
</tbody>
</table>
-<table class="docutils citation" frame="void" id="green-book" rules="none">
+<table class="docutils citation" frame="void" id="si-brochure" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label">[Green-Book]</td><td><cite>Quantities, Units and Symbols in Physical Chemistry</cite>,
-3rd edition, RSC Publishing, Cambridge 2007:
-[ISBN 0 85404 433 7; ISBN-13 978 0 85404 433 7]</td></tr>
+<tr><td class="label"><a class="fn-backref" href="#id6">[SI-brochure]</a></td><td><cite>The International System of Units (SI)</cite>:
+<a class="reference external" href="http://www.bipm.org/en/si/si_brochure/">http://www.bipm.org/en/si/si_brochure/</a></td></tr>
</tbody>
</table>
-<table class="docutils citation" frame="void" id="typefaces" rules="none">
+<table class="docutils citation" frame="void" id="encguide" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label">[typefaces]</td><td><em>(<a class="fn-backref" href="#id3">1</a>, <a class="fn-backref" href="#id7">2</a>)</em> <cite>Typefaces for Symbols in Scientific Manuscripts</cite>:
-<a class="reference external" href="http://physics.nist.gov/Document/typefaces.pdf">http://physics.nist.gov/Document/typefaces.pdf</a></td></tr>
+<tr><td class="label"><a class="fn-backref" href="#id8">[encguide]</a></td><td><cite>LaTeX font encodings</cite>:
+<a class="reference external" href="http://dante.ctan.org/CTAN/macros/latex/doc/encguide.pdf">http://dante.ctan.org/CTAN/macros/latex/doc/encguide.pdf</a></td></tr>
</tbody>
</table>
-<table class="docutils citation" frame="void" id="si-brochure" rules="none">
+<table class="docutils citation" frame="void" id="fntguide" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id5">[SI-brochure]</a></td><td><cite>The International System of Units (SI)</cite>:
-<a class="reference external" href="http://www.bipm.org/en/si/si_brochure/">http://www.bipm.org/en/si/si_brochure/</a></td></tr>
+<tr><td class="label"><a class="fn-backref" href="#id9">[fntguide]</a></td><td><cite>LaTeX 2e font selection</cite>:
+<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>
<!-- see also
-[koma-mail] Custom font substitution: http://www.komascript.de/node/823 -->
+[koma-mail] Custom font substitution: http://www.komascript.de/node/823
+
+[Green-Book] `Quantities, Units and Symbols in Physical Chemistry`,
+3rd edition, RSC Publishing, Cambridge 2007:
+[ISBN 0 85404 433 7; ISBN-13 978 0 85404 433 7] -->
<!-- Links -->
<!-- ***** -->
</div>
</div>
-</div>
</body>
</html>
diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.sty.pdf b/Master/texmf-dist/doc/latex/isomath/isomath.sty.pdf
new file mode 100644
index 00000000000..a7bd54414f2
--- /dev/null
+++ 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
new file mode 100644
index 00000000000..eb407f37486
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt
@@ -0,0 +1,636 @@
+isomath: Math for scientists
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+:Copyright: © 2008 Günter Milde
+:Licence: Released under the terms of the GNU General Public License
+ (version 2 or later).
+
+:Abstract: The isomath package enables formatting Greek and Latin
+ letters as symbols for vectors, matrices, and tensors
+ in the typefaces recommended for scientific papers
+ by the International Standard ISO 31. For this, a *bold italic*
+ and a *sans-serif bold italic* math alphabet are defined.
+
+.. contents::
+
+Introduction
+************
+
+Motivation
+==========
+
+.. Did you ever manage to write the stress tensor ``$\sigma$`` in a
+ *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).\ [#]_
+
+The traditional `LaTeX-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.
+
+* Greek letters are excluded from font changes with the math alphabets,
+ while the ISO 31 rules apply equally to letters from both the Greek
+ 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).
+
+* 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
+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.
+
+
+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
+
+ + 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``.
+
+* The `command aliases`_ ``\vectorsym``, ``\matrixsym``, and ``\tensorsym``
+ allow semantic markup selecting an ISO-conforming typeface.
+
+* For this, new `math alphabets`_ are defined:
+
+ :``\mathbold``: *boldface italic* (vector and matrix symbols),
+ :``\mathsans``: *sans-serif italic* (optional),
+ :``\mathboldsans``: *sans-serif bold italic* (tensor symbols).
+
+ The family for these fonts is by default taken from the document's
+ ``\rmdefault`` and ``\sfdefault`` values. The ``rmdefault=<family>`` and
+ ``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``
+ files.
+
+
+Examples
+========
+
+
+* In many cases (e.g. when ``\sfdefault`` expands to "cmss"), the
+ ``\mathboldsans`` alphabet is neither bold nor sans, as "cmss" has no OML
+ encoded variants and maps to "cmmi".
+
+ Use cmbright_ for sans-serif math alphabets::
+
+ \usepackage[sfdefault=cmbr]{isomath}
+
+* Redefine the standard ``\vec`` macro to typeset its argument in `bold
+ italic`::
+
+ \usepackage[sfdefault=cmbr]{isomath}
+ \renewcommand{\vec}{\vectorsym}
+
+* The mathdesign_ package provides an OML encoded *bold roman* font but does
+ not set it up for ``\mathbf``::
+
+ \usepackage[charter]{mathdesign}
+ \usepackage[OMLmathbf,sfdefault=cmbr]{isomath}
+
+ Now, ``\mathbf{\pi}`` works as expected.
+
+Related packages
+================
+
+Some packages already define Greek letters as ``\mathalpha`` and provide the
+``\mathbold`` alphabet (in OML):
+
+* arev_ (Arev/Vera Sans)
+* cmbright_ (CM Bright)
+* eulervm_ (Euler Math)
+* fixmath_ (Computer Modern)
+* hvmath_ (HV-Math/Helvetica)
+* mathpazo_ (Palatino)
+* tmmath_ (TM-Math/Times)
+
+This package builds on and extends fixmath_ by Walter Schmidt
+(see Requirements_).
+
+The cmbright_ package provides fonts for ``\mathsans`` and
+``\mathboldsans`` matching with Computer Modern and derivatives.
+
+Conflicts
+---------
+
+The `fourier`_ package for math typesetting with Utopia defines its own,
+incompatible math font encodings. It cannot be used with ``isomath`` but
+provides other means to typeset upright or italic Greek (see its
+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.
+
+OML font encoding
+=================
+
+The `LaTeX font encodings` guide [encguide]_ 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:
+
+* 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.
+
+* Both, ``\DeclareSymbolFont`` and ``\DeclareMathAlphabet`` require a
+ {<shape>} argument. Thus it is possible to define OML encoded math
+ alphabets in roman {n} as well as italic {it} shape without conflicts.
+
+* 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.
+
+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 ``oml*.fd`` files and by
+grepping for "DeclareFont.*OML", "SymbolFont.*OML" and "MathAlphabet.*OML"
+in ``*.sty`` files.
+
+.. _table 1:
+
+.. table:: Fonts supporting the OML font encoding
+ :class: booktab
+
+ ============= =========================== ======= ======== ====== =======
+ Name Family {m}{it} {bx}{it} {m}{n} {bx}{n}
+ ============= =========================== ======= ======== ====== =======
+ aer AE (Almost European) x x
+ antt Antykwa Torunska x x
+ cmr Computer Modern Roman x x
+ ccr Concrete x x
+ cmbr Computer Modern Bright x x
+ hlh Lucida x x
+ hfor CM with old-style digits x x
+ iwona Iwona (sans serif) x x
+ jkp Kepler Serif x x
+ jkpl Kepler Serif x x
+ jkpvos Kepler Serif x x
+ jkplvos Kepler Serif x x
+ llcmm LXfonts (sans serif) x x
+ lmr Latin Modern Roman x x
+ mak Kerkis x
+ mdbch Math Design Charter x x ? x
+ mdput Math Design Utopia x x ? x
+ mdugm Math Design Garamond x x ? x
+ neohellenic GFS Neohellenic x
+ plcm CM (PLaTeX) x
+ ptmom Times (Omega or MB-Times) x x
+ ptmomu Times (Omega or MB-Times) x x
+ ptmcm Times (psfont) x
+ pxr Palatino (pxfonts) x x
+ qpl Palatino/Pagella (qpxmath) x x
+ qtm Times/Termes (qtxmath) x x
+ txr Times (txfonts) x x
+ ywclm (greektex) x x
+ zavm Arev (Vera Sans-Serif) x x
+ zesfcm (efont) x
+ zplm Palatino (mathpazo) x x
+ zpple x x
+ ztmcm Times (mathptmx) x
+ zer Computer Modern (zefonts) x x
+ ============= =========================== ======= ======== ====== =======
+
+Explanations:
+
+* If there is an alias (substitution) from the text font to a math-variant,
+ only the text font is listed.
+
+* Many text fonts define substitutions also for {n}, however mapping to
+ an italic variant of the OML encoded font. These are not listed as
+ supporting {m}{n} or {bx}{n} here.
+
+The following fonts define ``cmm`` as OML substitution. A better matching
+substitution can be set with the rmdefault_ option.
+
+.. _table 2:
+
+.. table:: Non-CM fonts with ``cmm`` as OML substitution
+ :class: booktab
+
+ ============= ===============================
+ Family Name
+ ============= ===============================
+ bch Charter (psnfss)
+ pag Avant Garde (psnfss)
+ pbk Bookman (psnfss)
+ pcr Courier (psnfss)
+ phv Helvetica (psnfss)
+ pnc New Century Schoolbook (psnfss)
+ ppl Palatino (psnfss)
+ ptm Times Roman (psnfss)
+ put Utopia (psnfss)
+ pzc Zapf Chancery (psnfss)
+ uag Avant Garde (avantgar)
+ ubk Bookman (bookman)
+ ucr Courier (courier)
+ ucrs Courier
+ unc New Courier (nctrsbk)
+ uni Universal (universa)
+ uhv Helvetica (helvetic)
+ upl Palatino (palatino)
+ utm Times (times)
+ uzc Zapf Chancery (zapfchan)
+ ============= ===============================
+
+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
+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.
+
+Alternatively, T7 could be used for math alphabets (if it ever happens to
+materialise).
+
+Upright small Greek letters in ``\mathrm`` would enable the specification of
+Myons, Pions, alpha-particles, photons, and neutrinos without special
+packages. (With mathdesign_, this is already possible today.)
+
+Implementation
+**************
+
+Identification
+==============
+::
+
+ \NeedsTeXFormat{LaTeX2e}
+ \ProvidesPackage{isomath}
+ [2008/06/23 v0.1 typeset math according to International Standard ISO 31]
+
+Requirements
+============
+
+fixmath
+-------
+
+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 font family below.)
+::
+
+ \RequirePackage{fixmath}
+
+kvoptions
+---------
+
+The kvoptions_ package in the oberdiek_ bundle facilitates the setup of
+package options and provides a key=value interface (based on keyval_)::
+
+ \RequirePackage{kvoptions}
+
+Options
+=======
+
+rmdefault
+---------
+
+Alternative family for roman math fonts. The default is to use the
+corresponding text font family (``\rmdefault``) in OMS encoding.
+`Table 2`_ lists some fonts where a different setting is advised.
+::
+
+ \DeclareStringOption[\rmdefault]{rmdefault}
+
+sfdefault
+---------
+
+Alternative family for sans-serif math fonts. The default is to use the
+corresponding text font family (``\sfdefault``) in OMS encoding.
+
+Computer Modern Sans Serif (cmss) has no OMS encoded variant. Nor have many
+derivatives (lmss, aess, ...). Actually, there are only a few OML-encoded
+sans-serif fonts (all slanted/italic):
+
+:zavm: arev_ (Vera Sans with math extension, large x-hight)
+:cmbr: cmbright_ (Computer Modern Bright, slightly lighter than cmss)
+:iwona: iwona_ (Humanistic Sans Serif, some shapes very similar to roman)
+:hvm: hvmath_ (Helvetica Math, commercial, free bitmap version)
+:llcmm: lxfonts_ (LX Fonts, very wide, excentric, large x-hight, new in 2008)
+
+For most fonts (especially CM and related), ``[sfdefault=cmbr]`` is the
+recommended setting.
+
+::
+
+ \DeclareStringOption[\sfdefault]{sfdefault}
+
+
+TODO
+ Allow scaling?
+
+
+reuseMathalphabets
+------------------
+
+The definition of new `math alphabets`_ can lead to a "too many math
+alphabets used in version normal" error.
+
+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
+might use a different font).
+
+::
+
+ \DeclareBoolOption{reuseMathalphabets}
+
+Caution: Do not use ``reuseMathalphabets`` together with ``OMLmathbf`` or
+``OMLmathsf``.
+
+
+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.
+
+Setting these options enables access to small Greek letters in different
+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
+* many font packages define an italic font as OML replacement for a roman
+ font.
+
+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::
+
+ \ProcessKeyvalOptions*
+
+Declarations
+============
+
+Math alphabets
+--------------
+
+In math, LaTeX uses "absolute" fontnames instead of a selection by family,
+shape, and weight (see the [fntguide]_ for the rationale).
+
+We define a math alphabet for every required font variant and optionally
+re-define 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). ::
+
+ \ifisomath@reuseMathalphabets
+ \DeclareMathAlphabet{\mathbf}{OML}{\isomath@rmdefault}{bx}{it}
+ \def\mathbold{\mathbf}
+ \else
+ \DeclareMathAlphabet{\mathbold}{OML}{\isomath@rmdefault}{bx}{it}
+ \fi
+
+mathsans
+""""""""
+
+For *italic sans-serif*, we define a new alphabet named ``\mathsans`` (in
+analogy to ``\mathbold``). As this typeface is not required by ISO 31, it is
+only defined if the ``OMLmathsans`` option is set::
+
+ \ifisomath@OMLmathsans
+ \DeclareMathAlphabet{\mathsans}{OML}{\isomath@sfdefault}{m}{it}
+ \fi
+
+mathboldsans
+""""""""""""
+
+A *sans serif slanted bold* alphabet is needed for tensor symbols. With the
+reuseMathalphabets_ option, ``\mathsf`` is redefined and ``\mathboldsans``
+made an alias::
+
+ \ifisomath@reuseMathalphabets
+ \DeclareMathAlphabet{\mathsf}{OML}{\isomath@sfdefault}{bx}{it}
+ \def\mathboldsans{\mathsf}
+ \else
+ \DeclareMathAlphabet{\mathboldsans}{OML}{\isomath@sfdefault}{bx}{it}
+ \fi
+
+Redefine standard alphabets
+"""""""""""""""""""""""""""
+
+Redefine standard alphabets in `OML font encoding`_
+(if the corresponding `OML math alphabets`_ option is true). ::
+
+ \ifisomath@OMLmathrm
+ \SetMathAlphabet{\mathrm}{normal}{OML}{\isomath@rmdefault}{n}{n}
+ \fi
+ \ifisomath@OMLmathbf
+ \SetMathAlphabet{\mathbf}{normal}{OML}{\isomath@rmdefault}{b}{n}
+ \fi
+ \ifisomath@OMLmathsf
+ \SetMathAlphabet{\mathsf}{normal}{OML}{\isomath@sfdefault}{n}{n}
+ \fi
+ \ifisomath@OMLmathtt
+ \SetMathAlphabet{\mathtt}{normal}{OML}{\ttdefault}{n}{n}
+ \fi
+
+Command aliases
+---------------
+
+The following macros allow semantic markup of mathematical symbols.
+The symbols argument is typeset as proposed by ISO 31 and [typefaces]_.
+
+\\vectorsym
+"""""""""""
+
+Symbols for vectors are typeset *boldface italic*::
+
+ \newcommand{\vectorsym}{\mathbold}
+
+For easier writing or to make existing documents conform to the standard,
+you might want to re-define the standard ``\vec`` command after loading this
+package (cf. the Examples_ section).
+
+\\matrixsym
+"""""""""""
+
+Symbols for matrices are typeset *boldface italic*, i. e. in the same face
+as vectors. ::
+
+ \newcommand{\matrixsym}{\mathbold}
+
+
+\\tensorsym
+"""""""""""
+
+Symbols for tensors are *sans-serif bold italic*::
+
+ \newcommand{\tensorsym}{\mathboldsans}
+
+Font mappings
+-------------
+
+Some font packages provide a matching math font but do not define a
+substitution in their ``*.fd`` files.
+
+We define the substitutions needed for the math alphabet definitions in this
+package. Ideally, these should become part of a more complete set of
+definitions in the package's ``*.fd`` files:
+
+Mathpazo (Palatino) ppl -> zplm ::
+
+ \DeclareFontFamily{OML}{ppl}{\skewchar\font127}
+ \DeclareFontShape{OML}{ppl}{m}{it}{<-> ssub * zplm/m/it}{}
+ \DeclareFontShape{OML}{ppl}{bx}{it}{<-> ssub * zplm/b/it}{}
+
+Arev (arev): fav -> zavm ::
+
+ \DeclareFontFamily{OML}{fav}{}
+ \DeclareFontShape{OML}{fav}{m}{it}{<->ssub * zavm/m/it}{}
+ \DeclareFontShape{OML}{fav}{bx}{it}{<->ssub * zavm/b/it}{}
+
+LX Fonts (lxfonts): llcmss -> llcmm ::
+
+ % repeat font declarations from lxfonts.sty
+ \DeclareFontFamily{OML}{llcmm}{\skewchar\font'177}
+ \DeclareFontShape{OML}{llcmm}{m}{it}{<-> lcmmi8}{}
+ \DeclareFontShape{OML}{llcmm}{bx}{it}{<-> lcmmib8}{}
+
+ \DeclareFontFamily{OML}{llcmss}{}
+ \DeclareFontShape{OML}{llcmss}{m}{it}{<-> ssub * llcmm/m/it}{}
+ \DeclareFontShape{OML}{llcmss}{bx}{it}{<-> ssub * llcmm/bx/it}{}
+
+
+No declarations below this point::
+
+ \endinput
+
+
+References
+**********
+
+.. [typefaces] `Typefaces for Symbols in Scientific Manuscripts`:
+ http://physics.nist.gov/Document/typefaces.pdf
+
+.. [fonts-for-symbols] `On the use of italic and roman fonts for symbols in
+ scientific text`, (Revised December 1999):
+ http://old.iupac.org/standing/idcns/fonts_for_symbols.html
+
+.. [SI-brochure] `The International System of Units (SI)`:
+ http://www.bipm.org/en/si/si_brochure/
+
+.. [encguide] `LaTeX font encodings`:
+ http://dante.ctan.org/CTAN/macros/latex/doc/encguide.pdf
+
+.. [fntguide] `LaTeX 2e font selection`:
+ http://dante.ctan.org/CTAN/macros/latex/doc/fntguide.pdf
+
+.. see also
+ [koma-mail] Custom font substitution: http://www.komascript.de/node/823
+
+ [Green-Book] `Quantities, Units and Symbols in Physical Chemistry`,
+ 3rd edition, RSC Publishing, Cambridge 2007:
+ [ISBN 0 85404 433 7; ISBN-13 978 0 85404 433 7]
+
+.. Links
+.. *****
+
+.. _BIPM: http://www.bipm.org/
+.. _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
+.. _cmbright: http://dante.ctan.org/CTAN/help/Catalogue/entries/cmbright.html
+.. _eulervm: http://dante.ctan.org/CTAN/help/Catalogue/entries/eulervm.html
+.. _fixmath: http://dante.ctan.org/CTAN/help/Catalogue/entries/fixmath.html
+.. _fix-cm: http://dante.ctan.org/CTAN/help/Catalogue/entries/fix-cm.html
+.. _fourier: http://dante.ctan.org/CTAN/help/Catalogue/entries/fourier.html
+.. _hvmath: http://dante.ctan.org/CTAN/help/Catalogue/entries/hvmath.html
+.. _ifthen: http://dante.ctan.org/CTAN/help/Catalogue/entries/ifthen.html
+.. _iwona: http://dante.ctan.org/CTAN/help/Catalogue/entries/iwona.html
+.. _kpfonts: http://dante.ctan.org/CTAN/help/Catalogue/entries/kpfonts.html
+.. _kvoptions: http://dante.ctan.org/CTAN/help/Catalogue/entries/kvoptions.html
+.. _keyval: http://dante.ctan.org/CTAN/help/Catalogue/entries/keyval.html
+.. _lxfonts: http://dante.ctan.org/CTAN/help/Catalogue/entries/lxfonts.html
+.. _mathdesign: http://dante.ctan.org/CTAN/help/Catalogue/entries/mathdesign.html
+.. _mathpazo: http://dante.ctan.org/CTAN/help/Catalogue/entries/mathpazo.html
+.. _oberdiek: http://dante.ctan.org/CTAN/help/Catalogue/entries/oberdiek.html
+.. _sfmath: http://dtrx.de/od/tex/sfmath.html
+.. _pxfonts: http://dante.ctan.org/CTAN/help/Catalogue/entries/pxfonts.html
+.. _tmmath: http://dante.ctan.org/CTAN/help/Catalogue/entries/tmmath.html
+.. _txfonts: http://dante.ctan.org/CTAN/help/Catalogue/entries/txfonts.html