summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-09-19 23:46:08 +0000
committerKarl Berry <karl@freefriends.org>2011-09-19 23:46:08 +0000
commit4d169ca66f8bd4cfb4257a94e49edbfdcdc84ce8 (patch)
treefa6cb3f6085c6495059caccad40be5b76754b838 /Master/texmf-dist/source/latex
parent92d4b04fa1e31cfc4d0c314aa84d75d0a239db62 (diff)
new latex package fontaxes (19sep11)
git-svn-id: svn://tug.org/texlive/trunk@24024 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex')
-rw-r--r--Master/texmf-dist/source/latex/fontaxes/fontaxes.dtx1281
-rw-r--r--Master/texmf-dist/source/latex/fontaxes/fontaxes.ins56
2 files changed, 1337 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/fontaxes/fontaxes.dtx b/Master/texmf-dist/source/latex/fontaxes/fontaxes.dtx
new file mode 100644
index 00000000000..bbdf33fcaa9
--- /dev/null
+++ b/Master/texmf-dist/source/latex/fontaxes/fontaxes.dtx
@@ -0,0 +1,1281 @@
+% \iffalse meta-comment
+%
+% Copyright (c) 2007 by Andreas B\"uhmann
+% Copyright (c) 2011 by Michael Ummels <michael.ummels@rwth-aachen.de>
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3c
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is Michael Ummels.
+%
+% This work consists of the files fontaxes.dtx, fontaxes.ins and
+% the derived files fontaxes.sty, test-fontaxes.tex and fontaxes.pdf.
+%
+% \fi
+%
+%\iffalse
+%<*driver>
+\ProvidesFile{fontaxes.dtx}[2011/09/16 v1.0 Font selection axes]
+%</driver>
+%<package>\NeedsTeXFormat{LaTeX2e}
+%<package>\ProvidesPackage{fontaxes}[2011/09/16 v1.0 Font selection axes]
+%<*driver>
+\documentclass{ltxdoc}
+
+\usepackage[T1]{fontenc}
+\usepackage{charter}
+\usepackage[scaled=1.05]{inconsolata}
+\usepackage{array}
+\usepackage{booktabs}
+\usepackage{floatrow}
+\usepackage{hyperref}
+\usepackage{microtype}
+
+\hypersetup{
+ bookmarksnumbered,
+ colorlinks=false,
+ pdfborder={0 0 0},
+ pdftitle={Axes, axes, axes},
+ pdfauthor={Andreas B\"uhmann, Michael Ummels}
+}
+
+\newcommand*\pkg[1]{\mbox{#1}}
+\newcommand*\acro[1]{#1}
+\newcommand*\axis[1]{\textit{#1}}
+\floatsetup[table]{capposition=top}
+
+\begin{document}
+\DocInput{fontaxes.dtx}
+\end{document}
+%</driver>
+%\fi
+%
+% \CheckSum{719}
+% \CharacterTable
+% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+% Digits \0\1\2\3\4\5\6\7\8\9
+% Exclamation \! Double quote \" Hash (number) \#
+% Dollar \$ Percent \% Ampersand \&
+% Acute accent \' Left paren \( Right paren \)
+% Asterisk \* Plus \+ Comma \,
+% Minus \- Point \. Solidus \/
+% Colon \: Semicolon \; Less than \<
+% Equals \= Greater than \> Question mark \?
+% Commercial at \@ Left bracket \[ Backslash \\
+% Right bracket \] Circumflex \^ Underscore \_
+% Grave accent \` Left brace \{ Vertical bar \|
+% Right brace \} Tilde \~}
+%
+% \GetFileInfo{fontaxes.dtx}
+%
+% \title{Axes, axes, axes}
+% \author{Andreas B\"uhmann \and Michael Ummels}
+% \date{\fileversion\ -- \filedate}
+% \maketitle
+%
+% \begin{abstract}
+% The \pkg{fontaxes} package simulates multiple independent font selection
+% axes on top of certain single \acro{NFSS} axes: \axis{base family},
+% \axis{figure style}, and \axis{figure alignment} on top of \axis{family};
+% \axis{primary shape} and \axis{secondary shape} on top of \axis{shape};
+% and \axis{math weight} and \axis{math figure alignment} on top of
+% \axis{math version}.
+% \end{abstract}
+%
+% \tableofcontents
+%
+% \section{Introduction}
+%
+% The introduction of the New Font Selection Scheme (\acro{NFSS}) has
+% greatly simplified the usage of \LaTeX\ with fonts different from the
+% Computer Modern fonts originally designed for \TeX. However, the \acro{NFSS}
+% has some limitations. In particular, it~defines only one axis for the font
+% shape, which caters for both the actual \emph{shape} of the font (e.g.\
+% upright, italic or slanted) and the \emph{case} of the font (e.g.\
+% upper-lower case and small-caps). For example, if the current font shape is
+% italic, then selecting small capitals using |\scshape| or |\textsc| will
+% revert to an upright shape, even if the font has italic small capitals.
+%
+% The \pkg{fontaxes} package alleviates the deficiencies of the \acro{NFSS}
+% by simulating multiple axes on top of single \acro{NFSS} axes. In particular,
+% it replaces the single \acro{NFSS} shape axis by a primary and a secondary
+% shape axis, catering for the shape and the case of the font, respectively.
+% Moreover, the package introduces three new axes to deal
+% with different \emph{figure versions}, which are provided by many
+% professional fonts.
+%
+% \section{Usage}
+%
+% You can load this package by adding
+% \begin{quote}
+% |\usepackage{fontaxes}|
+% \end{quote}
+% to the preamble of your document. This redefines and makes available
+% certain font selection commands, which are described in the rest of
+% this section.
+%
+% \subsection{Shape}
+%
+% The \pkg{fontaxes} package splits the \acro{NFSS}'s single shape axis into
+% two: the primary shape axis (|n|, |it|, etc.) and the secondary shape axis
+% (|ulc|, |sc|, etc.).
+%
+% \DescribeMacro\upshape %
+% \DescribeMacro\itshape %
+% \DescribeMacro\slshape %
+% \DescribeMacro\swshape %
+% The commands |\upshape|, |\itshape|, and |\slshape| are redefined
+% to access the primary axis only. For access to a swash shape, the command
+% |\swshape| has been added.
+%
+% \DescribeMacro\ulcshape %
+% \DescribeMacro\scshape %
+% \DescribeMacro\sscshape %
+% The commands |\scshape| and |\sscshape| (spaced small caps) access the
+% secondary axis. To return from any small-caps shape to upper-lower case,
+% you can use the command |\ulcshape|.
+%
+% \DescribeMacro\fontprimaryshape %
+% \DescribeMacro\fontsecondaryshape %
+% All these commands update the two shape axes using the low-level commands
+% |\fontprimaryshape|\marg{value} and |\fontsecondaryshape|\marg{value}.
+%
+% \DescribeMacro\swdefault %
+% \DescribeMacro\sscdefault %
+% \DescribeMacro\ulcdefault %
+% If you want to change which values are used by the various commands
+% |\|\meta{abbr}|shape|, redefine the corresponding |\|\meta{abbr}|default|.
+% The additional commands |\swdefault|, |\sscdefault|, and |\ulcdefault| are
+% provided with their default values |sw|, |ssc|, and |ulc|, respectively.
+%
+% \subsection{Figure version}
+%
+% Different figure versions are usually implemented as different font families
+% (e.g.\ |MinionPro-{OsF,LF,TOsF,TLF}| or |ppl{j,x}|).
+% The \pkg{fontaxes} package splits off the axes \axis{figure style} and
+% \axis{figure alignment}, which leaves the \axis{base family} (e.g.\
+% |MinionPro| or |ppl|).\pagebreak
+%
+% \changes{v0.2}{2005/05/04}{Rename figures switching commands
+% |\|\meta{\dots}|fig|.}
+% \DescribeMacro\txfigures %
+% \DescribeMacro\lnfigures %
+% \DescribeMacro\tbfigures %
+% \DescribeMacro\prfigures %
+% The \pkg{fontaxes} package knows two figure styles, |text| and |lining|
+% (accessible via |\txfigures| and |\lnfigures|), and two modes of figure
+% alignment, |tabular| and |proportional| (accessible via the switches
+% |\tbfigures| and |\prfigures|).
+%
+% \DescribeMacro\fontfigurestyle %
+% \DescribeMacro\fontfigurealignment %
+% Additionally, you can access both axes directly using the low-level commands
+% |\fontfigurestyle|\marg{value} and |\fontfigurealignment|\marg{value}.
+%
+% \DescribeMacro\fontbasefamily %
+% If you want to change the font family without changing the figure version,
+% use |\fontbasefamily|\marg{value}. (All these commands require a successive
+% |\selectfont| to make the changes take effect.)
+%
+% For choosing the figure versions to be used in math mode, you can use the
+% corresponding axis \axis{math figure alignment}. Note that there is
+% currently no means for changing the figure style used in math.
+%
+% \subsection{Math version}
+%
+% \DescribeMacro\boldmath %
+% \DescribeMacro\unboldmath %
+% By default, \LaTeX\ provides two math versions, |normal| and |bold|, as well
+% as commands |\boldmath| and |\unboldmath| for switching between them. The
+% \pkg{fontaxes} packages redefines these commands to operate on the axis
+% \axis{math weight}.
+%
+% \DescribeMacro\tabularmath %
+% \DescribeMacro\proportionalmath %
+% A second axis \axis{math figure alignment} is introduced that allows you to
+% switch between |tabular| and |proportional| figures using |\tabularmath| and
+% |\proportionalmath|. (This assumes the presence of additional math versions
+% |tabular| and |boldtabular|; the package will copy the setups of math
+% versions |normal| and |bold| at the end of the preamble in case you do not
+% provide your own declarations.)
+%
+% \DescribeMacro\mathweight %
+% \DescribeMacro\mathfigurealignment %
+% You can directly assign values to the axes using the low-level commands
+% |\mathweight|\marg{value} and |\mathfigurealignment|\marg{value}.
+%
+% Table~\ref{tab:cmds} summarizes which commands set which values on which
+% axes.\par
+% \newcommand\nextaxis{\addlinespace[1\jot]}%
+% \begin{table}\centering
+% \begin{tabular}{@{}llll@{}}
+% \toprule
+% Command & Axis & Value & Default\\
+% \midrule
+% |\upshape| & |\fontprimaryshape| & |\updefault| & |n| \\
+% |\itshape| & & |\itdefault| & |it| \\
+% |\slshape| & & |\sldefault| & |sl| \\
+% |\swshape| & & |\swdefault| & |sw| \\
+% \nextaxis
+% |\ulcshape| & |\fontsecondaryshape| & |\ulcdefault| & |ulc| \\
+% |\scshape| & & |\scdefault| & |sc| \\
+% |\sscshape| & & |\sscdefault| & |ssc| \\
+% \midrule
+% |\txfigures| & |\fontfigurestyle| & |text| \\
+% |\lnfigures| & & |lining| \\
+% \nextaxis
+% |\tbfigures| & |\fontfigurealignment| & |tabular| \\
+% |\prfigures| & & |proportional| \\
+% \nextaxis
+% \meta{none} & |\fontbasefamily| & \meta{font-dependent}\\
+% \midrule
+% |\boldmath| & |\mathweight| & |bold| \\
+% |\unboldmath| & & |normal| \\
+% \nextaxis
+% |\tabularmath| & |\mathfigurealignment| & |tabular| \\
+% |\proportionalmath| & & |proportional| \\
+% \bottomrule
+% \end{tabular}
+% \caption{Summary of commands}
+% \label{tab:cmds}
+% \end{table}
+%
+% \subsection{Additional commands}
+%
+% \DescribeMacro\textsw %
+% \DescribeMacro\textssc %
+% \DescribeMacro\textulc %
+% \DescribeMacro\textfigures %
+% \DescribeMacro\liningfigures %
+% \DescribeMacro\tabularfigures %
+% \DescribeMacro\proportionalfigures %
+% Similar to the well-known |\textit|, |\textsc|, etc.\ this package provides
+% commands |\textsw|, |\textssc|, |\textulc|, |\textfigures|, |\liningfigures|,
+% |\tabularfigures| and |\proportionalfigures| that take one argument and
+% apply the font change only to the argument.
+% For example, |\textsw|\marg{text} is roughly equivalent to
+% |{\swshape|\meta{text}|}| (but automatically adds italic corrections).
+%
+% \DescribeMacro\figureversion %
+% The command |\figureversion|\marg{options} allows easy switching of multiple
+% aspects of figures simultaneously. It takes as an argument a comma-separated
+% list of one or more of the following options:
+% \begin{quote}
+% \begin{tabular}{@{}ll}
+% |text|, |osf| & for text figures,\\
+% |lining|, |lf| & for lining figures,\\
+% |tabular|, |tab| & for tabular figures,\\
+% |proportional|, |prop| & for proportional figures.
+% \end{tabular}
+% \end{quote}
+% For example, |\figureversion{lf,tab}| selects tabular lining figures.
+%
+% \iffalse
+% \section{Naming conventions}
+%
+% How to name your font families and shapes so they will work with this
+% package. (To be done \dots)
+% \fi
+%
+% \StopEventually{}
+%
+% \section{Implementation}
+%
+% \subsection{High-level author commands (Level 1)}
+%
+% \subsubsection{Shape}
+%
+% \begin{macro}{\upshape}
+% \begin{macro}{\itshape}
+% \begin{macro}{\slshape}
+% \begin{macro}{\swshape}
+% Axis 1: primary shape
+% \begin{macrocode}
+%<*package>
+\DeclareRobustCommand\upshape{\not@math@alphabet\upshape\relax
+ \fontprimaryshape\updefault\selectfont}
+\DeclareRobustCommand\itshape{\not@math@alphabet\itshape\mathit
+ \fontprimaryshape\itdefault\selectfont}
+\DeclareRobustCommand\slshape{\not@math@alphabet\slshape\relax
+ \fontprimaryshape\sldefault\selectfont}
+\DeclareRobustCommand\swshape{\not@math@alphabet\swshape\relax
+ \fontprimaryshape\swdefault\selectfont}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \changes{v0.2}{2005/05/04}{Renamed |nosc| to |ulc| (upper and lower case)}
+% \begin{macro}{\scshape}
+% \begin{macro}{\sscshape}
+% \begin{macro}{\ulcshape}
+% Axis 2: secondary shape
+% \begin{macrocode}
+\DeclareRobustCommand\scshape{\not@math@alphabet\scshape\relax
+ \fontsecondaryshape\scdefault\selectfont}
+\DeclareRobustCommand\sscshape{\not@math@alphabet\sscshape\relax
+ \fontsecondaryshape\sscdefault\selectfont}
+\DeclareRobustCommand\ulcshape{\not@math@alphabet\ulcshape\relax
+ \fontsecondaryshape\ulcdefault\selectfont}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \changes{v1.0}{2011/09/16}{Added compatibility macro}
+% \begin{macro}{\noscshape}
+% Provide an alias for compatibility with the \pkg{slantsc} package
+% \begin{macrocode}
+\let\noscshape\ulcshape
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\swdefault}
+% \begin{macro}{\ulcdefault}
+% \begin{macro}{\sscdefault}
+% \begin{macrocode}
+\providecommand\swdefault{sw}
+\providecommand\ulcdefault{ulc}
+\providecommand\sscdefault{ssc}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\textsw}
+% \begin{macro}{\textssc}
+% \begin{macro}{\textulc}
+% \begin{macrocode}
+\DeclareTextFontCommand{\textsw}{\swshape}
+\DeclareTextFontCommand{\textssc}{\sscshape}
+\DeclareTextFontCommand{\textulc}{\ulcshape}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \subsubsection{Figure version}
+%
+% \begin{macro}{\txfigures}
+% \begin{macro}{\lnfigures}
+% Axis 1: figure style
+% \begin{macrocode}
+\def\txfigures{\@nomath\txfigures
+ \fontfigurestyle{text}\selectfont}
+\def\lnfigures{\@nomath\lnfigures
+ \fontfigurestyle{lining}\selectfont}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\tbfigures}
+% \begin{macro}{\prfigures}
+% Axis 2: figure alignment
+% \begin{macrocode}
+\def\tbfigures{\@nomath\tbfigures
+ \fontfigurealignment{tabular}\selectfont}
+\def\prfigures{\@nomath\prfigures
+ \fontfigurealignment{proportional}\selectfont}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \changes{v0.2}{2005/05/04}{Renamed |oldstyle| to |text|}
+% \begin{macro}{\figureversion}
+% \changes{v0.2}{2005/05/04}{Added abbreviated options |tab| and |prop|.}
+% This code originally appeared in the package \pkg{MinionPro}. I have adapted
+% it to work within \pkg{fontaxes}' framework and also changed some option
+% names.
+% \begin{macrocode}
+\newcommand\fontaxes@fv@prefix{fontaxes@fv@switch@}
+\newcommand*\fontaxes@fv@newoption[1]
+ {\expandafter\newcommand\csname\fontaxes@fv@prefix #1\endcsname}
+\fontaxes@fv@newoption{text} {\txfigures}
+\fontaxes@fv@newoption{osf} {\txfigures}
+\fontaxes@fv@newoption{lining} {\lnfigures}
+\fontaxes@fv@newoption{lf} {\lnfigures}
+\fontaxes@fv@newoption{tabular} {\tbfigures\tabularmath}
+\fontaxes@fv@newoption{tab} {\tbfigures\tabularmath}
+\fontaxes@fv@newoption{proportional}{\prfigures\proportionalmath}
+\fontaxes@fv@newoption{prop} {\prfigures\proportionalmath}
+% \end{macrocode}
+% We simply iterate over the list of figure versions specified in the argument
+% to |\figureversion| and check if we have specified a matching option.
+% \begin{macrocode}
+\newcommand\fontaxes@fv@list{}
+\newcommand\fontaxes@fv{}
+\DeclareRobustCommand*\figureversion[1]{%
+ \edef\fontaxes@fv@list{\zap@space#1 \@empty}%
+ \@for\fontaxes@fv:=\fontaxes@fv@list\do{%
+ \@ifundefined{\fontaxes@fv@prefix\fontaxes@fv}{%
+ \PackageWarning{fontaxes}%
+ {Unknown figure style `\fontaxes@fv'\MessageBreak
+ specified as the argument to \string\figureversion.\MessageBreak
+ Figure style not changed}%
+ }{%
+ \@nameuse{\fontaxes@fv@prefix\fontaxes@fv}%
+ }%
+ }%
+}
+% \end{macrocode}
+% We have made |\figureversion| robust to protect it in moving arguments
+% (e.g., section titles). Additionally, we want it to simply be ignored when
+% hyperref is building \acro{PDF} strings (e.g., for bookmarks). The same is
+% true for similar commands, but we only include a selection of them (only the
+% forms with arguments).
+% \begin{macrocode}
+\AtBeginDocument{
+ \@ifpackageloaded{hyperref}{%
+ \pdfstringdefDisableCommands{%
+ \let\figureversion\@gobble
+ \let\textfigures\@firstofone
+ \let\liningfigures\@firstofone
+ \let\tabularfigures\@firstofone
+ \let\proportionalfigures\@firstofone
+ \let\textsw\@firstofone
+ \let\textssc\@firstofone
+ \let\textulc\@firstofone
+ }%
+ }{}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \noindent Axis 3: base family |\fontbasefamily{...}|
+%
+% \changes{v0.2}{2005/04/30}{Align command names with MinionPro.sty}
+% \begin{macro}{\textfigures}
+% \begin{macro}{\liningfigures}
+% \begin{macro}{\tabularfigures}
+% \begin{macro}{\proportionalfigures}
+% \begin{macrocode}
+\DeclareTextFontCommand{\textfigures}{\txfigures}
+\DeclareTextFontCommand{\liningfigures}{\lnfigures}
+\DeclareTextFontCommand{\tabularfigures}{\tbfigures\tabularmath}
+\DeclareTextFontCommand{\proportionalfigures}
+ {\prfigures\proportionalmath}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \subsubsection{Math version}
+%
+% \begin{macro}{\boldmath}
+% \begin{macro}{\unboldmath}
+% Axis 1: weight
+% \begin{macrocode}
+\def\boldmath{\@nomath\boldmath
+ \mathweight{bold}}
+\def\unboldmath{\@nomath\unboldmath
+ \mathweight{normal}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\tabularmath}
+% \begin{macro}{\proportionalmath}
+% Axis 2: figure alignment
+% \begin{macrocode}
+\def\tabularmath{\@nomath\tabularmath
+ \mathfigurealignment{tabular}}
+\def\proportionalmath{\@nomath\proportionalmath
+ \mathfigurealignment{proportional}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \subsection{Low-level author commands (Level 2)}
+%
+% \begingroup\parindent0pt\obeylines
+% |\mathweight{bold,normal}| sets |\mathversion|
+% |\mathfigurealignment{tabular,proportional}| sets |\mathversion|
+%
+% |\fontfigurestyle{text,lining}| sets |\fontfamily|
+% |\fontfigurealignment{tabular,proportional}| sets |\fontfamily|
+% |\fontbasefamily{...}| sets |\fontfamily|
+%
+% |\fontprimaryshape{n,it,sl,sw}| sets |\fontshape|
+% |\fontsecondaryshape{ulc,sc,ssc}| sets |\fontshape|
+% \endgroup
+%
+% \begin{macro}{\mathweight}
+% \begin{macro}{\mathfigurealignment}
+% \begin{macrocode}
+\DeclareRobustCommand\mathweight[1]{%
+ \fontaxes@get@math \edef\fontaxes@math@weight{#1}\fontaxes@set@math}
+\DeclareRobustCommand\mathfigurealignment[1]{%
+ \fontaxes@get@math \edef\fontaxes@math@align{#1}\fontaxes@set@math}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\fontfigurestyle}
+% \begin{macro}{\fontfigurealignment}
+% \begin{macro}{\fontbasefamily}
+% \begin{macrocode}
+\DeclareRobustCommand\fontfigurestyle[1]{%
+ \fontaxes@get@family \edef\fontaxes@figure@style{#1}\fontaxes@set@family}
+\DeclareRobustCommand\fontfigurealignment[1]{%
+ \fontaxes@get@family \edef\fontaxes@figure@align{#1}\fontaxes@set@family}
+\DeclareRobustCommand\fontbasefamily[1]{%
+ \fontaxes@get@family \edef\fontaxes@family@base{#1}\fontaxes@set@family}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\fontprimaryshape}
+% \begin{macro}{\fontsecondaryshape}
+% \begin{macrocode}
+\DeclareRobustCommand\fontprimaryshape[1]{%
+ \fontaxes@get@shape \edef\fontaxes@shape@one{#1}\fontaxes@set@shape}
+\DeclareRobustCommand\fontsecondaryshape[1]{%
+ \fontaxes@get@shape \edef\fontaxes@shape@two{#1}\fontaxes@set@shape}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \subsection{Internals (Layer 3)}
+% \begingroup\parindent0pt\obeylines
+% |\fontaxes@set@math| sets |\mathversion|
+% |\fontaxes@set@family| sets |\fontfamily|
+% |\fontaxes@set@shape| sets |\fontshape|
+% \endgroup
+%
+% \begin{macro}{\fontaxes@math@weight}
+% \begin{macro}{\fontaxes@math@align}
+% \begin{macro}{\fontaxes@family@base}
+% \begin{macro}{\fontaxes@figure@style}
+% \begin{macro}{\fontaxes@figure@align}
+% \begin{macro}{\fontaxes@shape@one}
+% \begin{macro}{\fontaxes@shape@two}
+% The macros that hold the current values of the axes (here with some
+% default values that will most certainly be overwritten during
+% initializiation; see |\fontaxes@get@|\dots)
+% \begin{macrocode}
+\newcommand*\fontaxes@math@weight{normal}
+\newcommand*\fontaxes@math@align{proportional}
+\newcommand*\fontaxes@family@base{MinionPro}
+\newcommand*\fontaxes@figure@style{text}
+\newcommand*\fontaxes@figure@align{proportional}
+\newcommand*\fontaxes@shape@one{n}
+\newcommand*\fontaxes@shape@two{ulc}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@set@math}
+% \begin{macro}{\fontaxes@set@family}
+% \begin{macro}{\fontaxes@set@shape}
+% \begin{macrocode}
+\newcommand*\fontaxes@set@math{%
+ \fontaxes@encode@math
+ \mathversion{\fontaxes@code}%
+ \fontaxes@save\math@version}
+\newcommand*\fontaxes@set@family{%
+ \fontaxes@encode@family
+ \fontfamily{\fontaxes@code}%
+ \fontaxes@save\f@family}
+\newcommand*\fontaxes@set@shape{%
+ \fontaxes@encode@shape
+ \fontshape{\fontaxes@code}%
+ \fontaxes@save\f@shape}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@get@math}
+% \begin{macro}{\fontaxes@get@family}
+% \begin{macro}{\fontaxes@get@shape}
+% Check for changes: if changed, try to decode and update axes.
+% \begin{macrocode}
+\newcommand*\fontaxes@get@math{%
+ \iffontaxes@changed\math@version{%
+ \fontaxes@decode@{math}{\math@version}%
+ \ifx\fontaxes@edoc\relax\else
+ \edef\fontaxes@math@weight{\expandafter\@firstoftwo\fontaxes@edoc}%
+ \edef\fontaxes@math@align{\expandafter\@secondoftwo\fontaxes@edoc}%
+ \fi
+ \fontaxes@save\math@version
+ }{}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\newcommand*\fontaxes@get@family{%
+ \iffontaxes@changed\f@family{%
+ \let\fontaxes@edoc\relax
+ \expandafter\fontaxes@split@family\f@family--\@nnil
+ \ifx\fontaxes@split@suffix\relax\else
+ \fontaxes@decode@{figures}{\fontaxes@split@suffix}%
+ \fi
+ \ifx\fontaxes@edoc\relax
+% \end{macrocode}
+% Try alternative
+% \begin{macrocode}
+ \expandafter\fontaxes@split@familyalt\f@family
+ \@empty\@empty\@empty\@empty\@nnil
+ \ifx\fontaxes@split@suffix\relax\else
+ \fontaxes@decode@{figuresalt}{\fontaxes@split@suffix}%
+ \fi
+ \ifx\fontaxes@edoc\relax
+ \fontaxes@warn@undecodable{family `\f@family'}%
+ \edef\fontaxes@family@base{\f@family}%
+ \else
+ \edef\fontaxes@family@base{\fontaxes@split@prefix}%
+ \edef\fontaxes@figure@style{\expandafter\@firstoftwo\fontaxes@edoc}%
+% \end{macrocode}
+% Do not overwrite align (does not occur in alternative naming scheme)
+% \begin{macrocode}
+ \fi
+ \else
+% \end{macrocode}
+% Store values
+% \begin{macrocode}
+ \edef\fontaxes@family@base{\fontaxes@split@prefix}%
+ \edef\fontaxes@figure@style{\expandafter\@firstoftwo\fontaxes@edoc}%
+ \edef\fontaxes@figure@align{\expandafter\@secondoftwo\fontaxes@edoc}%
+ \fi
+ }{}%
+}
+% \end{macrocode}
+% \begin{macrocode}
+\newcommand*\fontaxes@get@shape{%
+ \iffontaxes@changed\f@shape{%
+ \fontaxes@decode@{shape}{\f@shape}%
+ \ifx\fontaxes@edoc\relax\else
+ \edef\fontaxes@shape@one{\expandafter\@firstoftwo\fontaxes@edoc}%
+ \edef\fontaxes@shape@two{\expandafter\@secondoftwo\fontaxes@edoc}%
+ \fi
+ \fontaxes@save\f@shape
+ }{}%
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \subsection{Encoding}
+%
+% \begin{macro}{\fontaxes@encode@math}
+% \begin{macro}{\fontaxes@encode@family}
+% \begin{macro}{\fontaxes@encode@figures}
+% \begin{macro}{\fontaxes@encode@figuresalt}
+% \begin{macro}{\fontaxes@encode@shape}
+% \begin{macrocode}
+\newcommand*\fontaxes@encode@math{%
+ \fontaxes@encode@{math}{{\fontaxes@math@weight}{\fontaxes@math@align}}%
+}
+% \end{macrocode}
+% Default is concatenation
+% \begin{macrocode}
+\newcommand*\fontaxes@encode@math@default{%
+ \edef\fontaxes@code{\fontaxes@math@weight\fontaxes@math@align}}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\newcommand*\fontaxes@encode@family{%
+ \fontaxes@encode@{family}
+ {{\fontaxes@family@base}{\fontaxes@figure@style}{\fontaxes@figure@align}}%
+}
+% \end{macrocode}
+% Try different naming conventions
+% \begin{macrocode}
+\newcommand*\fontaxes@encode@family@default{%
+ \fontaxes@encode@figures
+ \edef\fontaxes@code{\fontaxes@family@base-\fontaxes@code}%
+ \fontaxes@check@family\fontaxes@code
+ \iffontaxes@exists\else
+ \fontaxes@encode@figuresalt
+ \edef\fontaxes@code{\fontaxes@family@base\fontaxes@code}%
+ \fontaxes@check@family\fontaxes@code
+ \iffontaxes@exists\else
+ \edef\fontaxes@code{\fontaxes@family@base}%
+ \fi
+ \fi
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\newcommand*\fontaxes@encode@figures{%
+ \fontaxes@encode@{figures}{{\fontaxes@figure@style}{\fontaxes@figure@align}}%
+}
+\newcommand*\fontaxes@encode@figures@default{%
+ \edef\fontaxes@code{OsF}%
+ \PackageWarning{fontaxes}{Unknown figure version
+ `\fontaxes@figure@style\space + \fontaxes@figure@align'\MessageBreak
+ Encoding to `\fontaxes@code'}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\newcommand*\fontaxes@encode@figuresalt{%
+ \fontaxes@encode@{figuresalt}{{\fontaxes@figure@style}{\fontaxes@figure@align}}%
+}
+\newcommand*\fontaxes@encode@figuresalt@default{%
+ \PackageWarning{fontaxes}{Unknown figure version
+ `\fontaxes@figure@style\space + \fontaxes@figure@align'\MessageBreak
+ Encoding to `\fontaxes@code'}%
+ \edef\fontaxes@code{j}%
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\newcommand*\fontaxes@encode@shape{%
+ \fontaxes@encode@{shape}{{\fontaxes@shape@one}{\fontaxes@shape@two}}%
+}
+% \end{macrocode}
+% Default is (reverse) concatenation
+% \begin{macrocode}
+\newcommand*\fontaxes@encode@shape@default{%
+ \edef\fontaxes@code{\fontaxes@shape@two\fontaxes@shape@one}%
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@encode@}
+% \begin{macrocode}
+\newcommand*\fontaxes@encode@[2]{%
+ \@ifundefined{fontaxes@encode@#1#2}
+ {\@nameuse{fontaxes@encode@#1@default}}
+ {\edef\fontaxes@code{\@nameuse{fontaxes@encode@#1#2}}}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@naming@exception}
+% To do: Add a user interface to specify naming exceptions
+% \begin{macrocode}
+\newcommand*\fontaxes@naming@exception[3]{%
+ \expandafter\edef\csname fontaxes@encode@#1#2\endcsname{#3}%
+}
+% \end{macrocode}
+% The defaults |n| and |ulc| disappear when combined.
+% \begin{macrocode}
+\fontaxes@naming@exception{shape}{{n}{ulc}}{n}
+\fontaxes@naming@exception{shape}{{n}{sc}}{sc}
+\fontaxes@naming@exception{shape}{{n}{ssc}}{ssc}
+\fontaxes@naming@exception{shape}{{it}{ulc}}{it}
+\fontaxes@naming@exception{shape}{{sl}{ulc}}{sl}
+\fontaxes@naming@exception{shape}{{sw}{ulc}}{sw}
+% \end{macrocode}
+% The defaults disappear in the concatenation. |boldtabular| is formed
+% regularly.
+% \begin{macrocode}
+\fontaxes@naming@exception{math}{{normal}{proportional}}{normal}
+\fontaxes@naming@exception{math}{{normal}{tabular}}{tabular}
+\fontaxes@naming@exception{math}{{bold}{proportional}}{bold}
+% \end{macrocode}
+% Provide abbreviations for font family suffixes.
+% \begin{macrocode}
+\fontaxes@naming@exception{figures}{{text}{proportional}}{OsF}
+\fontaxes@naming@exception{figures}{{text}{tabular}}{TOsF}
+\fontaxes@naming@exception{figures}{{lining}{proportional}}{LF}
+\fontaxes@naming@exception{figures}{{lining}{tabular}}{TLF}
+% \end{macrocode}
+% The |j|/|x| naming convention does not know about different figure
+% alignments. Let us silently ignore these.
+% \begin{macrocode}
+\fontaxes@naming@exception{figuresalt}{{text}{proportional}}{j}
+\fontaxes@naming@exception{figuresalt}{{text}{tabular}}{j}
+\fontaxes@naming@exception{figuresalt}{{lining}{proportional}}{x}
+\fontaxes@naming@exception{figuresalt}{{lining}{tabular}}{x}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Decoding}
+%
+% Detect if |\mathversion|, |\fontshape|, |\fontfamily| have been used not
+% under control of this package.
+%
+% \begin{macro}{\fontaxes@figure@style@domain}
+% \begin{macro}{\fontaxes@figure@align@domain}
+% \begin{macro}{\fontaxes@shape@one@domain}
+% \begin{macro}{\fontaxes@shape@two@domain}
+% \begin{macro}{\fontaxes@math@weight@domain}
+% \begin{macro}{\fontaxes@math@align@domain}
+% Assuming an injective encoding function, we can construct decoding tables
+% when we know the function's domain. To do: Warn if decoding entries are
+% overwritten (if the function is not injective).
+% \begin{macrocode}
+\newcommand*\fontaxes@figure@style@domain{text,lining}
+\newcommand*\fontaxes@figure@align@domain{proportional,tabular}
+% \end{macrocode}
+% \begin{macrocode}
+\newcommand*\fontaxes@shape@one@domain{n,it,sl,sw}
+\newcommand*\fontaxes@shape@two@domain{ulc,sc,ssc}
+% \end{macrocode}
+% \begin{macrocode}
+\newcommand*\fontaxes@math@weight@domain{normal,bold}
+\newcommand*\fontaxes@math@align@domain{proportional,tabular}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@create@decode@table}
+% \changes{v0.2b}{2007/03/31}{Restore values of axes}
+% |#1| name, |#2| list of axes
+% \begin{macrocode}
+\newcommand*\fontaxes@create@decode@table[2]{%
+ \begingroup
+ \fontaxes@foreach{#2}{%
+ \@nameuse{fontaxes@encode@#1}%
+ \global\expandafter
+ \edef\csname fontaxes@decode@#1{\fontaxes@code}\endcsname{#2}%
+ }%
+ \endgroup
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\AtEndOfPackage{
+ \fontaxes@create@decode@table{figures}
+ {{\fontaxes@figure@style}{\fontaxes@figure@align}}
+ \fontaxes@create@decode@table{figuresalt}
+ {{\fontaxes@figure@style}{\fontaxes@figure@align}}
+ \fontaxes@create@decode@table{shape}
+ {{\fontaxes@shape@one}{\fontaxes@shape@two}}
+ \fontaxes@create@decode@table{math}
+ {{\fontaxes@math@weight}{\fontaxes@math@align}}
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@warn@undecodable}
+% \begin{macrocode}
+\newcommand*\fontaxes@warn@undecodable[1]{%
+ \PackageWarning{fontaxes}{I don't know how to decode\MessageBreak #1}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@decode@}
+% \changes{v0.2a}{2007/03/21}{Fix error message}
+% Interpret the decoding tables.
+% \begin{macrocode}
+\newcommand*\fontaxes@decode@[2]{%
+ \@ifundefined{fontaxes@decode@#1{#2}}{%
+ \let\fontaxes@edoc\relax
+ \fontaxes@warn@undecodable{#1 `#2'}%
+ }{\edef\fontaxes@edoc{\@nameuse{fontaxes@decode@#1{#2}}}}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@save}
+% \begin{macro}{\iffontaxes@changed}
+% Save states of macros for future comparison
+% \begin{macrocode}
+\newcommand*\iffontaxes@changed[1]{%
+ \expandafter\ifx\csname fontaxes@last@\string#1\endcsname#1%
+ \expandafter\@secondoftwo
+ \else
+ \expandafter\@firstoftwo
+ \fi
+}
+\newcommand*\fontaxes@save[1]{%
+ \expandafter\let\csname fontaxes@last@\string#1\endcsname#1%
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \subsection{Compatibility}
+%
+% If no math versions |tabular| and |boldtabular| are defined in the preamble,
+% we provide defaults by copying the states of |normal| and |bold| (assuming,
+% in turn, that these two exist).
+% \begin{macrocode}
+\AtBeginDocument{%
+ \fontaxes@provide@mv@copy{tabular}{normal}%
+ \fontaxes@provide@mv@copy{boldtabular}{bold}%
+}
+% \end{macrocode}
+%
+% \begin{macro}{\fontaxes@provide@mv@copy}
+% \changes{v0.2}{2005/04/28}{Provide default math versions by copy}
+% Declare math version |#1| to be a copy of math version |#2| if |#1| does not
+% exist already. To accomplish this we have to know that a math version's
+% configuration is basically stored in a macro |\mv@|\meta{name} (which makes
+% us dependent on the NFSS implementation; sigh \dots).
+% \begin{macrocode}
+\newcommand*\fontaxes@provide@mv@copy[2]{%
+ \@ifundefined{mv@#1}{%
+ \DeclareMathVersion{#1}%
+ \expandafter\let\csname mv@#1\expandafter\endcsname
+ \csname mv@#2\endcsname
+ }{}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \subsection{Tools}
+%
+% \begin{macro}{\fontaxes@check@family}
+% \begin{macro}{\iffontaxes@exists}
+% Check if family switching would yield an existing shape.
+% \begin{macrocode}
+\newif\iffontaxes@exists
+\newcommand*\fontaxes@check@family[1]{%
+ \begingroup
+ \fontfamily{#1}\try@load@fontshape
+ \expandafter
+ \ifx\csname\curr@fontshape\endcsname\relax
+ \aftergroup\fontaxes@existsfalse
+ \else
+ \aftergroup\fontaxes@existstrue
+ \fi
+ \endgroup
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@split@prefix}
+% \begin{macro}{\fontaxes@split@suffix}
+% The results of splitting a family name.
+% \begin{macrocode}
+\newcommand*\fontaxes@split@prefix{}
+\newcommand*\fontaxes@split@suffix{}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@split@family}
+% Font name contains one hyphen, split there
+% \begin{macrocode}
+\newcommand*\fontaxes@split@family{}
+\def\fontaxes@split@family#1-#2-#3\@nnil{%
+ \let\fontaxes@split@prefix\relax
+ \let\fontaxes@split@suffix\relax
+ \def\@tempa{#3}%
+ \ifx\@tempa\@empty\else
+ \def\fontaxes@split@suffix{#2}%
+ \ifx\fontaxes@split@suffix\@empty
+ \let\fontaxes@split@suffix\relax
+ \else
+ \def\fontaxes@split@prefix{#1}%
+ \fi
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@split@familyalt}
+% Name consists of four characters, split off the last one
+% \begin{macrocode}
+\newcommand*\fontaxes@split@familyalt{}
+\def\fontaxes@split@familyalt#1#2#3#4#5\@nnil{%
+ \let\fontaxes@split@prefix\relax
+ \let\fontaxes@split@suffix\relax
+ \edef\@tempa{#5}%
+ \ifx\@tempa\@empty
+ \ifx\@empty#4\else
+ \def\fontaxes@split@prefix{#1#2#3}%
+ \def\fontaxes@split@suffix{#4}%
+ \fi
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\fontaxes@foreach}
+% \changes{v0.2}{2005/04/30}{More generic: allows an arbitrary number of axes}
+% Execute |#2| for each combination of values of the axes given in |#1| (in the
+% form |{\cs}{\cs}|\dots).
+% \begin{macrocode}
+\newcommand\fontaxes@foreach[2]{%
+ \begingroup
+ \def\fontaxes@foreach@{#2}%
+ \@tfor\@tempa:=#1\do{%
+ \@temptokena\expandafter{\fontaxes@foreach@}%
+ \edef\fontaxes@foreach@{%
+ \noexpand\@for
+ \expandafter\noexpand\@tempa:=%
+ \expandafter\noexpand\csname
+ \expandafter\expandafter
+ \expandafter\@gobble
+ \expandafter\string\@tempa
+ @domain%
+ \endcsname
+ \noexpand\do{\the\@temptokena}%
+ }%
+ }%
+ \expandafter\endgroup\fontaxes@foreach@
+}
+%</package>
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Tests}
+%
+% The file |test-fontaxes.tex| (docstrip target |test|) exercises some
+% features of \pkg{fontaxes}. Since it is rather ad-hoc code, it is not shown
+% here. (It also requires the \pkg{MinionPro} package.)
+%
+% \Finale
+% \endinput
+%
+% \begin{macrocode}
+%<*test>
+\documentclass[a4paper]{article}
+\usepackage{MinionPro}
+\usepackage[T1]{fontenc}
+
+\usepackage{longtable}
+\usepackage{fontaxes}
+\usepackage{hyperref}
+
+\makeatletter
+\newcommand\showshape{\hphantom{\normalfont\textsuperscript{sscsw}}%
+ \llap{\expandafter\normalfont\expandafter\textsuperscript
+ \expandafter{\f@shape}}}
+
+\newcommand\shapecmdlist{\upshape,\itshape,\slshape,\swshape,%
+ \ulcshape,\scshape,\sscshape}
+\newcommand\reacheableshapes{}
+\newtoks\tab
+\newcommand\atab[1]{%
+ \tab\expandafter{\the\tab#1}%
+}
+\newcommand\etab[1]{%
+ \edef\line{#1}%
+ \expandafter\atab\expandafter{\line}%
+}
+\newif\ifadded
+\newcommand\testall{%
+ \edef\reacheableshapes{\shapedefault}
+ \addedtrue
+ \@whilesw\ifadded\fi{%
+ \addedfalse
+ \@for\@sh:=\reacheableshapes\do{%
+ \begingroup
+ \fontshape\@sh\relax
+ \@for\@cmd:=\shapecmdlist\do{%
+ \@cmd\relax
+ \@expandtwoargs\in@{,\f@shape,}{,\reacheableshapes,}%
+ \ifin@\else
+ \xdef\reacheableshapes{\reacheableshapes,\f@shape}%
+ \global\addedtrue
+ \fi
+ }%
+ \endgroup
+ }%
+ }
+ \tab{\begin{longtable}[t]{ll}}
+ \@for\@sh:=\reacheableshapes\do{%
+ \etab{\noexpand\fontshape{\@sh}}%
+ \atab{\selectfont\showshape Am Anfang &}%
+ \etab{\noexpand\fontshape{\@sh}}%
+ \atab{\begin{tabular}[t]{ll}}%
+ \@for\@cmd:=\shapecmdlist\do{%
+ \atab{\normalfont\ttfamily}%
+ \etab{\expandafter\string\@cmd &
+ \expandafter\noexpand\@cmd\noexpand\showshape war das Wort%
+ \noexpand\\\relax}%
+ }%
+ \atab{\end{tabular} \\\relax}%
+ }
+ \atab{\end{longtable}\endgraf}%
+ \the\tab
+}
+
+\makeatother
+\parindent=0pt
+
+\begin{document}
+
+\section{Shape}
+\subsection{Switches}
+\fontbasefamily{MinionPro}\selectfont
+\figureversion{text,proportional}%
+\testall
+
+\subsection{Text font commands}
+
+\makeatletter
+\def\amp{&}
+\def\visible#1#2\\{%
+ #1#2 \amp {\def\@tempa{#1}\edef\@tempa{\expandafter
+ \strip@prefix\meaning\@tempa}\normalfont\ttfamily{\@tempa}}\\}
+\makeatother
+\begin{tabular}{ll}
+Am \visible{\textit{Anfang \textsc{war}}} das Wort\\
+Am \visible{\textsl{Anfang \textulc{war}}} das Wort\\
+Am \visible{\textsw{Anfang \textssc{war}}} das Wort\\
+Am \visible{\textsc{Anfang \textsl{war}}} das Wort\\
+Am \visible{\textssc{Anfang \textit{war}}} das Wort\\
+\end{tabular}
+
+\section{Figure version}
+
+\tracingmacros=2
+\begin{tabular}{lll}
+\visible\txfigures 12345 \visible\lnfigures 67890\\
+\visible\txfigures 12345 \visible\tbfigures 67890\\
+\visible\txfigures 12345 \visible\prfigures 67890\\
+\visible\txfigures 12345 \visible\txfigures 67890\\
+\visible\lnfigures 12345 \visible\lnfigures 67890\\
+\visible\lnfigures 12345 \visible\tbfigures 67890\\
+\visible\lnfigures 12345 \visible\prfigures 67890\\
+\visible\lnfigures 12345 \visible\txfigures 67890\\
+\visible\tbfigures 12345 \visible\lnfigures 67890\\
+\visible\tbfigures 12345 \visible\tbfigures 67890\\
+\visible\tbfigures 12345 \visible\prfigures 67890\\
+\visible\tbfigures 12345 \visible\txfigures 67890\\
+\visible{\tbfigures\lnfigures}12345
+ \visible\lnfigures 67890\\
+\visible{\tbfigures\lnfigures}12345
+ \visible\tbfigures 67890\\
+\visible{\tbfigures\lnfigures}12345
+ \visible\prfigures 67890\\
+\visible{\tbfigures\lnfigures}12345
+ \visible\txfigures 67890\\
+\end{tabular}
+
+\begingroup
+\figureversion{osf,lf,tab,prop, tabular,proportional , text ,lining,
+non-existent}
+\endgroup
+
+\subsection{Switch base family}
+
+\begingroup
+\def\nums{1234567890\par}
+\txfigures MinionPro \nums
+\fontbasefamily{ppl}\selectfont
+Palatino \nums
+\lnfigures
+lining \nums
+\fontbasefamily{MinionPro}\selectfont
+MinionPro \nums
+\figureversion{lining,tabular}%
+lining and tabular \nums
+\fontbasefamily{ppl}\selectfont
+Palatino \nums
+\txfigures
+text \nums
+\fontbasefamily{MinionPro}\selectfont
+MinionPro again, should be text \emph{and tabular} \nums
+\endgroup
+
+\subsection{Text font commands}
+
+\def\nums{t123 $m123$}
+\begin{tabular}{lll}
+\nums\quad\visible{(\textfigures{\nums})}\quad \nums\\
+\nums\quad\visible{(\liningfigures{\nums})}\quad \nums\\
+\nums\quad\visible{(\tabularfigures{\nums})}\quad \nums\\
+\nums\quad\visible{(\proportionalfigures{\nums})}\quad \nums\\
+\nums\quad\visible{(\tabularfigures{\liningfigures{\nums}})}\quad \nums\\
+\end{tabular}
+
+\begingroup Same but start from lining tabular figures\par
+\lnfigures\tbfigures
+\begin{tabular}{lll}
+\nums\quad\visible{(\textfigures{\nums})}\quad \nums\\
+\nums\quad\visible{(\liningfigures{\nums})}\quad \nums\\
+\nums\quad\visible{(\tabularfigures{\nums})}\quad \nums\\
+\nums\quad\visible{(\proportionalfigures{\nums})}\quad \nums\\
+\nums\quad\visible{(\tabularfigures{\liningfigures{\nums}})}\quad \nums\\
+\end{tabular}
+\endgroup
+
+\subsection{In moving argument: o123 \liningfigures{l456}
+ \tabularfigures{t789}
+ \figureversion{text,text,lining,text,proportional}op012 \textsw{Swash}
+ \textssc{Spaced \textulc{Small} Caps}}
+
+\tableofcontents
+
+\section{Math version}
+
+\def\formula{$123 + a - \sqrt{\beta}$}
+\begin{tabular}{lll}
+\visible\unboldmath \formula\quad \visible\boldmath \formula\\
+\visible\unboldmath \formula\quad \visible\tabularmath \formula\\
+\visible\unboldmath \formula\quad \visible\proportionalmath \formula\\
+\visible\unboldmath \formula\quad \visible\unboldmath \formula\\
+\visible\boldmath \formula\quad \visible\boldmath \formula\\
+\visible\boldmath \formula\quad \visible\tabularmath \formula\\
+\visible\boldmath \formula\quad \visible\proportionalmath \formula\\
+\visible\boldmath \formula\quad \visible\unboldmath \formula\\
+\visible\tabularmath \formula\quad \visible\boldmath \formula\\
+\visible\tabularmath \formula\quad \visible\tabularmath \formula\\
+\visible\tabularmath \formula\quad \visible\proportionalmath \formula\\
+\visible\tabularmath \formula\quad \visible\unboldmath \formula\\
+\visible{\tabularmath\boldmath}\formula\quad \visible\boldmath \formula\\
+\visible{\tabularmath\boldmath}\formula\quad \visible\tabularmath \formula\\
+\visible{\tabularmath\boldmath}\formula\quad \visible\proportionalmath \formula\\
+\visible{\tabularmath\boldmath}\formula\quad \visible\unboldmath \formula\\
+\end{tabular}
+
+\section{Recovery}
+
+\makeatletter
+\def\showfont{\edef\@tempa{\curr@fontshape}\hfill
+{\normalfont\ttfamily\@tempa}}
+\def\showmath{$123xyz$ \edef\@tempa{\math@version}\hfill
+{\normalfont\ttfamily\@tempa}}
+\makeatother
+
+\begingroup
+\scshape scshape \showfont\par
+\fontshape{scit}\selectfont selecting scit explicitly \showfont\par
+\sscshape Sscshape should adapt\showfont\par
+\endgroup
+
+\bigskip
+\begingroup
+\boldmath boldmath \showmath\par
+\mathversion{tabular} selecting tabular explicitly \showmath\par
+\boldmath boldmath \showmath\par
+\endgroup
+
+\bigskip
+\begingroup
+\fontfamily{MinionPro-LF}\selectfont selecting MinionPro-LF explicitly \showfont\par
+\tbfigures tabularfigures 1234 \showfont\par
+\endgroup
+
+\bigskip
+\begingroup
+\tbfigures tabularfigures 1234 \showfont\par
+\fontfamily{pplx}\selectfont selecting pplx explicitly \showfont\par
+\txfigures textfigures 1234 \showfont\par
+\fontbasefamily{MinionPro}\selectfont
+Back to MinionPro (is tabular still there?) 1234 \showfont\par
+\fontfamily{ptm}\selectfont selecting ptm explicitly \showfont\par
+\lnfigures liningfigures 1234 \showfont\par
+\tbfigures tabularfigures 1234 \showfont\par
+\fontbasefamily{MinionPro}\selectfont Back \dots 1234 \showfont\par
+\endgroup
+
+\end{document}
+%</test>
+% \end{macrocode}
diff --git a/Master/texmf-dist/source/latex/fontaxes/fontaxes.ins b/Master/texmf-dist/source/latex/fontaxes/fontaxes.ins
new file mode 100644
index 00000000000..7ed577b30a1
--- /dev/null
+++ b/Master/texmf-dist/source/latex/fontaxes/fontaxes.ins
@@ -0,0 +1,56 @@
+%
+% Copyright (c) 2007 by Andreas B\"uhmann
+% Copyright (c) 2011 by Michael Ummels <michael.ummels@rwth-aachen.de>
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3c
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is Michael Ummels.
+%
+% This work consists of the files fontaxes.dtx, fontaxes.ins and
+% the derived files fontaxes.sty, test-fontaxes.tex and fontaxes.pdf.
+%
+
+\input docstrip
+
+\preamble
+
+Copyright (c) 2007 by Andreas Buehmann
+Copyright (c) 2011 by Michael Ummels <michael.ummels@rwth-aachen.de>
+
+This work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.3c
+of this license or (at your option) any later version.
+The latest version of this license is in
+ http://www.latex-project.org/lppl.txt
+and version 1.3 or later is part of all distributions of LaTeX
+version 2005/12/01 or later.
+
+This work has the LPPL maintenance status `maintained'.
+
+The Current Maintainer of this work is Michael Ummels.
+
+This work consists of the files fontaxes.dtx, fontaxes.ins and
+the derived files fontaxes.sty, test-fontaxes.tex and fontaxes.pdf.
+
+\endpreamble
+
+\postamble
+\endpostamble
+
+\keepsilent
+\askforoverwritefalse
+
+\generate{
+ \file{fontaxes.sty}{\from{fontaxes.dtx}{package}}
+ \file{test-fontaxes.tex}{\from{fontaxes.dtx}{test}}
+}
+
+\endbatchfile