summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/fontspec/fontspec-doc-api.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-01-23 21:54:34 +0000
committerKarl Berry <karl@freefriends.org>2020-01-23 21:54:34 +0000
commitfb7a86c739d47ad1fe1a6e483b01b0240a83c854 (patch)
treebb844326b2fcc9773854406f9d3c12c6fb7b750b /Master/texmf-dist/source/latex/fontspec/fontspec-doc-api.tex
parent5d1480d3fcb2ca5d3647a5a5a56fab1506aafa4b (diff)
fontspec (23jan20)
git-svn-id: svn://tug.org/texlive/trunk@53512 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/fontspec/fontspec-doc-api.tex')
-rw-r--r--Master/texmf-dist/source/latex/fontspec/fontspec-doc-api.tex10
1 files changed, 9 insertions, 1 deletions
diff --git a/Master/texmf-dist/source/latex/fontspec/fontspec-doc-api.tex b/Master/texmf-dist/source/latex/fontspec/fontspec-doc-api.tex
index e5f11e3503a..3ef857e9143 100644
--- a/Master/texmf-dist/source/latex/fontspec/fontspec-doc-api.tex
+++ b/Master/texmf-dist/source/latex/fontspec/fontspec-doc-api.tex
@@ -99,9 +99,13 @@ the \verb|TUR| tag will be queried and used if possible as a fallback.
\section{Going behind \pkg{fontspec}'s back}
+
Expert users may wish not to use \pkg{fontspec}'s feature handling at all,
while still taking advantage of its \LaTeX\ font selection conveniences. The
-\feat{RawFeature} font feature allows font feature selection using a literal feature selection string if you happen to have the OpenType feature tag memorised.
+\feat{RawFeature} font feature allows font feature selection using a literal feature
+selection string if you happen to have the OpenType feature tag memorised.
+More importantly, this can be used to enable features for which \pkg{fontspec}
+does not yet have a user interface to.
\begin{Xexample}{raw}{Using raw font features directly.}
\fontspec{texgyrepagella-regular.otf}[RawFeature=+smcp]
@@ -113,6 +117,10 @@ Multiple features can either be included in a single declaration:\par
\noindent or with multiple declarations:\par
{\centering|[RawFeature=+smcp, RawFeature=+onum]|\par}
+Note that there is no error-checking when using |RawFeature|. Where a \pkg{fontspec}
+interface exists to a feature it is generally better to use it. If the font lacks the feature
+or if it would clash with another feature, \pkg{fontspec} will attemmpt to warn and/or resolve the issues.
+
\section{Renaming existing features \& options}
\label{sec:aliasfontfeature}