diff options
Diffstat (limited to 'macros/latex/contrib/fontspec/fontspec-doc-intro.tex')
-rw-r--r-- | macros/latex/contrib/fontspec/fontspec-doc-intro.tex | 63 |
1 files changed, 6 insertions, 57 deletions
diff --git a/macros/latex/contrib/fontspec/fontspec-doc-intro.tex b/macros/latex/contrib/fontspec/fontspec-doc-intro.tex index 28b8a00338..7f32adb009 100644 --- a/macros/latex/contrib/fontspec/fontspec-doc-intro.tex +++ b/macros/latex/contrib/fontspec/fontspec-doc-intro.tex @@ -78,16 +78,13 @@ Package options will be introduced below; some preliminary details are discussed \subsection{Font encodings} -The 2016 release of \pkg{fontspec} initiated some changes for font encodings and the loading of \pkg{xunicode}. -The 2017 release rolls out those changes as default. -The now-default \texttt{tuenc} package option switches the \textsc{nfss} font encoding to \texttt{TU}. +The (default) \texttt{tuenc} package option switches the \textsc{nfss} font encoding to \texttt{TU}. \texttt{TU} is a new Unicode font encoding, intended for both \XeTeX\ and \LuaTeX\ engines, and automatically contains support for symbols covered by \LaTeX's traditional \texttt{T1} and \texttt{TS1} font encodings (for example, |\%|, |\textbullet|, |\"u|, and so on). -As a result, with this package option, Ross Moore's \pkg{xunicode} package is \textbf{not} loaded. -Some new, experimental, features are now provided to customise some encoding details; see Part~\vref{part:enc} for further details. +Some additional features are provided by \pkg{fontspec} to customise some encoding details; see Part~\vref{part:enc} for further details. Pre-2017 behaviour can be achieved with the \texttt{euenc} package option. -This selects the \texttt{EU1} or \texttt{EU2} encoding (\XeTeX/\LuaTeX, resp.) and loads the \pkg{xunicode} package. +This selects the \texttt{EU1} or \texttt{EU2} encoding (\XeTeX/\LuaTeX, resp.) and loads the \pkg{xunicode} package for symbol support. Package authors and users who have referred explicitly to the encoding names \texttt{EU1} or \texttt{EU2} should update their code or documents. (See internal variable names described in \vref{sec:api} for how to do this properly.) @@ -132,22 +129,6 @@ This section documents some areas of adjustment that \pkg{fontspec} makes to improve default behaviour with \LaTeXe\ and third-party packages. -\subsection{Verbatim} -\label{sec:verb} - -Many verbatim mechanisms assume the existence of a `visible space' character that exists in the \textsc{ascii} space slot of the typewriter font. This character is known in Unicode as \unichar{2423}{box open}, which looks like this: `\verb*| |'. - -When a Unicode typewriter font is used, \LaTeX\ no longer prints visible spaces for the |verbatim*| environment and |\verb*| command. -This problem is fixed by using the correct Unicode glyph, and the following packages are patched to do the same: -\pkg{listings}, \pkg{fancyvrb}, \pkg{moreverb}, and \pkg{verbatim}. - -In the case that the typewriter font does not contain `\verb*| |', the Latin Modern Mono font is used as a fallback. - -In 2019, \LaTeX\ will use a new command \cs{verbvisiblespace} for internal commands and for -third party packages. If this new command is defined, \pkg{fontspec}'s patching code here -will be entirely disabled and the packages listed above should no longer rely on \pkg{fontspec} -to redefine their internals. - \subsection{Commands for old-style and lining numbers} @@ -162,44 +143,12 @@ the reverse for \cs{liningnums}\marg{text}. \subsection{Italic small caps} -\DescribeMacro{\itshape} -\DescribeMacro{\slshape} -\DescribeMacro{\scshape} -Note that this package redefines the \cs{itshape}, \cs{slshape}, and \cs{scshape} commands in order to allow them to select italic small caps in conjunction. -With these changes, writing |\itshape\scshape| will lead to italic small caps, and |\upshape| subsequently then moves back to small caps only. |\upshape| again returns from small caps to upright regular. -(And similarly for for |\slshape|. In addition, once italic small caps are selected then |\slshape| will switch to slanted small caps, and vice versa.) +Support now provided by \LaTeXe\ in 2020. \subsection{Emphasis and nested emphasis} -\DescribeMacro{\eminnershape} -\LaTeXe\ allows you to specify the behaviour of \cs{emph} nested within \cs{emph} by setting the \cs{eminnershape} command. -For example, -\begin{Verbatim} - \renewcommand\eminnershape{\upshape\scshape} -\end{Verbatim} -will produce small caps within |\emph{\emph{...}}|. - -\DescribeMacro{\emfontdeclare} -The \pkg{fontspec} package takes this idea one step further to allow arbitrary font shape changes and arbitrary levels of nesting within emphasis. -This is performed using the |\emfontdeclare| command, which takes a comma-separated list of font switches corresponding to increasing levels of emphasis. -An example: -\begin{enumerate} -\item |\emfontdeclare{\itshape,\upshape\scshape,\itshape}| will lead to `italics', `small caps', then `italic small caps' as the level of emphasis increases, as long as italic small caps are defined for the font. - Note that |\upshape| is required because the font changes are cascading. -\end{enumerate} -The implementation of this feature tries to be `smart' and guess what level of emphasis to use in the case of manual font changing. -This is reliable only if you use shape-changing commands in \cs{emfontdeclare}. -For example: -\begin{Verbatim} - \emfontdeclare{\itshape,\upshape\scshape,\itshape} - ... - \scshape small caps \emph{hello} -\end{Verbatim} -Here, the emphasised text `hello' will be printed in italic small caps since |\emph| can detect that the current font shape is already in the second `mode' of emphasis. - -\DescribeMacro{\emreset} -Finally, if you have so much nested emphasis that |\emfontdeclare| runs out of options, it will insert |\emreset| (by default just |\upshape|) and start again from the beginning. +Support now provided by \LaTeXe\ in 2020. \subsection{Strong emphasis} @@ -235,7 +184,7 @@ An example for setting up a font family for use with \cs{strong} is discussed in % ------------------------------------------------ % The FONTSPEC package <wspr.io/fontspec> % ------------------------------------------------ -% Copyright 2004-2019 Will Robertson, LPPL "maintainer" +% Copyright 2004-2020 Will Robertson, LPPL "maintainer" % Copyright 2009-2015 Khaled Hosny % Copyright 2013 Philipp Gesang % Copyright 2013-2016 Joseph Wright |