+-------------------------------------------+ + + + mathastext + + + + 'Use the text font in math mode' + + + +-------------------------------------------+ This Work may be distributed and/or modified under the conditions of the [LPPL 1.3c](https://www.latex-project.org/lppl/lppl-1-3c.txt) The Author of this Work is Jean-Francois Burnol (`jfbu at free dot fr`) Copyright (C) 2011-2019, 2022-2024 Jean-Francois Burnol Source: mathastext.dtx 1.4e 2024/10/26 DESCRIPTION =========== Optimal typographical results for documents containing mathematical symbols can only be hoped for with math fonts specifically designed to match a given text typeface. Although the list of freely available math fonts (alongside the Computer Modern and AMS extension fonts) is slowly expanding (fourier, kpfonts, mathdesign, pxfonts, txfonts, newpx, newtx, ...) it remains limited, and the situation is even worse with Unicode fonts (XeTeX/LuaTeX). So if you can't find a math font which fits well with your favorite text font, and wish to still be able to typeset mathematical documents, perhaps not of the highest typographical quality, but at least not subjected to obvious visual incompatibilities between your text font and the math fonts, try out mathastext: it will simply use the text font also for the math! - http://jf.burnol.free.fr/mathastext.html - http://jf.burnol.free.fr/showcase.html USAGE ===== `mathastext` is a LaTeX package \usepackage{mathastext} The document will use in math mode the text font as configured at package loading time, for these characters: abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 !?,.:;+-=()[]/#$%&<>|{}\ Main options: `italic`, `frenchmath`, `subdued`, `LGRgreek`. - Use the `italic` option to get the Latin letters in math mode be in italics. Digits and log-like operator names (pre-defined as well as user-defined) will be in the same shape as the text font (usually this means upright). - each `\Mathastext[]` in the preamble defines a math version to be later activated in the document body via the command `\MTversion{}`. - With the `subdued` option, mathastext will be active only inside such math versions. - For documents needing Greek letters the following is possible: - no option: Greek letters defined by other packages, - `eulergreek`: use the Euler font for the Greek letters, - `symbolgreek`: use the Postscript Symbol font for the Greek letters. - `LGRgreek`: use the document text font in LGR encoding. Further options specify the shape of the lowercase and uppercase Greek glyphs; starting with v1.15c it is possible to use multiple distinct LGR fonts in the same document. - Commands are provided to scale the Euler and Symbol fonts by an arbitrary factor to let them fit better with the document text font. - `\MTsetmathskips` allows to set up extra spacings around letters. RECENT CHANGES ============== 1.4e \[2024/10/26\] ---- * Fix a bug dating back to `1.3y` which caused under `LGRgreek` or `LGRgreeks` options an `\MTversion{normal}` to raise an `Extra \else` error (not if `subdued`). The unit test which could have shown this had been left aside at `1.4d` because it was so old that some matters unrelated to the package prevented its immediate use... alas... * Fix one more `1.4` regression: the (not really recommended) option `unimathaccents` was broken. Again a test file existed but it had been left apart from those automatically built, for some unknown reason... 1.4d \[2024/10/26\] ---- * Fix one more `1.4` regression (the worst one by far): `$f''$` caused a crash. Fortunately, the `everymath` option which re-enacts legacy code could be used as a *temporary emergency work-around*. Thanks to Enrico Gregorio for report. * The `1.4b` option `noletters` did not prevent the package from defining math mode symbols `\inodot` and `\jnodot`. It now does. * Fix a longstanding legacy bug which would have caused a crash if `\MTnonlettersobeymathxx` had been used with `XeLaTeX` in a document with the character `-` being a Babel shorthand. * Usage of `\Mathastext` or `\MTDeclareVersion` to declare a math version associated with an exotic non-text font encoding such as `OML` is theoretically possible (although of dubious practical use except for stress tests) but was broken since `1.3u` due to internals relying on `LaTeX` commands associated with text font encodings (for example to define `\inodot` using `\i`, or the `\hbar` with the help of the accent command `\=`) and which are not available in such context. This release handles such situation gracefully via warnings, rather than causing low level errors. * Improve looks in the PDF of this Change log. 1.4c \[2024/10/21\] ---- * Fix a regression at `1.4`: under `XeLaTeX`, loading `mathastext` caused an error if `unicode-math` and its `\setmathfont` had been used prior ("*Extended mathchar used as mathchar*" in relation to the minus sign character). Thanks to Michael Roland for report. Keep in mind though that the documentation (see 1.4.15 Unicode engines) has always said that the package "*is expected to be most definitely incompatible with unicode-math*". * Fix another regression at `1.4`, related to the same code and also avoided with `everymath` option, but showing with all engines. It caused `\MTnonlettersdonotobeymathxx`, if used, to reset the minus sign to its status as prior to the loading of `mathastext`, whereas it should have used the (by default) mathversion dependent one (which defaults to the en-dash in the font encoding as stored by `mathastext` in the extended math version). * `\Relbar` and `\relbar` redeclarations (needed as they are used by `LaTeX` for arrows, and the equal and minus signs if picked from the text font may not work well in-there) are now done via `\DeclareRobustCommand` also with package `amsmath` to match the current behavior of the latter. Note though that they will use the equal and minus signs as in place at package loading time, the documentation does say that `mathastext` should be loaded last. 1.4b \[2024/07/27\] ---- * Fix a regression at `1.4` regarding option `nodigits`. * New option: `noletters`. *I am in old age now so I can provide an option completely antithetical to my life work*. * Option `everymath` which is destined to be removed at next major release warns user about it. As major releases tend to happen once per decade I think the constant nagging will become insufferable and you will adapt to the `1.4` changes rather than persisting into using this option. 1.4a \[2024/07/20\] ---- * There was a documentation glitch in 1.4 and also a problem with the `\MTprimeskip` feature being lost under the emergency fall-back `everymath` option. 1.4 \[2024/07/20\] --- * Since 1.2 of 2012/12/20, mathastext has used *mathematically active* characters to propose certain advanced functionalities. For reasons half lost in the mists of time but whose main one was surely to keep the meaning of the active shape of characters unchanged outside of math mode, this mathematical activation, and (in most cases) the definitions of what active characters do, were done again at *each* entrance into math mode. At this 1.4 release, mathastext does *not inject any code whatsoever* into the `\everymath` and `\everydisplay` toks registers anymore (*except* for one font-related hack needed under `LuaLaTeX`, see below). Your documents will compile a tiny bit faster. * In (*unsual*) documents where users play with catcodes and mathcodes it is *impossible* to keep exact backward compatibility, because documented user commands which acted formerly as toggles with delayed action now will enact changes immediately if in the document body. In practice consequences are expected to be few, because catcode active characters are (as was already the case with earlier releases) hacked only when they are Babel shorthands and they are then modified in a way altering only their action in math mode. The precise description of what mathastext does when mathematically activating (or not) a character, depending on circumstances, is to be found among small-print comments in the section "Extended scope of the math alphabets commands". See also the documentation of the `\MTmathactiveletters` command for some specifics regarding ascii letters. * New option: `everymath`. It instructs mathastext to revert (partially) to its legacy code which uses `\everymath/\everydisplay`. This reversal is partial, the handling of ascii letters not being included into it. The `everymath` option is there *only to try as a quick fix* in case transition to this release causes a major problem in a user document and time is lacking to investigate. *Please report to the author such issues*. Option `everymath` is destined to be removed at next major release. * New option: `activedigits`. Enjoy. * It is now easier to hook into the mathastext architecture for mathematically activated ascii letters. See the new section "Hacking letters (and even digits) for special tasks". * Bugfix: do not override special behavior of the math mode dot in babel-spanish. * Bugfix: A *desperate* hack related to `LuaLaTeX` font matters and dating back to 1.3o 2016/05/03 had been for some years in dire need of an update regarding fonts using `Renderer=HarfBuzz`. This is done now. Thanks to tex.sx `user691586` for report. This is currently the sole remaining usage of `\everymath/\everydisplay`. * Bugfix: `\MTexplicitbracesobeymathxx` (which is related to `\{` and `\}`) was without effect since an upstream `LaTeX` change at its 2020-02-02 release. * With option symbolmisc, those math symbol macros formerly defined via `\DeclareRobustCommand` are now declared via `\protected\def`. * Removal of legacy branches previously kept to support `LaTeX` earlier than 2020-02-02. * Removal of support for EU1 and EU2 font encodings. * Option `noasterisk` deprecated at 1.2d 2013/01/02 has (finally) been removed. * Four test files previously included and auto-extracted from the distributed dtx have been dropped. One of them is still available on the package homepage. * Some parts of the documentation have been massively re-ordered and even to some extent improved. But there may be some occasions where obsolete statements will be found having the legacy `\everymath/\everydisplay` situation as background.