fontspec (22jan17)

git-svn-id: svn://tug.org/texlive/trunk@43016 c570f23f-e606-0410-a88d-b1316a301751

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