new font superiors (15aug12)

git-svn-id: svn://tug.org/texlive/trunk@27419 c570f23f-e606-0410-a88d-b1316a301751

14 files changed, 254 insertions, 1 deletions

diff --git a/Master/texmf-dist/doc/fonts/superiors/README b/Master/texmf-dist/doc/fonts/superiors/README
new file mode 100644
index 00000000000..c981f6ea22b
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/superiors/README
@@ -0,0 +1,13 @@
+This small package provides a means of adding to or modifying the superior figures used for footnote and endnote markers in any font collection.
+
+Current version: 1.00
+
+This material is subject to the LaTeX Project Public License. See http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for the details of that license.
+
+The package provides one superior figures font drawn from the Linux Libertine collection---installation requires enabling superiors.map. The default superior figures font is distributed with newtx, and provides figures based on STIX superior figures, compatible with Times and other heavy fonts.
+
+Any existing fonts collection, such as might be constructed by otfinst, may be used provided it has a complete set of superior digits.
+
+Please send comments and bug reports or suggestions for improvement to
+
+msharpe at ucsd dot edu
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/fonts/superiors/libfoot0-crop.pdf b/Master/texmf-dist/doc/fonts/superiors/libfoot0-crop.pdf
new file mode 100644
index 00000000000..d241a9fbc4b
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/superiors/libfoot0-crop.pdf
diff --git a/Master/texmf-dist/doc/fonts/superiors/libfoot1-crop.pdf b/Master/texmf-dist/doc/fonts/superiors/libfoot1-crop.pdf
new file mode 100644
index 00000000000..7468771f3dd
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/superiors/libfoot1-crop.pdf
diff --git a/Master/texmf-dist/doc/fonts/superiors/stempelfoot0-crop.pdf b/Master/texmf-dist/doc/fonts/superiors/stempelfoot0-crop.pdf
new file mode 100644
index 00000000000..3ae5d3ec1b1
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/superiors/stempelfoot0-crop.pdf
diff --git a/Master/texmf-dist/doc/fonts/superiors/stempelfoot1-crop.pdf b/Master/texmf-dist/doc/fonts/superiors/stempelfoot1-crop.pdf
new file mode 100644
index 00000000000..e39fe5ca900
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/superiors/stempelfoot1-crop.pdf
diff --git a/Master/texmf-dist/doc/fonts/superiors/superiors-doc.pdf b/Master/texmf-dist/doc/fonts/superiors/superiors-doc.pdf
new file mode 100644
index 00000000000..531e7db334e
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/superiors/superiors-doc.pdf
diff --git a/Master/texmf-dist/doc/fonts/superiors/superiors-doc.tex b/Master/texmf-dist/doc/fonts/superiors/superiors-doc.tex
new file mode 100644
index 00000000000..e1d775d0cdb
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/superiors/superiors-doc.tex
@@ -0,0 +1,106 @@
+\documentclass[11pt]{amsart}
+\usepackage[margin=.75in]{geometry} 
+\usepackage[parfill]{parskip}%\usepackage{graphicx}
+\usepackage{graphicx}
+%SetFonts
+% libertine text and newtxmath
+\usepackage{libertine}
+\usepackage[TS1,T1]{fontenc}
+\usepackage{textcomp}
+\usepackage[scaled=.85]{beramono} 
+\usepackage[libertine,cmbraces]{newtxmath}
+\renewcommand*{\rmdefault}{fxlj} %old-style figures in text, not math
+\def\libertine{\fontfamily{fxlj}\selectfont}
+%SetFonts
+\usepackage[supstfm=libertinesups,%
+  supscaled=1.2,%
+  raised=-.13em]{superiors}
+\title{Superior Figures}
+\author{Michael Sharpe}
+\date{\today}  % Activate to display a given date or no date
+
+\begin{document}
+\maketitle
+\section{Briefly}
+The default behavior of footnote and endnote markers in \LaTeX\ is to print the number as if it were a mathematical superscript. In most cases, this means the size is about 70\% of the normal lining figure and the top is somewhat above the tops of capital letters. In many cases, the superscript figure is simply reduced in all dimensions by about 70\%, making them appear rather slight, though overly tall. (The \textsf{libertine} package used for preparing this document has a custom footnote illustrated below.)
+
+As an alternative, one may use superior figures---small figures, usually 50\% to 60\% of the height of lining figures, like \textsu{1234567890}. Commonly, they are designed so that the tops of the numbers are aligned with the tops of the capital letters in the font, though sometimes a little higher, corresponding to the ascender height. PostScript fonts have for a long time mostly contained just a small subset $\{1,2,3\}$ of the possible superior digits, and most OpenType fonts in the Adobe portfolio, other than the most popular and the most recent, contain the same small subset. Moreover, the \textsf{TS1} encoding includes slots for only those three superior figures. Even the recent STIX collection contains just the basic three.
+
+
+This package allows you to add a full set of superior figures to a font family that lacks one. It uses two predefined collections---the default is {\tt ntxsups}, a collection matching Times, derived from the STIX fonts (digits 1..8 were taken from the vulgar fraction glyphs, and the digits 0, 9 were constructed to match them using FontForge) while the second, {\tt libertinesups}, is taken from Libertine-Legacy. (The standard \textsf{libertine} package provides no access to these glyphs other than through footnote markers.) In addition, you may specify any \TeX\ tfm whose figure slots contain superior figures. The package also allows you to scale the size of the imported figures, to take into account your general font scaling,  and to specify an amount by which to raise the imported, rescaled figures. You may also specify a spacing to apply before the footnote marker, using the parameter {\tt supspaced}. The package should be loaded after your Roman text font package\footnote{The {\tt newtxtext} package uses the {\tt ntxsups} superiors contained in the newtx package by default for footnote markers.}. 
+
+\textsc{Sample Invocations:}
+
+\begin{itemize}
+\item Times-like, no rescaling or raising, but with $.04${\tt em} space before footnote markers:
+\begin{verbatim}
+\usepackage[supspaced=.04em]{superiors}
+\end{verbatim}
+\item Libertine superiors scaled up by 20\%, then lowered:
+\begin{verbatim}
+\usepackage{libertine}
+\usepackage[supstfm=libertinesups,%
+  supscaled=1.2,%
+  raised=-.13em]% match XHeight of libertine
+{superiors}
+\end{verbatim}
+\item Use MinionPro\footnote{Assumes you have installed MinionPro according to the directions in the \textsf{minion2newtx} package.}
+ superiors at default size, lowered a bit:
+\begin{verbatim}
+\usepackage[supstfm=T1-Minion2Pro-Regular-sups-kern-liga,%
+  raised=-.05em]%
+{superiors}
+\end{verbatim}
+\end{itemize}
+
+It is best to specify a relative unit for the {\tt raised} and {\tt supspaced} parameters so that they change with the font size. (Recall that for a $10${\tt pt} font, {\tt 1em} is usually {\tt 10pt}, but the actual size of {\tt 1em} is defined relative to font size.)
+
+The following example compares libertine with its default footnote markers against libertine with the superiors package as described in the second example above:
+
+\[\includegraphics{libfoot0-crop} \qquad\includegraphics{libfoot1-crop}\]
+
+There is another parameter named {\tt scaled} that should be used only if you loaded your text font with a scale parameter different from $1.0$, and in this case, you should use the same scale parameter. For example:
+\begin{verbatim}
+\usepackage[lining,scaled=1.05]{bembo}
+\usepackage[scaled=1.05,%
+  supstfm=libertinesups,% libertine
+  supscaled=1.2,%
+  raised=-.13em]%
+{superiors}
+\end{verbatim}
+\section{Issues with superior figures}
+If a number of figure styles are available, many packages make use of \textsf{nfssext} (or its further extension \textsf{nfssext-cfr}) to access those special forms. For superior figures, two macros are defined by \textsf{nfssext}: \verb|\sustyle| and \verb|\textsu|, the first of which changes the text font to a font with superior figures (and is usually called with action confined to a group), while the second is a macro called like \verb|\textsu{123}| which applies \verb|\sustyle| to just its argument. In packages generated by {\tt otfinst}, if superior figures are available (even if only three of them), it redefines \verb|\@makefnmark|:
+\begin{verbatim}
+\def\@makefnmark{\hbox{\sustyle\@thefnmark}}
+\end{verbatim}
+so that it uses figures in \verb|\sustyle|. That leads to problems if you use footnote markers greater than three. For example, in Stempel Garamond, where there are only three superior figures available, the first graphic shows the default footnote markers provided by \textsf{otfinst}, the second shows the document processed with libertine footnote markers using 
+\begin{verbatim}
+\usepackage[supstfm=libertinesups,%
+  supscaled=1.2,%
+  raised=-.04em
+]{superiors}
+\end{verbatim}
+
+\[\includegraphics{stempelfoot0-crop} \qquad\includegraphics{stempelfoot1-crop}\]
+This package redefines these macros so that \verb|\sustyle| changes the font and applies the scaling changes, while changes due to the {\tt raised} parameter are applied only within \verb|\textsu|. For this reason, we have to modify the definition of \verb|\@makefnmark| as follows:
+\begin{verbatim}
+\def\@makefnmark{\hbox{\textsu{\hspace*{superiors@spaced}\@thefnmark}}}
+\end{verbatim}
+
+Relatively few Opentype text font families have a complete set of superior figures that can be accessed after running \textsf{otfinst}. Other than those listed above, the following are known to me to have a complete set of superior figures:
+\begin{verbatim}
+Adobe Bembo Std
+Adobe Caslon Pro
+Adobe Warnock Pro
+Monotype Dante Std
+Monotype Bell Std
+Monotype Perpetua Std
+Adobe Garamond Premier Pro
+Adobe Brioso Pro
+Adobe Arno Pro
+Adobe Kinesis Std
+Adobe Jenson Pro
+Adobe Kepler Std
+\end{verbatim}
+
+\end{document}  
\ No newline at end of file
diff --git a/Master/texmf-dist/fonts/enc/public/superiors/sups.enc b/Master/texmf-dist/fonts/enc/public/superiors/sups.enc
new file mode 100644
index 00000000000..f914faff2cc
--- /dev/null
+++ b/Master/texmf-dist/fonts/enc/public/superiors/sups.enc
@@ -0,0 +1,86 @@
+% File sups.enc  
+%
+% Encodes superior figures which may serve as replacements for font lacking them.
+/SupsEncoding [
+% 0x00
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0x10
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0x20
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0x30
+ /zero.superior /one.superior /two.superior /three.superior
+ /four.superior /five.superior /six.superior /seven.superior
+ /eight.superior /nine.superior /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0x40
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ % 0x50
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0x60
+/.notdef /.notdef /.notdef /.notdef
+/.notdef /.notdef /.notdef /.notdef
+/.notdef /.notdef /.notdef /.notdef
+/.notdef /.notdef /.notdef /.notdef
+% 0x70
+/.notdef /.notdef /.notdef /.notdef
+/.notdef /.notdef /.notdef /.notdef
+/.notdef /.notdef /.notdef /.notdef
+/.notdef /.notdef /.notdef /.notdef
+% 0x80
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0x90
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0xA0
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0xB0
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0xC0
+  /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0xD0
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0xE0
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+% 0xF0
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+ /.notdef /.notdef /.notdef /.notdef
+] def
+
diff --git a/Master/texmf-dist/fonts/map/dvips/public/superiors/superiors.map b/Master/texmf-dist/fonts/map/dvips/public/superiors/superiors.map
new file mode 100644
index 00000000000..d377f5098b5
--- /dev/null
+++ b/Master/texmf-dist/fonts/map/dvips/public/superiors/superiors.map
@@ -0,0 +1,2 @@
+libertinesups LinLibertine " SupsEncoding ReEncodeFont " <[sups.enc <fxlr.pfb
+crdo-sups Crdo-sups <crdo-sups.pfb
\ No newline at end of file
diff --git a/Master/texmf-dist/fonts/tfm/public/superiors/libertinesups.tfm b/Master/texmf-dist/fonts/tfm/public/superiors/libertinesups.tfm
new file mode 100644
index 00000000000..2fb6f1f00c7
--- /dev/null
+++ b/Master/texmf-dist/fonts/tfm/public/superiors/libertinesups.tfm
diff --git a/Master/texmf-dist/tex/latex/public/superiors/superiors.sty b/Master/texmf-dist/tex/latex/public/superiors/superiors.sty
new file mode 100644
index 00000000000..c089498c2db
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/public/superiors/superiors.sty
@@ -0,0 +1,43 @@
+\NeedsTeXFormat{LaTeX2e}
+\def\superiorsVersion{1.0}
+\def\superiorsDate{2012/08/11}
+\ProvidesPackage{superiors}[\superiorsDate\space-\space\superiorsVersion
+ superiors (License LPPL) Michael Sharpe]
+\RequirePackage{xkeyval}
+
+\def\supstfm{ntxsups}
+\newdimen\superiors@scale
+\def\superiors@raised{\z@}
+\def\superiors@spaced{\z@}
+\def\superiors@scaledval{1.0}
+\def\superiors@supscale{1.0}
+\define@key{superiors}{scaled}[1.0]{\def\superiors@scaledval{#1}}
+\define@key{superiors}{supscaled}[1.0]{\def\superiors@supscale{#1}}
+\define@key{superiors}{raised}[\z@]{\def\superiors@raised{#1}}
+\define@key{superiors}{supstfm}[ntxsups]{\def\supstfm{#1}}
+\define@key{superiors}{supspaced}[\z@]{\def\superiors@spaced{#1}}
+\DeclareOption*{%
+  \begingroup
+  \edef\x{\endgroup
+    \noexpand\setkeys{superiors}{\CurrentOption}}%
+  \x}
+
+\ProcessOptions*
+
+\setlength{\superiors@scale}{\superiors@scaledval\p@}
+\superiors@scale=\superiors@supscale\superiors@scale %
+\def\superiors@scaled{s*[\strip@pt\superiors@scale]}
+
+\DeclareFontFamily{U}{zsups}{}%
+  \DeclareFontShape{U}{zsups}{m}{n}{%
+    <-> \superiors@scaled \supstfm
+}{}
+\DeclareRobustCommand{\sustyle}{%
+  \not@math@alphabet\sustyle\relax
+  \usefont{U}{zsups}{m}{n}}
+
+\def\textsu#1{\raisebox{\superiors@raised}{\hbox{{\sustyle#1}}}}
+
+\def\@makefnmark{\hbox{\textsu{\hspace*{\superiors@spaced}\@thefnmark}}}
+
+\endinput
\ No newline at end of file
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index c9ad51dc064..5b0f8bb633c 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -382,7 +382,8 @@ my @TLP_working = qw(
     subfig subfigmat subfigure subfiles subfloat substances
     substitutefont substr subsupscripts
     sudoku sudokubundle suftesi sugconf
-    supertabular susy svg-inkscape svgcolor svn svn-multi svn-prov svninfo
+    superiors supertabular susy svg-inkscape svgcolor
+    svn svn-multi svn-prov svninfo
     swebib swimgraf syllogism syntax synproof syntrace synttree
     systeme
   t-angles t2
diff --git a/Master/tlpkg/tlpsrc/collection-fontsextra.tlpsrc b/Master/tlpkg/tlpsrc/collection-fontsextra.tlpsrc
index 056138705e8..9729fb17bf7 100644
--- a/Master/tlpkg/tlpsrc/collection-fontsextra.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-fontsextra.tlpsrc
@@ -159,6 +159,7 @@ depend skull
 depend staves
 depend starfont
 depend stix
+depend superiors
 depend tapir
 depend tengwarscript
 depend tfrupee
diff --git a/Master/tlpkg/tlpsrc/superiors.tlpsrc b/Master/tlpkg/tlpsrc/superiors.tlpsrc
new file mode 100644
index 00000000000..972a5412c0b
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/superiors.tlpsrc
@@ -0,0 +1 @@
+execute addMap superiors.map