summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/fontspec/fontspec-doc-opentype.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-01-24 03:00:54 +0000
committerNorbert Preining <norbert@preining.info>2020-01-24 03:00:54 +0000
commite1192611f0655a1ccaff0dff2f53c7c65fa5db07 (patch)
tree232f5be17a2221a57cc6515bfe8692772b3a3e89 /macros/latex/contrib/fontspec/fontspec-doc-opentype.tex
parentf7e5d81fe9880913485f7f8c541eeca7adf4c195 (diff)
CTAN sync 202001240300
Diffstat (limited to 'macros/latex/contrib/fontspec/fontspec-doc-opentype.tex')
-rw-r--r--macros/latex/contrib/fontspec/fontspec-doc-opentype.tex76
1 files changed, 38 insertions, 38 deletions
diff --git a/macros/latex/contrib/fontspec/fontspec-doc-opentype.tex b/macros/latex/contrib/fontspec/fontspec-doc-opentype.tex
index a21d7f80cf..fb08645abb 100644
--- a/macros/latex/contrib/fontspec/fontspec-doc-opentype.tex
+++ b/macros/latex/contrib/fontspec/fontspec-doc-opentype.tex
@@ -815,7 +815,7 @@ For completeness, the complete list of OpenType features \emph{not} provided wit
a \pkg{fontspec} interface is shown in \vref{tab:none-ot}.
Features omitted are partially by design and partially by oversight;
for example, the |aalt| feature is largely useless in \TeX\ since it is designed
-for providing a textsc{gui} interface for selecting `all alternates' of a glyph.
+for providing a \textsc{gui} interface for selecting `all alternates' of a glyph.
Others, such as optical bounds for example, simply haven't yet been considered
due to a lack of fonts available for testing.
Suggestions welcome for how/where to add these missing features to the package.
@@ -919,12 +919,12 @@ particular font. These correspond to the OpenType features |cv01| to |cv99|.
For each character that can be varied, it is possible to select among
possible options for that particular glyph.
-For example, in the example below, variants are chosen for glyphs `4' and `5',
+For example, in the hypothetical example below, variants are chosen for glyphs `4' and `5',
and the trailing |:|\meta{n} corresponds to which variety to choose.
\begin{Verbatim}
- \fontspec{EB Garamond 12 Italic}[CharacterVariant={4,5:2}] \& violet
+ \fontspec{CV Font}[CharacterVariant={4,5:2}] \& violet
\end{Verbatim}
-The numbering is entirely font-soecific. Glyph `5' might be the character `v', for example.
+The numbering is entirely font-specific. Glyph `5' might be the character `v', for example.
Character variants are specifically designed not to conflict with each
other, so you can enable them individually per character.
(Unlike stylistic alternates, say.)
@@ -979,19 +979,18 @@ according to the Script setting.
\otf{ResetAll}{}
\end{features}
-For OpenType fonts use a regular text slash to create fractions, but
-the \feat{Fraction} feature must be explicitly activated.
-Some (Asian fonts predominantly) also provide for the
-\opt{Alternate} feature. These are both shown in \exref{ot-frac}.
-
-\begin{Xexample}{ot-frac}{The \feat{Fractions} feature.}
- \fontspec{Hiragino Maru Gothic Pro W4}
- 1/2 \quad 1/4 \quad 5/6 \quad 13579/24680 \\
- \addfontfeature{Fractions=On}
- 1/2 \quad 1/4 \quad 5/6 \quad 13579/24680 \\
- \addfontfeature{Fractions=Alternate}
- 1/2 \quad 1/4 \quad 5/6 \quad 13579/24680 \\
-\end{Xexample}
+Activates the construction of `vulgar' fractions using precomposed glyphs and/or
+subscript and superscript characters from within the font.
+Coverage will vary by font; see \exref{ot-frac}.
+Some (Asian fonts predominantly) also provide for the \opt{Alternate} option.
+
+\begin{Lexample}{ot-frac}{The \feat{Fractions} feature.}
+\setsansfont{Lato}[Fractions=On]
+\setmonofont{IBM Plex Mono}[Fractions=On]
+
+\sffamily 1/2 47/11 1/1000 \par
+\ttfamily 1/2 47/11
+\end{Lexample}
@@ -1034,12 +1033,11 @@ controlled by the \opt{On}/\opt{Off} options.
\subsubsection{Letters} \label{sec:letters}
The \opt{Letters} feature specifies how the letters in the current font
will look. OpenType fonts may contain the following options:
-\opt{Uppercase}, \opt{SmallCaps}, \opt{PetiteCaps},
+\opt{SmallCaps}, \opt{PetiteCaps},
\opt{UppercaseSmallCaps}, \opt{UppercasePetiteCaps}, and
\opt{Unicase}.
\begin{features}{Letters}
-\otf*{Uppercase}{case}
\otf*{SmallCaps}{smcp}
\otf*{PetiteCaps}{pcap}
\otf*{UppercaseSmallCaps}{c2sc}
@@ -1066,24 +1064,6 @@ This difference is shown in \exref{caps}.
THIS SENTENCE no verb
\end{Lexample}
-Note that the \opt{Uppercase} option will (probably)
-not actually map letters to uppercase.
- \note{If you want automatic uppercase letters, look to \LaTeX's
- \cmd\MakeUppercase\ command.}
-It is designed to select various
-uppercase forms for glyphs such as accents and dashes, such as shown
-in \exref{letters-uppercase}; note the raised position of the hyphen
-to better match the surrounding letters.
-
-\begin{Lexample}{letters-uppercase}{An example of the \opt{Uppercase} option of the \feat{Letters} feature.}
- \fontspec{LinLibertine_R.otf}
- UPPER-CASE example \\
- \addfontfeature{Letters=Uppercase}
- UPPER-CASE example
-\end{Lexample}
-
-The \feat{Kerning} feature also contains an \opt{Uppercase} option,
-which adds a small amount of spacing in between letters (see \vref{sec:kerning}).
\subsubsection{Ligatures}
@@ -1196,7 +1176,7 @@ selected numerically such as for the \feat{Annotation} feature.
\otf*{Swash}{swsh}
\otf*{Cursive}{curs}
\otf*{Historic}{hist}
-\otf*{TitlingCaps}{titl}
+\otf*{Titling}{titl}
\otf*{HorizontalKana}{hkna}
\otf*{VerticalKana}{vkna}
\cmidrule{2-4}
@@ -1221,6 +1201,26 @@ particular substitutions are organised with which feature largely up to the font
M Q W
\end{Xexample}
+The \opt{Uppercase} option is designed to select various
+uppercase forms for glyphs such as accents and dashes, such as shown
+in \exref{style-uppercase}; note the raised position of the hyphen
+to better match the surrounding letters.
+It will (probably) not actually map letters to uppercase.
+ \note{If you want automatic uppercase letters, look to \LaTeX's
+ \cmd\MakeUppercase\ command.}
+This option used to be selected under the \feat{Letters} feature, but moved here
+as it generally does not actually affect the letters themselves.
+The \feat{Kerning} feature also contains an \opt{Uppercase} option,
+which adds a small amount of spacing in between letters (see \vref{sec:kerning}).
+
+\begin{Lexample}{style-uppercase}{An example of the \opt{Uppercase} option of the \feat{Style} feature.}
+ \fontspec{LinLibertine_R.otf}
+ UPPER-CASE example \\
+ \addfontfeature{Style=Uppercase}
+ UPPER-CASE example
+\end{Lexample}
+
+
In other features, larger breadths of changes can be seen, covering
the style of an entire alphabet.
See \exref{style-itrub}; here, the \opt{Italic} option affects the Latin text