summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/fontspec/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/fontspec/README')
-rw-r--r--Master/texmf-dist/doc/latex/fontspec/README67
1 files changed, 51 insertions, 16 deletions
diff --git a/Master/texmf-dist/doc/latex/fontspec/README b/Master/texmf-dist/doc/latex/fontspec/README
index 0610e92c6c3..8d5edc40e3a 100644
--- a/Master/texmf-dist/doc/latex/fontspec/README
+++ b/Master/texmf-dist/doc/latex/fontspec/README
@@ -3,7 +3,7 @@ THE FONTSPEC PACKAGE
====================
The fontspec package provides an automatic and unified interface for loading
-fonts in LaTeX. XeTeX and LuaTeX (the latter through the luaotfload package)
+fonts in LaTeX. XeTeX and LuaTeX (the latter through the `luaotfload` package)
allows a direct interface to fonts which may be loaded by their name rather
than filename, so no manual font installation is required.
@@ -15,7 +15,7 @@ others.
See the documentation `fontspec.pdf` for full information.
Release versions of fontspec are available from CTAN:
- <http://tug.ctan.org/pkg/fontspec>
+ <http://www.ctan.org/pkg/fontspec>
Development and historical versions are available from Github:
<http://github.com/wspr/fontspec>
@@ -27,7 +27,7 @@ Please offer suggestions and file bug reports in the issue tracker:
Requirements
------------
-The `fontspec` package requires an up-to-date TeX Live 2011 or MiKTeX 2.9,
+The `fontspec` package requires an up-to-date TeX Live or MiKTeX installation,
including the most recent version of the `l3kernel` package which provides
the LaTeX3 programming interface known as `expl3`.
@@ -37,25 +37,18 @@ Summary of user commands
Font families may be selected individually with the command
- \fontspec[<font options>]{<font name>}
+ \fontspec{<font name>}[<font options>]
Commands for selecting fonts efficiently through a document are created with
- \newfontfamily\myfamily[<font options>]{<font name>}
- \newfontface\myfont[<font options>]{<font name>}
+ \newfontfamily\myfamily{<font name>}[<font options>]
+ \newfontface\myfont{<font name>}[<font options>]
Default document fonts are selected with
- \setmainfont[<font options>]{<font name>}
- \setsansfont[<font options>]{<font name>}
- \setmonofont[<font options>]{<font name>}
-
-Fonts to be used in text strings in maths are defined with
-
- \setmathrm[<font options>]{<font name>}
- \setmathsf[<font options>]{<font name>}
- \setmathtt[<font options>]{<font name>}
- \setboldmathrm[<font options>]{<font name>}
+ \setmainfont{<font name>}[<font options>]
+ \setsansfont{<font name>}[<font options>]
+ \setmonofont{<font name>}[<font options>]
Features to be used for every subsequently defined font are specified with
@@ -72,6 +65,48 @@ Features may be added to the font currently in use with
Change history
--------------
+- v2.4 (25/05/2014)
+
+ * Significant change to the user interface: instead of `\setmainfont[features]{font}`, you now write `\setmainfont{font}[features]`.
+ Backwards compatibility is of course preserved.
+
+ The reason for this change is to improve the visual comprehension of the font loading syntax with large numbers of font features.
+
+ * Defaults for symbolic font families like this can now be specified with
+
+ \defaultfontfeatures[\rmfamily]{...}
+
+ or
+
+ \defaultfontfeatures[\headingsfont]{...}
+ \setfontfamily\headingsfont{...}
+
+ * New `PunctuationSpace=WordSpace` and `PunctuationSpace=TwiceWordSpace` settings, intended for monospaced fonts; these force the space after a period to be exactly one or two spaces wide, respectively, which preserves character alignment across lines.
+
+ * The features above now allow changes to the default settings:
+
+ * `Ligatures=TeX` is enabled by default with `\setmainfont` and `\setsansfont`.
+ * `WordSpace={1,0,0}` and `PunctuationSpace=WordSpace` are now enabled by default for `\setmonofont` to produce better monospaced results.
+ * (These can be adjusted by created your own `fontspec.cfg` file.)
+
+ * `SizeFeatures` can now be nested inside `ItalicFeatures` (etc.) and behaves correctly. This has been a very long overdue bug!
+
+ * New feature `NFSSFamily=ABC` to set the NFSS family of a font to “`ABC`”. Useful
+ when other packages use the `\fontfamily{ABC}\selectfont` interface.
+
+ * New feature `FontFace = {series}{shape}{font}` allows a font face to be loaded with a specific NFSS font series and font shape.
+ A more verbose syntax allows arbitrary font features as well (and this also plays nicely with `SizeFeatures`):
+
+ \fontspec{myfont.otf}[
+ FontFace = {b}{ui}{Font = myfont-bui.otf, <features>} ,
+ ]
+
+ The code above, for example, will allow a bold upright italic font to be selected using the standard NFSS interface: `\fontseries{b}\fontshape{ui}\selectfont`.
+
+ * `\defaultfontfeatures+` (note the `+`) can now be used to append to the default font feature set.
+
+ * Setting the `SmallCapsFont` using the `*`-replacement notation has been improved/fixed.
+
- v2.3c (2013/05/20)
* Compatbility with luaotfload 2013/05/20 2.2c, support for older version