summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/unicode-math
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-10-02 21:58:46 +0000
committerKarl Berry <karl@freefriends.org>2017-10-02 21:58:46 +0000
commitfd5f690d11016435384d6ae952eb94789cf60746 (patch)
treee565838dbddeb3874202f5fa5c307cfaa7fbb208 /Master/texmf-dist/doc/latex/unicode-math
parentb05bbbaa1cd9b63551731cdd1577f90225da2079 (diff)
unicode-math (2oct17)
git-svn-id: svn://tug.org/texlive/trunk@45453 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/unicode-math')
-rw-r--r--Master/texmf-dist/doc/latex/unicode-math/CHANGES.md211
-rw-r--r--Master/texmf-dist/doc/latex/unicode-math/CONTRIBUTING.md41
-rw-r--r--Master/texmf-dist/doc/latex/unicode-math/README.md211
-rw-r--r--Master/texmf-dist/doc/latex/unicode-math/unicode-math-doc.tex102
-rw-r--r--Master/texmf-dist/doc/latex/unicode-math/unicode-math.pdfbin384713 -> 346785 bytes
-rw-r--r--Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.ltx22
-rw-r--r--Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.pdfbin1611964 -> 1615724 bytes
7 files changed, 323 insertions, 264 deletions
diff --git a/Master/texmf-dist/doc/latex/unicode-math/CHANGES.md b/Master/texmf-dist/doc/latex/unicode-math/CHANGES.md
new file mode 100644
index 00000000000..6b01a0bfee8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/unicode-math/CHANGES.md
@@ -0,0 +1,211 @@
+CHANGE HISTORY
+--------------
+
+- v0.8g (2017/10/02)
+
+ * Better use of scriptstyle sizes in LuaTeX (I think a regression).
+ * Fix regression (`\mathbf` etc. not being set automatically) caused by the renaming of a `fontspec` internal command.
+ * Minor documentation improvements.
+ * (Only relevant for me: I've also disabled the test suite almost entirely to begin a re-write for ‘continuous integration’.)
+
+- v0.8f (2017/08/02)
+
+ * Emergency fix (thanks Bruno) for another bug revealed by `expl3` update.
+
+- v0.8e (2017/07/30)
+
+ * Add `\surd` to access the sqrt symbol.
+ * Fix bug exposed by `expl3` update to booleans.
+ * Add Deja Vu Math TeX Gyre in list of symbols.
+ * Add `\sime` alias for `\simeq` and `\nsimeq` for `\nsime`.
+ (For negations it's helpful when they have consistent naming.)
+
+- v0.8d (2017/01/25)
+
+ * `vargreek-shape=TeX` and `vargreek-shape=unicode` package options dropped; for consistency and compatibility, `\phi` and `\epsilon` should and will now behave the same as in `TeX`.
+ * On that note, when using control sequences such as `\mbfitsansvarphi` (and so on), there were a few faulty definitions. The new behaviour is to consistenyl define the `varphi` and `varepsilon` ones as those with the "curly" designs.
+ * Add `\wideoverbar`, `\widebreve`, `\widecheck`.
+ * Add `\mathsection`, `\mathparagraph`.
+ * Remove `\mupvarbeta`, `upold(Kk)oppa`, `\up(Ss)tigma`, `\up(Kk)oppa`, `\up(Ss)ampi` — none of these are maths symbols.
+ * `!` (`\mathexclam`) changed from `\mathpunct` to `\mathclose` for backwards compatibility with TeX.
+
+- v0.8c (2015/09/24)
+
+ * Add `\over(left/right)harpoon` as "wide" accents.
+ * Add RTL mathematics operators `\arabicmaj` and `\arabichad`, which correspond to `U+1EEF0` and `U+1EEF1`, resp.
+ * Remove `catchfile` package dependency.
+ * Update some internal names to match expl3 standards.
+
+- v0.8b (2015/09/09)
+
+ * Bug fix: Use the "ucharcat" package to simplify some code that caused some headaches with \tl_rescan:nn.
+
+- v0.8a (2015/08/06)
+
+ * Fix bug with \vert, \|, \(l/r)vert, etc., displaying with the wrong characters.
+
+ * Improve documentation to properly reflect changes in v0.8 and fix some broken examples.
+
+ * No longer reset catcodes of : and @ during \setmathfont .
+
+ * Fix remapping of alphabets (needed for Minion Math) in cases such as:
+
+ \setmathfont[range=bfit->it]{MinionMath-Bold.otf}
+
+- v0.8 (2015/07/29) **Breaking changes in this update!**
+
+ * `\mathrm` (`\mathup`), `\mathit`, `\mathbf`, `\mathsf`, and `\mathtt` revert to their traditional LaTeX meanings; they are set up to match their equivalent text fonts unless specifically set using `\setmathrm` and friends from `fontspec` or the new `\setmathfontface` in `unicode-math`. These commands should be used for *multi*-letter identifiers.
+
+ * New "symbol" commands have been added, `\symrm` (`\symup`), `symit`, ..., to replace the behaviour of the old commands. These should be used for *single*-letter identifiers. See the package documentation for more detail on these and related commands.
+
+ * Package options `mathit=sym`, `mathbf=sym`, etc., reverse the changes above to revert to pre-v0.8 behaviour for `\mathXYZ`. Regardless of package option, `\symXYZ` always maps to symbols and `\mathtextXYZ` is provided for the traditional `\mathXYZ` font switch.
+
+ * New command `\setoperatorfont` to set the font used for commands such as `\sin` and `\cos`. Usage: `\setoperatorfont\mathbf` or any command defined with `\setmathfontface`.
+
+ * Traditional LaTeX `\DeclareMathAlphabet` now works again for legacy font-loading packages.
+
+ * Commands defined to "force" Greek letters with `\upbeta` and `\itbeta`, etc.
+
+ * Assorted bug fixes and minor changes.
+
+- v0.7e (2014/06/30)
+
+ * No longer assume fixltx2e has been loaded.
+ * Some ascii math symbols have been renamed with a \math... prefix, such as \mathquestion.
+ * Assume latest luaotfload is being used; no need for a separate unicode-math.lua script.
+ * Assorted typos and minor bugs.
+
+- v0.7e (2013/05/04)
+
+ * Track luaotfload updates.
+
+- v0.7d (2013/03/16)
+
+ * More expl3 changes missed first time around. (Sorry again.)
+
+- v0.7c (2013/02/25)
+
+ * The Latin Modern math font name changed TWICE. Only caught the first one.
+ Sorry for any inconvenience caused.
+
+- v0.7b (2013/02/22)
+
+ * Keep in sync with Latin Modern Math font name change.
+ * Keep in sync with expl3 changes.
+
+- v0.7a (2012/07/28)
+
+ * Keep in sync with expl3 changes.
+
+- v0.7 (2012/05/30): The TeX Live 2012 release.
+
+ * Most changes (and all significant ones) in this release thanks to Khaled
+ Hosny, who is now credited as an author of the package.
+ * Many improvements for XeTeX support to take advantage of the new engine
+ (v0.9998) in TL2012.
+ * As a result, `\resetmathfont` is no longer required.
+ * Improve `\not` to use pre-combined glyphs where possible.
+ * LM Math is loaded by default.
+ * Support bottom accents.
+ * And add `\wideutilde`.
+ * The ‘symbols’ document is somewhat better organised and contains
+ information on whether a symbol is defined in plain TeX or amssymb.
+ * Various other minor fixes and additions:
+ * `\underleftrightarrow` added for fonts that support it.
+ * Don’t overwrite mathtool’s `\overbracket` and `\underbracket`.
+ * Bug in `[range=...]` parsing fixed.
+ * Add `\longdivision`.
+ * Add `\lgroup` and `\rgroup`.
+ * Fix ‘moustache’ delimiters.
+ * `\openbox` renamed to `\mathvisiblespace`, since it is already defined
+ in amsthm as an empty box.
+
+- v0.6a (2011/09/19)
+
+ * Always a bug that slips through the cracks! Fixes `\left.` and `\right.`
+ * Add experimental package option `warnings-off=...` which allows warnings
+ to be suppressed on an individual basis.
+
+- v0.6 (2011/09/18)
+
+ * Keep in sync with fontspec internals
+ (sorry for the small delay where things were broken)
+ * Keep in sync with expl3 deprecated functions
+ * Math versions (finally) implemented; can now change maths fonts
+ mid-document without reinitialising everything
+ (thanks to Ulrike Fischer and Ulrik Vieth)
+ * Symbols file `unimath-symbols.pdf` now uses maths versions to compare
+ all of the OpenType maths fonts I currently have access to
+ * Over- and under- braces, brackets, and parentheses now work in XeTeX
+ (thanks to Claudio Beccari)
+ * Many internal changes, including a re-write of the `range` feature;
+ it should now be faster and more robust
+ * Tentative programmer's interface for querying the current math style:
+ `\l_um_mathstyle_tl`.
+ * Remove (outdated) interaction with beamer; you must specify
+ `professionalfonts` manually for now
+ * Quieten the console output when loading maths fonts with incomplete maths
+ style coverage
+ * Synonym added: `\lnot` -> `\neg`
+ * Two added Unicode symbols (names tentative): `\blanksymbol` and `\openbox`
+ (thanks to Apostolos Syropoulos)
+ * Fixed literal sub-/super-script input.
+
+- v0.5e (2011/07/31)
+
+ * Fix forward compatibility clash with deprecated expl3 functions (sorry)
+ * Command names are now `\protected`; this makes them safe to use in moving
+ arguments and so on
+ * Similarly to the change in v0.5c, the main math font is now loaded in
+ math family zero (equiv. to LaTeX's `operators` math font)
+ * `\mathring` added
+ * Ensure that a math font has been selected in order to prevent problems
+ in minimal documents (this will be unnecessary when the OpenType LM math
+ font is released)
+ * Documentation for which was which of epsilon/varepsilon was backwards!
+ (thank to Rasmus Villemoes for pointing this out)
+ * Spurious `\upUpsilon` removed (the one at U+03A5 is now the correct one)
+ * Typo when defining `\dprime` fixed
+ (thanks to Ulrik Vieth for these last two)
+ * Fix the math class of `\modtwosum`; it is now a large operator
+ (thanks to Michael Ummels)
+ * Move several LuaTeX-related patches to the `lualatex-math` package
+ * Fixed mathtool's `\cramped` in XeLaTeX usage
+
+- v0.5d (2011/01/30)
+
+ * Assorted improvements to LuaLaTeX support, including non-growing accents
+ available in LuaTeX v0.65 and later
+ * Improved behaviour with reading and using maths font dimensions
+ * Better compatibility with legacy maths packages and environments
+ (always more worked needed, though)
+ * Fix the default setting for "vargreek-shape"
+
+- v0.5c (2010/09/27)
+
+ * Fix a long-standing bug in XeLaTeX in which the "master" math
+ families 2 and 3 weren't being set; hence fraction rules and many other
+ parameters were not being set correctly
+ * Stay in sync with internal fontspec changes
+
+- v0.5b (2010/09/19): Tune-up
+
+ * Added missing symbols/synonyms:
+ \diamond \smallint \emptyset \hbar \backepsilon \eth
+ * \overline works for LuaLaTeX
+ * Fix \slash; previously, it overwrote the text definition
+ * \vartriangle now has the correct math class
+
+- v0.5a (2010/07/14): TeX Live 2010 release
+
+ * Numerous documentation improvements
+ * Bug fix against stray catcode changes
+ * Add `\mathcal` and `\mathbfcal` as distinct from the Script style;
+ these are only supported by the XITS fonts at present
+ * Small changes to the range of symbols offered (especially note that `\ac`
+ is now `\invlazys` to avoid acronym package clash)
+ * Superscripts are allowed after primes (as they should be)
+ * Numerous LuaLaTeX improvements, including roots and over/under braces.
+
+- v0.5 (2010/06/03): Initial CTAN release
+
diff --git a/Master/texmf-dist/doc/latex/unicode-math/CONTRIBUTING.md b/Master/texmf-dist/doc/latex/unicode-math/CONTRIBUTING.md
new file mode 100644
index 00000000000..860883abd29
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/unicode-math/CONTRIBUTING.md
@@ -0,0 +1,41 @@
+# Guidelines for issues and pull requests
+
+## Issues
+
+Thanks for taking the time to report an issue!
+Any apologies that I take longer, sometimes *way longer*, than I should to address them.
+
+There are two important key points for submitting an issue:
+
+* When submitting an issue, please include a *complete* minimal example.
+* When loading maths fonts, please do so by *filename* only.
+* If you are using a proprietary/unusual font, please try a maths font in TeX Live to see
+ if it exhibits the same behaviour; it's obviously much harder for me to test with fonts
+ I don't yet have or can't access.
+
+For example, this is a good minimal example:
+
+ \documentclass{article}
+ \usepackage{unicode-math}
+ \setmathfont{texgyrepagella-math.otf}
+ \begin{document}
+ \[
+ x^2 + y^2 = z^2
+ \]
+ \end{document}
+
+This is an example of a *bad* example:
+
+ \usepackage{unicode-math}
+ \setmathfont{TeX Gyre Pagella Math}
+
+ % later:
+ \[
+ x^2 + y^2 = z^2
+ \]
+
+## Pull Requests
+
+I'm usually not fussy! Generally I'll just be impressed you've taken the effort.
+
+If you are changing documentation only (i.e., no code changes), you can add `[ci skip]` to the commit message and the test suite won't be run to check that the changes haven't broken anything.
diff --git a/Master/texmf-dist/doc/latex/unicode-math/README.md b/Master/texmf-dist/doc/latex/unicode-math/README.md
index d10e0bc76fc..f2b352de8df 100644
--- a/Master/texmf-dist/doc/latex/unicode-math/README.md
+++ b/Master/texmf-dist/doc/latex/unicode-math/README.md
@@ -76,211 +76,7 @@ Latest developmental and archived historical versions are available from Github:
Please file bug reports with minimal examples:
> <http://github.com/wspr/unicode-math/issues>
-
-
-CHANGE HISTORY
---------------
-
-- v0.8f (2017/08/02)
-
- * Emergency fix (thanks Bruno) for another bug revealed by `expl3` update.
-
-- v0.8e (2017/07/30)
-
- * Add `\surd` to access the sqrt symbol.
- * Fix bug exposed by `expl3` update to booleans.
- * Add Deja Vu Math TeX Gyre in list of symbols.
- * Add `\sime` alias for `\simeq` and `\nsimeq` for `\nsime`.
- (For negations it's helpful when they have consistent naming.)
-
-- v0.8d (2017/01/25)
-
- * `vargreek-shape=TeX` and `vargreek-shape=unicode` package options dropped; for consistency and compatibility, `\phi` and `\epsilon` should and will now behave the same as in `TeX`.
- * On that note, when using control sequences such as `\mbfitsansvarphi` (and so on), there were a few faulty definitions. The new behaviour is to consistenyl define the `varphi` and `varepsilon` ones as those with the "curly" designs.
- * Add `\wideoverbar`, `\widebreve`, `\widecheck`.
- * Add `\mathsection`, `\mathparagraph`.
- * Remove `\mupvarbeta`, `upold(Kk)oppa`, `\up(Ss)tigma`, `\up(Kk)oppa`, `\up(Ss)ampi` — none of these are maths symbols.
- * `!` (`\mathexclam`) changed from `\mathpunct` to `\mathclose` for backwards compatibility with TeX.
-
-- v0.8c (2015/09/24)
-
- * Add `\over(left/right)harpoon` as "wide" accents.
- * Add RTL mathematics operators `\arabicmaj` and `\arabichad`, which correspond to `U+1EEF0` and `U+1EEF1`, resp.
- * Remove `catchfile` package dependency.
- * Update some internal names to match expl3 standards.
-
-- v0.8b (2015/09/09)
-
- * Bug fix: Use the "ucharcat" package to simplify some code that caused some headaches with \tl_rescan:nn.
-
-- v0.8a (2015/08/06)
-
- * Fix bug with \vert, \|, \(l/r)vert, etc., displaying with the wrong characters.
-
- * Improve documentation to properly reflect changes in v0.8 and fix some broken examples.
-
- * No longer reset catcodes of : and @ during \setmathfont .
-
- * Fix remapping of alphabets (needed for Minion Math) in cases such as:
-
- \setmathfont[range=bfit->it]{MinionMath-Bold.otf}
-
-- v0.8 (2015/07/29) **Breaking changes in this update!**
-
- * `\mathrm` (`\mathup`), `\mathit`, `\mathbf`, `\mathsf`, and `\mathtt` revert to their traditional LaTeX meanings; they are set up to match their equivalent text fonts unless specifically set using `\setmathrm` and friends from `fontspec` or the new `\setmathfontface` in `unicode-math`. These commands should be used for *multi*-letter identifiers.
-
- * New "symbol" commands have been added, `\symrm` (`\symup`), `symit`, ..., to replace the behaviour of the old commands. These should be used for *single*-letter identifiers. See the package documentation for more detail on these and related commands.
-
- * Package options `mathit=sym`, `mathbf=sym`, etc., reverse the changes above to revert to pre-v0.8 behaviour for `\mathXYZ`. Regardless of package option, `\symXYZ` always maps to symbols and `\mathtextXYZ` is provided for the traditional `\mathXYZ` font switch.
-
- * New command `\setoperatorfont` to set the font used for commands such as `\sin` and `\cos`. Usage: `\setoperatorfont\mathbf` or any command defined with `\setmathfontface`.
-
- * Traditional LaTeX `\DeclareMathAlphabet` now works again for legacy font-loading packages.
-
- * Commands defined to "force" Greek letters with `\upbeta` and `\itbeta`, etc.
-
- * Assorted bug fixes and minor changes.
-
-- v0.7e (2014/06/30)
-
- * No longer assume fixltx2e has been loaded.
- * Some ascii math symbols have been renamed with a \math... prefix, such as \mathquestion.
- * Assume latest luaotfload is being used; no need for a separate unicode-math.lua script.
- * Assorted typos and minor bugs.
-
-- v0.7e (2013/05/04)
-
- * Track luaotfload updates.
-
-- v0.7d (2013/03/16)
-
- * More expl3 changes missed first time around. (Sorry again.)
-
-- v0.7c (2013/02/25)
-
- * The Latin Modern math font name changed TWICE. Only caught the first one.
- Sorry for any inconvenience caused.
-
-- v0.7b (2013/02/22)
-
- * Keep in sync with Latin Modern Math font name change.
- * Keep in sync with expl3 changes.
-
-- v0.7a (2012/07/28)
-
- * Keep in sync with expl3 changes.
-
-- v0.7 (2012/05/30): The TeX Live 2012 release.
-
- * Most changes (and all significant ones) in this release thanks to Khaled
- Hosny, who is now credited as an author of the package.
- * Many improvements for XeTeX support to take advantage of the new engine
- (v0.9998) in TL2012.
- * As a result, `\resetmathfont` is no longer required.
- * Improve `\not` to use pre-combined glyphs where possible.
- * LM Math is loaded by default.
- * Support bottom accents.
- * And add `\wideutilde`.
- * The ‘symbols’ document is somewhat better organised and contains
- information on whether a symbol is defined in plain TeX or amssymb.
- * Various other minor fixes and additions:
- * `\underleftrightarrow` added for fonts that support it.
- * Don’t overwrite mathtool’s `\overbracket` and `\underbracket`.
- * Bug in `[range=...]` parsing fixed.
- * Add `\longdivision`.
- * Add `\lgroup` and `\rgroup`.
- * Fix ‘moustache’ delimiters.
- * `\openbox` renamed to `\mathvisiblespace`, since it is already defined
- in amsthm as an empty box.
-
-- v0.6a (2011/09/19)
-
- * Always a bug that slips through the cracks! Fixes `\left.` and `\right.`
- * Add experimental package option `warnings-off=...` which allows warnings
- to be suppressed on an individual basis.
-
-- v0.6 (2011/09/18)
-
- * Keep in sync with fontspec internals
- (sorry for the small delay where things were broken)
- * Keep in sync with expl3 deprecated functions
- * Math versions (finally) implemented; can now change maths fonts
- mid-document without reinitialising everything
- (thanks to Ulrike Fischer and Ulrik Vieth)
- * Symbols file `unimath-symbols.pdf` now uses maths versions to compare
- all of the OpenType maths fonts I currently have access to
- * Over- and under- braces, brackets, and parentheses now work in XeTeX
- (thanks to Claudio Beccari)
- * Many internal changes, including a re-write of the `range` feature;
- it should now be faster and more robust
- * Tentative programmer's interface for querying the current math style:
- `\l_um_mathstyle_tl`.
- * Remove (outdated) interaction with beamer; you must specify
- `professionalfonts` manually for now
- * Quieten the console output when loading maths fonts with incomplete maths
- style coverage
- * Synonym added: `\lnot` -> `\neg`
- * Two added Unicode symbols (names tentative): `\blanksymbol` and `\openbox`
- (thanks to Apostolos Syropoulos)
- * Fixed literal sub-/super-script input.
-
-- v0.5e (2011/07/31)
-
- * Fix forward compatibility clash with deprecated expl3 functions (sorry)
- * Command names are now `\protected`; this makes them safe to use in moving
- arguments and so on
- * Similarly to the change in v0.5c, the main math font is now loaded in
- math family zero (equiv. to LaTeX's `operators` math font)
- * `\mathring` added
- * Ensure that a math font has been selected in order to prevent problems
- in minimal documents (this will be unnecessary when the OpenType LM math
- font is released)
- * Documentation for which was which of epsilon/varepsilon was backwards!
- (thank to Rasmus Villemoes for pointing this out)
- * Spurious `\upUpsilon` removed (the one at U+03A5 is now the correct one)
- * Typo when defining `\dprime` fixed
- (thanks to Ulrik Vieth for these last two)
- * Fix the math class of `\modtwosum`; it is now a large operator
- (thanks to Michael Ummels)
- * Move several LuaTeX-related patches to the `lualatex-math` package
- * Fixed mathtool's `\cramped` in XeLaTeX usage
-
-- v0.5d (2011/01/30)
-
- * Assorted improvements to LuaLaTeX support, including non-growing accents
- available in LuaTeX v0.65 and later
- * Improved behaviour with reading and using maths font dimensions
- * Better compatibility with legacy maths packages and environments
- (always more worked needed, though)
- * Fix the default setting for "vargreek-shape"
-
-- v0.5c (2010/09/27)
-
- * Fix a long-standing bug in XeLaTeX in which the "master" math
- families 2 and 3 weren't being set; hence fraction rules and many other
- parameters were not being set correctly
- * Stay in sync with internal fontspec changes
-
-- v0.5b (2010/09/19): Tune-up
-
- * Added missing symbols/synonyms:
- \diamond \smallint \emptyset \hbar \backepsilon \eth
- * \overline works for LuaLaTeX
- * Fix \slash; previously, it overwrote the text definition
- * \vartriangle now has the correct math class
-
-- v0.5a (2010/07/14): TeX Live 2010 release
-
- * Numerous documentation improvements
- * Bug fix against stray catcode changes
- * Add `\mathcal` and `\mathbfcal` as distinct from the Script style;
- these are only supported by the XITS fonts at present
- * Small changes to the range of symbols offered (especially note that `\ac`
- is now `\invlazys` to avoid acronym package clash)
- * Superscripts are allowed after primes (as they should be)
- * Numerous LuaLaTeX improvements, including roots and over/under braces.
-
-- v0.5 (2010/06/03): Initial CTAN release
+See `CHANGES.md` for the complete listing of change history.
LICENCE
@@ -294,7 +90,8 @@ greater.
This work is author-maintained and consists of the files
-- unicode-math*.dtx,
+- unicode-math.dtx,
+- unicode-math-*.dtx,
- unicode-math-table.tex,
- unimath-example.ltx,
- unimath-symbols.ltx,
@@ -303,6 +100,8 @@ This work is author-maintained and consists of the files
the derived files
- unicode-math.lua,
+- unicode-math-xetex.sty,
+- unicode-math-luatex.sty,
- unicode-math.sty;
the compiled documentation files
diff --git a/Master/texmf-dist/doc/latex/unicode-math/unicode-math-doc.tex b/Master/texmf-dist/doc/latex/unicode-math/unicode-math-doc.tex
index 9f235da34a7..d23cab3b8dd 100644
--- a/Master/texmf-dist/doc/latex/unicode-math/unicode-math-doc.tex
+++ b/Master/texmf-dist/doc/latex/unicode-math/unicode-math-doc.tex
@@ -212,60 +212,67 @@ have been fantastic beta testers.
Load \pkg{unicode-math} as a regular \LaTeX\ package. It should be loaded
after any other maths or font-related package in case it needs to overwrite
-their definitions. Here's an example:
+their definitions. Here's an example using the filename syntax to load the \TeX\ Gyre Pagella Math font: (this works for both \XeLaTeX\ and \LuaLaTeX)
\begin{Verbatim}
\usepackage{amsmath} % if desired
\usepackage{unicode-math}
-\setmathfont{Asana-Math.otf}
-\end{Verbatim}
-Three OpenType maths fonts are included by default in \TeX\ Live 2011:
-Latin Modern Math, Asana Math, and XITS Math.
-These can be loaded directly with their filename
-with both \XeLaTeX\ and \LuaLaTeX; resp.,
-\begin{Verbatim}
-\setmathfont{latinmodern-math.otf}
-\setmathfont{Asana-Math.otf}
-\setmathfont{xits-math.otf}
+\setmathfont{texgyrepagella-math.otf}
\end{Verbatim}
-Other OpenType maths fonts may be loaded in the usual way; please see the
-\pkg{fontspec} documentation for more information.
-Once the package is loaded, traditional TFM-based fonts are not supported any more;
-you can only switch to a different OpenType math font using the \cs{setmathfont} command.
+Once the package is loaded, traditional TFM-based maths fonts are no longer supported;
+you can only switch to a different OpenType maths font using the \cs{setmathfont} command.
If you do not load an OpenType maths font before |\begin{document}|, Latin Modern Math (see above) will be loaded automatically.
\subsection{New commands}
-\textbf{New v0.8:}
-\pkg{unicode-math} provides the following commands to select specific `alphabets' within the unicode maths font: (usage, e.g.: |$\symbfsf{g}$|${}\to\symbfsf{g}$)
-\begin{quote}
-\ExplSyntaxOn
-\clist_map_inline:nn {
- normal, literal, up, bfup, bfit, sfup, sfit, bfsfup, bfsfit, bfsf,
- bb, bbit, scr, bfscr, cal, bfcal, frak, bffrak,
- up, sf, bf, tt, it,
- }{\cs{sym#1}~}
-\ExplSyntaxOff
-\end{quote}
-Many of these are also defined with `familiar' synonyms:
-\begin{quote}
-\ExplSyntaxOn
-\clist_map_inline:nn {
- normal, bb, bbit, scr, bfscr, cal, bfcal, frak, bffrak,
- bfup, bfit, sfup, sfit, bfsfup, bfsfit, bfsf
- }{\mbox{\cs{math#1}}~}
-\ExplSyntaxOff
-\end{quote}
-So what about \cs{mathup}, \cs{mathit}, \cs{mathbf}, \cs{mathsf}, and \cs{mathtt}?
+\pkg{unicode-math} provides a number of commands (such as |\symbfsf|) to select specific `symbol alphabets' within the unicode maths font, with usage, e.g., |$\symbfsf{g}$|${}\to\symbfsf{g}$.
+The full listing is shown in \Tabref{symvsmath}.
+For backwards compatibility, many of these are also defined with `familiar' synonyms such as |\mathbfsf|.
+However, where possible the `sym' prefix commands should be preferred, as certain synonyms may become deprecated in time.
+
+\begin{table}\centering
+ \topcaption{New \pkg{unicode-math} commands.}
+ \tablabel{symvsmath}
+ \begin{tabular}{lll}
+ \toprule
+ \pkg{unicode-math} command & Synonym \\
+ \midrule
+ |\symup| & \\
+ |\symit| & \\
+ |\symbf| & \\
+ |\symsf| & \\
+ |\symtt| & \\
+ \midrule
+ |\symnormal| & |\mathnormal| \\
+ |\symliteral| & \\
+ |\symbfup| & |\mathbfup| \\
+ |\symbfit| & |\mathbfit| \\
+ |\symsfup| & |\mathsfup| \\
+ |\symsfit| & |\mathsfit| \\
+ |\symbfsfup| & |\mathbfsfup| \\
+ |\symbfsfit| & |\mathbfsfit| \\
+ |\symbfsf| & |\mathbfsf| \\
+ |\symbb| & |\mathbb| \\
+ |\symbbit| & |\mathbbit| \\
+ |\symscr| & |\mathscr| \\
+ |\symbfscr| & |\mathbfscr| \\
+ |\symcal| & |\mathcal| \\
+ |\symbfcal| & |\mathbfcal| \\
+ |\symfrak| & |\mathfrak| \\
+ |\symbffrak| & |\mathbffrak| \\
+ \bottomrule
+ \end{tabular}
+\end{table}
+
+While most alphabet commands are provided with the \cs{math...} prefix synonyms, there are five `legacy' font alphabets that intentionally behave somewhat different.
+These are \cs{mathup}, \cs{mathit}, \cs{mathbf}, \cs{mathsf}, and \cs{mathtt}.
(N.B.: \cs{mathrm} is defined as a synonym for \cs{mathup}, but the latter is prefered as it is a script-agnostic term.)
-These commands have `overloaded' meanings in \LaTeX, and it's important to consider the subtle differences between, e.g., \cs{symbf} and \cs{mathbf}.
-The former switches to single-letter mathematical symbols, whereas the second switches to a text font that behaves correctly in mathematics but should be used for multi-letter identifiers.
-These four commands (and \cs{mathrm}) are defined in the traditional \LaTeX\ manner.
-Further details are discussed in \secref{mathselect}.
-Additional similar commands can be defined using
-\begin{Verbatim}
-\setmathfontface\mathfoo{...}
-\end{Verbatim}
+These commands have `overloaded' meanings in traditional \LaTeX, and it's important to consider the subtle differences between, e.g., the new \cs{symbf} and \cs{mathbf}.
+The \cs{symbf} command switches to single-letter mathematical symbols (generally within the same OpenType font).
+The \cs{mathbf} command switches to a text font that is set up to behave correctly in mathematics, and should be used for multi-letter identifiers.
+These could be denoted `text math alphabets'; further details are discussed in \secref{mathselect}.
+Additional similar `text math alphabet' commands can be defined using the \cs{setmathfontface} command discussed in \secref{mathselect}.
+To control the behaviour of the default text math alphabet commands to behave in a backwards-compatible mode, see the package options described in \secref{textmathlegacy}.
\subsection{Package options}
Package options may be set when the package as loaded or at any later
@@ -291,7 +298,7 @@ Therefore, the following two examples are equivalent:
\setmathfont{Cambria Math}[math-style=TeX]
\end{Verbatim}
-A short list of package options is shown in \tabref{pkgopt}.
+A summary list of package options is shown in \tabref{pkgopt}.
See following sections for more information.
\begin{table}\centering
@@ -477,7 +484,7 @@ For example, if you want to define a new legacy maths alphabet font \cs{mathittt
The five `text math' fonts, discussed above, are: \cs{mathrm}, \cs{mathbf}, \cs{mathit}, \cs{mathsf}, and \cs{mathtt}.
These commands are also defined with their original definition under synonyms \cs{mathtextrm}, \cs{mathtextbf}, and so on.
-When selecting document fonts using \pkg{fontspec} commands such as \cs{setmainfont}, \pkg{unicode-math} inserts some additional that keeps the current default fonts `in sync' with their corresponding \cs{mathrm} commands, etc.
+When selecting document fonts using \pkg{fontspec} commands such as \cs{setmainfont}, \pkg{unicode-math} inserts some additional code into \pkg{fontspec} that keeps the current default fonts `in sync' with their corresponding \cs{mathrm} commands, etc.
For example, in standard \LaTeX, \cs{mathsf} doesn't change even if the main document font is changed using |\renewcommand\sfdefault{...}|. With \pkg{unicode-math} loaded, after writing |\setsansfont{Helvetica}|, \cs{mathsf} will now be set in Helvetica.
@@ -485,6 +492,7 @@ If the \cs{mathsf} font is set explicitly at any time in the preamble, this `aut
\subsubsection{Replacing `text math' fonts by symbols}
+\seclabel{textmathlegacy}
For certain types of documents that use legacy input syntax (say you're typesetting a new version of a book written in the 1990s), it would be preferable to use |\symbf| rather than |\mathbf| en masse.
For example, if bold maths is used only for vectors and matrices, a dedicated symbol font will produce better spacing and will better match the main math font.
@@ -510,8 +518,6 @@ A series of package options (\tabref{legacyfontswitch}) are provided to facilita
\end{tabular}
\end{table}
-A `smart' macro is intended for a future version of \pkg{unicode-math} that can automatically distinguish between single- and multi-letter arguments to \cs{mathbf} and use either the maths symbol or the `text math' font as appropriate.
-
\subsubsection{Operator font}
diff --git a/Master/texmf-dist/doc/latex/unicode-math/unicode-math.pdf b/Master/texmf-dist/doc/latex/unicode-math/unicode-math.pdf
index 67d02229f42..e1294f4e845 100644
--- a/Master/texmf-dist/doc/latex/unicode-math/unicode-math.pdf
+++ b/Master/texmf-dist/doc/latex/unicode-math/unicode-math.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.ltx b/Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.ltx
index caa0e8daf93..fe6df238c95 100644
--- a/Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.ltx
+++ b/Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.ltx
@@ -4,10 +4,10 @@
% SYMBOLS DEFINED BY UNICODE-MATH
%%%%%%%%%%%%%%%%%%%%%%%
-\documentclass{article}
+\documentclass[final]{article}
\makeatletter
-\usepackage{booktabs,catchfile,shortvrb,geometry,metalogo,varwidth,textcomp,longtable,hyperref}
+\usepackage{ragged2e,setspace,booktabs,catchfile,shortvrb,geometry,metalogo,textcomp,longtable,tabu,hyperref}
\geometry{margin=3cm}
\hypersetup{colorlinks,linkcolor=black}
@@ -46,28 +46,28 @@
\defmathfont{cambria}{Cambria Math}{66CCCC}
\defmathfont{asana}{Asana-Math.otf}{6666CC}
\defmathfont{pagella}{texgyrepagella-math.otf}{AA6666}
-\defmathfont{euler}{euler.otf}{CC66CC}
\defmathfont{dejavu}{texgyredejavu-math.otf}{AACC66}
+\defmathfont{euler}{euler.otf}{CC66CC}
\def\INPUT{\input{unicode-math-table.tex}}
\def\TABLE{%
\par\noindent
-\begin{longtable}[l]{@{}lccccccccll@{}}
+\begin{longtabu}[l]{@{}lcccccccclX[l]@{}}
\toprule
\textsc{usv} & M & X & S & C & A & P & D & E & Macro & Description \\
\midrule \endhead
\INPUT\\
\bottomrule
-\end{longtable}
+\end{longtabu}
}
\makeatletter
\def\USV#1{\footnotesize\scshape\MakeLowercase{u+\@gobble#1}}
\makeatother
\def\CMD#1{\footnotesize\cmd#1}
\def\DESC#1{%
- \begin{varwidth}[t]{4cm}
- \raggedright\linespread{0.6}\scriptsize #1%
- \end{varwidth}
+ \begin{spacing}{0.5}
+ \RaggedRight\scriptsize #1%
+ \end{spacing}
}
\newcommand\SHOW[1]{%
@@ -155,7 +155,7 @@ This document uses the file \texttt{unicode-math-table.tex}
to print every symbol defined by the \textsf{unicode-math}
package.
Use this document to find the command name or the Unicode glyph slot for a symbol that you wish to use.
-Nine fonts are shown: (with approximate symbol counts)
+The following fonts are shown: (with approximate symbol counts)
\begin{itemize}
\item[M] \mathversion{lm} $\mathup{Latin\ Modern\ Math}$ (\ref{count:lm})
\item[X] \mathversion{xits} $\mathup{XITS\ Math}$ (\ref{count:xits})
@@ -163,9 +163,11 @@ Nine fonts are shown: (with approximate symbol counts)
\item[C] \mathversion{cambria} $\mathup{Cambria\ Math}$ (\ref{count:cambria})
\item[A] \mathversion{asana} $\mathup{Asana\ Math}$ (\ref{count:asana})
\item[P] \mathversion{pagella} $\mathup{TeX\ Gyre\ Pagella\ Math}$ (\ref{count:pagella})
+\item[D] \mathversion{dejavu} $\mathup{DejaVu\ Math\ TeX\ Gyre}$ (\ref{count:dejavu})
\item[E] \mathversion{euler} $\mathup{Neo\ Euler}$ (\ref{count:euler})
-\item[D] \mathversion{dejavu} $\mathup{DejaVu Math TeX Gyre}$ (\ref{count:dejavu})
\end{itemize}
+Note that there are addition maths fonts in the `\TeX\ Gyre' collection which aren't included here.
+
Symbols defined in Plain \TeX\ are indicated with {\color[gray]{0.6} \textsuperscript{\sffamily (p)}} after their macro name.
\LaTeX\ follows Plain \TeX, but defines a handful more, indicated with {\color[gray]{0.6} \textsuperscript{\sffamily (l)}}
Symbols defined in \textsf{amssymb} are indicated with {\color[gray]{0.6} \textsuperscript{\sffamily (a)}}.
diff --git a/Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.pdf b/Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.pdf
index 14ba299ac1f..de512a5d0e2 100644
--- a/Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.pdf
+++ b/Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.pdf
Binary files differ