summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-09-18 00:10:58 +0000
committerKarl Berry <karl@freefriends.org>2010-09-18 00:10:58 +0000
commit3e043cb9a8d83174690ec924925f69217e3f1fcb (patch)
tree062b6cd49afe87309be093ad755e258b853bd2e5 /Master/texmf-dist/doc/latex/isomath/isomath.sty.txt
parent079fd1cddf588d6f323494351c5f11cccb6f2381 (diff)
isomath update (24aug10)
git-svn-id: svn://tug.org/texlive/trunk@19786 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/isomath/isomath.sty.txt')
-rw-r--r--Master/texmf-dist/doc/latex/isomath/isomath.sty.txt715
1 files changed, 130 insertions, 585 deletions
diff --git a/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt b/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt
index c133b50b45e..2c7405d7988 100644
--- a/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt
+++ b/Master/texmf-dist/doc/latex/isomath/isomath.sty.txt
@@ -1,409 +1,25 @@
-isomath: Math for scientists
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+isomath.sty: Math for scientists
+********************************
-:Copyright: © 2008, 2009 Günter Milde
+:Copyright: © 2008, 2010 Günter Milde
:Licence: This work may be distributed and/or modified under the
- conditions of the `LaTeX Project Public License`_, either
- version 1.3 of this license or (at your option) any later version.
+ conditions of the `LaTeX Project Public License`_, either
+ version 1.3 of this license or (at your option) any later version.
-: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 the International Standard ISO 31
-`Quantities and units` [ISO-31]_.\ [#]_
-
-The traditional `LaTeX math style` deviates in some points from this rules:
-
-* The ``\vec`` command produces an array accent, while ISO 31 recommends
- a *bold italic* typeface for vector symbols.
-
-* 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.
-
-* There is no provision for typesetting letters in *sans-serif bold italic*
- recommended for typesetting tensor symbols.
-
-Some of these points are adressed by `related packages`_, however
-there is currently no package (known to the author) that defines the
-*sans-serif bold italic* math alphabet needed for tensor symbols.
-
-.. [#] Summaries of these rules are free available, see [typefaces]_,
- [checklist]_, [fonts-for-symbols]_, and [SI-brochure]_.
-
-
-Features
-========
-
-The ``isomath.sty`` package facilitates the task to abide with ISO 31 when
-typesetting math with LaTeX:
-
-* Equal treatment of Latin and `Greek in math`_ via fixmath.sty_:
-
- + Greek letters change shape together with Latin letters if a different
- math alphabet is used.
-
- + Uppercase Greek letters are typeset in italic style by default.
-
- + Upright Greek letters can be made available through the ``\mathrm``
- and ``\mathbf`` alphabets, if the corresponding fonts support the
- `OML font encoding`_.
-
-* The `command aliases`_ ``\vectorsym``, ``\matrixsym``, and ``\tensorsym``
- allow semantic markup. They print the argument in 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 no substitution definition in their ``*.fd``
- files.
-
-
-Usage
-=====
-
-Make sure that LaTeX can find ``isomath.sty`` and insert the command
-``\usepackage{isomath}`` in the document preamble.
-
-For package options, see the Options_ section below.
-
-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}
-
- Define also a slanted sans-serif math alphabet::
-
- \usepackage[sfdefault=cmbr,OMLmathsans]{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}`` produces a bold upright pi symbol.
-
-Related packages
-================
-
-A set of packages at CTAN also defines Greek letters as ``\mathalpha`` and
-provide the ``\mathbold`` alphabet (in OML):
-
-* arev_ (Arev/Vera Sans)
-* cmbright_ (CM Bright)
-* eulervm_ (Euler Math)
-* fixmath_ (Computer Modern)
-* hvmath_ (HV-Math/Helvetica)
-* mathpazo_ (Palatino)
-* tmmath_ (TM-Math/Times)
-
-This package requires and extends fixmath.sty_.
-
-The cmbright_ package provides *sans serif* and *sans-serif bold* fonts for
-the ``\mathsans`` and ``\mathboldsans`` alphabets that match with Computer
-Modern and derivatives.
-
-Conflicts
----------
-
-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 the additional definitions in isomath lead to a "too many
-math alphabets used in version normal" error. The error can be avoided with
-the reuseMathAlphabets_ option.
-
-.. [#] However, it is possible to use the symbols from `fourier`_ together
- with math alphabets from another package, e.g `mathdesign`_::
-
- \usepackage{fourier}
- \usepackage[OMLmathbf,rmdefault=mdput,sfdefault=cmbr]{isomath}
-
-
-Greek in Math
-=============
-
-IUPAC_'s [fonts-for-symbols]_ guide says:
-
- 2. The overall rule is that symbols representing physical quantities (or
- variables) are italic, but symbols representing units, or labels, are
- roman. [...]
-
- 3. The above rule **applies equally to letter symbols from both the Greek
- and the Latin alphabet**, although authors often appear to resist
- putting Greek letters into italic.
-
-[emphasis by the author]. In contrast, the standard LaTeX style treats Greek
-symbols as invariant operators with lower case italic and upper case upright.
-
-Unicode Math Support
---------------------
-
-The technical report `Unicode Support for Mathematics` [tr25]_ lists
-"lphanumeric symbols encountered in mathematics"in table 2 `Mathematical
-Alphabets`.
-
-The Unicode block `mathematical alphanumeric symbols`_ provides style
-variants for Latin and Greek letters and digits. It is labelled "to be used
-for mathematical variables where style variations are important
-semantically".
-
-.. _table 1:
-
-.. table:: Styles in the `mathematical alphanumeric symbols`_
- Unicode block
- :class: booktab
-
- ================= ==== ================= ============================
- Style LGD LaTeX macro Package, Comment
- [#]_
- ================= ==== ================= ============================
- bold LGD ``\mathbf`` no Greek
-
- italic LG ``\mathit`` no Greek
- \ ``\mathnormal`` small Greek but
- old-style roman Digits
- bold italic LG ``\mathbold`` fixmath and friends
- \ ``\boldsymbol`` ams
- script L ``\mathcal`` or only capital Latin
- (calligraphic) ``\mathscr``
- bold script L
- fraktur L ``\mathfrak`` eufrak
- double-struck L D ``\mathbb`` bbold, mathbbol,
- mbboard
- \ ``\mathbbm`` bbm
- \ ``\mathds`` dsfont
- bold fraktur L
- sans-serif L D ``\mathsf`` no Greek
- sans-serif bold LGD
- sans-serif italic L ``\mathsans`` isomath
- sans bold italic LG ``\mathboldsans`` isomath
- monospace L D ``\mathtt`` no Greek
- ----------------- ---- ----------------- ----------------------------
- *Not in the mathematical alphanumeric symbols block*:
- ---------------------------------------------------------------------
- plain LGD ``\mathrm`` no Greek
- \ ``\mathnormal`` capital Greek
- ================= ==== ================= ============================
-
-.. [#] LGD: **L**\ atin, **G**\ reek, **D**\ igits
-
-
-OML font encoding
------------------
-
-*OML* is the only established font encoding providing Latin and Greek
-letters in one font. (The text font encoding *LGR* is Greek-only while *T7*
-is just a "reserved name" for a standard Greek encoding.)
-
-Definition
-""""""""""
-
-The `LaTeX font encodings` guide [encguide]_ names OML `TeX math italic` and
-defines:
-
- The OML encoding contains italic Latin and Greek letters for use in
- mathematical formulas (typically used for variables) together with some
- symbols.
-
-However, the reference to **italic** letters seems to be a description of
-the *state of the art* rather than a necessary restriction:
-
-* There is only one OML encoded font in the Computer Modern fonts:
- `Computer Modern Math Italic` (cmmi).
-
-* 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 set up OML encoded math
- alphabets in roman {n} as well as italic {it} shape without conflicts.
-
-* The name `TeX math italic` can be interpreted as "encoding *of* `Computer
- Modern Math Italic`" rather than "encoding *for* math italic" fonts.
-
- A less confusing name would be `TeX math letters` or `Original/Old
- Math Letters`. The latter would also explain the acronym OML.
-
-A more inclusive definition would be:
-
- The OML encoding contains Latin and Greek letters for use in mathematical
- formulas (typically used for variables) together with some symbols.
- It first appeared in the `Computer Modern Math Italic` (cmmi) font.
-
-
-
-Support
-"""""""
-
-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 2:
-
-.. 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 x
- mdput Math Design Utopia x x x x
- mdugm Math Design Garamond x 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_ or sfdefault_ options.
-
-.. _table 3:
-
-.. 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 a LaTeX equivalent of the `Mathematical
-Alphanumeric Symbols`_ Unicode block.
-
-This should be (relatively) easy to achieve via virtual fonts when the
-glyphs for the Greek letters already exist. Examples are Latin Modern,
-Kerkis, GFS-Neohellenic, LX-Fonts and KP-Serif.
-
-Alternatively, the T7 encoding could be used for math alphabets (if it ever
-happens to materialise).
-
-Upright small Greek letters in ``\mathrm`` would enable the specification of
-the constant pi, Myons, Pions, alpha-particles, photons, and neutrinos
-without special packages. (With mathdesign_, this is already possible
-today.)
-
-
-Implementation
-**************
-
-Identification
-==============
-::
+:Identification:
+ ::
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{isomath}
- [2009/06/19 v0.3 typeset math according to International Standard ISO 31]
+ [2010/08/23 v0.4 math according to ISO 31]
+
+: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.
History
--------
+=======
.. class:: borderless
@@ -415,124 +31,87 @@ History
\ option reuseMathalphabets -> reuseMathAlphabets.
0.3 2009-06-19 documentation update;
\ fix OMLmathrm and OMLmathsans definitions;
-\ switch license to LPPL
+\ switch license to LPP.
+0.4 2010-08-23 split user documentation from literate source;
+\ option ``scaled``;
+\ documentation update.
=== ============ ========================================================
+.. contents::
+
Requirements
============
fixmath.sty
-----------
-
The package fixmath_ by Walter Schmidt defines Greek letters as symbols
-of type ``\mathalpha`` and takes them from the "letters" SymbolFont in
-``\mathnormal`` (as opposed to "operators" in ``fontmath.ltx``).
+of type ``\mathalpha`` and takes them from the ``letters`` SymbolFont in
+``\mathnormal`` (as opposed to ``operators`` in ``fontmath.ltx``).
fixmath_ also defines the ``\mathbold`` alphabet, setting it to ``cmm``.
-However, this definition will be overwritten with a configurable value for
-the font family below.)
+This definition will be overwritten with a configurable value for
+the font family below.
::
\RequirePackage{fixmath}
-.. caution::
-
- After loading fixmath, placing Greek letters in a math alphabet, e.g.
- ``\mathrm{k\Omega}``, can lead to garbage, as the standard math alphabets
- are usually taken from OT1 encoded fonts that have ligatures and
- non-alpha symbols in place of the small Greek letters.
-
- If the chosen font supports the `OML font encoding`_, you can use the
- options for `OML math alphabets`_. Otherwise, place Greek letters
- outside the math alphabet command.
-
- Some packages provide ``\up*`` or ``\var*`` macros for upright Greek
- letters, e.g. ``\mathrm{k}\upOmega``.
-
-
+
kvoptions.sty
-------------
-
The kvoptions_ package in the oberdiek_ bundle facilitates the setup of
package options and provides a key=value interface (based on keyval_)::
\RequirePackage{kvoptions}
+
Options
=======
rmdefault
---------
-
-Alternative family for roman math fonts. The default is to use the
-corresponding text font family (``\rmdefault``) in OML encoding.
-`Table 3`_ lists some fonts where a different setting is advised.
-
+Family for roman math fonts. Must be available in OML
+encoding. The default is to use the corresponding text font family
+(``\rmdefault``).
::
\DeclareStringOption[\rmdefault]{rmdefault}
sfdefault
---------
+Family for sans-serif math fonts. The default selects `CM Bright`, as
+most sans serif fonts are not available in OML encoding::
-Alternative family for sans-serif math fonts. The default is to use the
-corresponding text font family (``\sfdefault``) in OML encoding.
-
-Computer Modern Sans Serif (cmss) has no OML 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[cmbr]{sfdefault}
+
+scaled
+------
+The sans-serif fonts, ``fav`` (Arev), ``llcmss`` (LX Fonts), and
+``iwona`` can be scaled with the ``scaled`` option.
::
- \DeclareStringOption[\sfdefault]{sfdefault}
+ \DeclareStringOption[1.0]{scaled}
+ % Use a key definition like in inconsolata.sty (cf. also helvet.sty)?
+ % \define@key{isomath}{scaled}[1.0]{\def\isomath@scaled{s*[#1]}}
-TODO
- Allow scaling?
-
-
reuseMathAlphabets
------------------
+The definition of new `math alphabets`_ can lead to a “too many math
+alphabets used in version normal” error.
-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, this toggles the math-mode off and
-might use a different font).
-
+As a workaround, this option tells `isomath` to re-use the existing
+``\mathbf`` and ``\mathsf`` alphabets for *italic* bold and sans-serif
+bold.
::
\DeclareBoolOption{reuseMathAlphabets}
-.. caution::
- Do not use ``reuseMathAlphabets`` together with the ``OMLmathbf`` or
- ``OMLmathsf`` options.
-
-
-OML math alphabets
-------------------
-
-With Greek letters defined as ``\mathalpha``, the math alphabets are
-expected to be in `OML font encoding`_. Unfortunately, the standard math
-alphabets are usually taken from OT1 encoded fonts that have ligatures and
-non-alpha symbols in place of the small Greek letters.
-
-The following options cause isomath to (re)define `math alphabets`_ in OML
-encoding::
+
+OMLmath*
+--------
+The following options cause `isomath` to (re)define the corresponding
+`math alphabets`_ in OML encoding::
\DeclareBoolOption{OMLmathrm}
\DeclareBoolOption{OMLmathbf}
@@ -540,20 +119,16 @@ encoding::
\DeclareBoolOption{OMLmathsans}
\DeclareBoolOption{OMLmathtt}
-Setting these options enables access to small Greek letters in different
-shapes with e.g. ``\mathrm{\pi}`` — *if an OML encoded font is available*.
-Currently, support for the `OML font encoding`_ is rather limited:
+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, only the mathdesign_ fonts support roman in
+OML encoding.
-* only the mathdesign_ fonts support 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.
+With some packages, these options can result in a “too many math alphabets
+used in version normal” error.
Process Options
---------------
-
Process the options with ``kvoptions`` extensions::
\ProcessKeyvalOptions*
@@ -562,27 +137,35 @@ Process the options with ``kvoptions`` extensions::
Declarations
============
+
Math alphabets
--------------
-In math, LaTeX uses "absolute" fontnames instead of a selection by family,
-shape, and weight because typefaces have a semantic meaning [fntguide]_.
-This correlates with the `Unicode math support`_ where the
-`mathematical alphanumeric symbols`_ block defines distinct Unicode
-characters for Greek and Latin letters in different typefaces.
+In math, LaTeX uses “absolute” fontnames instead of a selection by
+family, shape, and weight because typefaces have a semantic meaning
+(see fntguide_).
-Isomath defines a math alphabet for every required font variant and
-optionally re-defines the standard math alphabets in `OML font encoding`_.
-Unfortunately, the number of math alphabets in one math version is limited
-to 16, so we have to be carefull not to exceed this.
+`isomath` defines a math alphabet for every required font variant and
+optionally re-defines the standard math alphabets in `OML` font encoding.
-mathbold
-""""""""
+Unfortunately, the number of math alphabets in one math version is
+limited to 16, so we have to be carefull not to exceed this. The
+``reuseMathAlphabets`` option reduces this number by two, with the
+side effect of italic shape with ``\mathbf`` and ``\mathsf`` commands::
+ \ifisomath@reuseMathAlphabets
+ \PackageWarningNoLine{isomath}{%
+ Re-using math alphabet `mathsf' for \protect \mathboldsans
+ \MessageBreak and `mathbf' for \protect \mathbold
+ }
+ \fi
+
+mathbold
+~~~~~~~~
The *italic bold* math alphabet is named ``\mathbold`` like in
-`related packages`_. With the reuseMathAlphabets_ option, ``\mathfb``
-is redefined and ``\mathbold`` made an alias (overwriting existing
-definitions)::
+fixmath_ and related packages. With the reuseMathAlphabets_ option,
+the roman bold math alphabet ``\mathbf`` is redefined and
+``\mathbold`` made an alias (overwriting existing definitions)::
\ifisomath@reuseMathAlphabets
\DeclareMathAlphabet{\mathbf}{OML}{\isomath@rmdefault}{bx}{it}
@@ -592,8 +175,7 @@ definitions)::
\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::
@@ -603,11 +185,11 @@ is only defined if the ``OMLmathsans`` option is set::
\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::
+~~~~~~~~~~~~
+A *sans serif slanted bold* alphabet is needed for tensor symbols.
+With the reuseMathAlphabets_ option, the upright sans serif math
+alphabet ``\mathsf`` is redefined and ``\mathboldsans`` made an
+alias::
\ifisomath@reuseMathAlphabets
\DeclareMathAlphabet{\mathsf}{OML}{\isomath@sfdefault}{bx}{it}
@@ -617,10 +199,10 @@ made an alias::
\fi
Redefine standard alphabets
-"""""""""""""""""""""""""""
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Redefine standard alphabets in `OML font encoding`_
-if the corresponding `OML math alphabets`_ option is true::
+Redefine standard alphabets in `OML` font encoding
+if the corresponding `OMLmath*`_ option is true::
\ifisomath@OMLmathrm
\SetMathAlphabet{\mathrm}{normal}{OML}{\isomath@rmdefault}{m}{n}
@@ -639,18 +221,18 @@ Command aliases
---------------
The following macros allow semantic markup of mathematical symbols.
-The argument is typeset as proposed by ISO 31 and [typefaces]_.
+The argument is typeset as proposed by ISO 31 and
+`Typefaces for Symbols in Scientific Manuscripts`_.
\\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).
+package (cf. the Examples section of the documentation).
Attention: Some fonts (CM, Latin Modern, ...) have old-style figures in
their math italic version. The Null vector must not be written ``\vec{0}``
@@ -659,8 +241,7 @@ in this case. Use e.g. ``\mathbf{0}``, ``\boldsymbol{0}`` (with AMS math) or
alias for a bold vector.
\\matrixsym
-"""""""""""
-
+~~~~~~~~~~~
Symbols for matrices are typeset *boldface italic*, i. e. in the same face
as vectors. ::
@@ -668,114 +249,78 @@ as vectors. ::
\\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.
+Some font packages provide matching text and 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:
+We define the substitutions needed for the math alphabet definitions
+in this package. Ideally, these should become part of the package's
+``*.fd`` files.
-Mathpazo (Palatino) ppl -> zplm ::
+For details about the font definition macros see the fntguide_.
+
+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 (see omlzavm.fd): fav -> zavm ::
+
+Scaling
+~~~~~~~
+Scale the ``fav`` (Arev), ``llcmss`` (LX Fonts), and ``iwona`` fonts
+by the value of the ``scaled`` option.
- \DeclareFontFamily{OML}{fav}{\skewchar \font =127}
- \DeclareFontShape{OML}{fav}{m}{it}{<->ssub * zavm/m/it}{}
- \DeclareFontShape{OML}{fav}{bx}{it}{<->ssub * zavm/b/it}{}
+To get scaled versions of a font, you cannot use the ``ssub``
+`size function`, but must use the empty function or ``s`` with the font
+file as argument [found by experiment, GM 2010-01-28].
+
+Arev (see omlzavm.fd): fav <-> zavm ::
+
+ \DeclareFontFamily{OML}{fav}{\skewchar\font127}
+ \DeclareFontShape{OML}{fav}{m}{it}{<-> s * [\isomath@scaled] zavmri7m}{}
+ \DeclareFontShape{OML}{fav}{bx}{it}{<-> s * [\isomath@scaled] zavmbi7m}{}
LX Fonts (see lxfonts.sty): llcmss -> llcmm ::
- \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}{}
+ \DeclareFontFamily{OML}{llcmss}{\skewchar\font'177}
+ \DeclareFontShape{OML}{llcmss}{m}{it}{<-> s * [\isomath@scaled] lcmmi8}{}
+ \DeclareFontShape{OML}{llcmss}{bx}{it}{<-> s * [\isomath@scaled] lcmmib8}{}
+Ivona (see ``omliwona.fd``)::
+
+ \DeclareFontFamily{OML}{iwona}{}
+ \DeclareFontShape{OML}{iwona}{m}{it}{<-> s * [\isomath@scaled] mi-iwonari}{}
+ \DeclareFontShape{OML}{iwona}{bx}{it}{<-> s * [\isomath@scaled] mi-iwonabi}{}
No declarations below this point::
\endinput
-
-References
-**********
-
-.. [ISO-31] International Standard 31 `Quantities and units`,
- (ISO 31-0:1992 to ISO 31-14:1992):
- http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_tc_browse.htm?commid=46202
-
-.. [typefaces] `Typefaces for Symbols in Scientific Manuscripts`:
- http://physics.nist.gov/Document/typefaces.pdf
-
-.. [checklist] `SI Unit rules and style conventions`
- Check List for Reviewing Manuscripts:
- http://physics.nist.gov/cuu/Units/checklist.html
-
-.. [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
-
-.. [tr25] `Unicode Support for Mathematics`, Unicode Technical Report #25:
- http://www.unicode.org/reports/tr25/
-
-.. see also
- [koma-mail] Custom font substitution: http://www.komascript.de/node/823
-
- [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
.. *****
.. _LaTeX Project Public License: http://www.latex-project.org/lppl.txt
-.. _BIPM: http://www.bipm.org/
-.. _IUPAC: http://iupac.org/
-.. _IUPAP: http://www.iupap.org/
-.. _NIST: http://physics.nist.gov/
-.. _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
+.. _fntguide: http://dante.ctan.org/CTAN/macros/latex/doc/fntguide.pdf
.. _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
+.. _kvoptions: http://dante.ctan.org/CTAN/help/Catalogue/entries/kvoptions.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
+.. _mathematical alphanumeric symbols:
+ http://www.unicode.org/charts/PDF/U1D400.pdf
.. _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
+.. _`Typefaces for Symbols in Scientific Manuscripts`:
+ http://physics.nist.gov/Document/typefaces.pdf