summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/fontspec/README.md
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-01-22 22:34:22 +0000
committerKarl Berry <karl@freefriends.org>2017-01-22 22:34:22 +0000
commit4f70a140932277cc2ef6292e47ebe25c5d8c3230 (patch)
tree09c23cbf4ffd71fde1b8049902f73511adef85d9 /Master/texmf-dist/doc/latex/fontspec/README.md
parent60a21cad39ca930406807ef85e67b5b3f8407b2a (diff)
fontspec (22jan17)
git-svn-id: svn://tug.org/texlive/trunk@43016 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/fontspec/README.md')
-rw-r--r--Master/texmf-dist/doc/latex/fontspec/README.md59
1 files changed, 43 insertions, 16 deletions
diff --git a/Master/texmf-dist/doc/latex/fontspec/README.md b/Master/texmf-dist/doc/latex/fontspec/README.md
index 6715e5c64ba..2f522755053 100644
--- a/Master/texmf-dist/doc/latex/fontspec/README.md
+++ b/Master/texmf-dist/doc/latex/fontspec/README.md
@@ -1,4 +1,4 @@
-THE FONTSPEC PACKAGE v2.5a
+THE FONTSPEC PACKAGE v2.5c
==========================
The fontspec package provides an automatic and unified interface for loading
@@ -35,39 +35,65 @@ Table of Contents
Summary of user commands
------------------------
-Font families may be selected individually with the command
+To define commands for selecting fonts efficiently through a document:
- \fontspec{<font name>}[<font options>]
-
-Commands for selecting fonts efficiently through a document are created with
-
- \newfontfamily\myfamily{<font name>}[<font options>]
- \newfontface\myfont{<font name>}[<font options>]
+ \newfontfamily\<font switch>{<font name>}[<font options>]
+ \newfontface \<font switch>{<font name>}[<font options>]
-Default document fonts are selected with
+To select the default document fonts:
\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
+To define an ad hoc font family individually:
+
+ \fontspec{<font name>}[<font options>]
+
+To specify features to be used for every subsequently defined font:
\defaultfontfeatures{<default font options>}
\defaultfontfeatures+{<add to default font options>}
- \defaultfontfeatures[<font name>]{<default font options for "font name">}
- \defaultfontfeatures+[<font name>]{<add to default font options for "font name">}
-Features may be added to the font currently in use with
+To specify features to be used for specific fonts:
+
+ \defaultfontfeatures[<font name or switch>]{<default font options>}
+ \defaultfontfeatures+[<font name or switch>]{<add to defaults>}
+
+To add features to the font family currently in use:
\addfontfeatures{<font options to add>}
- \addfontfeature{<...>} does the same thing
Change history
--------------
-- v2.5a (2016/02/01) "bugs fixed"
+- v2.5c (2017/01/20) "Christmas 2016 release"
+
+ * `TU` font encoding now default, with encoding files provided by the kernel.
+ * Experimental interface added for customising encodings.
+ * Add feature `Ornament=`*n* corresponding to OpenType feature `+ornm=`*n*.
+ * Add feature `FontIndex=`*n* to support TrueType Collection (TTC) files.
+ * Nested `\emph` is now much smarter and will cleverly nest even if manual font changes are made.
+ * Tries to resolve situations when font features clash.
+ E.g., `Numbers={Uppercase,Lowercase}` will define only `+onum` rather than the previous behaviour of `+lnum;+onum` to let the engine sort things out. Coverage may still be preliminary.
+ * Add API function `\fontspec_if_current_feature:nTF` for querying selected features based on their OpenType tag.
+ * Add user function `\IfFontFeatureActiveTF` for querying selected features based on their `fontspec` specification.
+ * All "tag-based" OpenType features are now provided in `Feat`/`FeatOff`/`FeatReset` forms to disable and reset them.
+ * `ResetAll` provided for all "tag-based" OpenType feature keys. (E.g., `Ligatures=ResetAll`.)
+ * Big table of OpenType feature tags to help cross-reference which fontspec feature (if any) corresponds to which OpenType feature.
+ * Bug fixed for `Script` selection.
+
+- v2.5b (2016/05/14) "More bugs" (somehow never released)
+
+ * Fixed bug with garbage text printed in certain "verbatim" situations under LuaTeX.
+ * Improve interaction between optical sizes and small caps.
+ * Remove documentation for `FeatureFile`, since this is no longer supported under LuaLaTeX
+ (there are other methods to perform the same thing, but no "easy" user interface that `fontspec` can provide at this stage).
+ * Fix regression causing an error message if `fontspec` loaded before `\documentclass'.
+
+- v2.5a (2016/02/01) "Bugs fixed"
* Rather embarrassing bug fix! (`unicode-math` was broken.)
* Remember to add the `fontspec.cfg` file to the distribution.
@@ -77,7 +103,8 @@ Change history
- v2.5 (2016/01/30) "TL2016 release"
- * Provide a new Unicode font encoding ("TU") to replace EU1/EU2 and xunicode. If this causes problems, load fontspec with the `[euenc]` option to revert to the old behaviour.
+ * Provide a new Unicode font encoding ("TU") to replace EU1/EU2 and xunicode.
+ * Activate with package option `[tuenc]'; once it becomes the default (later this year), `[euenc]` option will revert to the old behaviour.
* New command `\emfontdeclare` for defining font shapes when arbitrarily nesting the `\emph` command.
* Allow slanted small caps and better internal methods for "combining" font shapes; this fixes a few bugs.
* Incorporate "new" font script tags for Indic fonts. E.g., when selecting `Script=Bengali`, fontspec will first query the font for the `bng2` OpenType script, and if not found select `beng`.