summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/mathastext/README
blob: 136080be0a57b052932c16bf1815632e0babec7e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
Copyright (C) 2011, 2012 by Jean-Francois Burnol.
[see bottom of this file for the LPPL statement]

    +-------------------------------------------+
    +                 mathastext                +
    +                                           +
    +      `Use the text font in math mode'     +
    +             v1.2d  2013/01/02             +
    +             jfbu (at) free.fr             +
    +-------------------------------------------+


                    INTRODUCTION

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,
and others...) 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 incompatibi-
-lities between your text font and the math fonts,
try out mathastext: it will simply use the text font also
for the math!


                        USAGE

main options: italic, subdued, defaultmathsizes, LGRgreek.

          \usepackage[options]{mathastext}
          after other font related packages.

          The document will then use the text
          font also in math mode (letters,
          digits, punctuation and a a few other
          ascii characters).      

          Optionally load further font packages
          and then make use of the
          \Mathastext[version_name] command to
          define math versions in the preamble
          and use them in the document body with
          the \MTversion{version_name} command.

          With the subdued option, mathastext is
          only active inside such a defined math
          version. 

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).

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. 

Read the PDF documentation for more.

Examples available there:
     http://jf.burnol.free.fr/mathsastext.html
     http://jf.burnol.free.fr/showcase.html


                    INSTALLATION

Run latex or pdflatex on mathastext.dtx to create the mathastext.sty
file. Move the .sty file to a suitable location within the TeX
installation. Run latex twice more on mathastext.dtx to finish
producing the documentation.

During this process test files have been generated which serve to
illustrate some features of the package.


CHANGE LOG

1.2d [2013/01/02]

   *  an incompatibility with amsmath (its macro \resetMathstrut@),
      exists since version 1.2 of the package. This is fixed
      here.

   *  various improvements in dealing with the asterisk and in the
      mechanism of letting non-letter symbols obey the math alphabet
      commands.

   *  documentation extended and improved.


1.2c [2012/12/31]

   *  mathastext now inserts automatically after all (latin)
      letters in math mode their italic corrections, if the font
      used is upright (sic). This improves the spacings for the
      positioning of subscripts. The feature is de-activated
      inside the math alphabets commands (apart from \mathnormal),
      so as to not prohibit the formation of ligatures,

   *  the documentation has been extended to explain in detail the
      issues which are relevant to the new feature of added italic
      corrections,

   *  version 1.2 had some bad bugs when confronted to active
      characters. This is corrected and additionally \MTnonletters-
      -donotobeymathxx is made the default, as the user input is too
      much constrained in its absence.

   *  a less fatal, but still annoying, typo had made the dot in 1.2
      of type \mathpunct rather than \mathord

   *  the inner namespace has been rationalized a bit.


1.2 [2012/12/20]

   *  a new command sets up the amount of space to be automatically
      inserted before the derivative glyph (useful when using an
      upright font).

   *  the scope of the math alphabets has been extended to apply
      to the non-alphabetical characters, and also to operator
      names. 

   *  the format of the dtx file has changed. The package file
      is self-extracting from the dtx, and four additional test
      files are also produced during `latex mathastext.dtx'.

1.15f and 1.15g [2012/10/25]

   *  \$, \#, \&, and \% had been re-defined by mathastext since its
      inception in a rather strange (but working) way, which
      could cause surprises to other packages. Fixed.

   *  the subdued mechanism for the math alphabets is implemented
      in a simpler and more efficient manner than in 1.15e.

   *  the `defaultxx' options act a bit differently, and are more
      useful in case of a `too many math alphabets' situation.

   *  various improvements in the documentation.

   *  general clean up and better commenting of the source code.


1.15e [2012/10/22]

   *  new user commands to specify skip or glue to be
      inserted after the math symbols \exists and \forall

   *  complete (user transparent) rewrite of the code
      implementing the subdued option; and its action has
      been extended to apply also to the \mathbf, \mathit,
      \mathsf, \mathtt alphabets and not only to \mathrm and
      \mathnormal as in the previous versions.

   *  improvements in the documentation.


1.15d [2012/10/13]

   *  the Unicode situation is now correctly treated,
      throughout the code (this had been left in a half-done
      way from version 1.14 of April 2011). 

        - this includes an issue related to amsmath and its
      DeclareMathOperator macro which has been fixed,

        - and the code related to \relbar and \Relbar (and
      \models) has been revised.


1.15c [2012/10/05]

   *  it is now possible to use distinct fonts in LGR encoding
      for the Greek letters according to the current math
      version. 

   *  improvements to the documentation.


1.15b

   *  corrected a `feature' of 1.15 which was backward-
      incompatible

   *  improvements to the pdf documentation


1.15  [2012/09/26]

   *  the subdued option allows the mathastextification to
      act only locally.  

   *  some measures taken to deal with amsmath related
      issues when using xetex or luatex.


1.14c

   *  a bug is fixed: the \Mathastext macro reinitializes
      the fonts in the normal and bold math versions, but it
      also erroneously redeclared the math alphabet changing
      commands which could have been set up in previously
      defined math versions (via earlier calls to
      \Mathastext[version_name]).


1.14b [2011/04/03]

   *  there was a bug with \$, \#, \&, \% in math mode which
      showed up when ten or more math families had been
      declared. This bug affected also the minus sign under
      the same circumstances, when Unicode engines were
      used. Fixed.

   *  the options LGRgreek and selfGreek act now a bit
      differently, and new options LGRgreeks and selfGreeks
      have been defined. 

   +  I also cleaned up a bit the code, for a more
      structured namespace.


1.14

   *  mathastext now modifies also the math alphabets \mathit,
      \mathsf and \mathtt, thus making it a quite generic
      complete manner to adapt the math configuration to fonts
      provided with no math support.


1.13b

   *  when the Symbol font is used for \prod and \sum this 
      will be only for inline math; display math will use the
      default glyphs 


1.13 [2011/03/11]

   *  the LGRgreek option is added.

   *  internal changes for better readability of the code.


1.12

   *  various bugs have been corrected.

   *  the endash and alldelims options are active by default.

   *  the package is more Unicode aware.

   *  the \Mathastext command has been improved to
      facilitate the mechanism of math versions also when
      using XeTeX or LuaTeX (with package fontspec.) 

   *  the en-dash and dotless i and j now work with all
      encodings, Unicode inclusive.


1.11 [2011/02/06] optional argument to \Mathastext macro.


1.1  [2011/02/01] options italic and frenchmath.


1.0  [2011/01/25]

Copyright (C) 2011, 2012 by Jean-Francois Burnol.

	The files of this package 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.

	The latest version of this license is in
	  http://www.latex-project.org/lppl.txt
	and version 1.3 or later is part of all distributions of
	LaTeX version 2003/12/01 or later.