diff options
author | Karl Berry <karl@freefriends.org> | 2017-10-02 21:58:46 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-10-02 21:58:46 +0000 |
commit | fd5f690d11016435384d6ae952eb94789cf60746 (patch) | |
tree | e565838dbddeb3874202f5fa5c307cfaa7fbb208 /Master/texmf-dist/doc | |
parent | b05bbbaa1cd9b63551731cdd1577f90225da2079 (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')
-rw-r--r-- | Master/texmf-dist/doc/latex/unicode-math/CHANGES.md | 211 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/unicode-math/CONTRIBUTING.md | 41 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/unicode-math/README.md | 211 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/unicode-math/unicode-math-doc.tex | 102 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/unicode-math/unicode-math.pdf | bin | 384713 -> 346785 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.ltx | 22 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/unicode-math/unimath-symbols.pdf | bin | 1611964 -> 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 Binary files differindex 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 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 Binary files differindex 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 |