summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/fontspec/fontspec-doc-api.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/fontspec/fontspec-doc-api.tex')
-rw-r--r--macros/latex/contrib/fontspec/fontspec-doc-api.tex10
1 files changed, 9 insertions, 1 deletions
diff --git a/macros/latex/contrib/fontspec/fontspec-doc-api.tex b/macros/latex/contrib/fontspec/fontspec-doc-api.tex
index e5f11e3503..3ef857e914 100644
--- a/macros/latex/contrib/fontspec/fontspec-doc-api.tex
+++ b/macros/latex/contrib/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}