% Copyright (c) 2002--2004 Philipp Lehman
% Permission is granted to copy, distribute and/or modify this document under
% the terms of the GNU Free Documentation License, version 1.2, with no
% invariant sections, no front-cover texts, and no back-cover texts. This
% document is distributed in the hope that it will be useful, but without any
% warranty; without even the implied warranty of merchantability or fitness for
% a particular purpose.

\documentclass[a4paper,12pt]{book}
\usepackage[latin9]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{lmodern}
\usepackage{hyperref}
\usepackage{shortvrb}
\usepackage{listings}
\usepackage{tabularx}
\usepackage{longtable}
\usepackage{booktabs}
\usepackage{csquotes}
\usepackage{array}
\usepackage{color}
\usepackage{xspace}
\usepackage{calc}

% output format

\ifpdf
  \usepackage{pdfcolmk}
  \hypersetup{plainpages=false,
              pdfpagelabels=true,
	      colorlinks=true,
	      bookmarksnumbered=false,
	      bookmarksopen=true}
\fi

% miscellanea

\setcounter{secnumdepth}{1}
\setcounter{tocdepth}{1}
\newcommand*{\defaultcolor}{\color{black}}
\newcommand*{\spotcolor}{\color{red}}
\frenchspacing
\raggedbottom

% chapter headings

\AtBeginDocument{\renewcommand*{\chaptername}{Tutorial}}

% environments

\newenvironment{anumerate}
  {\def\theenumi{\Alph{enumi}}%
   \enumerate}
  {\endenumerate}

\newenvironment{changelog}
  {\list{}{%
     \setlength{\leftmargin}{2.5em}%
     \setlength{\labelwidth}{0pt}%
     \setlength{\labelsep}{0pt}%
     \setlength{\itemsep}{0pt}%
     \setlength{\parsep}{0pt}%
     \let\makelabel\releaselabel}}
  {\endlist}

\makeatletter
\newcommand*{\releaselabel}[1]{%
  \if @#1@%
    \global\@itempenalty\z@
  \else
    \global\@itempenalty\@M
    \hspace{-\leftmargin}\bfseries
    \@releaselabel #1@%
  \fi}
\def\@releaselabel#1 #2@{%
  \makebox[\leftmargin-0.5em][r]{#1}%
  \hspace{0.5em}#2}
\makeatother

% display/inline verbatim

\MakeShortVerb{\|}

\newcommand*{\displayverbfont}{%
  \ttfamily\fontsize{8}{10}\selectfont}

\makeatletter
\providecommand{\toclevel@lstlisting}{5}
\makeatother

\lstset{%
  aboveskip=0.5\baselineskip,
  belowskip=0.5\baselineskip,
  basicstyle=\displayverbfont,
  commentstyle=\itshape,
  emphstyle=\spotcolor,
  numberstyle=\tiny\defaultcolor,
  numbersep=8pt,
  basewidth=0.5em,
  fontadjust=true,
  flexiblecolumns=true,
  keepspaces=false}

\lstdefinestyle{plain}{}
\lstdefinestyle{shell}{}
\lstdefinestyle{afm}{%
  moredelim=[is][\spotcolor]{\#}{\#}}
\lstdefinestyle{map}{%
  moredelim=[is][\spotcolor]{\#}{\#}}
\lstdefinestyle{postscript}{%
  comment=[l]{\%},
  moredelim=[is][\spotcolor]{\#}{\#}}
\lstdefinestyle{texconf}{%
  comment=[l]{\%},
  moredelim=[is][\spotcolor]{\#}{\#}}
\lstdefinestyle{fontinst}{%
  numbers=left,
  escapeinside={\%*}{\^^M},
  moredelim=[is][\spotcolor]{\%\#}{\#\%}}
\lstdefinestyle{latex}{%
  numbers=left,
  escapeinside={\%*}{\^^M},
  moredelim=[is][\spotcolor]{\%\#}{\#\%}}

% tables

\makeatletter

\newcolumntype{R}[2]{>{\column@hspace{#1}{#2}\ttfamily}r<{}}
\newcolumntype{L}[2]{>{\ttfamily}r<{\column@hspace{#1}{#2}}}
\newcolumntype{T}[1]{>{\usefont{T1}{cmr}{m}{n}}p{#1}}

\newcommand*{\column@hspace}[2]{%
  \settowidth{\@tempdimb}{\texttt{#2}}%
  \setlength{\@tempdima}{#1-\@tempdimb}%
  \hspace{0.5\@tempdima}}

\makeatother

% fonts: some pathetic workarounds

\let\textos\relax
\let\textln\relax
\let\osstyle\relax
\let\lnstyle\relax
\let\caps\textsc

\makeatletter

\newcommand{\textfrac}[2]{%
  \leavevmode
  \begingroup
    \setlength{\@tempdima}{\f@size pt*\real{0.6}}%
    \begingroup
      \fontsize{\@tempdima}{\baselineskip}\selectfont
      \setlength{\@tempdimb}{\heightof{0}*\real{0.7}}%
      \raisebox{\@tempdimb}{#1}%
    \endgroup
    \textfractionsolidus
    \begingroup
      \fontsize{\@tempdima}{\baselineskip}\selectfont #2%
    \endgroup
  \endgroup}

\makeatother

% general markup, names, acronyms

\makeatletter

\DeclareRobustCommand*{\fnurl}{\hyper@normalise\href@fnurl}
\newcommand*{\href@fnurl}[1]{\footnote{\hyper@linkurl{\Hurl{#1}}{#1}}}

\makeatother

\let\bin\path
\let\sty\path
\newcommand*{\env}[1]{{\ttfamily\selectfont\$#1}}

\newcommand*{\tex}{TeX\xspace}
\newcommand*{\latex}{La\-TeX\xspace}
\newcommand*{\pdftex}{pdf\-TeX\xspace}
\newcommand*{\dvips}{dvips\xspace}
\newcommand*{\dvipdfm}{dvipdfm\xspace}
\newcommand*{\xdvi}{xdvi\xspace}
\newcommand*{\texinfo}{Tex\-info\xspace}
\newcommand*{\tetex}{te\-TeX\xspace}
\newcommand*{\miktex}{MiK\-TeX\xspace}
\newcommand*{\MF}{Meta\-font\xspace}
\newcommand*{\unix}{Unix\xspace}
\newcommand*{\ascii}{Ascii\xspace}
\newcommand*{\PS}{Post\-Script\xspace}
\newcommand*{\Tone}{Type~1\xspace}
\newcommand*{\PSTone}{\PS\Tone}
\newcommand*{\TT}{True\-Type\xspace}
\newcommand*{\OT}{Open\-Type\xspace}
\newcommand*{\micropress}{Micro\-Press\xspace}
\newcommand*{\ctan}{\textsc{ctan}\xspace}
\newcommand*{\ftp}{\textsc{ftp}\xspace}
\newcommand*{\pdf}{\textsc{pdf}\xspace}
\newcommand*{\dvi}{\textsc{dvi}\xspace}
\newcommand*{\pk}{\textsc{pk}\xspace}
\newcommand*{\nfss}{\textsc{nfss}\xspace}
\newcommand*{\tds}{\textsc{tds}\xspace}
\newcommand*{\scosf}{\textsc{sc\,\&\,osf}\xspace}
\newcommand*{\osf}{\textsc{osf}\xspace}
\newcommand*{\mb}{\,\textsc{mb}\xspace}
\newcommand*{\toneenc}{T1\xspace}
\newcommand*{\tsoneenc}{TS1\xspace}
\newcommand*{\otoneenc}{OT1\xspace}
\newcommand*{\lyoneenc}{LY1\xspace}
\newcommand*{\qxenc}{QX1\xspace}
\newcommand*{\ttwoaenc}{T2A\xspace}
\newcommand*{\ttwobenc}{T2B\xspace}
\newcommand*{\ttwocenc}{T2C\xspace}
\newcommand*{\xtwoenc}{X2\xspace}
\newcommand*{\baseone}{\tex Base~1\xspace}

\begin{document}

\pagestyle{empty}

\begingroup\centering

\vspace*{2\baselineskip}

{\Huge\bfseries The Font\par Installation Guide\par}

\vspace{\baselineskip}

{\large Using Postscript fonts to their full\par
 potential with Latex\par}

\vspace{\baselineskip}

{\small Originally written by\par}

\vspace{\baselineskip}

{\large Philipp Lehman\par}

\vfill

{\large December 2004 \textperiodcentered\ Revision 2.14\par}

\vspace*{4\baselineskip}

\clearpage\null\vfill

\begin{minipage}[b]{0.8\textwidth}
\footnotesize\raggedright
\setlength{\parskip}{0.5\baselineskip}

Copyright © 2002--2004 Philipp Lehman

Permission is granted to copy, distribute and\slash or modify this document under the terms of the GNU Free Documentation License, version 1.2, with no invariant sections, no front-cover texts, and no back-cover texts.

A copy of the license is included in the appendix.

This document is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.
\end{minipage}

\endgroup
\vspace*{4\baselineskip}

\cleardoublepage
\pagestyle{headings}

\tableofcontents

\chapter*{Introduction}
\label{introduction}
\addcontentsline{toc}{chapter}{Introduction}

This guide to setting up \PSTone fonts for use with \tex and \latex is not systematic but task-oriented. It will discuss the most common scenarios you are likely to encounter when installing \PS fonts. The individual tutorials collected here are not self-contained, though: the second tutorial will presuppose that you have read the first one and so on. All the tools employed in the installation process are documented well, the actual difficulty most users are facing when trying to install new fonts is understanding how to put all the pieces together. This applies to fontinst, the \tex font installation tool, in particular. Controlled by \tex commands, fontinst is a powerful and extremely flexible tool. While its manual documents all available commands individually, you will most likely wonder how to actually employ them after reading the manual. This is what this guide is about.

\begin{trivlist}\bfseries
\item Please note that the original author of this guide has resigned as maintainer. As of this writing (August 2010), almost all of the information in this document is still applicable. Section \ref{basics:mapfile}, however, is in need of a partial update and the Fontname scheme has been gradually losing its attraction.
\end{trivlist}

\section*{Additional documentation}

You will need the following additional manuals while working with this guide:

\begin{description}

\item[The fontinst manual] Shipping as \path{fontinst.dvi}, the fontinst manual is the most important piece of documentation you will need when working with this guide since all files required for proper \PS font support can be generated with fontinst. You do not need to work through the sections explaining all low-level commands in detail, but make sure that you have read the more general parts and that you have a basic understanding of what fontinst is and what it does. If this manual is not included in your distribution, get it from the Comprehensive \tex Archive Network (\ctan).\fnurl{http://www.ctan.org/tex-archive/fonts/utilities/fontinst/doc/manual/}

\item[The Fontname scheme] Fonts used with \tex are usually renamed according to a dedicated naming standard, the Fontname scheme by Karl Berry. Take a look at the outline of the scheme as given in \path{fontname.dvi} and make sure you have copies of the individual map files at hand. These lists define names for a large number of commercial \PS fonts. You will need them while working with this guide. If the documentation of the Fontname scheme is not part of your distribution, you can read it online\fnurl{http://www.ctan.org/tex-archive/info/fontname/} or download the complete package from a \ctan \ftp server.\fnurl{ftp://tug.ctan.org/tex-archive/info/fontname.tar.gz}

\item[The \latex font selection guide] It might be a good idea to read the \latex font selection guide as well before proceeding with the first tutorial. It provides an overview of the New Font Selection Scheme (\nfss), the part of \latex which controls font selection. This system is not used during font installation, but it will help you to understand certain aspects of the installation process. This guide ships with most \tex distributions as \path{fntguide.dvi} and is also available in \pdf format from \ctan.\fnurl{http://www.ctan.org/tex-archive/macros/latex/doc/fntguide.pdf} Feel free to skip the chapter about math fonts as we are only going to deal with text fonts here. Setting up math fonts is a science in its own right.

\end{description}

\section*{Software requirements}

Fontinst and the tools required to compile font metrics and virtual fonts are part of all major \tex distributions. The installation recipes discussed in this guide should therefore work on virtually every platform supported by \tex. The installation procedure as a whole, however, includes certain aspects which are specific to a given platform and \tex distribution. Such aspects include the final location of fonts and support files, the way additional tools such as \dvips are configured, and the command used to update the file hash tables. In such cases the guide will be referring to the \tetex distribution. Adapting these instructions to other platforms and distributions, however, should not pose a major obstacle. Note that the installation recipes in this guide require fontinst version 1.9 or later. As of this writing (December 2004), version 1.926 is the latest stable release available from \ctan.\fnurl{http://www.ctan.org/tex-archive/fonts/utilities/fontinst/} If you are not sure whether your \tex installation includes an up-to-date version of fontinst, locate the file \path{fontinst.sty} on your system and inspect its header. Alternatively, you can use the following plain \tex file:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\input fontinst.sty
\fontinstversion
\bye
\end{lstlisting}

\noindent Run this file through plain \bin{tex} and inspect the newly created \dvi file. It should bear the version number 1.926 or higher. If you need to update fontinst, note that you most probably require a newer version of the \PS encoding vector \path{8r.enc} for \dvips and \pdftex as well. This file is distributed separately and is not included in the fontinst release.\fnurl{http://www.ctan.org/tex-archive/info/fontname/8r.enc} The latest release of the guide you are just reading can always be found at \ctan.\fnurl{http://www.ctan.org/tex-archive/info/Type1fonts/fontinstallationguide/} You might want to check for an update before you continue.

\section*{Further assistance}

While this guide tries to address the most common questions concerning the integration of \PSTone fonts with \tex, it cannot cover all possible cases, nor will it introduce all of fontinst's features. If you have any further questions concerning fontinst after reading this guide, you might want to post them on the fontinst mailing list.\fnurl{http://www.tug.org/mailman/listinfo/fontinst/} If you are in need of further assistance with respect to \tex and fonts in general, you might also want to consider posting them on the \tex-fonts mailing list.\fnurl{http://www.math.utah.edu/mailman/listinfo/tex-fonts/} Both lists are friendly forums enjoying competent contributors. They are not busy at all times, so allow a few days for replies before you turn to a different forum. Posting questions on the |comp.text.tex| newsgroup is worthwhile as well, especially with more general questions. This newsgroup is very busy at all times, but the replies might be less focused when it comes to specific questions about fontinst or \PSTone fonts. Please refrain from sending any questions to the author of this guide.

\chapter{The basics}
\label{basics}

This introductory tutorial serves two purposes. It covers the most basic installation scenario by explaining how to use fontinst's |\latinfamily| macro to integrate a small font family into a \tex system. By providing step-by-step installation instructions, it will also discuss the installation procedure as a whole. The later tutorials will focus on the more advanced capabilities of fontinst without going over all of the installation steps again. Before we begin, let us take a look at an overview of the installation procedure:

\begin{description}

\item[Step 1: renaming the font files] First of all, we copy all \Tone fonts (suffix \path{pfb}) and the corresponding metric files in text format (\path{afm}) to a temporary directory and rename them according to the Fontname scheme.

\item[Step 2: creating metrics and virtual fonts] We will use fontinst, a font installer that works with Adobe font metric files in text format (\path{afm}), to generate \tex metric files and virtual fonts. Fontinst is normally not used interactively but controlled by a \tex file. Since the driver file is specific to a given font family, we need to write a suitable file for our fonts.

\item[Step 3: compiling metrics and virtual fonts] Fontinst will generate font metrics and virtual fonts in a human-readable format which need to be converted to a machine-readable form afterwards. Hence we run all property list files (\path{pl}) created by fontinst through \bin{pltotf} to create \tex font metrics (\path{tfm}) and all virtual property list files (\path{vpl}) through \bin{vptovf} to create virtual fonts (\path{vf}) and the corresponding \tex font metrics for them.

\item[Step 4: installing fonts and support files] Calling fontinst a font installer is slightly misleading in that it does not move any files around. We still need to move all font metrics (\path{afm}), \Tone font outlines (\path{pfb}), \tex font metrics (\path{tfm}), virtual fonts (\path{vf}), and font definition files (\path{fd}) to the local \tex tree manually.

\item[Step 5: creating and installing map files] The fonts are now set up for \tex and \latex, but not for \dvi and \pdf drivers, which are configured separately. We create map files for \dvips, \pdftex, and \xdvi. We install the map files and add them to the applications' configuration files.

\item[Step 6: updating the hash tables] Finally, we run \bin{texhash} to update the file hash tables used by the kpathsea search library. The remaining files in our working directory are not required anymore and may be deleted.

\end{description}

\section{Renaming the font files}
\label{basics:rename}

Users unfamiliar with fontinst tend to moan when introduced to the Fontname scheme for the first time. This file naming standard, which is also known by the name of its creator as the Karl Berry scheme, is often regarded as overly complicated, cumbersome, unclear, and unmanageable. And indeed, it will appear somewhat cumbersome to anyone working with an operating system that does not impose silly limits on the lengths of file names. All of that is not the fault of its creator, however, but an inevitable result of the historical need to encode a complete font designation in a string of eight characters in order to cope with the limitations of filesystems which are not capable of handling longer file names. The most important asset of the Fontname scheme is that it is the only formalized naming system widely used within the \tex community. Given the large number of files required to integrate a given typeface into a \tex system, installations without formal file naming would quickly get out of control. So, if the next couple of paragraphs should sound a bit cumbersome to you, you are in good company. Rest assured that after installing a few font families and watching your installation grow, you will understand the benefits of this scheme.

In order to understand the basic principles of the Fontname scheme, see the file \path{fontname.dvi} for an overview as well as excerpts from various map files. Browse the map files of individual vendors for the complete listings. When using the |\latinfamily| macro, strict adherence to the scheme is required. If you write a custom fontinst file using lower-level commands, the naming is technically up to you. It is still a good idea to stick to the naming system where possible. If a given typeface is not included in the map file for the respective foundry, take the foundry code from \path{supplier.map} and the code of the typeface from \path{typeface.map}. If the typeface is not listed at all, you will need to create a new code. This should be an unused one if possible. Try handling weight, variant, and encoding codes as strictly as possible. Foundry and typeface codes may be handled more liberally.

For large text font families, most font vendors do not put all fonts in a single package. They usually offer a base package containing upright and italic\slash oblique fonts plus an advanced package which has to be purchased separately and can normally not be used independently in a sensible way. Typical examples of this kind are so-called \scosf packages including a set of optical small caps\footnote{Optical or real small caps, as opposed to mechanical or \enquote*{faked} ones, are special glyphs found in a dedicated small caps font. They are preferable to mechanical small caps since they were actually drawn by the font designer. Mechanical small caps are generated by taking the tall caps of the font and scaling them down. The installation of optical small caps will be discussed in tutorial \ref{scosf}.} and hanging figures\footnote{While lining figures are aligned with the height of the capital letters, hanging or \enquote*{old style} figures have ascenders and descenders to blend in with lowercase and mixed case text. Hanging figures are designed for use within mixed case text whereas lining figures are suitable for all uppercase text only. The latter also work well for applications like numbered lists and, since they are usually monospaced, for tabular settings. The installation of hanging figures will be discussed in tutorial \ref{scosf} as well.} which complement the fonts in the base package. The advanced package might also contain a set of expert\footnote{Expert fonts are complements to be used in conjunction with regular text fonts. They usually contain optical small caps, additional sets of figures, ligatures as well as some other symbols. Please refer to tutorial \ref{expbase} for further information.} fonts, additional weights such as light, semibold, or black, additional widths such as condensed or extended, or symbols fonts providing text ornaments.

We will use Sabon as an example in this tutorial. The Sabon family offered by Adobe is split up into two packages. The base package contains upright and italic fonts (with lining figures) in regular and bold weights, while the so-called \scosf package provides optical small caps and hanging figures. Hanging figures are also known as \enquote*{old style} figures, hence the name \scosf. In the first and the second tutorial we will deal with the base package only. Adding the \scosf package to the base install will be discussed in the third tutorial. As we receive the package from Adobe or from a vendor, it contains the following files:

\begin{lstlisting}[style=plain,emph={afm,pfb}]{}
sar_____.afm    sai_____.afm     sab_____.afm    sabi_____.afm
sar_____.inf    sai_____.inf     sab_____.inf    sabi_____.inf
sar_____.pfb    sai_____.pfb     sab_____.pfb    sabi_____.pfb
sar_____.pfm    sai_____.pfm     sab_____.pfm    sabi_____.pfm
\end{lstlisting}

\noindent Of those files, we only need two types: the font metrics in \ascii format (\path{afm}) and the binary font outlines (\path{pfb}). We copy these to our working directory to rename them. In this case, finding the proper names is simple because the typeface is listed explicitly in \path{adobe.map}:

\begin{lstlisting}[style=map]{}
#psbr8a#    Sabon-Roman                       A    088    #sar_____#
#psbri8a#   Sabon-Italic                      A    088    #sai_____#
#psbb8a#    Sabon-Bold                        A    088    #sab_____#
#psbbi8a#   Sabon-BoldItalic                  A    088    #sabi____#
\end{lstlisting}

\noindent The first column indicates the Fontname name and the last column the original name of the files as shipped by the vendor.\footnote{The fourth column may also prove helpful: it indicates the number of the Adobe font package to which this font belongs. This number will save you a lot of time if you are trying to locate updated metric files for a font on Adobe's \ftp server since the files are sorted by package number there.} After renaming, we find the following files in the working directory:

\begin{lstlisting}[style=map]{}
psbr8a.afm      psbri8a.afm      psbb8a.afm      psbbi8a.afm
psbr8a.pfb      psbri8a.pfb      psbb8a.pfb      psbbi8a.pfb
\end{lstlisting}

\noindent We can now begin with the installation process.

\section{Creating metrics and virtual fonts}
\label{basics:fontinst}

Since writing a fontinst file can be quite a time-consuming thing to do, fontinst provides a special macro which is able to deal with standard scenarios like this one. You can look up the |\latinfamily| command in the fontinst manual to understand what it does in detail. For our situation, it will suffice to say that it is able to recognize the standard fonts we provide by their file name~-- hence the need for strict adherence to the Fontname scheme in this case. Fontinst will create all metric and auxiliary files required by \latex without further directions in the form of lower-level commands. Therefore our fontinst file is as simple as it can get:

\begin{lstlisting}[style=fontinst,emph={latinfamily,recordtransforms,endrecordtransforms}]{drv-latfam}
\input fontinst.sty
\needsfontinstversion{1.926}%*		\label{basics:drv:a}
\recordtransforms{%#psb-rec.tex#%}%*	\label{basics:drv:c}
\latinfamily{%#psb#%}{}%*		\label{basics:drv:b}
\endrecordtransforms%*			\label{basics:drv:d}
\bye
\end{lstlisting}

\noindent First of all, we load fontinst and add line \ref{basics:drv:a} to verify that we are using a suitably recent version of fontinst. After that, we basically call the |\latinfamily| macro in line \ref{basics:drv:b}, using the base of the file names (the foundry code plus the typeface code) as its first argument. The second argument of this macro is code to be expanded whenever this typeface is used. It is frequently employed to suppress hyphenation of fixed-width fonts by setting the hyphenation character to a non-existing encoding slot. If we wanted to suppress hyphenation for this font family, we would call the macro like this:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\latinfamily{psb}{\%#hyphenchar#%\font=%#-1#%}
\end{lstlisting}

\noindent When installing fixed-width fonts we would also define the integer variable |monowidth|. This variable is used internally by fontinst's encoding vectors. Initializing it to any value will disable ligatures and adjust certain spacing values. The exact value does not matter since fontinst uses the existence of this variable as a boolean indicator~-- do not set it to zero for proportional fonts. For fixed-width fonts the following line should be given before calling |\latinfamily|:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\setint{%#monowidth#%}{1}
\end{lstlisting}

\noindent Lines \ref{basics:drv:c} and \ref{basics:drv:d} enclose the |\latinfamily| macro in an environment that records all transformations applied to the fonts during installation and writes them to the external file \path{psb-rec.tex}. We will need this file later in order to create a map file for Sabon. This process will be discussed in section \ref{basics:mapfile}. We save our fontinst driver file as, for example, \path{psb-drv.tex} and run it through \bin{tex}:

\begin{lstlisting}[style=shell]{}
tex psb-drv.tex
\end{lstlisting}

\noindent The |\latinfamily| macro will create metric files, virtual fonts, and auxiliary files for four different encodings: \baseone, \otoneenc, \toneenc, and \tsoneenc. While \baseone serves as the basis of virtual fonts using other encodings, it is usually not employed as such on the \latex level, although |\latinfamily| provides font definition files for the \baseone encoded fonts as well.

The \otoneenc encoding is a 7-bit legacy encoding solely suitable for text using the English alphabet only because it requires the use of composite glyphs when typesetting accented letters. These glyphs are inferior to the native glyphs provided by \PS fonts. When using \otoneenc encoding and typesetting the letter \textit{a} with a grave accent, for example, \tex does not use the real glyph \textit{ŕ} as provided by the font because \otoneenc discards all accented letters (this amounts to almost half of the glyphs found in common \PS fonts). Instead, \tex will use the stand-alone grave accent and move it over the lowercase letter \textit{a} to form a composite glyph. Apart from their inferior typographic quality, composite letters break \tex's hyphenation algorithm so that words containing an accented letter are not hyphenated beyond this letter. Another problem with them is that they break searching for words containing accented letters in \pdf files. In short, \otoneenc should be considered obsolete unless you need the letters of the English alphabet only. But even in this case, \toneenc encoding would be a sound choice.

\toneenc, also known as Cork encoding, is a more recent text encoding suitable for a wide range of languages using the Latin script. Also known as Text Companion encoding, \tsoneenc complements \toneenc by providing additional glyphs such as currency signs and other frequently used symbols like \enquote*{copyright} or \enquote*{registered}. \tsoneenc is never used as the main text encoding because it merely contains symbols. A user interface to the glyphs found in \tsoneenc is provided by the \sty{textcomp} package. Refer to appendix \ref{textcomp} for a list of all symbols provided by \sty{textcomp}.

When running the fontinst driver file, fontinst will write a lot of messages to the terminal. These will include warnings about glyphs not being found, since a few glyphs defined in \otoneenc and \toneenc encoding are missing from the glyph set of our fonts:

\begin{lstlisting}[style=plain]{}
(/usr/share/texmf/tex/fontinst/base/ot1.etx
Warning: missing glyph `dotlessj'.
Warning: missing glyph `lslashslash'.
\end{lstlisting}

\begin{lstlisting}[style=plain,aboveskip=0pt]{}
(/usr/share/texmf/tex/fontinst/base/t1.etx
Warning: missing glyph `perthousandzero'.
Warning: missing glyph `dotlessj'.
Warning: missing glyph `Eng'.
Warning: missing glyph `eng'.
\end{lstlisting}

\noindent These warnings are normal, the missing glyphs are simply not provided by most \PS fonts. In addition to that, you will most likely be lacking the ligatures \enquote*{ff}, \enquote*{ffi}, and \enquote*{ffl}. This means that they will not be typeset as a single glyph but as a sequence of characters. There is no warning message in this case as fontinst will construct the ligatures using the single-letter glyphs at hand. You will usually find these ligatures in so-called expert fonts which complement the base fonts. Some foundries however, like FontFont, include them in the base fonts. Standard \PS fonts should always provide the ligatures \enquote*{fi} and \enquote*{fl}. The situation is worse for \tsoneenc encoding since parts of it are rather exotic, defining glyphs not found in industry-standard fonts such as a \enquote*{copyleft} symbol, or glyphs which should rather go in a dedicated symbol font such as arrow symbols:

\begin{lstlisting}[style=plain]{}
(/usr/share/texmf/tex/fontinst/base/ts1.etx
Warning: missing glyph `arrowleft'.
Warning: missing glyph `arrowright'.
Warning: missing glyph `tieaccentlowercase'.
Warning: missing glyph `tieaccentcapital'.
Warning: missing glyph `newtieaccentlowercase'.
Warning: missing glyph `newtieaccentcapital'.
Warning: missing glyph `blank'.
Warning: missing glyph `hyphendbl'.
Warning: missing glyph `zerooldstyle'.
Warning: missing glyph `oneoldstyle'.
Warning: missing glyph `twooldstyle'.
Warning: missing glyph `threeoldstyle'.
Warning: missing glyph `fouroldstyle'.
Warning: missing glyph `fiveoldstyle'.
Warning: missing glyph `sixoldstyle'.
Warning: missing glyph `sevenoldstyle'.
Warning: missing glyph `eightoldstyle'.
Warning: missing glyph `nineoldstyle'.
Warning: missing glyph `angbracketleft'.
Warning: missing glyph `angbracketright'.
Warning: missing glyph `Omegainv'.
Warning: missing glyph `bigcircle'.
Warning: missing glyph `Omega'.
Warning: missing glyph `arrowup'.
Warning: missing glyph `arrowdown'.
Warning: missing glyph `born'.
Warning: missing glyph `divorced'.
Warning: missing glyph `died'.
Warning: missing glyph `leaf'.
Warning: missing glyph `married'.
Warning: missing glyph `musicalnote'.
Warning: missing glyph `hyphendblchar'.
Warning: missing glyph `dollaroldstyle'.
Warning: missing glyph `centoldstyle'.
Warning: missing glyph `colonmonetary'.
Warning: missing glyph `won'.
Warning: missing glyph `naira'.
Warning: missing glyph `guarani'.
Warning: missing glyph `peso'.
Warning: missing glyph `lira'.
Warning: missing glyph `recipe'.
Warning: missing glyph `interrobang'.
Warning: missing glyph `interrobangdown'.
Warning: missing glyph `dong'.
Warning: missing glyph `pertenthousand'.
Warning: missing glyph `pilcrow'.
Warning: missing glyph `baht'.
Warning: missing glyph `numero'.
Warning: missing glyph `discount'.
Warning: missing glyph `estimated'.
Warning: missing glyph `openbullet'.
Warning: missing glyph `servicemark'.
Warning: missing glyph `quillbracketleft'.
Warning: missing glyph `quillbracketright'.
Warning: missing glyph `copyleft'.
Warning: missing glyph `circledP'.
Warning: missing glyph `referencemark'.
Warning: missing glyph `radical'.
Warning: missing glyph `euro'.
\end{lstlisting}

\noindent While this may seem like a long list, it is not unusual when installing fonts not specifically designed for \tex. You will get the most common symbols such as currency signs and other frequently used symbols, and chances are that you are not going to miss the lacking ones. If you want to learn more about these encodings, simply run fontinst's encoding vectors through \bin{latex} to get a \dvi file containing a commented listing of all the glyphs:

\begin{lstlisting}[style=shell]{}
latex 8r.etx
latex ot1.etx
latex t1.etx
latex ts1.etx
\end{lstlisting}

\noindent When fontinst is finished, all \tex font metrics and virtual fonts are available in a human-readable format which still requires some post-processing before we can install these files.

\section{Compiling metrics and virtual fonts}
\label{basics:compile}

In order to convert the \tex metrics into a binary format that \tex can read directly, we run the property list files (\path{pl}) created by fontinst through \bin{pltotf} to generate \tex font metric files (\path{tfm}). We also run the virtual property list files (\path{vpl}) files through \bin{vptovf} to create virtual fonts (\path{vf}). When using the Bash shell, this can be accomplished as follows:

\begin{lstlisting}[style=shell]{}
for file in  *.pl; do pltotf $file; done
for file in *.vpl; do vptovf $file; done
\end{lstlisting}

\noindent The generation of \tex font metrics, virtual fonts, and font definition files is now complete.

\section{Installing fonts and support files}
\label{basics:install}

The \tetex distribution supports a total of three \tex directory trees by default: a global one, a local one, and a user tree. The global tree is usually maintained by package management software. It contains all files provided by the \tetex distribution. The local tree is for everything that is not part of \tetex but should be available system-wide.\footnote{Other \tex distributions such as \miktex do not cater for three separate trees but they also support a local tree which is separate from the global system tree.} The user tree is intended for private files of individual users on the system.

Fonts and everything related to them should go in the local tree if you have administrative access on the system. Putting them in the global tree is a bad idea because they might get overwritten when you update \tetex; putting them in a private one will restrict access to them to a single user which is probably not what you want if you have administrative access. It is a good idea to define the variable \env{TEXMF} (all trees) in a way that references \env{TEXMFLOCAL} (the local tree) before \env{TEXMFMAIN} (the global tree). This will allow you to install newer versions of selected packages in the local tree without updating the whole install. I recommend defining \env{TEXMF} as follows in \path{texmf.cnf}:

\begin{lstlisting}[style=plain]{}
TEXMF = {$HOMETEXMF,!!$TEXMFLOCAL,!!$TEXMFMAIN}
\end{lstlisting}

\noindent This will give you two levels on top of the global install: your local extensions will be preferred over files in the global tree and can in turn be overridden by individual users who put files in their private tree (\env{HOMETEXMF}). These settings should go into the global configuration file for the kpathsea search library, \path{texmf.cfg}. For the rest of this section we will assume that we are installing the fonts in the local tree and that its top directory is \path{/usr/local/share/texmf}. The relevant branches of the local tree are as follows:

\begin{lstlisting}[style=plain,emph={fonts,afm,tfm,pfb,vf,fd,type1,tex,latex,adobe,sabon}]{}
/usr/local/share/texmf/
/usr/local/share/texmf/dvips/
/usr/local/share/texmf/dvips/config/
/usr/local/share/texmf/fonts/
/usr/local/share/texmf/fonts/afm/
/usr/local/share/texmf/fonts/afm/adobe/
/usr/local/share/texmf/fonts/afm/adobe/sabon/
/usr/local/share/texmf/fonts/tfm/
/usr/local/share/texmf/fonts/tfm/adobe/
/usr/local/share/texmf/fonts/tfm/adobe/sabon/
/usr/local/share/texmf/fonts/type1/
/usr/local/share/texmf/fonts/type1/adobe/
/usr/local/share/texmf/fonts/type1/adobe/sabon/
/usr/local/share/texmf/fonts/vf/
/usr/local/share/texmf/fonts/vf/adobe/
/usr/local/share/texmf/fonts/vf/adobe/sabon/
/usr/local/share/texmf/pdftex/
/usr/local/share/texmf/pdftex/config/
/usr/local/share/texmf/tex/
/usr/local/share/texmf/tex/latex/
/usr/local/share/texmf/tex/latex/adobe/
/usr/local/share/texmf/tex/latex/adobe/sabon/
/usr/local/share/texmf/xdvi/
/usr/local/share/texmf/xdvi/config/
\end{lstlisting}

\noindent The main components of this directory structure are defined by the \tex Directory Structure (\tds),\fnurl{http://www.tug.org/tds/} another standard introduced to cope with the large number of files that make up a typical \tex system. The appropriate locations for the different file types should be more or less obvious. The \path{fonts/} branch has subdirectories for \ascii font metrics (\path{afm/}), \tex font metrics (\path{tfm/}), \Tone fonts (\path{type1/}), and virtual fonts (\path{vf/}). It is customary to create subdirectories for the foundry and for each font family. You can take the names of these subdirectories from the Fontname scheme as well, although this is not a requirement. The standard directory name for the foundry is given in the file \path{supplier.map}, the standard name for the typeface in \path{typeface.map}. Here are the relevant lines from both files for Sabon:

\begin{lstlisting}[style=map]{}
p  #adobe#        @r{Adobe (@samp{p} for PostScript)}
sb #sabon#        Sabon b:ClassicalGaramondBT
\end{lstlisting}

\noindent The font description files (\path{fd}) for \latex go in a subdirectory of \path{tex/latex/}\negthinspace. The exact location is up to you but I recommend using the \path{foundry/typeface} scheme as well. We do not need the directories \path{dvips/}\negthinspace, \path{pdftex/}\negthinspace, and \path{xdvi/} at this point, but we are going to use them later. Now we create all directories and copy the files into the local tree as follows:

\begin{lstlisting}[style=shell,emph={fonts,afm,tfm,pfb,vf,fd,type1,tex,latex}]{}
cp *.afm /usr/local/share/texmf/fonts/afm/adobe/sabon/
cp *.tfm /usr/local/share/texmf/fonts/tfm/adobe/sabon/
cp *.pfb /usr/local/share/texmf/fonts/type1/adobe/sabon/
cp *.vf  /usr/local/share/texmf/fonts/vf/adobe/sabon/
cp *.fd  /usr/local/share/texmf/tex/latex/adobe/sabon/
\end{lstlisting}

\noindent All the files that \tex and \latex need in order to use Sabon are now available. At this point we could create a perfectly valid \dvi file with the right amount of blank space for every glyph~-- but we would not see a single glyph when looking at a \dvi preview. Note that \tex itself is completely indifferent to the actual font files. It will only use the metrics in the \path{tfm} files without accessing the glyph outlines. Rendering or embedding fonts is at the responsibility of the application which displays the \dvi file or processes it further in order to generate \PS. A \dvi file merely contains high-level references to fonts and glyphs, it does not contain the actual font files or any low-level instructions concerning reencoding or rendering. \pdftex is a special case because it combines the roles of \tex and a \pdf driver. All of these applications need to know which fonts to use. This information is provided in \enquote*{map} files which map font metrics to font outlines.

\section{Creating and installing map files}
\label{basics:mapfile}

In this guide, we will deal with the three most popular applications supporting \PS fonts, the \PS driver \dvips, the \dvi viewer \xdvi, and \pdftex. All of them need to be provided with a suitable map file. Creating map files is a rather laborious task when done manually as used to be custom in the past. As of version 1.9, fontinst is capable of creating map files almost automatically. We still need to provide it with some instructions and the required data, but this data can be collected by fontinst itself during the installation process. For this reason, we had fontinst write the records to the file \path{psb-rec.tex} in section \ref{basics:fontinst}. In order to transform these records into a proper map file, fontinst still needs some guidance by means of another fontinst driver file. We will call it \path{psb-map.tex}:

\begin{lstlisting}[style=fontinst,emph={adddriver,donedrivers}]{map-psb}
\input finstmsc.sty
\resetstr{PSfontsuffix}{.pfb}%*		\label{basics:map:a}
\adddriver{%#dvips#%}{%#psb.map#%}%*	\label{basics:map:b}
\input %#psb-rec.tex#%%*		\label{basics:map:c}
\donedrivers%*				\label{basics:map:d}
\bye
\end{lstlisting}

\noindent We start off by loading \path{finstmsc.sty}, the component of the fontinst package which provides the map file writer we need. Line \ref{basics:map:a} resets the string used as the suffix of all font files to \path{.pfb} (the default is \path{.pfa}) and line \ref{basics:map:b} activates the map fragment writer for \dvips, instructing it to write the properly formated records to \path{psb.map}, our final map file. We load the data from \path{psb-rec.tex} and start the transformation process in line \ref{basics:map:c}. After running \path{psb-map.tex} through \bin{tex}, we get a valid map file for \dvips. But what about \xdvi and \pdftex? As of this writing (December 2004), map file support in fontinst is restricted to \dvips and \dvipdfm. Fortunately, \xdvi and \pdftex are capable of reading \dvips's map files to a certain extent. If written with a little bit of care, \dvips, \pdftex, and \xdvi can share the same map file. The map files created by fontinst's map file writer for dvips should work fine in this respect. For details on the format of map files, please refer to tutorial \ref{mapfiles}.

We install the map file by copying \path{psb.map} to the branch \path{dvips/config/} in the local \tex tree. In order to configure \dvips, we locate the default configuration file of \dvips (\path{config.ps}) in the main \tex tree and copy it to the same location. If the search order for all \tex trees is set up as suggested above, this local copy will now be picked up instead of the global one. We open this file in a text editor, locate the section for map files (lines defining map files begin with a lowercase |p|), and add the new map file so that the updated section looks as follows:

\begin{lstlisting}[style=texconf]{}
% Map files
p +psfonts.map
p ...
#p +psb.map#
\end{lstlisting}

\noindent The procedure for \pdftex is similar: the configuration file is called \path{pdftex.cfg} and map files are marked with the string |map| at the beginning of the line. After copying the file to the branch \path{pdftex/config} of the local tree and updating it, the relevant section should look similar to the following example:

\begin{lstlisting}[style=texconf]{}
% Map files
map +pdftex.map
map ...
#map +psb.map#
\end{lstlisting}

\noindent We repeat this step one more time for \xdvi. The configuration file for \xdvi is called \path{xdvi.cfg}, the local branch is \path{xdvi/config} and lines indicating a map file begin with |dvipsmap|:

\begin{lstlisting}[style=texconf]{}
% Map files
dvipsmap ps2pk.map
dvipsmap ...
#dvipsmap psb.map#
\end{lstlisting}

\noindent In addition to that, we have to make sure that an encoding definition for \baseone encoding is provided as well. The configuration file for \xdvi should contain the following line:

\begin{lstlisting}[style=texconf]{}
% Tag   Suffix  Encoding name           Encoding file
enc     8r      TeXBase1Encoding        8r.enc
\end{lstlisting}

\noindent The installation is now finished. All files left in the working directory will not be used any more and may be deleted. Do not forget to update the file hash tables by running \bin{texhash} or an equivalent command!

\section{Using the new fonts}
\label{basics:usage}

Everything you need to know about using the fonts can be found in the \latex font selection guide.\fnurl{http://www.ctan.org/tex-archive/macros/latex/doc/fntguide.pdf} The second chapter of this guide documents the standard \nfss commands used to switch fonts under \latex. Let us take a look at some examples. To select Sabon at any point in a \latex file, we use a command like:

\begin{lstlisting}[style=latex,numbers=none,emph={fontfamily,psb}]{}
\fontfamily{psb}\selectfont
\end{lstlisting}

\noindent Sabon provides two weights which are readily available using compact font selection macros like |\textbf| and |\bfseries|. Larger font families may offer more than two weights. To select a particular weight, we use the |\fontseries| command in conjunction with the \nfss series codes defined during the installation of the font family. Please refer to the code tables in appendix \ref{tables} for a list of the most common \nfss codes. To select the semibold (|sb|) weight for example, we would use the following commands:

\begin{lstlisting}[style=latex,numbers=none,emph={fontseries,sb}]{}
\fontseries{sb}\selectfont
\end{lstlisting}

\noindent Compact font switching macros such as |\mdseries| and |\bfseries| do not switch to a fixed \nfss font series, they use |\mddefault| and |\bfdefault| for the regular and bold weight respectively. If we want to use semibold as the default bold weight, for example, we simply redefine |\bfdefault| accordingly:

\begin{lstlisting}[style=latex,numbers=none,emph={bfdefault,sb}]{}
\renewcommand*{\bfdefault}{sb}
\end{lstlisting}

\noindent In order to use Sabon as the default roman typeface for the whole document, we redefine |\rmdefault| in the preamble:

\begin{lstlisting}[style=latex,numbers=none,emph={rmdefault,psb}]{}
\renewcommand*{\rmdefault}{psb}
\end{lstlisting}

\noindent It is much more convenient to put the initialization of the font family into a dedicated style file (\path{sty}), though. Our file \path{sabon.sty} might look like this:

\begin{lstlisting}[style=latex,emph={rmdefault,psb}]{}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{sabon}[2002/04/17 v1.0 Adobe Sabon]
\RequirePackage[T1]{fontenc}
\RequirePackage{textcomp}
\renewcommand*{\rmdefault}{psb}
\endinput
\end{lstlisting}

\noindent Essentially, we redefine |\rmdefault| in order to use Sabon as the default roman typeface for the whole document. In addition to that, we load the \sty{fontenc} package and switch to \toneenc encoding, which is more appropriate for \PS fonts than the \otoneenc encoding used by default. We also load the \sty{textcomp} package which provides a user interface for the symbols found in \tsoneenc encoding. This will allow us to access symbols such as \enquote*{copyright} or \enquote*{registered} (appendix \ref{textcomp} provides a list of all symbols supported by \sty{textcomp}). If the \sty{textcomp} package is used in conjunction with \sty{inputenc}, it is even possible to enter most of these symbols directly in a \latex file.

There is one thing we have to keep in mind when switching to \toneenc encoding. The default encoding is a global setting that applies to all text fonts used in a \latex file, unless the encoding is reset explicitly using the \nfss macro |\fontencoding|. It will affect the font family defined as |\rmdefault|, but also the families set up as |\sfdefault| and |\ttdefault|. By default, these are Computer Modern Sans Serif (|cmss|) and Computer Modern Typewriter (|cmtt|). Using these fonts in conjunction with \toneenc encoding will pose some problems most European \tex users are already well familiar with. It is perfectly possible, provided that we use a suitable version of the Computer Modern fonts. Choosing a suitable version, however, can be quite difficult. We will discuss some typical issues related to that in the following section.

Alternatively, we could use some other \toneenc encoded sans serif and typewriter typefaces available in \PS format. For example, here is an enhanced version of \path{sabon.sty} using Helvetica (|phv|) and Courier (|pcr|):

\begin{lstlisting}[style=latex,emph={sfdefault,phv,ttdefault,pcr}]{}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{sabon}[2002/04/17 v1.0 Adobe Sabon with PS fonts]
\RequirePackage[T1]{fontenc}
\RequirePackage{textcomp}
\renewcommand*{\rmdefault}{psb}
\renewcommand*{\sfdefault}{phv}
\renewcommand*{\ttdefault}{pcr}
\endinput
\end{lstlisting}

\noindent This setup is certainly not the most fortunate one in terms of typography, but it should be safe from a technical perspective. Helvetica and Courier are part of the \PS base fonts built into every Level 2 \PS device. \tex distributions usually do not ship with the original versions of these fonts but they provide suitable replacements for them. Viewing \dvi files on screen or creating \pdf files should not pose any problem in this case.

For our setup of Sabon, the next section is only relevant if you want to use Computer Modern Sans Serif and Computer Modern Typewriter in conjunction with Sabon. If you deploy different \toneenc encoded sans serif and typewriter typefaces, which are available in \PS format, all you need to do is redefine |\sffamily| and |\ttfamily| in \path{sabon.sty} or in the preamble of the respective \latex file as shown above for Helvetica and Courier. You might still want to read the next section in this case because it discusses one of the most frequently asked questions concerning fonts under \tex and \latex.

\section{Computer Modern and \toneenc encoding}
\label{basics:cm}

The Computer Modern fonts designed for \toneenc and \tsoneenc encoding are called \textsc{ec} and \textsc{tc} fonts respectively, together known as European Computer Modern. When switching to \toneenc encoding, we implicitly switch to these fonts. Note that European Computer Modern, while being derived from Donald Knuth's original Computer Modern typefaces, is not simply a \toneenc encoded drop-in replacement. Over the years it has evolved into an independent typeface. The additional fonts created for the European Computer Modern family have been subject to debate based on their design. Some of them are considered to be typographically inferior to the original designs. From a technical perspective, the problem with the European Computer Modern fonts is that, historically, they have been available in \MF format only. This implies that \PS and \pdf files will contain bitmap representations of these fonts when we switch to \toneenc encoding. Bitmap fonts, however, have a fixed resolution and so are not independent of the output device. They are not suitable for on-screen display and pose a major obstacle in the usually \PS-based workflow of professional print shops, if they are tolerated at all.

\begin{table}
  \centering\small
  \begin{tabularx}{\textwidth}{Xll}
    \toprule
    \caps{typeface} &
    \multicolumn{2}{c}{\caps{fonts}} \\
    \cmidrule(l){2-3}
    &	\makebox[100pt][c]{\caps{name}} &
    	\makebox[100pt][c]{\caps{format}} \\
    \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
    Computer Modern		& \textsc{cm}				& \MF \\
    				& \textsc{cm}, Blue Sky			& \PS \\
    				& \textsc{cm}, Bakoma			& \PS, \TT \\
    				& \textsc{ae}				& virtual fonts\\
    				& \textsc{ze}				& virtual fonts\\
    European Computer Modern	& \textsc{ec\,\&\,tc}			& \MF \\
				& \textsc{ec\,\&\,tc}, \micropress	& \PS \\
    				& Tt2001				& \PS \\
    				& \textsc{cm}-super			& \PS \\
    Latin Modern		& \textsc{lm}				& \PS \\
    European Modern		& \textsc{em}				& \PS \\
    \bottomrule
  \end{tabularx}
  \caption{Computer Modern fonts and formats}
  \label{tables:cm-formats}
\end{table}

Donald Knuth had designed the Computer Modern fonts in \MF format and with \otoneenc encoding in mind. Blue Sky Research and Y\&Y developed \PS versions of these fonts later, which were donated to the public in 1997 and have been shipping with most \tex distributions ever since. While these fonts work fine for \PS and \pdf files, they are not suitable for tasks requiring letters not found in the English alphabet because their glyph base is still restricted to \otoneenc encoding. Jörg Knappen's European Computer Modern fonts address this issue by providing a more comprehensive set of glyphs, but they have in turn been subject to the limitations of \MF. In the following, I will briefly introduce several solutions which try to address these problems. Most of them are trade-offs in one way or another. Tables \ref{tables:cm-formats} and \ref{tables:cm-encodings} attempt to provide an overview of the major design variations over the Computer Modern theme along with their implementations. These tables are by no means exhaustive, there are even more fonts derived from the original Computer Modern typefaces.

To work around the hyphenation problem of \otoneenc encoding while sticking to the original Computer Modern fonts, there is a choice of two packages on \ctan which provide \toneenc encoded virtual fonts based on the original Computer Modern family of fonts: the \textsc{ae}\fnurl{http://www.ctan.org/tex-archive/fonts/ae/} and the \textsc{ze}\fnurl{http://www.ctan.org/tex-archive/fonts/zefonts/} fonts. The \textsc{ae} fonts are built on top of Computer Modern exclusively, but unfortunately they lack almost a dozen \toneenc characters including double and single guillemets, which makes their default setup unsuitable for all French and a lot of German texts. For Computer Modern Typewriter, the situation is even worse. There is a supplemental package called \sty{aecompl} which adds \MF versions of the missing characters, but that again brings up the problem we were trying to avoid in the first place. A different complement called \sty{aeguill}\fnurl{http://www.ctan.org/tex-archive/macros/latex/contrib/supported/aeguill/} at least adds \PS versions of the guillemets. An enhanced version of \path{sabon.sty} might then look like this:

\begin{table}
  \centering\small
  \begin{tabularx}{\textwidth}{Xll}
    \toprule
    \caps{fonts} &
    \multicolumn{2}{c}{\caps{encodings}} \\
    \cmidrule(l){2-3}
    &	\multicolumn{1}{c}{\makebox[120pt][c]{\caps{native}}} &
    	\multicolumn{1}{c}{\makebox[120pt][c]{\caps{supported}}} \\
    \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
    \textsc{cm}			& \otoneenc		& \otoneenc\\
    \textsc{cm}, Blue Sky	& \otoneenc		& \otoneenc\\
    \textsc{ae}			& \otoneenc		& \toneenc, with composite glyphs\\
    \textsc{ze}			& \otoneenc		& \toneenc, with composite glyphs\\
    \textsc{ec, tc} 		& \toneenc, \tsoneenc	& \toneenc, \tsoneenc\\
    \textsc{cm}-super		& Adobe Standard	&
		\toneenc, \tsoneenc, \ttwoaenc, \ttwobenc, \ttwocenc, \xtwoenc\\
    \textsc{lm}			& font specific		&
		\toneenc, \tsoneenc, \lyoneenc, \qxenc\\
    \bottomrule
  \end{tabularx}
  \caption{Computer Modern fonts and encodings}
  \label{tables:cm-encodings}
\end{table}

\begin{lstlisting}[style=latex,emph={aeguill}]{}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{sabon}[2002/04/17 v1.0 Adobe Sabon with AE]
\RequirePackage[T1]{fontenc}
\RequirePackage{textcomp}
\RequirePackage{aeguill}
\renewcommand*{\rmdefault}{psb}
\endinput
\end{lstlisting}

\noindent The \textsc{ze} fonts take a different approach to work around this problem: the missing characters are taken from standard \PS fonts such as Times and Helvetica. This means that there will be some typographical inconsistencies, but we are safe from a technical point of view. While the \textsc{ae} fonts and the corresponding supplemental packages ship with most \tex distributions, you might need to download the \textsc{ze} fonts from \ctan. When using the \textsc{ze} fonts, our enhanced version of \path{sabon.sty} would look like this:

\begin{lstlisting}[style=latex,emph={zefonts}]{}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{sabon}[2002/04/17 v1.0 Adobe Sabon with ZE]
\RequirePackage[T1]{fontenc}
\RequirePackage{textcomp}
\RequirePackage{zefonts}
\renewcommand*{\rmdefault}{psb}
\endinput
\end{lstlisting}

\noindent There is a more robust solution you might be interested in if you require \toneenc encoded Computer Modern fonts. Free \PS versions of the European Computer Modern fonts have been made available, although they might not have made their way into every \tex distribution yet. As mentioned before, one problem with \otoneenc encoded fonts is that they rely on composite glyphs which break searching for words containing accented letters in \pdf files. Both the \textsc{ae} and the \textsc{ze} fonts, although they enable \tex to hyphenate words containing accented letters properly, still suffer from this particular problem as they are based on \otoneenc encoded fonts internally. It is highly advisable to switch to a real \toneenc version of the Computer Modern fonts in \PS format. Such fonts are included in two independent packages: Péter Szabó's Tt2001\fnurl{http://www.ctan.org/tex-archive/fonts/ps-type1/ec/} as well as Vladimir Volovich's more recent \textsc{cm}-super\fnurl{http://www.ctan.org/tex-archive/fonts/ps-type1/cm-super/} package. Both packages include \PS fonts which are traced and post-processed conversions of their \MF counterparts.

Unless you know that a specific font you need is provided by the Tt2001 package only, go with the more advanced \textsc{cm}-super package which will bring you as close to a real solution as you can possibly get when using the European Computer Modern fonts. Note, however, that it is a rather large download. Since it includes a huge number of fonts, the compressed package is about 64\mb in size. The \textsc{cm}-super fonts use Adobe Standard as their native encoding, but the glyph set provided by these fonts includes Cyrillic letters as well. In addition to \toneenc and \tsoneenc, \textsc{cm}-super supports the Cyrillic encodings \ttwoaenc, \ttwobenc, \ttwocenc, and \xtwoenc. See the package documentation for installation instructions and answers to the most frequently asked questions. Here is a version of our style file for use in conjunction with \textsc{cm}-super:

\begin{lstlisting}[style=latex,emph={type1ec}]{}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{sabon}[2002/04/17 v1.0 Adobe Sabon with CM-Super]
\RequirePackage[T1]{fontenc}
\RequirePackage{textcomp}
\RequirePackage{type1ec}
\renewcommand*{\rmdefault}{psb}
\endinput
\end{lstlisting}

\noindent Recently, yet another new implementation of Computer Modern has been released to the public, the promising Latin Modern fonts created by Bogus\l aw Jackowski and Janusz M. Nowacki. Unlike Tt2001 and \textsc{cm}-super, Latin Modern is derived from the original Computer Modern designs and has been augmented with accented letters as well as other glyphs missing from the very small glyph base of the original fonts. While the Latin Modern fonts are younger than European Computer Modern, they are a parallel development from a systematic perspective. Consequently, they are not affected by the controversial design decisions underlying certain parts of the European Computer Modern family of fonts. They use a font specific encoding by default and feature a glyph base suitable for \toneenc, \tsoneenc, \lyoneenc as well as the Polish encoding \qxenc. Even though these fonts are still under development they are already quite usable as of this writing (December 2004). Here is yet another iteration of our style file for Sabon, combined with Latin Modern for the sans serif and typewriter families:

\begin{lstlisting}[style=latex,emph={lmodern}]{}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{sabon}[2003/07/27 v1.0 Adobe Sabon with LM]
\RequirePackage[T1]{fontenc}
\RequirePackage{textcomp}
\RequirePackage{lmodern}
\renewcommand*{\rmdefault}{psb}
\endinput
\end{lstlisting}

\noindent Apart from these free fonts, there are also commercial offerings from Y\&Y\fnurl{http://www.yandy.com/em.htm} and \micropress.\fnurl{http://www.micropress-inc.com/fonts/ecfonts/ecmain.htm} Judging by the vendors' websites, \micropress offers \PS versions of European Computer Modern while the European Modern fonts by Y\&Y are augmented \PS versions of the original Computer Modern typeface. Please refer to the respective website for details and pricing.

\chapter{Standard font sets}
\label{standard}

The |\latinfamily| shorthand is very convenient, but it is not designed to cope with complex installation scenarios. Sooner or later you will probably have more specific requirements or simply desire more control over the basics. This will require using lower-level fontinst commands in most cases.

\section{A verbose fontinst file}
\label{standard:fontinst}

In this tutorial, we will essentially repeat the scenario discussed in the previous one. This time, however, we will employ lower-level commands. The verbose driver file introduced here will also serve as a template for subsequent tutorials.

\begin{lstlisting}[style=fontinst,emph={substitutesilent,bx,b}]{drv-psb}
\input fontinst.sty
\needsfontinstversion{1.926}
\substitutesilent{bx}{b}
\end{lstlisting}

\noindent After loading fontinst and verifying the version we set up an alias that will suppress a warning when the respective font is substituted. Why would we want to set up this particular alias? Note that |bx| is the \nfss code of the \enquote*{bold extended} series. The \latex macros |\textbf| and |\bfseries| do not switch to a fixed series, they use |\bfdefault| instead which defaults to |bx|. As long as we are using the Computer Modern fonts this is fine since they actually include bold extended fonts. For font families which do not, however, using these macros would result in a warning. To avoid that, we would need to redefine |\bfdefault| to a suitable weight. The problem here is that |\bfdefault| is a global setting applying to all of \latex's font families (|\rmdefault|, |\sfdefault|, and |\ttdefault|), but it is not safe to assume that all of them will offer the same weights. To avoid any need to redefine |\bfdefault| unless we really want to, we set up an alias so that every request for \enquote*{bold extended} (|bx|) is substituted by \enquote*{bold} (|b|). Unless bold extended fonts are available, simply think of |bx| as the default bold weight.\footnote{This substitution is a default setting that fontinst will always silently include. We could omit the respective line in this case, but if semibold fonts are available you might prefer using those as the default bold weight.}

The standard weight is selected by \latex in a similar way. The relevant macro is called |\mddefault| and defaults to |m|. Make sure that the \nfss series |m| is always defined, either mapped to actual fonts or as a substitution. In this case our font family provides regular-weight fonts so we will simply use them for the |m| series. Some font families, however, are based on the main weights \enquote*{light} and \enquote*{demibold} instead of \enquote*{regular} and \enquote*{bold}. In this case, we would either just map these weights to the |m| and |b| series directly or use the proper \nfss series codes (|l| and |db|) plus the following substitutions:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\substitutesilent{m}{l}
\substitutesilent{bx}{db}
\end{lstlisting}

\noindent Again, think of |m| as the default weight if regular-weight fonts are not available. Every font family should provide mappings for the \nfss series |m| and |bx| in the font definition file. If fonts matching these series exactly are not available, use substitutions to ensure that the defaults for |\mddefault| and |\bfdefault| will work without user intervention. Since |\mddefault| and |\bfdefault| are overall settings applying to all of \latex's families, redefining them explicitly may cause problems. Doing so should be an option, not a requirement.

\begin{lstlisting}[style=fontinst,emph={smallcapsscale}]{drv-psb}
\setint{smallcapsscale}{800}
\end{lstlisting}

\noindent The basic Sabon set we are dealing with offers upright and italic fonts but no optical small caps. As a substitute, fontinst is capable of transparently generating so-called mechanical or \enquote*{faked} small caps~-- as opposed to optical or \enquote*{real} small caps which are actual glyphs found in a dedicated small caps font. Mechanical small caps are generated by taking the tall caps of the font and scaling them by a certain factor: 1000 means full size, 800 means 0.8. Since \Tone fonts scale linearly, scaling down tall caps implies that they will appear lighter than the corresponding lowercase glyphs, thus disturbing the color of the page. However, if they are too tall they do not mix well with the lowercase alphabet.

Optical small caps usually match the x-height of the font. This is the height of the lowercase alphabet without ascenders and descenders. They blend in seamlessly with lowercase and mixed case text. Depending on the typeface, this usually corresponds to a value in the range of 650--750. If you scale down tall caps so that they match the x-height of the font, they will appear too light in running text. Finding a suitable value for this is obviously a trade-off. We are going to use fontinst's default setting of 800 here but you might want to experiment with a value in the range of 750--800. For serious applications of small caps we would need optical small caps, provided in a dedicated small caps or in an expert font. For details on small caps and expert sets, please refer to tutorial \ref{scosf} and \ref{expbase} respectively.

\begin{lstlisting}[style=fontinst,emph={slant}]{drv-psb}
\setint{slant}{167}%*						\label{standard:drv:a}
\end{lstlisting}

\noindent The integer variable |smallcapsscale| is a known variable used by fontinst's encoding vectors. We could use it in conjunction with |\latinfamily| as well. The variable |slant| is specific to our fontinst file. We define it for convenience so that we can set the slant factor for all subsequent font transformations globally. The slant factor defines how much the glyphs slope to the right. It is a real number equivalent to the tangent of the slant angle. Fontinst represents this number as an integer though, so we have to multiply the tangent by 1000. The value 167 (\texttildelow\,9.5°) is a reasonable default. Any value significantly greater that 176 (\texttildelow\,10°) is usually too much.

\begin{lstlisting}[style=fontinst]{drv-psb}
\recordtransforms{%#psb-rec.tex#%}%*				\label{standard:drv:b}
\end{lstlisting}

\noindent We start off with some basic font transformations. All reencoding and transformation steps will be recorded in the file \path{psb-rec.tex} so that we can automatically build a matching map file later. The environment recording font transformations, which we open in line \ref{standard:drv:b}, will be closed at the very end of the fontinst file, in line \ref{standard:drv:z}.

\begin{lstlisting}[style=fontinst]{drv-psb}
\transformfont{psbr%#8r#%}{\reencodefont{%#8r#%}{\fromafm{psbr%#8a#%}}}
\transformfont{psbri%#8r#%}{\reencodefont{%#8r#%}{\fromafm{psbri%#8a#%}}}
\transformfont{psbb%#8r#%}{\reencodefont{%#8r#%}{\fromafm{psbb%#8a#%}}}
\transformfont{psbbi%#8r#%}{\reencodefont{%#8r#%}{\fromafm{psbbi%#8a#%}}}
\end{lstlisting}

\noindent The fonts are reencoded from Adobe Standard (Fontname code |8a|) to \baseone encoding (|8r|). Please refer to the fontinst manual for an explanation of the syntax of the individual commands used here and in the following.

\begin{lstlisting}[style=fontinst,emph={slantfont,slant}]{drv-psb}
\transformfont{psbr%#o#%8r}{\slantfont{\int{slant}}\reencodefont{8r}{\fromafm{psbr8a}}}
\transformfont{psbb%#o#%8r}{\slantfont{\int{slant}}\reencodefont{8r}{\fromafm{psbb8a}}}
\end{lstlisting}

\noindent Like the |\latinfamily| shorthand, our fontinst file should create slanted fonts as well. These need to be reencoded and, well, slanted. We are using the |slant| variable defined in line \ref{standard:drv:a} to set the slant factor. The raw, \tex Base 1 encoded fonts are now prepared for the generation of virtual fonts.

\begin{lstlisting}[style=fontinst,emph={psb,T1}]{drv-psb}
\installfonts%*							\label{standard:drv:c}
\installfamily{T1}{psb}{}
\end{lstlisting}

\noindent The installation of a font family is enclosed in an environment which we open in line \ref{standard:drv:c} and close later in line \ref{standard:drv:d}. First of all, the font family we are about to install has to be declared: we have Adobe Sabon and we are going to install it in \toneenc encoding (Fontname code |8t|). The third argument to |\installfamily| corresponds to the second one of the |\latinfamily| command: it is used to include code in the font definition file that will be expanded by \latex whenever the font is selected. \toneenc will serve as our base encoding in \latex's text mode later. The |\latinfamily| command also provides \otoneenc (|7t|) and \baseone encoded fonts. We will omit both encodings here as we do not need them. While raw \baseone encoded fonts (|8r|) form the basis of all virtual fonts, they are usually not deployed as such on the \tex level, and the \otoneenc encoding is not suitable for \PS fonts anyway. We will therefore deliberately ignore it and focus on \toneenc and \tsoneenc exclusively.

\begin{lstlisting}[style=fontinst,emph={newlatin,t1}]{drv-psb}
\installfont{psbr%#8t#%}{psbr8r,newlatin}{t1}{T1}{psb}{m}{n}{}%*\label{standard:drv:e}
\end{lstlisting}

\noindent To create the individual virtual fonts, we use fontinst's |\installfont| command. The first argument to |\installfont| is the virtual font we are going to create, the second one is a list of files used to build this font. These can be \path{afm}, \path{mtx}, or \path{pl} files, their suffix is omitted. If multiple fonts are provided, |\installfont| does not overwrite any encoding slots when reading in additional files, it simply fills vacant slots if it finds suitable glyphs in the next font. The metric file \path{newlatin.mtx} is an auxiliary file provided by fontinst which should always be read when creating \otoneenc or \toneenc encoded text fonts. The third argument is the file name of an encoding vector without the file suffix, in this case \path{t1.etx}. The remaining arguments are written verbatim to the font definition file and declare the respective font in a format that the \latex font selection scheme (\nfss) can process: \toneenc encoding, Adobe Sabon\footnote{\latex does not really care about the name of the font or the foundry. This argument simply defines the code that identifies the font within the \nfss.}, medium\footnote{In fact, the more appropriate name would be \textit{regular} because \textit{medium} is a moderate bold weight with the \nfss code |mb|.}, normal (that is, upright or roman). The last argument is only relevant if fonts with different design sizes are available. It is empty for linearly scaled fonts.

\begin{lstlisting}[style=fontinst,emph={t1c}]{drv-psb}
\installfont{psbrc8t}{psbr8r,newlatin}{t1c}{T1}{psb}{m}{sc}{}
\end{lstlisting}

\noindent The small caps font is slightly different. Since we do not have any \Tone font containing optical small caps we need to \enquote*{fake} them by scaling the uppercase alphabet and putting the scaled glyphs in the encoding slots of the lowercase alphabet. Fortunately, we do not have to deal with the actual low-level glyph scaling. We simply load \path{t1c.etx}, a special encoding vector which will take care of that, using the value of |smallcapsscale| as the scaling factor.

\begin{lstlisting}[style=fontinst]{drv-psb}
\installfont{psbro8t}{psbro8r,newlatin}{t1}{T1}{psb}{m}{sl}{}
\installfont{psbri8t}{psbri8r,newlatin}{t1}{T1}{psb}{m}{it}{}%*	\label{standard:drv:f}
\end{lstlisting}

\noindent Since the slanting was already performed on the raw fonts, the virtual slanted and the italic fonts are handled just like the upright ones. Now all regular fonts are done and we can repeat this part (\ref{standard:drv:e}--\ref{standard:drv:f}) for the bold fonts:

\begin{lstlisting}[style=fontinst]{drv-psb}
\installfont{psbb8t}{psbb8r,newlatin}{t1}{T1}{psb}{b}{n}{}
\installfont{psbbc8t}{psbb8r,newlatin}{t1c}{T1}{psb}{b}{sc}{}
\installfont{psbbo8t}{psbbo8r,newlatin}{t1}{T1}{psb}{b}{sl}{}
\installfont{psbbi8t}{psbbi8r,newlatin}{t1}{T1}{psb}{b}{it}{}
\endinstallfonts%*						\label{standard:drv:d}
\end{lstlisting}

\noindent After that, we start adding virtual fonts for \tsoneenc encoding. The \tsoneenc encoding complements \toneenc by providing additional glyphs such as currency signs and other frequently used symbols. This encoding will not be used as the main output encoding of our \latex files later. It is accessed exclusively by way of macros provided by the \sty{textcomp} package.

\begin{lstlisting}[style=fontinst,emph={TS1,psb}]{drv-psb}
\installfonts
\installfamily{TS1}{psb}{}
\end{lstlisting}

\noindent Like \path{newlatin.mtx}, the file \path{textcomp.mtx} is an auxiliary metric file provided by fontinst. It should always be added when creating \tsoneenc encoded fonts. The third argument in line \ref{standard:drv:g}, the encoding vector, refers to \path{ts1.etx} in this case:

\begin{lstlisting}[style=fontinst,emph={textcomp,ts1}]{drv-psb}
\installfont{psbr%#8c#%}{psbr8r,textcomp}{ts1}{TS1}{psb}{m}{n}{}%*	\label{standard:drv:g}
\end{lstlisting}

\noindent Since the \tsoneenc encoding contains symbols and figures only, the \tsoneenc encoded regular and small caps fonts are identical. Hence we do not need a \tsoneenc encoded virtual small caps font, but we still have to instruct \latex where to get the respective glyphs from. Otherwise the macros of the \sty{textcomp} package might not work properly whenever the active \nfss shape is |sc|. To do so, we use the |\installfontas| macro and \enquote*{install} the virtual font built in line \ref{standard:drv:g} once more, this time as the small caps shape. This will merely add a line to the font definition file without creating an additional virtual font:

\begin{lstlisting}[style=fontinst,emph={installfontas,TS1,psb,m,sc}]{drv-psb}
\installfontas{psbr8c}{TS1}{psb}{m}{sc}{}
\end{lstlisting}

\noindent The slanted and italic fonts are handled like the upright one:

\begin{lstlisting}[style=fontinst]{drv-psb}
\installfont{psbro8c}{psbro8r,textcomp}{ts1}{TS1}{psb}{m}{sl}{}
\installfont{psbri8c}{psbri8r,textcomp}{ts1}{TS1}{psb}{m}{it}{}%*\label{standard:drv:h}
\end{lstlisting}

\noindent We repeat \ref{standard:drv:g}--\ref{standard:drv:h} for the bold fonts:

\begin{lstlisting}[style=fontinst]{drv-psb}
\installfont{psbb8c}{psbb8r,textcomp}{ts1}{TS1}{psb}{b}{n}{}
\installfontas{psbb8c}{TS1}{psb}{b}{sc}{}
\installfont{psbbo8c}{psbbo8r,textcomp}{ts1}{TS1}{psb}{b}{sl}{}
\installfont{psbbi8c}{psbbi8r,textcomp}{ts1}{TS1}{psb}{b}{it}{}
\end{lstlisting}

\noindent Finally, we close all environments and terminate:

\begin{lstlisting}[style=fontinst]{drv-psb}
\endinstallfonts
\endrecordtransforms%*						\label{standard:drv:z}
\bye
\end{lstlisting}

\section{The \textit{latinfamily} macro revisited}
\label{standard:latinfamily}

\noindent Note that our fontinst file is not strictly equivalent to the |\latinfamily| macro but rather stripped down to the most useful parts with respect to typical \PS fonts. Essentially, we did not create any font description files for the raw \baseone encoded fonts and we dropped \otoneenc encoding. If you are curious, you should be able to reconstruct all the steps taken by |\latinfamily| when looking at the log file created by fontinst while keeping our file in mind. Here are the relevant lines from the log file after running |\latinfamily| on the basic Sabon set. Only lines beginning with \enquote*{|INFO> run|} are relevant in this context as they indicate lower-level macros used by |\latinfamily|:

\begin{lstlisting}[style=plain]{}
INFO> run \transformfont  <psbr8r> from <psbr8a>
INFO> run \installrawfont <psbr8r><psbr8r,8r><8r><8r><psb><m><n>
INFO> run \installfont <psbr7t><psbr8r,newlatin><OT1><OT1><psb><m><n>
INFO> run \installfont <psbr8t><psbr8r,newlatin><T1><T1><psb><m><n>
INFO> run \installfont <psbr8c><psbr8r,textcomp><TS1><TS1><psb><m><n>
INFO> run \installfont <psbrc7t><psbr8r,newlatin><OT1c><OT1><psb><m><sc>
INFO> run \installfont <psbrc8t><psbr8r,newlatin><T1c><T1><psb><m><sc>
INFO> run \transformfont  <psbro8r> from <psbr8r> (faking oblique)
INFO> run \installrawfont <psbro8r><psbro8r,8r><8r><8r><psb><m><sl>
INFO> run \installfont <psbro7t><psbro8r,newlatin><OT1><OT1><psb><m><sl>
INFO> run \installfont <psbro8t><psbro8r,newlatin><T1><T1><psb><m><sl>
INFO> run \installfont <psbro8c><psbro8r,textcomp><TS1><TS1><psb><m><sl>
INFO> run \transformfont  <psbri8r> from <psbri8a>
INFO> run \installrawfont <psbri8r><psbri8r,8r><8r><8r><psb><m><it>
INFO> run \installfont <psbri7t><psbri8r,newlatin><OT1i><OT1><psb><m><it>
INFO> run \installfont <psbri8t><psbri8r,newlatin><T1i><T1><psb><m><it>
INFO> run \installfont <psbri8c><psbri8r,textcomp><TS1i><TS1><psb><m><it>
INFO> run \transformfont  <psbb8r> from <psbb8a>
INFO> run \installrawfont <psbb8r><psbb8r,8r><8r><8r><psb><b><n>
INFO> run \installfont <psbb7t><psbb8r,newlatin><OT1><OT1><psb><b><n>
INFO> run \installfont <psbb8t><psbb8r,newlatin><T1><T1><psb><b><n>
INFO> run \installfont <psbb8c><psbb8r,textcomp><TS1><TS1><psb><b><n>
INFO> run \installfont <psbbc7t><psbb8r,newlatin><OT1c><OT1><psb><b><sc>
INFO> run \installfont <psbbc8t><psbb8r,newlatin><T1c><T1><psb><b><sc>
INFO> run \transformfont  <psbbo8r> from <psbb8r> (faking oblique)
INFO> run \installrawfont <psbbo8r><psbbo8r,8r><8r><8r><psb><b><sl>
INFO> run \installfont <psbbo7t><psbbo8r,newlatin><OT1><OT1><psb><b><sl>
INFO> run \installfont <psbbo8t><psbbo8r,newlatin><T1><T1><psb><b><sl>
INFO> run \installfont <psbbo8c><psbbo8r,textcomp><TS1><TS1><psb><b><sl>
INFO> run \transformfont  <psbbi8r> from <psbbi8a>
INFO> run \installrawfont <psbbi8r><psbbi8r,8r><8r><8r><psb><b><it>
INFO> run \installfont <psbbi7t><psbbi8r,newlatin><OT1i><OT1><psb><b><it>
INFO> run \installfont <psbbi8t><psbbi8r,newlatin><T1i><T1><psb><b><it>
INFO> run \installfont <psbbi8c><psbbi8r,textcomp><TS1i><TS1><psb><b><it>
\end{lstlisting}

\noindent This listing is a complete summary of what the |\latinfamily| macro does in this case, broken down into lower-level commands. The order of the commands differs slightly from our file, because the |\transformfont| calls are not grouped at the beginning but rather used \enquote*{on demand} for each shape. This difference is irrelevant from a technical point of view. |\transformfont| must obviously be called before |\installfont| or |\installrawfont| tries to use the transformed fonts, but the exact location does not matter. Since we did not create any font description files for \baseone encoding, we did not use the |\installrawfont| macro in our fontinst file. This macro does not build a virtual font but rather sets up a raw, \baseone encoded font for use under \latex.

Here are some crucial points we would have to keep in mind when writing a fontinst file that does exactly what |\latinfamily| would do: the macro |\installrawfont| is used in conjunction with \path{8r.mtx} instead of \path{newlatin.mtx}, the encoding file is obviously \path{8r.etx} in this case. Creating \otoneenc encoded virtual fonts requires \path{newlatin.mtx} and \path{ot1.etx}. You will also notice that, in addition to \path{ot1c.etx} and \path{t1c.etx}, fontinst used encoding files like \path{ot1i.etx} and \path{t1i.etx} when creating italic virtual fonts. For \toneenc encoding, \path{t1.etx} and \path{t1i.etx} are equivalent (\path{t1i.etx} simply reads \path{t1.etx} internally), hence we did not bother using \path{t1i.etx} in our fontinst file. The situation is the same with \path{ts1.etx} and \path{ts1i.etx}. For \otoneenc encoding, however, the difference is crucial because this encoding differs depending on the shape: the upright shape features a dollar symbol while the italic shape puts an italic pound symbol in the slot of the dollar. This is yet another idiosyncrasy of \otoneenc.

\chapter{Optical small caps and hanging figures}
\label{scosf}

When choosing a new typeface, bear in mind that optical small caps and hanging figures are not available for all commercial \PS fonts. If they are available for a certain typeface, they are usually provided separately, either in a \scosf or in an expert font package. We will deal with the former case in this tutorial, the latter will be discussed in tutorial \ref{expbase}. Suppose we have acquired the Sabon \scosf package to complement our base install of Sabon. This package provides four additional fonts: a regular \scosf, an italic \osf, a bold \osf, and a bold italic \osf font. These fonts will provide us with hanging figures for all shapes in both weights. Small caps are available for the regular weight only; we will still have to make do with mechanical small caps for the bold weight. Note that Adobe does not include a separate regular-weight upright \osf font. The respective figures are to be found in the small caps font instead. Our original file set looks like this:

\begin{lstlisting}[style=plain,emph={afm,pfb}]{}
sar_____.afm    sai_____.afm     sab_____.afm    sabi_____.afm
sar_____.inf    sai_____.inf     sab_____.inf    sabi_____.inf
sar_____.pfb    sai_____.pfb     sab_____.pfb    sabi_____.pfb
sar_____.pfm    sai_____.pfm     sab_____.pfm    sabi_____.pfm
\end{lstlisting}

\begin{lstlisting}[style=plain,aboveskip=0pt,emph={afm,pfb}]{}
sarsc___.afm    saiof___.afm     sabof___.afm    sabio___.afm
sarsc___.inf    saiof___.inf     sabof___.inf    sabio___.inf
sarsc___.pfb    saiof___.pfb     sabof___.pfb    sabio___.pfb
sarsc___.pfm    saiof___.pfm     sabof___.pfm    sabio___.pfm
\end{lstlisting}

\noindent After renaming and choosing the required files, we could start off with the following set of files:

\begin{lstlisting}[style=plain]{}
psbr8a.afm      psbri8a.afm      psbb8a.afm      psbbi8a.afm
psbr8a.pfb      psbri8a.pfb      psbb8a.pfb      psbbi8a.pfb
\end{lstlisting}

\begin{lstlisting}[style=plain,aboveskip=0pt]{}
psbrc8a.afm     psbrij8a.afm     psbbj8a.afm     psbbij8a.afm
psbrc8a.pfb     psbrij8a.pfb     psbbj8a.pfb     psbbij8a.pfb
\end{lstlisting}

\noindent But before we begin, let us take a closer look at the encoding of the fonts. We will have to deal with some peculiarities characteristic for typical \scosf sets. Taking a look at \path{psbr8a.afm}, you will see that in Adobe Standard encoding, which is the native encoding of all fonts of the Sabon family, the figures are encoded as \enquote*{zero}, \enquote*{one}, \enquote*{two} and so on:

\begin{lstlisting}[style=afm]{}
C 48 ; WX 556 ; N #zero# ; B 52 -15 504 705 ;
C 49 ; WX 556 ; N #one#  ; B 91   0 449 705 ;
C 50 ; WX 556 ; N #two#  ; B 23   0 507 705 ;
\end{lstlisting}

\noindent Compare that to the glyph names of figures in an expert font:

\begin{lstlisting}[style=afm]{}
C 48 ; WX 511 ; N #zerooldstyle# ; B 40 -14 480 436 ;
C 49 ; WX 328 ; N #oneoldstyle#  ; B 35  -3 294 425 ;
C 50 ; WX 440 ; N #twooldstyle#  ; B 44  -3 427 436 ;
\end{lstlisting}

\noindent The different glyph names are appropriate because regular \PS fonts usually come with lining figures by default while expert fonts feature hanging (\enquote*{old style}) figures. Now let us take a look at \path{psbrc8a.afm}:

\begin{lstlisting}[style=afm]{}
C 48 ; WX 556 ; N #zero# ; B  41 -15 515 457 ;
C 49 ; WX 556 ; N #one#  ; B 108   0 448 442 ;
C 50 ; WX 556 ; N #two#  ; B  72   0 512 457 ;
\end{lstlisting}

\noindent When comparing these glyph names to the actual outlines in \path{psbrc8a.pfb},\footnote{The correct name of this font is \path{psbrcj8a}, but we will stick to the naming proposed in Fontname's \path{adobe.map} here.} we can see that this font in fact comes with hanging (\enquote*{old style}) figures even though the figures are labeled using the standard names. This is the case with all \osf fonts included in the \scosf package. The reason why this complicates the installation procedure will become clear when we take a look at the \tex side. In \toneenc encoding, for example, the figures are (essentially) encoded like this by default:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\setslot{%#zero#%}\endsetslot
\setslot{%#one#%}\endsetslot
\setslot{%#two#%}\endsetslot
\end{lstlisting}

\noindent While \tsoneenc encoding (essentially) references them as follows:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\setslot{%#zerooldstyle#%}\endsetslot
\setslot{%#oneoldstyle#%}\endsetslot
\setslot{%#twooldstyle#%}\endsetslot
\end{lstlisting}

\noindent We face a similar problem with small caps. The lowercase letters in \path{psbr8a.afm} are labeled like this:

\begin{lstlisting}[style=afm]{}
C 97 ; WX 500 ; N #a# ; B 42 -15 465 457 ;
C 98 ; WX 556 ; N #b# ; B 46 -15 514 764 ;
C 99 ; WX 444 ; N #c# ; B 25 -15 419 457 ;
\end{lstlisting}

\noindent Expert fonts, which provide small caps as well but do not need to follow Adobe Standard encoding, encode small caps as follows:

\begin{lstlisting}[style=afm]{}
C 97 ; WX 457 ; N #Asmall# ; B -15  -3 467 446 ;
C 98 ; WX 481 ; N #Bsmall# ; B  34  -3 437 437 ;
C 99 ; WX 501 ; N #Csmall# ; B  38 -14 477 448 ;
\end{lstlisting}

\noindent Our font \path{psbrc8a} features small caps in place of lowercase letters but it has to follow Adobe Standard encoding:

\begin{lstlisting}[style=afm]{}
C 97 ; WX 556 ; N #a# ; B 10   0 546 509 ;
C 98 ; WX 556 ; N #b# ; B 49   0 497 490 ;
C 99 ; WX 556 ; N #c# ; B 49 -12 512 502 ;
\end{lstlisting}

\noindent This is one of the tricky parts when installing typical \scosf sets. Fontinst's encoding vectors expect distinct names for distinct glyphs while the metric files of \scosf fonts do not provide unique names for optical small caps and hanging figures. The other idiosyncrasy of \scosf sets is specific to a few font foundries including Adobe: there is no upright \osf font so we have to take the upright hanging figures from the small caps font when building virtual fonts. If you are installing a font family featuring an upright \osf font you obviously do not need to exchange any glyphs to get upright hanging figures.

\section{The fontinst file}
\label{scosf:fontinst}

\noindent In the following, we will use the fontinst file introduced in the last tutorial as a template and add the features we need. We will create two \latex font families: |psb| and |psbj|. The former will provide lining figures while the latter will use the hanging figures of the \osf fonts instead. Both families will incorporate optical small caps where available. In the following, all comments concerning the fontinst file will be restricted to those aspects diverging from our template. Please refer to the previous tutorial for a commentary on the original template.

\begin{lstlisting}[style=fontinst]{drv-psbj}
\input fontinst.sty
\needsfontinstversion{1.926}
\substitutesilent{bx}{b}
\setint{smallcapsscale}{800}
\setint{slant}{167}
\recordtransforms{psb-rec.tex}
\transformfont{psbr8r}{\reencodefont{8r}{\fromafm{psbr8a}}}%*		\label{scosf:drv:a}
\transformfont{psbri8r}{\reencodefont{8r}{\fromafm{psbri8a}}}
\transformfont{psbb8r}{\reencodefont{8r}{\fromafm{psbb8a}}}
\transformfont{psbbi8r}{\reencodefont{8r}{\fromafm{psbbi8a}}}%*		\label{scosf:drv:b}
\end{lstlisting}

\noindent The first couple of lines of our template remain unchanged.

\begin{lstlisting}[style=fontinst]{drv-psbj}
\transformfont{%#psbrc8r#%}{\reencodefont{8r}{\fromafm{%#psbrc8a#%}}}%*	\label{scosf:drv:c}
\transformfont{%#psbrij8r#%}{\reencodefont{8r}{\fromafm{%#psbrij8a#%}}}
\transformfont{%#psbbj8r#%}{\reencodefont{8r}{\fromafm{%#psbbj8a#%}}}
\transformfont{%#psbbij8r#%}{\reencodefont{8r}{\fromafm{%#psbbij8a#%}}}%*\label{scosf:drv:d}
\end{lstlisting}

\noindent After the reencodings inherited form our template (\ref{scosf:drv:a}--\ref{scosf:drv:b}), we insert the new fonts which need to be reencoded as well (\ref{scosf:drv:c}--\ref{scosf:drv:d}).

\begin{lstlisting}[style=fontinst]{drv-psbj}
\transformfont{psbro8r}{\slantfont{\int{slant}}\reencodefont{8r}{\fromafm{psbr8a}}}
\transformfont{psbbo8r}{\slantfont{\int{slant}}\reencodefont{8r}{\fromafm{psbb8a}}}
\transformfont{%#psbrco8r#%}{\slantfont{\int{slant}}\reencodefont{8r}{\fromafm{%#psbrc8a#%}}}%* \label{scosf:drv:e}
\transformfont{%#psbboj8r#%}{\slantfont{\int{slant}}\reencodefont{8r}{\fromafm{%#psbbj8a#%}}}
\end{lstlisting}

\noindent In addition to that, we need slanted versions of the new fonts. Slanting the small caps font (\ref{scosf:drv:e}) may seem a bit unusual given that we do not want to create a slanted small caps shape. But since the regular-weight hanging figures are found in the small caps font, we need a slanted version of that as well to provide matching figures for the slanted shape of the |psbj| family later.

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfonts
\installfamily{T1}{psb}{}
\installfont{psbr8t}{psbr8r,newlatin}{t1}{T1}{psb}{m}{n}{}%*		\label{scosf:drv:f}
\end{lstlisting}

\noindent Building the virtual font for the upright shape (\ref{scosf:drv:f}) is straightforward and in line with our driver template. We depart from our template as we approach the tricky part mentioned above, the font \path{psbrc8r} which contains both small caps and hanging figures. Before we get to the problem of hanging versus lining figures, let us consider a basic case first. To install a text font featuring optical small caps, such as \path{psbrc8r}, we would use the following line:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\installfont{psbrc8t}{psbrc8r,newlatin}{%#t1#%}{T1}{psb}{m}{sc}{}
\end{lstlisting}

\noindent We need the encoding file \path{t1.etx} in this case since the small caps are labeled like ordinary lowercase glyphs in \path{psbrc8a}. The encoding file \path{t1c.etx} would be inappropriate because it expects the small caps to be labeled as \enquote*{Asmall}, \enquote*{Bsmall}, and \enquote*{Csmall}. If it does not find any matching glyphs, it \enquote*{fakes} them by scaling down the tall caps of the respective font~-- which is why we used \path{t1c.etx} in tutorial \ref{standard}. The problem is that \path{psbrc8r} also contains hanging figures whereas we want |psb| to be a consistent family featuring lining figures throughout. Fortunately, we can leverage virtual fonts to combine the glyphs of several raw fonts. In this case, we take the lining figures from \path{psbr8r}:

\begin{lstlisting}[style=fontinst,emph={suffix,lining}]{drv-psbj}
\installfont{psbrc8t}{psbrc8r,%#psbr8r#% suffix lining,newlatin}{lining,t1}{T1}{psb}{m}{sc}{}%* \label{scosf:drv:g}
\end{lstlisting}

\noindent We read \path{psbrc8r} first and \path{psbr8r} after that. Note that |\installfont| does not overwrite any encoding slots when processing additional metric files, it simply fills vacant slots if it finds suitable glyphs in the next font. If the glyphs had unique names, we could simply take the (lining) figures from \path{psbr8r} while the rest of the glyphs including the small caps would be provided by \path{psbrc8r}. But the figures in \path{psbrc8r} are labeled just like those in \path{psbr8r}. How is fontinst supposed to distinguish between the two sets? This is where fontinst's |suffix| option comes into play. This option will add the suffix \enquote*{lining} to the names of all glyphs in \path{psbr8r}. Our encoding vector \path{t1.etx}, however, does not contain any glyph names ending in \enquote*{lining}. The figures are encoded as \enquote*{zero}, \enquote*{one}, \enquote*{two}. Hence we need to create an additional file to get the figures right~-- the encoding file \path{lining.etx}:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\relax
\encoding
\setcommand\digit#1{#1lining}
\endencoding
\endinput
\end{lstlisting}

\noindent So how does all of this fit together? To understand this approach, we need to take another look at how \path{t1.etx} defines the encoding slots for all figures:

\begin{lstlisting}[style=fontinst,numbers=none,emph={digit}]{}
\setslot{\digit{%#one#%}}\endsetslot
\setslot{\digit{%#two#%}}\endsetslot
\setslot{\digit{%#three#%}}\endsetslot
\end{lstlisting}

\noindent The glyph names are not given verbatim in \path{t1.etx}, they are passed to the |\digit| macro as an argument. The default definition of this macro as given in \path{t1.etx} looks like this:

\begin{lstlisting}[style=fontinst,numbers=none,emph={digit}]{}
\setcommand\digit#1{%##1#%}
\end{lstlisting}

\noindent This means that the glyph labeled \enquote*{one} in the \path{afm} file will end up in the encoding slot for the numeral one in the virtual font. Our encoding file \path{lining.etx}, which is read before \path{t1.etx}, predefines the |\digit| macro as follows:

\begin{lstlisting}[style=fontinst,numbers=none,emph={digit}]{}
\setcommand\digit#1{%##1lining#%}
\end{lstlisting}

\noindent Since fontinst's |\setcommand| macro will only define a command if it has not been defined yet, this is the definition which will be used when \path{t1.etx} is processed. With all of that in mind, let us go over line \ref{scosf:drv:g} again:

\begin{lstlisting}[style=fontinst,numbers=none,emph={suffix,lining}]{}
\installfont{psbrc8t}{psbrc8r,%#psbr8r#% suffix lining,newlatin}{lining,t1}{T1}{psb}{m}{sc}{}
\end{lstlisting}

\noindent Because of \path{lining.etx}, fontinst expects all figures to be labeled in the form \enquote*{zerolining}, \enquote*{onelining}, \enquote*{twolining} and so on. All the other glyph names defined by the encoding file \path{t1.etx} remain unchanged. When processing the metric files, fontinst will consider the glyphs found in \path{psbrc8r} first, but it will skip the figures. When processing \path{psbr8r} after that, it will skip almost all of the glyphs it finds in this font since appending the string |lining| to their names has effectively rendered them invalid. The only exception are the figures which now match the format defined in \path{lining.etx}. Hence the virtual font \path{psbrc8t} will be based on \path{psbrc8r} coupled with the figures of \path{psbr8r}.

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfont{psbri8t}{psbri8r,newlatin}{t1}{T1}{psb}{m}{it}{}
\installfont{psbro8t}{psbro8r,newlatin}{t1}{T1}{psb}{m}{sl}{}
\end{lstlisting}

\noindent The installation of the remaining fonts does not differ from our template. We continue with the bold fonts:

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfont{psbb8t}{psbb8r,newlatin}{t1}{T1}{psb}{b}{n}{}
\installfont{psbbc8t}{psbb8r,newlatin}{%#t1c#%}{T1}{psb}{b}{sc}{}%*		\label{scosf:drv:h}
\end{lstlisting}

\noindent Optical small caps are available for the regular weight only. For the bold series we have to make do with \enquote*{faked} small caps, hence we use the encoding file \path{t1c.etx} in line \ref{scosf:drv:h}. The remaining lines for \toneenc encoding do not require any adjustments either:

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfont{psbbi8t}{psbbi8r,newlatin}{t1}{T1}{psb}{b}{it}{}
\installfont{psbbo8t}{psbbo8r,newlatin}{t1}{T1}{psb}{b}{sl}{}
\endinstallfonts
\end{lstlisting}

\noindent That's it for \toneenc encoding. We continue with \tsoneenc:

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfonts
\installfamily{TS1}{psb}{}
\end{lstlisting}

\noindent While \tsoneenc is primarily intended for symbols complementing \toneenc, it includes hanging figures as well. As the only way to use them is loading the \sty{textcomp} package and typing cumbersome text commands like |\textzerooldstyle| (see appendix \ref{textcomp:expert}), it is not very useful to have them in \tsoneenc. Our |psbj| family will make them the default figures anyway so that they are readily available. But we are being picky. Let us see how we can put hanging figures in |TS1/psb| as well. As mentioned above, the problem is that the \osf fonts use regular glyph names for the hanging figures while fontinst's \tsoneenc encoding vector references them by \enquote*{oldstyle} names. Hence we have to turn regular figures~-- which are in fact hanging figures not encoded as such~-- into hanging figures. For the upright fonts, the hanging figures are in fact in the small caps font which complicates the installation even more. But we have dealt with this problem before and the approach should look familiar:

\begin{lstlisting}[style=fontinst,emph={suffix,oldstyle,ts1}]{drv-psbj}
\installfont{psbr8c}{psbr8r,%#psbrc8r#% suffix oldstyle,textcomp}{ts1}{TS1}{psb}{m}{n}{}
\end{lstlisting}

\noindent This time, we do not need an additional encoding file because \path{ts1.etx} uses \enquote*{oldstyle} names by default. All we need to do in order to ensure unique glyph names is adding the string |oldstyle| to the glyphs in \path{psbrc8r} when building the virtual font.

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfontas{psbr8c}{TS1}{psb}{m}{sc}{}
\installfont{psbro8c}{psbro8r,%#psbrco8r#% suffix oldstyle,textcomp}{ts1}{TS1}{psb}{m}{sl}{}
\end{lstlisting}

\noindent The slanted shape is handled in a similar way because it relies on the figures in the small caps font as well. For the remaining virtual fonts the installation is simpler. Since we have raw \osf fonts with hanging figures, all we need to do is rename these figures for \tsoneenc encoding:

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfont{psbri8c}{psbri8r,%#psbrij8r#% suffix oldstyle,textcomp}{ts1}{TS1}{psb}{m}{it}{}
\installfont{psbb8c}{psbb8r,%#psbbj8r#% suffix oldstyle,textcomp}{ts1}{TS1}{psb}{b}{n}{}
\installfontas{psbb8c}{TS1}{psb}{b}{sc}{}
\installfont{psbbo8c}{psbbo8r,%#psbboj8r#% suffix oldstyle,textcomp}{ts1}{TS1}{psb}{b}{sl}{}
\installfont{psbbi8c}{psbbi8r,%#psbbij8r#% suffix oldstyle,textcomp}{ts1}{TS1}{psb}{b}{it}{}
\endinstallfonts
\end{lstlisting}

\noindent This is the first half of our fontinst file. Compared to the template introduced in the previous tutorial it adds optical small caps to \toneenc and hanging figures to \tsoneenc encoding. We will now create an additional font family (|psbj|) featuring hanging figures by default.

\begin{lstlisting}[style=fontinst,emph={suffix,oldstyle,t1j}]{drv-psbj}
\installfonts
\installfamily{T1}{psbj}{}
\installfont{psbrj8t}{psbr8r,%#psbrc8r#% suffix oldstyle,newlatin}{t1j}{T1}{psbj}{m}{n}{}
\end{lstlisting}

\noindent In order to incorporate hanging figures, we need to exchange the figure sets of some fonts again. There is no need to create an additional encoding file this time. Fontinst ships with an encoding vector called \path{t1j.etx} which uses \enquote*{oldstyle} names by default. We use \path{t1j.etx} and add an \enquote*{oldstyle} suffix to the glyph names of the small caps font to combine \path{psbr8r} with the figures in \path{psbrc8r}. If you are installing a font package which includes an upright \osf font, simply use that and build the virtual font as shown for the italic \osf font in line \ref{scosf:drv:i}.

\begin{lstlisting}[style=fontinst,emph={t1}]{drv-psbj}
\installfont{psbrcj8t}{psbrc8r,newlatin}{t1}{T1}{psbj}{m}{sc}{}
\end{lstlisting}

\noindent The small caps font does not require any modifications this time. The raw font already contains hanging figures so we can use it as-is. Since \path{psbrc8r} uses standard glyph names for small caps and hanging figures, we use the regular encoding vector \path{t1.etx}.

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfont{psbroj8t}{psbro8r,%#psbrco8r#% suffix oldstyle,newlatin}{t1j}{T1}{psbj}{m}{sl}{}
\end{lstlisting}

\noindent The slanted shape is handled like the upright one: we combine \path{psbro8r} with the slanted hanging figures provided by \path{psbrco8r}.

\begin{lstlisting}[style=fontinst,emph={t1}]{drv-psbj}
\installfont{psbrij8t}{psbrij8r,newlatin}{t1}{T1}{psbj}{m}{it}{}%*		\label{scosf:drv:i}
\end{lstlisting}

\noindent Building the italic virtual font is trivial because we have an italic \osf font with easily accessible hanging figures in the standard slots (note the regular encoding vector \path{t1.etx}). Since there are \osf fonts for all bold shapes as well, they do not require any special modifications either. We simply use the appropriate \osf fonts instead of the fonts from the basic Sabon package:

\begin{lstlisting}[style=fontinst,emph={t1,t1c}]{drv-psbj}
\installfont{psbbj8t}{psbbj8r,newlatin}{t1}{T1}{psbj}{b}{n}{}
\installfont{psbbcj8t}{psbbj8r,newlatin}{t1c}{T1}{psbj}{b}{sc}{}
\end{lstlisting}

\noindent We create \enquote*{faked} bold small caps using the encoding file \path{t1c.etx} because there is no bold small caps font.

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfont{psbboj8t}{psbboj8r,newlatin}{t1}{T1}{psbj}{b}{sl}{}
\installfont{psbbij8t}{psbbij8r,newlatin}{t1}{T1}{psbj}{b}{it}{}
\endinstallfonts
\end{lstlisting}

\noindent Since \tsoneenc is not a regular text encoding, we do not need to create \tsoneenc encoded fonts for the |psbj| family. Any |TS1/psbj| fonts would be identical to |TS1/psb| anyway. To ensure that the \sty{textcomp} package works with the |psbj| family as well, however, we still have to create a suitable font definition file for |TS1/psbj|:

\begin{lstlisting}[style=fontinst]{drv-psbj}
\installfonts
\installfamily{TS1}{psbj}{}
\end{lstlisting}

\noindent We use |\installfontas| to \enquote*{install} the \tsoneenc encoded virtual fonts of the |psb| family as |TS1/psbj|. As mentioned before, this will merely add some lines to the font definition file without creating any additional virtual fonts:

\begin{lstlisting}[style=fontinst]{drv-psbj}
\%#installfontas#%{psbr8c}{%#TS1#%}{%#psbj#%}{m}{n}{}
\installfontas{psbr8c}{TS1}{psbj}{m}{sc}{}
\installfontas{psbro8c}{TS1}{psbj}{m}{sl}{}
\installfontas{psbri8c}{TS1}{psbj}{m}{it}{}
\installfontas{psbb8c}{TS1}{psbj}{b}{n}{}
\installfontas{psbb8c}{TS1}{psbj}{b}{sc}{}
\installfontas{psbbo8c}{TS1}{psbj}{b}{sl}{}
\installfontas{psbbi8c}{TS1}{psbj}{b}{it}{}
\endinstallfonts
\endrecordtransforms
\bye
\end{lstlisting}

\noindent Now we have a fully functional setup of |psb| and |psbj| in \toneenc and \tsoneenc encoding.

\section{An extended style file}
\label{scosf:styfile}

\noindent With two Sabon families at hand, we might want to update \path{sabon.sty} to make them easily accessible. We add the two options |lining| and |oldstyle| for the respective font families (\ref{scosf:sty:b}, \ref{scosf:sty:c}) and make hanging figures the default (\ref{scosf:sty:d}). Loading the package with the option |oldstyle| or without any option will set up |psbj| as the default roman family while using the |lining| option will make it select |psb| instead:

\begin{lstlisting}[style=latex,emph={sabon,lining,oldstyle,psb,psbj}]{sabon}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{sabon}[2002/05/12 v1.1 Adobe Sabon]
\RequirePackage[T1]{fontenc}
\RequirePackage{textcomp}
\RequirePackage{nfssext}%*					\label{scosf:sty:a}
\DeclareOption{lining}{\renewcommand*{\rmdefault}{psb}}%*	\label{scosf:sty:b}
\DeclareOption{oldstyle}{\renewcommand*{\rmdefault}{psbj}}%*	\label{scosf:sty:c}
\ExecuteOptions{oldstyle}%*					\label{scosf:sty:d}
\ProcessOptions*
\endinput
\end{lstlisting}

\noindent It might also be handy to have dedicated text commands to switch between the two figure sets. Since such commands will need to work with all font families anyway, let us put them in a stand-alone style file and load it in \path{sabon.sty} (\ref{scosf:sty:a}). The style file \path{nfssext.sty} might look like this:

\begin{lstlisting}[style=latex]{nfssext1}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{nfssext}[2003/03/14 v1.2 Experimental NFSS Extensions]
\newcommand*{\exfs@tempa}{}
\newcommand*{\exfs@tempb}{}
\newcommand*{\exfs@try@family}[1]{%
  \let\exfs@tempa\relax
  \begingroup
    \fontfamily{#1}\try@load@fontshape%*			\label{scosf:nfex:a}
    \expandafter\ifx\csname\curr@fontshape\endcsname\relax
      \PackageWarning{nfssext}{%%*				\label{scosf:nfex:b}
	Font family '\f@encoding/#1' not available\MessageBreak
	Ignoring font switch}%%*				\label{scosf:nfex:c}
    \else
      \gdef\exfs@tempa{\fontfamily{#1}\selectfont}%%*		\label{scosf:nfex:d}
    \fi
  \endgroup
  \exfs@tempa}
\end{lstlisting}

\noindent This is an outline for a command that makes use of a few \nfss internals to switch to a specific family if and only if it is available. Essentially, we try to load the requested family in the current encoding (\ref{scosf:nfex:a}). If this succeeds, we set up a macro (\ref{scosf:nfex:d}) to be expanded later that will actually switch font families; if not, we print a warning message (\ref{scosf:nfex:b}--\ref{scosf:nfex:c}) and do nothing.

\begin{lstlisting}[style=latex]{nfssext1}
\def\exfs@get@base#1#2#3#4\@nil{#1#2#3}%%*			\label{scosf:nfex:e}
\DeclareRobustCommand{\%#lnstyle#%}{%
  \not@math@alphabet\lnstyle\relax
  \exfs@try@family{\expandafter\exfs@get@base\f@family\@nil}}
\DeclareRobustCommand{\%#osstyle#%}{%
  \not@math@alphabet\osstyle\relax
  \exfs@try@family{\expandafter\exfs@get@base\f@family\@nil %#j#%}}
\end{lstlisting}

\noindent The macros |\lnstyle| and |\osstyle| switch to lining and hanging (\enquote*{old style}) figures respectively. They are employed like |\bfseries| or |\itshape|. Internally, they will take the first three letters of the current \nfss font family name (\ref{scosf:nfex:e}), append a letter to it where appropriate (none for lining figures, |j| for hanging figures), and call |\exfs@try@family|. Even though this mechanism is rather simple-minded, it should work just fine for all fonts set up according to the Fontname scheme.

\begin{lstlisting}[style=latex,emph={textln,textos,lnstyle,osstyle}]{nfssext1}
\DeclareTextFontCommand{\textln}{\lnstyle}
\DeclareTextFontCommand{\textos}{\osstyle}
\endinput
\end{lstlisting}

\noindent The corresponding text commands, |\textln| and |\textos|, take one mandatory argument and can be employed like |\textbf| or |\textit|.

\section{The fonts supplied with \tex}
\label{scosf:texfonts}

The standard \PS fonts supplied with the most common \tex distributions do not include optical small caps, nor do they include hanging figures. The default typeface of both plain \tex and \latex however, Computer Modern Roman, does include such glyphs. Unfortunately, the design of the small caps is flawed. Their height corresponds to what you usually end up with when creating mechanical small caps. Being too tall, these small caps hardly blend in with lowercase text at all, even though their color matches that of the lowercase alphabet.

Hanging figures are included in Computer Modern as well, but they are hidden in some of the math fonts. The only way to use them with the default setup is rather cumbersome: the macro |\oldstylenums| will take the numbers to be typeset as hanging figures as an argument. There is a set of virtual fonts for the European Computer Modern fonts which make these hanging figures the default in \tex's text mode so that they are readily available. These fonts are provided in the \textsc{eco} package available from \ctan.\fnurl{http://www.ctan.org/tex-archive/fonts/eco/} Please refer to the package documentation for installation and usage instructions. Since this package essentially consists of a set of virtual fonts, it should also work in conjunction with the \textsc{cm}-super fonts mentioned in section \ref{basics:cm}. Note that all of this applies to \tex's text mode only. In math mode, \tex will use an independant set of fonts.

\chapter{The euro currency symbol}
\label{euro}

While the euro symbol has been supported by \latex for quite some time~-- it is included in \tsoneenc encoding and the \sty{textcomp} package provides the corresponding text command |\texteuro|~-- the real problem is getting fonts that provide this glyph and setting them up accordingly. You might want to read this tutorial even if you are not affected by this particular issue, because it deals with some generic encoding problems that you may encounter in a different context as well. There is a bit more to updating a font than drawing a euro symbol and putting it in the font. It has to be properly encoded as well. Since the euro symbol is not defined in Adobe Standard encoding, it can normally only be included as an uncoded glyph in regular \PS text fonts. An uncoded glyph is only accessible after reencoding and assigning it to a valid encoding slot. Some font foundries decided to follow this path in order to conform to Adobe Standard encoding. Others prefer to drop some supposedly rarely used glyph and put the euro symbol in its encoding slot instead. While this violates the encoding standard, it can be more convenient under certain circumstances. In the following, we will explore ways to handle both situations cleanly. Finally, we will learn how to take the euro symbol from an external font if none is provided by the text font itself.

\section{Uncoded euro symbol}
\label{euro:uncoded}

While Adobe used to be rather inattentive to the problem at first, the foundry is finally updating their typeface portfolio by gradually adding matching euro symbols to their fonts~-- a process that has been promoted by the introduction of the \OT font format. Recent releases of Adobe Garamond, for example, already ship with matching euro symbols. A quick look at the \path{afm} file shows that in this case, the foundry decided to handle the encoding problem in a strict manner. The new symbol is correctly labeled as \enquote*{Euro} but it is not encoded by default as that would violate Adobe Standard encoding. An encoding slot number of \textln{-1} means that the glyph is uncoded:

\begin{lstlisting}[style=afm]{}
C #-1# ; WX 572 ; N #Euro# ; B -13 -14 542 640 ;
\end{lstlisting}

\noindent In order to access it, we need to reencode the font and assign the glyph \enquote*{Euro} to a valid encoding slot. The standard procedure we have been pursuing in this guide involves reencoding all fonts to \baseone encoding anyway precisely because of cases like this one. By reencoding all fonts to \baseone encoding we ensure that all glyphs our virtual fonts rely on are properly encoded in the raw fonts we use as their basis. As of fontinst 1.9, the encoding file \path{8r.etx} includes the euro symbol. Note that you also need a matching version of \path{8r.enc} for \dvips and \pdftex. This file is distributed separately and not included in the fontinst release.\fnurl{http://www.ctan.org/tex-archive/info/fontname/8r.enc} Since reencoding all text fonts to \baseone encoding is part of our regular installation routine anyway, the fontinst file does not need any adjustments:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\transformfont{padr8r}{\reencodefont{8r}{\fromafm{padr8a}}}
\end{lstlisting}

\noindent The reencoding step will ensure that the euro symbol is available in all \baseone encoded raw fonts. We can use them to build \tsoneenc encoded virtual fonts as usual:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\installfont{padr8c}{padr8r,textcomp}{ts1}{TS1}{pad}{m}{n}{}
\end{lstlisting}

\noindent After installing the fonts and all auxiliary files, the euro symbol will be available as |\texteuro| when loading the \sty{textcomp} package.

\section{Euro symbol encoded as currency symbol}
\label{euro:currency}

Bitstream was one of the first type foundries to update their font collection and add a matching euro symbol to all fonts. When looking at the fonts, the first thing we notice is that the foundry decided to encode the euro symbol as the generic currency symbol \enquote*{\textcurrency}. The reason for this is that you can access the symbol without reencoding the font, which can be very difficult on some systems. Since the generic currency symbol is hardly ever used anyway, it is no surprise that this particular glyph was dropped. We could install Bitstream fonts as usual and use |\textcurrency| instead of |\texteuro| to access the euro symbol, but that would imply keeping the idiosyncrasies of a given font in mind while writing, and modifying the text when changing the typeface~-- not quite what one would expect when working with a high-level markup language like \latex.

When taking a closer look at the \path{pfb} and \path{afm} files, we can see that the fonts in fact contain two euro symbols. The first one is found in encoding slot 168, that is, it is encoded as the currency symbol and labeled accordingly. To verify that, we have to take a look at the \path{pfb} files in a font editor. Since the euro symbol is both encoded and labeled just like a currency symbol, there is no way to tell the difference by looking at the \path{afm} file only:

\begin{lstlisting}[style=afm]{}
C #168# ; WX 556 ; N #currency# ; B 6 -12 513 697 ;
\end{lstlisting}

\noindent The other one is uncoded (slot \textln{-1}) and labeled as \enquote*{Euro}:

\begin{lstlisting}[style=afm]{}
C #-1# ; WX 556 ; N #Euro# ; B 6 -12 513 697 ;
\end{lstlisting}

\noindent If we want a readily available euro symbol (and one that is available \textit{as such}), we have two options in this case. Either we reencode the font and assign the uncoded euro symbol to a valid encoding slot or we use the already encoded euro symbol found in the slot of the currency symbol and move it to the proper encoding slot. The former case was already discussed above, let us now investigate the latter.

The easiest way to move the glyph to a different slot is resetting it when creating the \tsoneenc encoded virtual fonts. This requires that the glyph is already encoded (in any slot) in the raw fonts serving as their basis. Since the \baseone encoding we use for all base fonts includes both the euro and the generic currency symbol this should not pose any problems. The low-level commands which reset the glyph go in a dedicated metric file, \path{reseteur.mtx}, which we have to create ourselves:

\begin{lstlisting}[style=fontinst,emph={resetglyph,endsetglyph,glyph}]{}
\relax
\metrics
\resetglyph{%#euro#%}%*				\label{euro:reset:a}
  \glyph{%#currency#%}{1000}
\endsetglyph%*					\label{euro:reset:b}
\setleftrightkerning{euro}{currency}{1000}
\unsetglyph{currency}%*				\label{euro:reset:c}
\endmetrics
\end{lstlisting}

\noindent We reset the glyph \enquote*{euro} based on the glyph \enquote*{currency} scaled to its full size in line \ref{euro:reset:a}--\ref{euro:reset:b}, adjust the kerning on either side of \enquote*{euro} to match that of \enquote*{currency} and finally unset the glyph \enquote*{currency} in line \ref{euro:reset:c} because there is no such thing as a generic currency symbol in this font. In the fontinst file, we include the metric file \path{reseteur.mtx} in the file list of the respective |\installfont| command right after the metrics for this font have been read. This might look as follows:

\begin{lstlisting}[style=fontinst,numbers=none,emph={reseteur}]{}
\installfont{bsbr8c}{bsbr8r,reseteur,textcomp}{ts1}{TS1}{bsb}{m}{n}{}
\end{lstlisting}

\noindent We only need to do this for the \tsoneenc encoded virtual fonts as \toneenc does not include the euro symbol. Apart from that, the fontinst file does not need any adjustments.

\section{Euro symbol taken from symbol font}
\label{euro:eurofont}

Let us go back to our install of Sabon to see if we can get euro support for Sabon as well. The font itself does not include any euro symbol at all. If we do not provide a euro symbol, fontinst will automatically try to fake it by overstriking the capital letter \enquote*{C} with two horizontal bars as a last resort. This procedure might yield acceptable results in some cases, but the quality varies significantly from typeface to typeface. The result can be anything from reasonable to completely unsuable. Still, it is by all means worth a try if no matching euro symbol is available.

We could also try to take the euro symbol from an external symbol font. While some font foundries at least provide special symbol fonts containing a collection of matching euro glyphs for all typefaces that have not been updated yet, Adobe merely offers a set of generic euro fonts containing glyphs that do not really match any typeface at all. From a typographical perspective, this is a desperate workaround. However, lacking a matching euro symbol, we do not have a choice. The Adobe Euro fonts\fnurl{http://www.adobe.com/type/eurofont.html} come in three flavors: serif (Euro Serif), sans serif (Euro Sans), and condensed sans serif (Euro Mono, intended for use with monospaced fonts). Each family consists of regular, regular italic, bold, and bold italic fonts.

Instead of using a serif euro that does not match our typeface we will use the sans serif design which has a more generic look that adheres to the reference design of the European Commission. Granted, this one does not match our typeface either~-- but at least it does not pretend to do so. Now that we are aware of the most common encoding pitfalls, we inspect the \path{afm} files first before proceeding with the installation. The Euro fonts put the euro symbol in all encoding slots. When looking at the \path{afm} file, we can see that the fonts use a font specific encoding and that the glyphs are labeled as \enquote*{Euro} with a consecutive number appended to the name:

\begin{lstlisting}[style=afm]{}
C 33 ; WX 750 ; N #Euro.001# ; B 10 -12 709 685 ;
C 34 ; WX 750 ; N #Euro.002# ; B 10 -12 709 685 ;
C 35 ; WX 750 ; N #Euro.003# ; B 10 -12 709 685 ;
C 36 ; WX 750 ; N #Euro.004# ; B 10 -12 709 685 ;
C 37 ; WX 750 ; N #Euro.005# ; B 10 -12 709 685 ;
\end{lstlisting}

\noindent On further inspection, we find two additional glyphs. There is a glyph labeled \enquote*{Euro} in slot 128 as well as an uncoded glyph labeled \enquote*{uni\textsc{20ac}}:

\begin{lstlisting}[style=afm]{}
C #128# ; WX 750 ; N #Euro#    ; B 10 -12 709 685 ;
C  #-1# ; WX 750 ; N #uni20AC# ; B 10 -12 709 685 ;
\end{lstlisting}

\noindent The number \textsc{20ac} is 8364 in hexadecimal and slot 8364 is the encoding slot of the euro symbol in Unicode encoding, hence the string \enquote*{uni\textsc{20ac}}. Obviously someone was trying to make sure that every application out there would be able to access that euro symbol. Fortunately, this covers our situation as well. We need a glyph that is encoded and labeled as \enquote*{Euro}. The encoding slot number does not matter since we will include it in a virtual font using a different encoding anyway. The one in slot 128 fits our needs perfectly. In practice, this means that we can simply add the file name to the input file list of an |\installfont| command when creating \tsoneenc encoded virtual fonts with fontinst:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\installfont{psbr8c}{psbr8r,%#zpeurs#%,textcomp}{ts1}{TS1}{psb}{m}{n}{}
\end{lstlisting}

\noindent Since the Adobe Euro fonts are non-standard, their naming is non-standard as well. We will discuss that in more detail below. Before running this file, we need to copy the properly named \path{afm} files of the Adobe Euro fonts to the working directory so that fontinst will find them. For the euro glyph to be available later, the Euro fonts need to be installed in the usual way so that \tex as well as \pdftex, \dvips, and \xdvi are able to use them.

\section{Installing symbol fonts}
\label{euro:install}

From a technical perspective, symbol fonts differ from text fonts in that they are not based on any standardized encoding. They use a font specific encoding instead. Essentially, this means that the order of the glyphs in the font is arbitrary. When installing symbol fonts, we will usually not reencode them. This implies that we have to provide some kind of user interface tailored for the font if we want to access the glyphs directly. We will discuss that in detail below. Adobe's Euro font package\fnurl{http://www.adobe.com/type/eurofont.html} provides us with the following set of files:

\begin{lstlisting}[style=plain,emph={afm,pfb}]{}
_1______.afm    _1i_____.afm     _1b_____.afm    _1bi____.afm
_1______.inf    _1i_____.inf     _1b_____.inf    _1bi____.inf
_1______.pfb    _1i_____.pfb     _1b_____.pfb    _1bi____.pfb
_1______.pfm    _1i_____.pfm     _1b_____.pfm    _1bi____.pfm
_2______.afm    _2i_____.afm     _2b_____.afm    _2bi____.afm
_2______.inf    _2i_____.inf     _2b_____.inf    _2bi____.inf
_2______.pfb    _2i_____.pfb     _2b_____.pfb    _2bi____.pfb
_2______.pfm    _2i_____.pfm     _2b_____.pfm    _2bi____.pfm
_3______.afm    _3i_____.afm     _3b_____.afm    _3bi____.afm
_3______.inf    _3i_____.inf     _3b_____.inf    _3bi____.inf
_3______.pfb    _3i_____.pfb     _3b_____.pfb    _3bi____.pfb
_3______.pfm    _3i_____.pfm     _3b_____.pfm    _3bi____.pfm
\end{lstlisting}

\noindent The Fontname map file \path{adobe.map} defines the following names for these fonts:

\begin{lstlisting}[style=map]{}
#zpeur#     EuroSerif-Regular                 A    916    #_3______#
#zpeub#     EuroSerif-Bold                    A    916    #_3b_____#
#zpeubi#    EuroSerif-BoldItalic              A    916    #_3bi____#
#zpeuri#    EuroSerif-Italic                  A    916    #_3i_____#
#zpeurs#    EuroSans-Regular                  A    916    #_1______#
#zpeubs#    EuroSans-Bold                     A    916    #_1b_____#
#zpeubis#   EuroSans-BoldItalic               A    916    #_1bi____#
#zpeuris#   EuroSans-Italic                   A    916    #_1i_____#
#zpeurt#    EuroMono-Regular                  A    916    #_2______#
#zpeubt#    EuroMono-Bold                     A    916    #_2b_____#
#zpeubit#   EuroMono-BoldItalic               A    916    #_2bi____#
#zpeurit#   EuroMono-Italic                   A    916    #_2i_____#
\end{lstlisting}

\noindent We select all \path{afm} and all \path{pfb} files, rename them, and start off with the following file set:

\begin{lstlisting}[style=plain]{}
zpeur.afm       zpeuri.afm       zpeub.afm       zpeubi.afm
zpeur.pfb       zpeuri.pfb       zpeub.pfb       zpeubi.pfb
zpeurs.afm      zpeuris.afm      zpeubs.afm      zpeubis.afm
zpeurs.pfb      zpeuris.pfb      zpeubs.pfb      zpeubis.pfb
zpeurt.afm      zpeurit.afm      zpeubt.afm      zpeubit.afm
zpeurt.pfb      zpeurit.pfb      zpeubt.pfb      zpeubit.pfb
\end{lstlisting}

\noindent The installation of symbol fonts does not really require fontinst as far as creating the metrics is concerned because we do not need to reencode the fonts or create virtual fonts based on them. Simply running \bin{afm2tfm} on each \path{afm} file to create the corresponding \path{tfm} file for \tex would do the job:

\begin{lstlisting}[style=shell]{}
afm2tfm zpeur.afm  zpeur.tfm
afm2tfm zpeuri.afm zpeuri.tfm
afm2tfm zpeub.afm  zpeub.tfm
afm2tfm zpeubi.afm zpeubi.tfm
\end{lstlisting}

\noindent \bin{afm2tfm} is able to create slanted fonts as well:

\begin{lstlisting}[style=shell]{}
afm2tfm zpeur.afm -s 0.167 zpeuro.tfm
afm2tfm zpeub.afm -s 0.167 zpeubo.tfm
\end{lstlisting}

\noindent The downside of using \bin{afm2tfm} is that we have to create font definition files and map files manually. Font definition files are not required if the fonts are only referenced by other virtual fonts, but they will allow us the access the fonts directly in any \latex file. We will use fontinst to take advantage of its map file writer and the fact that it generates font definition files automatically.

\begin{lstlisting}[style=fontinst]{drv-zpeu}
\input fontinst.sty
\needsfontinstversion{1.926}
\setint{slant}{167}
\recordtransforms{peu-rec.tex}
\end{lstlisting}

\noindent Our fontinst file starts with a familiar header.

\begin{lstlisting}[style=fontinst]{drv-zpeu}
\transformfont{zpeuro}{\slantfont{\int{slant}}{\fromafm{zpeur}}}
\transformfont{zpeubo}{\slantfont{\int{slant}}{\fromafm{zpeub}}}
\transformfont{zpeuros}{\slantfont{\int{slant}}{\fromafm{zpeurs}}}
\transformfont{zpeubos}{\slantfont{\int{slant}}{\fromafm{zpeubs}}}
\transformfont{zpeurot}{\slantfont{\int{slant}}{\fromafm{zpeurt}}}
\transformfont{zpeubot}{\slantfont{\int{slant}}{\fromafm{zpeubt}}}
\end{lstlisting}

\noindent Symbol fonts are not reencoded but we still need slanted versions of the upright euro fonts to go with our slanted text fonts.

\begin{lstlisting}[style=fontinst,emph={U,peu}]{drv-zpeu}
\installfonts
\installfamily{U}{peu}{}
\end{lstlisting}

\noindent When creating font definition files for symbol fonts, we use the encoding code |U| to indicate an unknown (font specific) encoding.

\begin{lstlisting}[style=fontinst]{drv-zpeu}
\installrawfont{zpeur}{zpeur}{%#txtfdmns#%,%#zpeur mtxasetx#%}{U}{peu}{m}{n}{}
\end{lstlisting}

\noindent We want to convert the font metrics given in the |afm| file to \tex font metrics directly, without using virtual fonts as a mediating layer. For this kind of task, we need fontinst's |\installrawfont| macro. In case of a straight |afm| to |tfm| conversion, the name of the \tex font metric file (first argument) is identical to the name of the |afm| file (second argument). Like |\installfont|, the |\installrawfont| macro requires an encoding file as well. So how do we deal with a font specific encoding? We load \path{zpeur} followed by the option |mtxasetx|. This option instructs fontinst to create an ad-hoc encoding vector based on the order of the glyphs in the font. We add the file \path{txtfdmns.etx} to ensure that \tex's |\fontdimen| parameters are set for this font as well (they are normally set by encoding files like \path{t1.etx}).

\begin{lstlisting}[style=fontinst]{drv-zpeu}
\installfontas{zpeur}{U}{peu}{m}{sc}{}
\end{lstlisting}

\noindent The fonts do not include a small caps shape so we reuse the upright one. The remaining fonts are installed in a similar way:

\begin{lstlisting}[style=fontinst]{drv-zpeu}
\installrawfont{zpeuro}{zpeuro}{txtfdmns,zpeuro mtxasetx}{U}{peu}{m}{sl}{}
\installrawfont{zpeuri}{zpeuri}{txtfdmns,zpeuri mtxasetx}{U}{peu}{m}{it}{}
\installrawfont{zpeub}{zpeub}{txtfdmns,zpeub mtxasetx}{U}{peu}{b}{n}{}
\installfontas{zpeub}{U}{peu}{b}{sc}{}
\installrawfont{zpeubo}{zpeubo}{txtfdmns,zpeubo mtxasetx}{U}{peu}{b}{sl}{}
\installrawfont{zpeubi}{zpeubi}{txtfdmns,zpeubi mtxasetx}{U}{peu}{b}{it}{}
\endinstallfonts
\end{lstlisting}

\noindent We add the Euro Sans fonts:

\begin{lstlisting}[style=fontinst]{drv-zpeu}
\installfonts
\installfamily{U}{peus}{}
\installrawfont{zpeurs}{zpeurs}{txtfdmns,zpeurs mtxasetx}{U}{peus}{m}{n}{}
\installfontas{zpeurs}{U}{peus}{m}{sc}{}
\installrawfont{zpeuros}{zpeuros}{txtfdmns,zpeuros mtxasetx}{U}{peus}{m}{sl}{}
\installrawfont{zpeuris}{zpeuris}{txtfdmns,zpeuris mtxasetx}{U}{peus}{m}{it}{}
\installrawfont{zpeubs}{zpeubs}{txtfdmns,zpeubs mtxasetx}{U}{peus}{b}{n}{}
\installfontas{zpeubs}{U}{peus}{b}{sc}{}
\installrawfont{zpeubos}{zpeubos}{txtfdmns,zpeubos mtxasetx}{U}{peus}{b}{sl}{}
\installrawfont{zpeubis}{zpeubis}{txtfdmns,zpeubis mtxasetx}{U}{peus}{b}{it}{}
\endinstallfonts
\end{lstlisting}

\noindent And the Euro Mono fonts:

\begin{lstlisting}[style=fontinst]{drv-zpeu}
\installfonts
\installfamily{U}{peut}{}
\installrawfont{zpeurt}{zpeurt}{txtfdmns,zpeurt mtxasetx}{U}{peut}{m}{n}{}
\installfontas{zpeurt}{U}{peut}{m}{sc}{}
\installrawfont{zpeurot}{zpeurot}{txtfdmns,zpeurot mtxasetx}{U}{peut}{m}{sl}{}
\installrawfont{zpeurit}{zpeurit}{txtfdmns,zpeurit mtxasetx}{U}{peut}{m}{it}{}
\installrawfont{zpeubt}{zpeubt}{txtfdmns,zpeubt mtxasetx}{U}{peut}{b}{n}{}
\installfontas{zpeubt}{U}{peut}{b}{sc}{}
\installrawfont{zpeubot}{zpeubot}{txtfdmns,zpeubot mtxasetx}{U}{peut}{b}{sl}{}
\installrawfont{zpeubit}{zpeubit}{txtfdmns,zpeubit mtxasetx}{U}{peut}{b}{it}{}
\endinstallfonts
\endrecordtransforms
\bye
\end{lstlisting}

\noindent Fontinst will record the mapping data in \path{peu-rec.tex}, but we still need an additional driver file which converts these records to the final map file:

\begin{lstlisting}[style=fontinst]{map-zpeu}
\input finstmsc.sty
\resetstr{PSfontsuffix}{.pfb}
\adddriver{dvips}{peu.map}
\input peu-rec.tex
\donedrivers
\bye
\end{lstlisting}

\noindent After running both fontinst files through \bin{tex}, we process the property list files (\path{pl}) created by fontinst with \bin{pltotf} in order to generate \tex font metric files (\path{tfm}). We install the map file \path{peu.map} as well as all \path{afm}, \path{tfm}, \path{pfb}, and \path{fd} files in the local \tex tree as explained section \ref{basics:install} and add \path{peu.map} to the configuration files for \pdftex, \dvips, and \xdvi. Finally, we run \bin{texhash}. The euro symbol can now be used in virtual fonts. Since we have font definition files for \latex as well, we could also access it in any \latex file with a command sequence like this one:

\begin{lstlisting}[style=latex,numbers=none,emph={U,peu}]{}
{\fontencoding{U}\fontfamily{peu}\selectfont\char 128}
\end{lstlisting}

\noindent So let us make that a generic euro package, \path{peufonts.sty}, for use with all fonts that do not provide a native euro symbol:

\begin{lstlisting}[style=latex,emph={eurrm,eursf,eurtt}]{peufonts.sty}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{peufonts}[2002/10/25 v1.0 Adobe Euro Fonts]
\RequirePackage{textcomp}%*				\label{euro:peufnt:a}
\DeclareRobustCommand{\eurrm}{%
  %#{#%\fontencoding{U}\fontfamily{%#peu#%}\selectfont\char 128%#}#%}
\DeclareRobustCommand{\eursf}{%
  %#{#%\fontencoding{U}\fontfamily{%#peus#%}\selectfont\char 128%#}#%}
\DeclareRobustCommand{\eurtt}{%
  %#{#%\fontencoding{U}\fontfamily{%#peut#%}\selectfont\char 128%#}#%}
\end{lstlisting}

\noindent We define three macros, |\eurrm|, |\eursf|, and |\eurtt|, which typeset a serif, sans serif, and monospaced euro symbol respectively. Note the additional set of braces. They form a group which keeps the font change local.

\begin{lstlisting}[style=latex,emph={serif,sans,mono,eurrm,eursf,eurtt}]{peufonts.sty}
\DeclareOption{serif}{\def\eur{\eurrm}}
\DeclareOption{sans}{\def\eur{\eursf}}
\DeclareOption{mono}{\def\eur{\eurtt}}
\DeclareOption{textcomp}{%
  \PackageInfo{peufonts}{Hijacking '\string\texteuro'}%
  \def\texteuro{\eur}}
\ExecuteOptions{sans}%*					\label{euro:peufnt:b}
\ProcessOptions*
\endinput
\end{lstlisting}

\noindent We also provide |\eur| along with three options controlling whether it uses the serif, sans serif, or monospaced euro symbol. Sans is set up as the default in line \ref{euro:peufnt:b}. The option \sty{textcomp} will hijack the text command |\texteuro| as provided by the \sty{textcomp} package. This is very handy when using the \sty{inputenc} package with Latin\,9 (\textsc{iso-8859-15}) as input encoding and entering the euro symbol directly, as \sty{inputenc} uses |\texteuro| internally. With this option, we may also type |\texteuro| or simply \texttt{\texteuro} in the input file to typeset a euro symbol. For this to work, \sty{inputenc} has to be loaded before this package. Please keep in mind that this is a global redefinition affecting all text fonts. We do not activate it by default as some fonts may provide a native euro symbol. We also write a message to the log when redefining |\texteuro| and request the \sty{textcomp} package in line \ref{euro:peufnt:a}.

\chapter{Expert font sets, regular setup}
\label{expbase}

Expert fonts are complements to be used in conjunction with regular text fonts. They usually contain optical small caps, additional sets of figures~-- hanging, inferior, superior~--, the f-ligatures ff, fi, fl, ffi, and ffl, plus a few text fractions and some other symbols. Since they are companion fonts only, which do not contain the regular uppercase and lowercase alphabet, they are not useful on their own. To employ them in a sensible way we need the basic text fonts as well. In this tutorial, we will install the complete Monotype Janson font set as provided by the base and the expert package offered by Agfa Monotype. The base package contains four text fonts (regular, regular italic, bold, bold italic):

\begin{lstlisting}[style=plain,emph={afm,pfb}]{}
jan_____.afm    jani____.afm     janb____.afm    janbi___.afm
jan_____.inf    jani____.inf     janb____.inf    janbi___.inf
jan_____.pfb    jani____.pfb     janb____.pfb    janbi___.pfb
jan_____.pfm    jani____.pfm     janb____.pfm    janbi___.pfm
\end{lstlisting}

\noindent The expert package adds the corresponding expert fonts:

\begin{lstlisting}[style=plain,emph={afm,pfb}]{}
jny_____.afm    jnyi____.afm     jnyb____.afm    jnybi___.afm
jny_____.inf    jnyi____.inf     jnyb____.inf    jnybi___.inf
jny_____.pfb    jnyi____.pfb     jnyb____.pfb    jnybi___.pfb
jny_____.pfm    jnyi____.pfm     jnyb____.pfm    jnybi___.pfm
\end{lstlisting}

\noindent When talking about \enquote*{expert font sets} in this tutorial, we are referring to all of the above (base plus expert package). The proper file names for Monotype Janson are given in \path{monotype.map}. Expert fonts have essentially the same file name as the corresponding text fonts, but their encoding code is |8x| instead of |8a| for Adobe Standard encoding. After renaming the files, we start off with the following file set:

\begin{lstlisting}[style=plain,belowskip=0pt]{}
mjnr8a.afm      mjnri8a.afm      mjnb8a.afm      mjnbi8a.afm
mjnr8a.pfb      mjnri8a.pfb      mjnb8a.pfb      mjnbi8a.pfb
\end{lstlisting}

\begin{lstlisting}[style=plain]{}
mjnr8x.afm      mjnri8x.afm      mjnb8x.afm      mjnbi8x.afm
mjnr8x.pfb      mjnri8x.pfb      mjnb8x.pfb      mjnbi8x.pfb
\end{lstlisting}

\noindent There are two ways to install an expert font set. Apart from writing a verbose fontinst file using low-level commands we may also use the |\latinfamily| macro. We will take a look at the latter case first and proceed with a verbose fontinst file afterwards.

\section{A basic fontinst file}
\label{expbase:latinfamily}

As usual, our driver file starts with a typical header (\ref{expbase:lat:a}--\ref{expbase:lat:b}). The Janson expert package provides optical small caps for the regular weight but the bold expert fonts do not contain any small caps. For the bold series, we have to make do with mechanical small caps. The |\latinfamily| macro will take care of that automatically. All we need to do is define a scaling factor of 0.72 on line \ref{expbase:lat:b}:

\begin{lstlisting}[style=fontinst]{drv-mjn-latfamx}
\input fontinst.sty%*			\label{expbase:lat:a}
\needsfontinstversion{1.926}
\substitutesilent{bx}{b}
\setint{%#smallcapsscale#%}{%#720#%}%*	\label{expbase:lat:b}
\recordtransforms{mjn-rec.tex}
\end{lstlisting}

\noindent In the third tutorial we have incorporated lining and hanging figures by creating two font families: a family with the basic, three-character font family name (lining figures) and a second family featuring hanging figures, with the letter |j| appended to the font family name. The character |j| is the Fontname code for hanging figures. In this tutorial, we need an additional code: the letter |x|, indicating a font featuring expert glyphs. When installing expert sets with the |\latinfamily| macro we use these family names to instruct fontinst that we have an expert set at hand and that we want it to create a font family featuring expert glyphs with lining figures (\ref{expbase:lat:c}) plus a second family featuring expert glyphs with hanging figures (\ref{expbase:lat:d}):

\begin{lstlisting}[style=fontinst,emph={mjnx,mjnj}]{drv-mjn-latfamx}
\latinfamily{mjnx}{}%*			\label{expbase:lat:c}
\latinfamily{mjnj}{}%*			\label{expbase:lat:d}
\endrecordtransforms
\bye
\end{lstlisting}

\noindent Please note that appending |x| and |j| to the font family name works for expert font sets only. The |\latinfamily| macro is not capable of dealing with \scosf font sets in the same way. Such font sets always require a fontinst file using low-level commands such as the one discussed in tutorial \ref{scosf}.

\section{A verbose fontinst file}
\label{expbase:fontinst}

While the |\latinfamily| macro incorporates the most fundamental features of expert sets, such as optical small caps and additional f-ligatures, it does not exploit all the glyphs found in expert fonts. To take advantage of them, we need to use low-level fontinst commands, at least for parts of the fontinst file. But before we start with our verbose fontinst file, let us first take a look at some encoding issues specific to expert fonts. When dealing with \scosf fonts in the third tutorial, we had to rename some glyphs or move them around because in \scosf fonts, hanging figures and small caps are found in the standard slots for figures and the lowercase alphabet. With small caps and hanging figures provided by expert fonts the installation is in fact simpler since all glyph names are unique. To understand the difference, we will take a brief look at the glyph names in the respective \path{afm} files. Compare the names of the lowercase glyphs as found in \path{mjnr8a.afm} to the small caps glyph names in \path{mjnr8x.afm}:

\begin{lstlisting}[style=afm]{}
C  97 ; WX 427 ; N #a# ; B 59 -13 409 426 ;
C  98 ; WX 479 ; N #b# ; B 18 -13 442 692 ;
C  99 ; WX 427 ; N #c# ; B 44 -13 403 426 ;
\end{lstlisting}

\begin{lstlisting}[style=afm]{}
C  97 ; WX 479 ; N #Asmall# ; B 19  -4 460 451 ;
C  98 ; WX 438 ; N #Bsmall# ; B 31  -4 395 434 ;
C  99 ; WX 500 ; N #Csmall# ; B 37 -12 459 443 ;
\end{lstlisting}

\noindent The situation is similar for lining and hanging (\enquote*{old style}) figures. The following lines are taken from \path{mjnr8a.afm} and \path{mjnr8x.afm} respectively:

\begin{lstlisting}[style=afm,belowskip=0pt]{}
C 48 ; WX 469 ; N #zero# ; B  37 -12 432 627 ;
C 49 ; WX 469 ; N #one#  ; B 109  -5 356 625 ;
C 50 ; WX 469 ; N #two#  ; B  44   0 397 627 ;
\end{lstlisting}

\begin{lstlisting}[style=afm]{}
C 48 ; WX 469 ; N #zerooldstyle# ; B 39  0 431 387 ;
C 49 ; WX 271 ; N #oneoldstyle#  ; B 44 -5 229 405 ;
C 50 ; WX 396 ; N #twooldstyle#  ; B 37  0 356 415 ;
\end{lstlisting}

\noindent In practice, this means that adding expert fonts to the basic font set amounts to little more than adding them to the input file list of |\installfont| in most cases. Still, some additional steps are required. Fortunately, all we need to do in order to make optical small caps and hanging figures readily available is using dedicated encoding vectors provided by fontinst. These encoding vectors reference the glyphs by names corresponding to those found in expert fonts, thus allowing us to pick optical small caps and hanging figures at will. With that in mind, we can get down to business. Our fontinst file begins with a typical header:

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\input fontinst.sty
\needsfontinstversion{1.926}
\substitutesilent{bx}{b}
\setint{%#smallcapsscale#%}{%#720#%}%*							\label{expbase:drv:a}
\setint{slant}{167}
\recordtransforms{mjn-rec.tex}
\end{lstlisting}

\noindent Unfortunately, Monotype Janson provides small caps for the regular weight only. Hence we have to make do with mechanical small caps for the bold series. We set a scaling factor of 0.72 for that in line \ref{expbase:drv:a}.

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\transformfont{mjnr8r}{\reencodefont{8r}{\fromafm{mjnr8a}}}%*				\label{expbase:drv:b}
\transformfont{mjnri8r}{\reencodefont{8r}{\fromafm{mjnri8a}}}
\transformfont{mjnb8r}{\reencodefont{8r}{\fromafm{mjnb8a}}}
\transformfont{mjnbi8r}{\reencodefont{8r}{\fromafm{mjnbi8a}}}%*				\label{expbase:drv:c}
\transformfont{mjnro8r}{\slantfont{\int{slant}}\reencodefont{8r}{\fromafm{mjnr8a}}}%*	\label{expbase:drv:d}
\transformfont{mjnbo8r}{\slantfont{\int{slant}}\reencodefont{8r}{\fromafm{mjnb8a}}}%*	\label{expbase:drv:e}
\end{lstlisting}

\noindent We reencode (\ref{expbase:drv:b}--\ref{expbase:drv:c}) and slant (\ref{expbase:drv:d}--\ref{expbase:drv:e}) the basic fonts as usual. Expert fonts do not require any reencoding, but we need slanted versions of them as well: 

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\transformfont{mjnro8x}{\slantfont{\int{slant}}{\fromafm{mjnr8x}}}
\transformfont{mjnbo8x}{\slantfont{\int{slant}}{\fromafm{mjnb8x}}}
\end{lstlisting}

\noindent We will create two font families: |mjnx|, featuring expert glyphs, optical small caps, and lining figures, plus |mjnj| incorporating hanging instead of lining figures. \tsoneenc encoded virtual fonts will be generated for the |mjnx| family only.

\begin{lstlisting}[style=fontinst,emph={mjnr8x,mjnx,t1}]{drv-mjnx}
\installfonts
\installfamily{T1}{mjnx}{}
\installfont{mjnr%#9e#%}{mjnr8r,mjnr8x,newlatin}{t1}{T1}{mjnx}{m}{n}{}
\end{lstlisting}

\noindent As mentioned above, incorporating expert glyphs boils down to adding an additional file to the arguments of the |\installfont| command, in this case the file \path{mjnr8x.afm}. Note that we use the encoding suffix |9e| instead of |8t| for all \toneenc encoded virtual fonts of the |mjnx| family to indicate that they feature expert glyphs. While the code |8t|, as defined by the Fontname scheme, is for \toneenc (Cork) encoding, |9e| indicates \toneenc plus expert glyphs. Please refer to section 2.4 of the Fontname scheme for a comprehensive list of these codes and the code tables on page \pageref{tables} of this guide for additional hints.

\begin{lstlisting}[style=fontinst,emph={mjnr8x,t1c}]{drv-mjnx}
\installfont{mjnrc9e}{mjnr8r,mjnr8x,newlatin}{t1c}{T1}{mjnx}{m}{sc}{}
\end{lstlisting}

\noindent For the small caps font we use the encoding vector \path{t1c.etx} which will map the small caps in \path{mjnr8x.afm} to the encoding slots of the lowercase alphabet in our \toneenc encoded virtual font. The remaining virtual fonts of the |mjnx| family are built as expected:

\begin{lstlisting}[style=fontinst,emph={t1c}]{drv-mjnx}
\installfont{mjnri9e}{mjnri8r,mjnri8x,newlatin}{t1}{T1}{mjnx}{m}{it}{}
\installfont{mjnro9e}{mjnro8r,mjnro8x,newlatin}{t1}{T1}{mjnx}{m}{sl}{}
\installfont{mjnb9e}{mjnb8r,mjnb8x,newlatin}{t1}{T1}{mjnx}{b}{n}{}
\installfont{mjnbc9e}{mjnb8r,mjnb8x,newlatin}{t1c}{T1}{mjnx}{b}{sc}{}
\end{lstlisting}

\noindent Since the bold expert font does not include small caps, we have to create mechanical ones. The \path{t1c.etx} encoding vector will deal with that transparently if it does not find optical small caps in any of the raw fonts, using the value of |smallcapsscale| as the scaling factor.

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\installfont{mjnbi9e}{mjnbi8r,mjnbi8x,newlatin}{t1}{T1}{mjnx}{b}{it}{}
\installfont{mjnbo9e}{mjnbo8r,mjnbo8x,newlatin}{t1}{T1}{mjnx}{b}{sl}{}
\endinstallfonts
\end{lstlisting}

\noindent That's it for \toneenc encoding. Creating \tsoneenc encoded virtual fonts featuring expert glyphs is pretty straightforward. In order to take advantage of the additional glyphs provided by expert fonts, we simply add them to the input file list:

\begin{lstlisting}[style=fontinst,emph={mjnr8x,mjnx,ts1}]{drv-mjnx}
\installfonts
\installfamily{TS1}{mjnx}{}
\installfont{mjnr%#9c#%}{mjnr8r,mjnr8x,textcomp}{ts1}{TS1}{mjnx}{m}{n}{}
\end{lstlisting}

\noindent Note the encoding suffix of the virtual fonts. We use |9c| instead of |8c| to indicate that the virtual fonts feature expert glyphs.

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\installfontas{mjnr9c}{TS1}{mjnx}{m}{sc}{}
\installfont{mjnri9c}{mjnri8r,mjnri8x,textcomp}{ts1}{TS1}{mjnx}{m}{it}{}
\installfont{mjnro9c}{mjnro8r,mjnro8x,textcomp}{ts1}{TS1}{mjnx}{m}{sl}{}
\installfont{mjnb9c}{mjnb8r,mjnb8x,textcomp}{ts1}{TS1}{mjnx}{b}{n}{}
\installfontas{mjnb9c}{TS1}{mjnx}{b}{sc}{}
\installfont{mjnbi9c}{mjnbi8r,mjnbi8x,textcomp}{ts1}{TS1}{mjnx}{b}{it}{}
\installfont{mjnbo9c}{mjnbo8r,mjnbo8x,textcomp}{ts1}{TS1}{mjnx}{b}{sl}{}
\endinstallfonts
\end{lstlisting}

\noindent The |mjnx| family including \toneenc and \tsoneenc encoded fonts is now complete. We continue with the |mjnj| family which we want to feature hanging figures by default:

\begin{lstlisting}[style=fontinst,emph={t1j,mjnj}]{drv-mjnx}
\installfonts
\installfamily{T1}{mjnj}{}
\installfont{mjnr%#9d#%}{mjnr8r,mjnr8x,newlatin}{t1j}{T1}{mjnj}{m}{n}{}
\end{lstlisting}

\noindent The encoding code |9d| indicates a \toneenc encoded font with expert glyphs and hanging figures. We will use this code for all \toneenc encoded virtual fonts of the |mjnj| family. This family is supposed to feature hanging figures in the standard encoding slots for figures. We have to keep in mind that the regular encoding vector for \toneenc encoding (\path{t1.etx}) references the figures as \enquote*{zero} and \enquote*{one} while the hanging (\enquote*{old style}) figures in the expert font (which we want to be available by default) are labeled \enquote*{zerooldstyle} and \enquote*{oneoldstyle}. In order to arrange the glyphs according to our wishes, we use the special encoding vector \path{t1j.etx}. This file is essentially equivalent to \path{t1.etx}, but it will automatically append the suffix \enquote*{oldstyle} to the names of figures referenced by the encoding vector.

\begin{lstlisting}[style=fontinst,emph={t1cj}]{drv-mjnx}
\installfont{mjnrc9d}{mjnr8r,mjnr8x,newlatin}{t1cj}{T1}{mjnj}{m}{sc}{}
\end{lstlisting}

\noindent For the small caps shape, we use the encoding file \path{t1cj.etx} instead of \path{t1c.etx} to make hanging figures the default. The other virtual fonts are built like the upright shape:

\begin{lstlisting}[style=fontinst,emph={t1cj}]{drv-mjnx}
\installfont{mjnri9d}{mjnri8r,mjnri8x,newlatin}{t1j}{T1}{mjnj}{m}{it}{}
\installfont{mjnro9d}{mjnro8r,mjnro8x,newlatin}{t1j}{T1}{mjnj}{m}{sl}{}
\installfont{mjnb9d}{mjnb8r,mjnb8x,newlatin}{t1j}{T1}{mjnj}{b}{n}{}
\installfont{mjnbc9d}{mjnb8r,mjnb8x,newlatin}{t1cj}{T1}{mjnj}{b}{sc}{}
\end{lstlisting}

\noindent The bold expert fonts do not include small caps but the encoding file \path{t1cj.etx} is capable of creating mechanical small caps transparently, hence we use it for the bold small caps font as well.

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\installfont{mjnbi9d}{mjnbi8r,mjnbi8x,newlatin}{t1j}{T1}{mjnj}{b}{it}{}
\installfont{mjnbo9d}{mjnbo8r,mjnbo8x,newlatin}{t1j}{T1}{mjnj}{b}{sl}{}
\endinstallfonts
\end{lstlisting}

\noindent Finally, we use |\installfontas| to \enquote*{install} the \tsoneenc encoded virtual fonts of the |mjnx| family as |TS1/mjnj|. This will merely add some lines to the font definition file without creating any additional virtual fonts:

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\installfonts
\installfamily{TS1}{mjnj}{}
\installfontas{mjnr9c}{TS1}{mjnj}{m}{n}{}
\installfontas{mjnr9c}{TS1}{mjnj}{m}{sc}{}
\installfontas{mjnri9c}{TS1}{mjnj}{m}{it}{}
\installfontas{mjnro9c}{TS1}{mjnj}{m}{sl}{}
\installfontas{mjnb9c}{TS1}{mjnj}{b}{n}{}
\installfontas{mjnb9c}{TS1}{mjnj}{b}{sc}{}
\installfontas{mjnbi9c}{TS1}{mjnj}{b}{it}{}
\installfontas{mjnbo9c}{TS1}{mjnj}{b}{sl}{}
\endinstallfonts
\end{lstlisting}

\noindent At this point, we have a comprehensive text setup featuring expert f-ligatures, optical small caps as well as a choice of readily available lining and hanging figures. However, there are some glyphs in expert fonts that we have not considered yet.

\section{Inferior and superior figures}
\label{expbase:figures}

Expert fonts usually provide superior and inferior figures which can be combined with a dedicated fraction slash called \enquote*{solidus} to typeset arbitrary text fractions like \textfrac{1}{2} or even \textfrac{31}{127}. Please note that these figures are not suitable for \tex's math mode but they can be useful in text mode even if there is no need to typeset text fractions. For example, in this guide the footnote marks in the body text are typeset using superior figures and inferior figures are used for the line numbers of the code listings. Like hanging figures, we want inferior and superior figures to be readily available. Therefore, we will create two additional font families, |mjn0| and |mjn1|, which put inferior and superior figures in the standard encoding slots for figures just like our |mjnj| family does for hanging figures. We have been using the encoding vector \path{t1j.etx} to make hanging figures the default in this tutorial so let us find out what \path{t1j.etx} does in detail and try to modify this approach according to our needs. The regular \toneenc encoding vector \path{t1.etx} defines the encoding slots for all figures as follows:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\setslot{\digit{%#one#%}}\endsetslot
\setslot{\digit{%#two#%}}\endsetslot
\setslot{\digit{%#three#%}}\endsetslot
\end{lstlisting}

\noindent The glyph names of figures are not given verbatim, they are used as an argument to the |\digit| macro. This is the default definition of said macro as given in \path{t1.etx}:

\begin{lstlisting}[style=fontinst,numbers=none,emph={digit}]{}
\setcommand\digit#1{%##1#%}
\end{lstlisting}

\noindent This means that the glyph labeled \enquote*{one} in the \path{afm} file will end up in the encoding slot for the numeral one in the virtual font~-- and so on. \path{t1j.etx} defines the |\digit| macro as follows:

\begin{lstlisting}[style=fontinst,numbers=none,emph={digit}]{}
\setcommand\digit#1{%##1oldstyle#%}
\end{lstlisting}

\noindent In this case the glyph labeled \enquote*{oneoldstyle} in the \path{afm} file will end up in the encoding slot for the numeral one in the \toneenc encoded virtual font. When comparing the glyph names of hanging, inferior, and superior figures in the \path{afm} files of our expert fonts now, the approach we need to take in order to access them should be obvious:

\begin{lstlisting}[style=afm,belowskip=0pt]{}
C  48 ; WX 469 ; N #zerooldstyle# ; B 39  0 431 387 ;
C  49 ; WX 271 ; N #oneoldstyle#  ; B 44 -5 229 405 ;
C  50 ; WX 396 ; N #twooldstyle#  ; B 37  0 356 415 ;
\end{lstlisting}

\begin{lstlisting}[style=afm,belowskip=0pt]{}
C 210 ; WX 323 ; N #zeroinferior# ; B 27 -13 296 355 ;
C 211 ; WX 323 ; N #oneinferior#  ; B 84  -5 240 357 ;
C 212 ; WX 323 ; N #twoinferior#  ; B 27   0 288 358 ;
\end{lstlisting}

\begin{lstlisting}[style=afm]{}
C 200 ; WX 323 ; N #zerosuperior# ; B 27 293 296 661 ;
C 201 ; WX 323 ; N #onesuperior#  ; B 84 298 240 661 ;
C 202 ; WX 323 ; N #twosuperior#  ; B 27 303 288 661 ;
\end{lstlisting}

\noindent Just like \enquote*{old style} figures, inferior and superior figures use suffixes to the respective glyph names in (properly encoded) expert fonts. This means that we can simply load an additional encoding file before loading \path{t1.etx} and predefine the |\digit| macro accordingly. For inferior figures, we create the file \path{inferior.etx}:

\begin{lstlisting}[style=fontinst,numbers=none,emph={digit}]{}
\relax
\encoding
\setcommand\digit#1{%##1inferior#%}
\endencoding
\endinput
\end{lstlisting}

\noindent All we need to do is use |\setcommand| to predefine the |\digit| macro like this:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\setcommand\digit#1{#1%#inferior#%}
\end{lstlisting}

\noindent This will add the suffix \enquote*{inferior} to all digits. Since fontinst's |\setcommand| macro works like \latex's |\providecommand|, the encoding file \path{t1.etx} will not overwrite our definition if we load it after \path{inferior.etx}. The approach is similar for superior figures. We create another encoding file called \path{superior.etx}:

\begin{lstlisting}[style=fontinst,numbers=none,emph={digit}]{}
\relax
\encoding
\setcommand\digit#1{%##1superior#%}
\endencoding
\endinput
\end{lstlisting}

\noindent With \path{inferior.etx} and \path{superior.etx} at hand, we can now easily create the font families |mjn0| and |mjn1|. Let us put the new encoding vectors in our working directory and go back to the fontinst file: 

\begin{lstlisting}[style=fontinst,emph={inferior,mjn0}]{drv-mjnx}
\installfonts
\installfamily{T1}{mjn0}{}
\installfont{mjnr%#0#%9e}{mjnr8r,mjnr8x,newlatin}{inferior,t1}{T1}{mjn0}{m}{n}{}
\end{lstlisting}

\noindent We add the Fontname code |0| to the names of the virtual fonts in order to indicate inferior figures, load our newly created encoding file \path{inferior.etx} before \path{t1.etx}, and adapt the \nfss font declarations accordingly. Other than that, the virtual fonts of the |mjn0| family are generated in the usual way:

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\installfontas{mjnr09e}{T1}{mjn0}{m}{sc}{}
\installfont{mjnri09e}{mjnri8r,mjnri8x,newlatin}{inferior,t1}{T1}{mjn0}{m}{it}{}
\installfont{mjnro09e}{mjnro8r,mjnro8x,newlatin}{inferior,t1}{T1}{mjn0}{m}{sl}{}
\installfont{mjnb09e}{mjnb8r,mjnb8x,newlatin}{inferior,t1}{T1}{mjn0}{b}{n}{}
\installfontas{mjnb09e}{T1}{mjn0}{b}{sc}{}
\installfont{mjnbi09e}{mjnbi8r,mjnbi8x,newlatin}{inferior,t1}{T1}{mjn0}{b}{it}{}
\installfont{mjnbo09e}{mjnbo8r,mjnbo8x,newlatin}{inferior,t1}{T1}{mjn0}{b}{sl}{}
\endinstallfonts
\end{lstlisting}

\noindent Any \tsoneenc encoded virtual fonts of the |mjn0| family would not differ from those of |mjnx|, so we create a font definition file which points \latex to the \tsoneenc encoded virtual fonts we created for the |mjnx| family before:

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\installfonts
\installfamily{TS1}{mjn0}{}
\installfontas{mjnr9c}{TS1}{mjn0}{m}{n}{}
\installfontas{mjnr9c}{TS1}{mjn0}{m}{sc}{}
\installfontas{mjnri9c}{TS1}{mjn0}{m}{it}{}
\installfontas{mjnro9c}{TS1}{mjn0}{m}{sl}{}
\installfontas{mjnb9c}{TS1}{mjn0}{b}{n}{}
\installfontas{mjnb9c}{TS1}{mjn0}{b}{sc}{}
\installfontas{mjnbi9c}{TS1}{mjn0}{b}{it}{}
\installfontas{mjnbo9c}{TS1}{mjn0}{b}{sl}{}
\endinstallfonts
\end{lstlisting}

\noindent For the |mjn1| family, we adapt the names of the virtual fonts (adding the Fontname code 1 to indicate superior figures), the encoding files (\path{superior.etx} and \path{t1.etx}), and the \nfss declarations:

\begin{lstlisting}[style=fontinst,emph={superior,mjn1}]{drv-mjnx}
\installfonts
\installfamily{T1}{mjn1}{}
\installfont{mjnr%#1#%9e}{mjnr8r,mjnr8x,newlatin}{superior,t1}{T1}{mjn1}{m}{n}{}
\end{lstlisting}

\noindent We create the remaining virtual fonts in a similar way:

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\installfontas{mjnr19e}{T1}{mjn1}{m}{sc}{}
\installfont{mjnri19e}{mjnri8r,mjnri8x,newlatin}{superior,t1}{T1}{mjn1}{m}{it}{}
\installfont{mjnro19e}{mjnro8r,mjnro8x,newlatin}{superior,t1}{T1}{mjn1}{m}{sl}{}
\installfont{mjnb19e}{mjnb8r,mjnb8x,newlatin}{superior,t1}{T1}{mjn1}{b}{n}{}
\installfontas{mjnb19e}{T1}{mjn1}{b}{sc}{}
\installfont{mjnbi19e}{mjnbi8r,mjnbi8x,newlatin}{superior,t1}{T1}{mjn1}{b}{it}{}
\installfont{mjnbo19e}{mjnbo8r,mjnbo8x,newlatin}{superior,t1}{T1}{mjn1}{b}{sl}{}
\endinstallfonts
\end{lstlisting}

\noindent Finally, we create a font definition file for |TS1/mjn1| and terminate our fontinst file:

\begin{lstlisting}[style=fontinst]{drv-mjnx}
\installfonts
\installfamily{TS1}{mjn1}{}
\installfontas{mjnr9c}{TS1}{mjn1}{m}{n}{}
\installfontas{mjnr9c}{TS1}{mjn1}{m}{sc}{}
\installfontas{mjnri9c}{TS1}{mjn1}{m}{it}{}
\installfontas{mjnro9c}{TS1}{mjn1}{m}{sl}{}
\installfontas{mjnb9c}{TS1}{mjn1}{b}{n}{}
\installfontas{mjnb9c}{TS1}{mjn1}{b}{sc}{}
\installfontas{mjnbi9c}{TS1}{mjn1}{b}{it}{}
\installfontas{mjnbo9c}{TS1}{mjn1}{b}{sl}{}
\endinstallfonts
\endrecordtransforms
\bye
\end{lstlisting}

\noindent Our setup is now complete as far as \latex is concerned. We still need to create another fontinst file that will read the data recorded in \path{mjn-rec.tex} and convert it to a map file suitable for dvips. The format of this driver file is discussed in section \ref{basics:mapfile} of this guide.

\section{An extended style file}
\label{expbase:styfile}

\noindent Our style file for Janson, \path{janson.sty}, is based on the one suggested in section \ref{scosf:styfile}. We simply adjust the package name and the names of the font families:

\begin{lstlisting}[style=latex,emph={janson,mjnx,mjnj}]{}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{janson}[2002/12/30 v1.0 Monotype Janson]
\RequirePackage[T1]{fontenc}
\RequirePackage{textcomp}
\RequirePackage{nfssext}
\DeclareOption{lining}{\renewcommand*{\rmdefault}{mjnx}}
\DeclareOption{oldstyle}{\renewcommand*{\rmdefault}{mjnj}}
\ExecuteOptions{oldstyle}
\ProcessOptions*
\endinput
\end{lstlisting}

\noindent With an expert font set at hand, however, we have to extend \path{nfssext.sty} to support expert families:

\begin{lstlisting}[style=latex,firstnumber=1]{nfssext2}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{nfssext}[2003/03/14 v1.2 Experimental NFSS Extensions]
\newcommand*{\exfs@tempa}{}
\newcommand*{\exfs@tempb}{}
\newcommand*{\exfs@try@family}[2][]{%
  \let\exfs@tempa\relax
  \begingroup
    \fontfamily{#2}\try@load@fontshape%*			\label{expbase:nfex:a}
    \expandafter\ifx\csname\curr@fontshape\endcsname\relax
      \edef\exfs@tempa{#1}%
      \ifx\exfs@tempa\@empty
	\PackageWarning{nfssext}{%%*				\label{expbase:nfex:b}
	  Font family '\f@encoding/#2' not available\MessageBreak
	  Ignoring font switch}%%*				\label{expbase:nfex:c}
      \else
	\PackageInfo{nfssext}{%%*				\label{expbase:nfex:d}
	  Font family '\f@encoding/#2' not available\MessageBreak
	  Font family '\f@encoding/#1' tried instead}%%*	\label{expbase:nfex:e}
        \exfs@try@family{#1}%%*					\label{expbase:nfex:f}
      \fi
    \else
      \gdef\exfs@tempa{\fontfamily{#2}\selectfont}%
    \fi
  \endgroup
  \exfs@tempa}
\end{lstlisting}

\noindent As soon as expert fonts come into play, the |\lnstyle| macro has to cater for two font families which, depending on the font, may contain lining figures: a basic font family with a three-character code or an expert family with a four-character code ending with the letter |x|. To make sure that |nfssext.sty| will work for fonts like Janson as well as fonts without an expert set, the first thing we need to do is extend our main font switching macro, enabling it to cope with both cases. To do so, we will introduce an optional argument. Essentially, we try to load the font family given by the mandatory argument first (\ref{expbase:nfex:a}). If this family is not available, we do not quit with a warning but add a note to the log file (\ref{expbase:nfex:d}--\ref{expbase:nfex:e}) and try the family given by the optional argument next (\ref{expbase:nfex:f}). If loading the alternative family fails as well, we finally print a warning message (\ref{expbase:nfex:b}--\ref{expbase:nfex:c}). If the optional argument is not used, the second step will be omitted.

\begin{lstlisting}[style=latex]{nfssext2}
\def\exfs@get@base#1#2#3#4\@nil{#1#2#3}
\DeclareRobustCommand{\%#lnstyle#%}{%
  \not@math@alphabet\lnstyle\relax
  \exfs@try@family[\expandafter\exfs@get@base\f@family\@nil]%%*		\label{expbase:nfex:g}
                  {\expandafter\exfs@get@base\f@family\@nil %#x#%}}%*	\label{expbase:nfex:h}
\end{lstlisting}

\noindent After that, the |\lnstyle| macro needs to be adjusted in order to exploit the optional argument. It will try the expert family with a four-character code first (\ref{expbase:nfex:h}) and make |\exfs@try@family| fall back to the basic font family with a three-character code (\ref{expbase:nfex:g}) if the former is not available.

\begin{lstlisting}[style=latex]{nfssext2}
\DeclareRobustCommand{\%#osstyle#%}{%
  \not@math@alphabet\osstyle\relax
  \exfs@try@family{\expandafter\exfs@get@base\f@family\@nil %#j#%}}
\end{lstlisting}

\noindent The availability of hanging figures is expressed by appending the letter |j| to the font family code for both basic and expert font sets, so |\osstyle| does not need any modification.

\begin{lstlisting}[style=latex]{nfssext2}
\DeclareRobustCommand{\%#instyle#%}{%
  \not@math@alphabet\instyle\relax
  \exfs@try@family{\expandafter\exfs@get@base\f@family\@nil %#0#%}}
\DeclareRobustCommand{\%#sustyle#%}{%
  \not@math@alphabet\sustyle\relax
  \exfs@try@family{\expandafter\exfs@get@base\f@family\@nil %#1#%}}
\end{lstlisting}

\noindent With inferior and superior figures implemented as two additional font families, |mjn0| and |mjn1|, we add two macros activating these families by adding |0| and |1| to the family name respectively.

\begin{lstlisting}[style=latex,emph={textin,textsu,instyle,sustyle}]{nfssext2}
\DeclareTextFontCommand{\textln}{\lnstyle}
\DeclareTextFontCommand{\textos}{\osstyle}
\DeclareTextFontCommand{\textin}{\instyle}
\DeclareTextFontCommand{\textsu}{\sustyle}
\endinput
\end{lstlisting}

\noindent We also add two text commands, |\textin| and |\textsu|, which activate these figures locally, similar to |\textit| or |\textbf|.

\section{Using the features of expert fonts}
\label{expbase:usage}

Most features of expert font sets such as additional f-ligatures and optical small caps will be available automatically when selecting the new font families. Using them does not require any additional macros. Lining and hanging figures can be conveniently selected by activating the respective font family, in this case |mjnx| and |mjnj|, or by using the style file \path{janson.sty} suggested above. Since inferior and superior figures are not used as regular figures, they are treated differently. We will take a look at some possible applications. The inferior and superior figures found in expert fonts were originally intended for typesetting text fractions so let us write a simple macro for that. To typeset a fraction, we combine inferior and superior figures with the |\textfractionsolidus| macro provided by the \sty{textcomp} package. Accessing the figures implies switching font families locally. Note the additional set of braces which will keep the font change local:

\begin{lstlisting}[style=latex,numbers=none,emph={mjn1,mjn0,textfractionsolidus}]{}
\newcommand*{\textfrac}[2]{%
  %#{#%\fontfamily{mjn1}\selectfont #1%#}#%%
  \textfractionsolidus
  %#{#%\fontfamily{mjn0}\selectfont #2%#}#%}
\end{lstlisting}

\noindent Writing |\textfrac{1}{2}| in the input file will typeset the fraction \textfrac{1}{2}. When looking at regular and expert fonts in a font editor, you will see that they contain a fixed number of text fractions. Some of them are included in \tsoneenc encoding and supported by the \sty{textcomp} package (see appendix \ref{textcomp}), but typing rather long commands such as |\textthreequarters| is not exactly convenient. Since there are only nine of them they are not very useful anyway. With a complete set of inferior and superior figures at our disposal, our macro will work for arbitrary fractions like \textfrac{3}{7} or \textfrac{13}{17}. Instead of using \enquote*{hard-wired} fonts as shown above, it is even better to use the font switching macros provided by \path{nfssext.sty} instead since they will dynamically adjust to the active text font:

\begin{lstlisting}[style=latex,numbers=none,emph={textsu,textin}]{}
\newcommand*{\textfrac}[2]{%
  \textsu{#1}%
  \textfractionsolidus
  \textin{#2}}
\end{lstlisting}

\noindent What about using superior figures as footnote numbers? To do so, we need to redefine |\@makefnmark|. This is \latex's default definition:

\begin{lstlisting}[style=latex,numbers=none,emph={@textsuperscript}]{}
\def\@makefnmark{\hbox{\@textsuperscript{\normalfont\@thefnmark}}}
\end{lstlisting}

\noindent In order to use optical superior figures instead of mechanical ones, we drop |\@textsuperscript| and switch font families instead:

\begin{lstlisting}[style=latex,numbers=none,emph={fontfamily,selectfont,mjn1}]{}
\def\@makefnmark{\hbox{\fontfamily{mjn1}\selectfont\@thefnmark}}
\end{lstlisting}

\noindent We do not need to add additional braces in this case since |\hbox| will keep the font change local. Using our new font switching macros, this may also be accomplished like this:

\begin{lstlisting}[style=latex,numbers=none,emph={sustyle}]{}
\def\@makefnmark{\hbox{\sustyle\@thefnmark}}
\end{lstlisting}

\noindent Keep in mind that, if you want to put a definition of |\@makefnmark| in the preamble of a regular \latex input file (as opposed to a class or a style file), it has to be enclosed in |\makeatletter| and |\makeatother|:

\begin{lstlisting}[style=latex,numbers=none,emph={makeatletter,makeatother}]{}
\makeatletter
\def\@makefnmark{\hbox{\sustyle\@thefnmark}}
\makeatother
\end{lstlisting}

\chapter{Expert font sets, extended setup}
\label{exppro}

In this tutorial we will combine what we have learned in tutorials \ref{scosf} and \ref{expbase} to install a very complete font set featuring expert fonts, small caps, and hanging figures. This tutorial will also add multiple weights, italic small caps, italic swashes and text ornaments to that. Our example is Adobe Minion, base plus expert packages:

\begin{lstlisting}[style=map]{}
pmnr8a    Minion-Regular                    A    143    morg____
pmnrc8a   Minion-RegularSC                  A    144    mosc____
pmnri8a   Minion-Italic                     A    143    moi_____
pmnric8a  Minion-ItalicSC                   A    144    moisc___
pmnriw7a  Minion-SwashItalic                A    144    moswi___
pmns8a    Minion-Semibold                   A    143    mosb____
pmnsc8a   Minion-SemiboldSC                 A    144    mosbs___
pmnsi8a   Minion-SemiboldItalic             A    143    mosbi___
pmnsic8a  Minion-SemiboldItalicSC           A    144    mosic___
pmnsiw7a  Minion-SwashSemiboldItalic        A    144    mossb___
pmnb8a    Minion-Bold                       A    143    mob_____
pmnbj8a   Minion-BoldOsF                    A    144    mobos___
pmnbi8a   Minion-BoldItalic                 A    143    mobi____
pmnbij8a  Minion-BoldItalicOsF              A    144    mobio___
pmnc8a    Minion-Black                      A    143    mobl____
pmncj8a   Minion-BlackOsF                   A    144    mozof___
pmnr8x    MinionExp-Regular                 A    144    mjrg____
pmnri8x   MinionExp-Italic                  A    144    mji_____
pmns8x    MinionExp-Semibold                A    144    mjsb____
pmnsi8x   MinionExp-SemiboldItalic          A    144    mjsbi___
pmnb8x    MinionExp-Bold                    A    144    mjb_____
pmnbi8x   MinionExp-BoldItalic              A    144    mjbi____
pmnc8x    MinionExp-Black                   A    144    mjbl____
pmnrp     Minion-Ornaments                  A    144    moor____
\end{lstlisting}

\noindent Note that the bold and black fonts do not feature optical small caps. There are expert fonts for these weights, but they do not contain any small caps glyphs. When looking at the list of available shapes in each weight class it should be obvious that the semibold fonts are the intended default bold weight of this typeface. The bold fonts are merely intended for applications requiring a stronger contrast, for example to highlight the keywords in a dictionary. We will omit the black fonts in this tutorial as they are only of limited use. If required, they are easily added to the fontinst file. In addition to these text fonts, the expert package includes a set of regular-weight display fonts intended for titling and display work at very large sizes. Generated from the same master sources by interpolation, the display fonts share the lettershapes of the text fonts while being based on a design size of 72\,pt. Since they form a complete set including small caps and expert fonts, they are handled just like the Minion text set and we will not explicitly consider them here.

\section{The fontinst file}
\label{exppro:fontinst}

With a very comprehensive set of fonts at our disposal, we will be fastidious. We will not create any computed glyph shapes (no mechanical small caps and no slanted fonts), making this setup suitable for professional typesetting. Without further ado, we start off as usual:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\nonstopmode
\input fontinst.sty
\needsfontinstversion{1.926}
\substitutesilent{%#bx#%}{%#sb#%}%*					\label{exppro:drv:a}
\recordtransforms{pmn-rec.tex}
\end{lstlisting}

\noindent We make semibold the default bold weight by substituting |sb| for |bx| in line \ref{exppro:drv:a}.
First of all, we reencode all base fonts which are based on Adobe Standard encoding. Even though the swash fonts are also based on Adobe Standard, they are handled like expert fonts because they contain a special set of glyphs, all of which are encoded by default:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\transformfont{pmnr8r}{\reencodefont{8r}{\fromafm{pmnr8a}}}
\transformfont{pmnrc8r}{\reencodefont{8r}{\fromafm{pmnrc8a}}}
\transformfont{pmnri8r}{\reencodefont{8r}{\fromafm{pmnri8a}}}
\transformfont{pmnric8r}{\reencodefont{8r}{\fromafm{pmnric8a}}}
\transformfont{pmns8r}{\reencodefont{8r}{\fromafm{pmns8a}}}
\transformfont{pmnsc8r}{\reencodefont{8r}{\fromafm{pmnsc8a}}}
\transformfont{pmnsi8r}{\reencodefont{8r}{\fromafm{pmnsi8a}}}
\transformfont{pmnsic8r}{\reencodefont{8r}{\fromafm{pmnsic8a}}}
\transformfont{pmnb8r}{\reencodefont{8r}{\fromafm{pmnb8a}}}
\transformfont{pmnbi8r}{\reencodefont{8r}{\fromafm{pmnbi8a}}}
\end{lstlisting}

\noindent In this tutorial we are dealing with a typeface featuring both \scosf and expert sets. When building virtual fonts, we could take small caps and hanging figures from either set of fonts. We will use the expert fonts anyway in order to take advantage of the extra f-ligatures exclusively found in expert fonts, so why not simply take the small caps from the same source as demonstrated in tutorial \ref{expbase}? Note that there is one problem with taking optical small caps from an expert font: there will be no kerning between the uppercase alphabet and the small caps replacing the lowercase letters because the glyphs are found in separate fonts. Without dedicated small caps fonts there is nothing we can do about that short of adding kerning pairs manually. Now that we have both expert and small caps fonts, however, we could take an approach similar to the one outlined in tutorial \ref{scosf}, adding the expert font on top of that to get the additional ligatures. We will use a different technique though, which extracts the more comprehensive kerning data from the small caps fonts while taking the glyphs from the base and the expert fonts only:

\begin{lstlisting}[style=fontinst,emph={reglyphfonts,endreglyphfonts}]{drv-pmnx}
\reglyphfonts
\input %#csckrn2x.tex#%
\%#reglyphfont#%{pmnrc%#8x#%}{pmnrc%#8r#%}%*				\label{exppro:drv:b}
\reglyphfont{pmnric8x}{pmnric8r}
\reglyphfont{pmnsc8x}{pmnsc8r}
\reglyphfont{pmnsic8x}{pmnsic8r}
\endreglyphfonts
\end{lstlisting}

\noindent To do so, we use fontinst's |reglyphfonts| environment and the |\reglyphfont| macro. This macro will essentially apply a batch job to the metric file given as the second argument and save the result to a new file specified by the first argument. The actual transformation commands are read from \path{csckrn2x.tex}, which is provided by fontinst. This file will discard all glyph metrics, keeping only the kerning data we need. It will also rename all glyphs so that they conform to the naming conventions of expert fonts (hence we use the encoding code |8x|, which indicates an expert font, when saving the transformed data). This way we ensure that we get unique glyph names. Apart from being conceptually cleaner, this approach has the additional benefit of not requiring the small caps fonts after the metrics and the virtual fonts have been generated, resulting in slightly smaller \pdf and \PS files if the fonts are embedded.

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfonts
\installfamily{T1}{pmnx}{}
\installfont{pmnr9e}{pmnr8r,pmnr8x,newlatin}{t1}{T1}{pmnx}{m}{n}{}
\installfont{pmnri9e}{pmnri8r,pmnri8x,newlatin}{t1}{T1}{pmnx}{m}{it}{}
\%#installfontas#%{%#pmnri9e#%}{T1}{pmnx}{m}{%#sl#%}{}
\end{lstlisting}

\noindent The setup of the upright and italic shapes does not differ from tutorial \ref{expbase} at all. We do not create slanted fonts but install the italic font as both italic and slanted shape.

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfont{pmnrc9e}{pmnr8r,pmnr8x,%#pmnrc8x#%,newlatin}{%#t1c#%}{T1}{pmnx}{m}{sc}{}
\end{lstlisting}

\noindent When creating the small caps font, we use the encoding file \path{t1c.etx} since the small caps in the expert font bear unique names suitable for this encoding vector. We also want to add the kerning data found in \path{pmnrc8a.afm} to our virtual font. This data was already extracted and saved to \path{pmnrc8x} in line \ref{exppro:drv:b}, so we simply add this file to the input file list. After that, we have a fully kerned small caps font.

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfont{pmnric9e}{pmnri8r,pmnri8x,%#pmnric8x#%,newlatin}{%#t1c#%}{T1}{pmnx}{m}{%#si#%}{}
\end{lstlisting}

\noindent Minion also features an italic small caps font which we install just like its upright counterpart, using |si| as the \nfss shape code.

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfont{pmns9e}{pmns8r,pmns8x,newlatin}{t1}{T1}{pmnx}{sb}{n}{}
\installfont{pmnsi9e}{pmnsi8r,pmnsi8x,newlatin}{t1}{T1}{pmnx}{sb}{it}{}
\installfontas{pmnsi9e}{T1}{pmnx}{sb}{sl}{}
\installfont{pmnsc9e}{pmns8r,pmns8x,pmnsc8x,newlatin}{t1c}{T1}{pmnx}{sb}{sc}{}
\installfont{pmnsic9e}{pmnsi8r,pmnsi8x,pmnsic8x,newlatin}{t1c}{T1}{pmnx}{sb}{si}{}
\end{lstlisting}

\noindent We repeat these steps for the semibold and the bold weight. The bold weight is slightly different because there are no optical small caps:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfont{pmnb9e}{pmnb8r,pmnb8x,newlatin}{t1}{T1}{pmnx}{b}{n}{}
\installfont{pmnbi9e}{pmnbi8r,pmnbi8x,newlatin}{t1}{T1}{pmnx}{b}{it}{}
\installfontas{pmnbi9e}{T1}{pmnx}{b}{sl}{}
\installfontas{pmnb9e}{T1}{pmnx}{b}{sc}{}
\installfontas{pmnbi9e}{T1}{pmnx}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent After finishing \toneenc encoding we continue with \tsoneenc. Our approach to \tsoneenc encoding does not differ substantially from tutorial \ref{expbase}:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfonts
\installfamily{TS1}{pmnx}{}
\installfont{pmnr9c}{pmnr8r,pmnr8x,textcomp}{ts1}{TS1}{pmnx}{m}{n}{}
\installfont{pmnri9c}{pmnri8r,pmnri8x,textcomp}{ts1}{TS1}{pmnx}{m}{it}{}
\installfontas{pmnri9c}{TS1}{pmnx}{m}{sl}{}
\installfontas{pmnr9c}{TS1}{pmnx}{m}{sc}{}
\installfontas{pmnri9c}{TS1}{pmnx}{m}{si}{}
\installfont{pmns9c}{pmns8r,pmns8x,textcomp}{ts1}{TS1}{pmnx}{sb}{n}{}
\installfont{pmnsi9c}{pmnsi8r,pmnsi8x,textcomp}{ts1}{TS1}{pmnx}{sb}{it}{}
\installfontas{pmnsi9c}{TS1}{pmnx}{sb}{sl}{}
\installfontas{pmns9c}{TS1}{pmnx}{sb}{sc}{}
\installfontas{pmnsi9c}{TS1}{pmnx}{sb}{si}{}
\installfont{pmnb9c}{pmnb8r,pmnb8x,textcomp}{ts1}{TS1}{pmnx}{b}{n}{}
\installfont{pmnbi9c}{pmnbi8r,pmnbi8x,textcomp}{ts1}{TS1}{pmnx}{b}{it}{}
\installfontas{pmnbi9c}{TS1}{pmnx}{b}{sl}{}
\installfontas{pmnb9c}{TS1}{pmnx}{b}{sc}{}
\installfontas{pmnbi9c}{TS1}{pmnx}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent The |pmnx| family is now complete. We continue with |pmnj| which will feature hanging figures by default:

\begin{lstlisting}[style=fontinst,emph={t1j}]{drv-pmnx}
\installfonts
\installfamily{T1}{pmnj}{}
\installfont{pmnr9d}{pmnr8r,pmnr8x,newlatin}{t1j}{T1}{pmnj}{m}{n}{}
\installfont{pmnri9d}{pmnri8r,pmnri8x,newlatin}{t1j}{T1}{pmnj}{m}{it}{}
\installfontas{pmnri9d}{T1}{pmnj}{m}{sl}{}
\end{lstlisting}

\noindent To make hanging figures the default throughout the |pmnj| family we employ the encoding file \path{t1j.etx}. Other than that, the setup of the upright and italic shapes does not differ from |pmnx|.

\begin{lstlisting}[style=fontinst,emph={t1cj}]{drv-pmnx}
\installfont{pmnrc9d}{pmnr8r,pmnr8x,pmnrc8x,newlatin}{t1cj}{T1}{pmnj}{m}{sc}{}
\installfont{pmnric9d}{pmnri8r,pmnri8x,pmnric8x,newlatin}{t1cj}{T1}{pmnj}{m}{si}{}
\end{lstlisting}

\noindent For the small caps shape of the |pmnj| family we essentially use the technique introduced above. Since this font family will feature hanging figures, however, we load the encoding file \path{t1cj.etx}.

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfont{pmns9d}{pmns8r,pmns8x,newlatin}{t1j}{T1}{pmnj}{sb}{n}{}
\installfont{pmnsi9d}{pmnsi8r,pmnsi8x,newlatin}{t1j}{T1}{pmnj}{sb}{it}{}
\installfontas{pmnsi9d}{T1}{pmnj}{sb}{sl}{}
\installfont{pmnsc9d}{pmns8r,pmns8x,pmnsc8x,newlatin}{t1cj}{T1}{pmnj}{sb}{sc}{}
\installfont{pmnsic9d}{pmnsi8r,pmnsi8x,pmnsic8x,newlatin}{t1cj}{T1}{pmnj}{sb}{si}{}
\end{lstlisting}

\noindent Again, we repeat these steps for the semibold weight. The bold fonts are handled like those of the |pmnx| family, only differing in the choice of the encoding file:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfont{pmnb9d}{pmnb8r,pmnb8x,newlatin}{t1j}{T1}{pmnj}{b}{n}{}
\installfont{pmnbi9d}{pmnbi8r,pmnbi8x,newlatin}{t1j}{T1}{pmnj}{b}{it}{}
\installfontas{pmnbi9d}{T1}{pmnj}{b}{sl}{}
\installfontas{pmnb9d}{T1}{pmnj}{b}{sc}{}
\installfontas{pmnbi9d}{T1}{pmnj}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent We employ fontinst's |\installfontas| macro to provide a complete font definition file for \tsoneenc encoding, using the \tsoneenc encoded fonts of the |pmnx| family:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfonts
\installfamily{TS1}{pmnj}{}
\installfontas{pmnr9c}{TS1}{pmnj}{m}{n}{}
\installfontas{pmnr9c}{TS1}{pmnj}{m}{sc}{}
\installfontas{pmnri9c}{TS1}{pmnj}{m}{it}{}
\installfontas{pmnri9c}{TS1}{pmnj}{m}{sl}{}
\installfontas{pmnri9c}{TS1}{pmnj}{m}{si}{}
\installfontas{pmns9c}{TS1}{pmnj}{sb}{n}{}
\installfontas{pmns9c}{TS1}{pmnj}{sb}{sc}{}
\installfontas{pmnsi9c}{TS1}{pmnj}{sb}{it}{}
\installfontas{pmnsi9c}{TS1}{pmnj}{sb}{sl}{}
\installfontas{pmnsi9c}{TS1}{pmnj}{sb}{si}{}
\installfontas{pmnb9c}{TS1}{pmnj}{b}{n}{}
\installfontas{pmnb9c}{TS1}{pmnj}{b}{sc}{}
\installfontas{pmnbi9c}{TS1}{pmnj}{b}{it}{}
\installfontas{pmnbi9c}{TS1}{pmnj}{b}{sl}{}
\installfontas{pmnbi9c}{TS1}{pmnj}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent In addition to |pmnx| and |pmnj|, we add dedicated font families incorporating inferior and superior figures:

\begin{lstlisting}[style=fontinst,emph={inferior,t1}]{drv-pmnx}
\installfonts
\installfamily{T1}{pmn0}{}
\installfont{pmnr09e}{pmnr8r,pmnr8x,newlatin}{inferior,t1}{T1}{pmn0}{m}{n}{}
\installfont{pmnri09e}{pmnri8r,pmnri8x,newlatin}{inferior,t1}{T1}{pmn0}{m}{it}{}
\installfontas{pmnr09e}{T1}{pmn0}{m}{sc}{}
\installfontas{pmnri09e}{T1}{pmn0}{m}{sl}{}
\installfontas{pmnri09e}{T1}{pmn0}{m}{si}{}
\installfont{pmns09e}{pmns8r,pmns8x,newlatin}{inferior,t1}{T1}{pmn0}{sb}{n}{}
\installfont{pmnsi09e}{pmnsi8r,pmnsi8x,newlatin}{inferior,t1}{T1}{pmn0}{sb}{it}{}
\installfontas{pmns09e}{T1}{pmn0}{sb}{sc}{}
\installfontas{pmnsi09e}{T1}{pmn0}{sb}{sl}{}
\installfontas{pmnsi09e}{T1}{pmn0}{sb}{si}{}
\installfont{pmnb09e}{pmnb8r,pmnb8x,newlatin}{inferior,t1}{T1}{pmn0}{b}{n}{}
\installfont{pmnbi09e}{pmnbi8r,pmnbi8x,newlatin}{inferior,t1}{T1}{pmn0}{b}{it}{}
\installfontas{pmnb09e}{T1}{pmn0}{b}{sc}{}
\installfontas{pmnbi09e}{T1}{pmn0}{b}{sl}{}
\installfontas{pmnbi09e}{T1}{pmn0}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent Since inferior figures are found in the expert fonts, our approach here does not differ from the one introduced in section \ref{expbase:figures}. We also provide a font definition file for \tsoneenc encoding:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfonts
\installfamily{TS1}{pmn0}{}
\installfontas{pmnr9c}{TS1}{pmn0}{m}{n}{}
\installfontas{pmnr9c}{TS1}{pmn0}{m}{sc}{}
\installfontas{pmnri9c}{TS1}{pmn0}{m}{it}{}
\installfontas{pmnri9c}{TS1}{pmn0}{m}{sl}{}
\installfontas{pmnri9c}{TS1}{pmn0}{m}{si}{}
\installfontas{pmns9c}{TS1}{pmn0}{sb}{n}{}
\installfontas{pmns9c}{TS1}{pmn0}{sb}{sc}{}
\installfontas{pmnsi9c}{TS1}{pmn0}{sb}{it}{}
\installfontas{pmnsi9c}{TS1}{pmn0}{sb}{sl}{}
\installfontas{pmnsi9c}{TS1}{pmn0}{sb}{si}{}
\installfontas{pmnb9c}{TS1}{pmn0}{b}{n}{}
\installfontas{pmnb9c}{TS1}{pmn0}{b}{sc}{}
\installfontas{pmnbi9c}{TS1}{pmn0}{b}{it}{}
\installfontas{pmnbi9c}{TS1}{pmn0}{b}{sl}{}
\installfontas{pmnbi9c}{TS1}{pmn0}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent The same holds true for superior figures:

\begin{lstlisting}[style=fontinst,emph={superior,t1}]{drv-pmnx}
\installfonts
\installfamily{T1}{pmn1}{}
\installfont{pmnr19e}{pmnr8r,pmnr8x,newlatin}{superior,t1}{T1}{pmn1}{m}{n}{}
\installfont{pmnri19e}{pmnri8r,pmnri8x,newlatin}{superior,t1}{T1}{pmn1}{m}{it}{}
\installfontas{pmnr19e}{T1}{pmn1}{m}{sc}{}
\installfontas{pmnri19e}{T1}{pmn1}{m}{sl}{}
\installfontas{pmnri19e}{T1}{pmn1}{m}{si}{}
\installfont{pmns19e}{pmns8r,pmns8x,newlatin}{superior,t1}{T1}{pmn1}{sb}{n}{}
\installfont{pmnsi19e}{pmnsi8r,pmnsi8x,newlatin}{superior,t1}{T1}{pmn1}{sb}{it}{}
\installfontas{pmns19e}{T1}{pmn1}{sb}{sc}{}
\installfontas{pmnsi19e}{T1}{pmn1}{sb}{sl}{}
\installfontas{pmnsi19e}{T1}{pmn1}{sb}{si}{}
\installfont{pmnb19e}{pmnb8r,pmnb8x,newlatin}{superior,t1}{T1}{pmn1}{b}{n}{}
\installfont{pmnbi19e}{pmnbi8r,pmnbi8x,newlatin}{superior,t1}{T1}{pmn1}{b}{it}{}
\installfontas{pmnb19e}{T1}{pmn1}{b}{sc}{}
\installfontas{pmnbi19e}{T1}{pmn1}{b}{sl}{}
\installfontas{pmnbi19e}{T1}{pmn1}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent And \tsoneenc encoding:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfonts
\installfamily{TS1}{pmn1}{}
\installfontas{pmnr9c}{TS1}{pmn1}{m}{n}{}
\installfontas{pmnr9c}{TS1}{pmn1}{m}{sc}{}
\installfontas{pmnri9c}{TS1}{pmn1}{m}{it}{}
\installfontas{pmnri9c}{TS1}{pmn1}{m}{sl}{}
\installfontas{pmnri9c}{TS1}{pmn1}{m}{si}{}
\installfontas{pmns9c}{TS1}{pmn1}{sb}{n}{}
\installfontas{pmns9c}{TS1}{pmn1}{sb}{sc}{}
\installfontas{pmnsi9c}{TS1}{pmn1}{sb}{it}{}
\installfontas{pmnsi9c}{TS1}{pmn1}{sb}{sl}{}
\installfontas{pmnsi9c}{TS1}{pmn1}{sb}{si}{}
\installfontas{pmnb9c}{TS1}{pmn1}{b}{n}{}
\installfontas{pmnb9c}{TS1}{pmn1}{b}{sc}{}
\installfontas{pmnbi9c}{TS1}{pmn1}{b}{it}{}
\installfontas{pmnbi9c}{TS1}{pmn1}{b}{sl}{}
\installfontas{pmnbi9c}{TS1}{pmn1}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent In order to incorporate the italic swashes we will create an additional font family called |pmnw|. 

\begin{lstlisting}[style=fontinst,emph={unsetcaps,t1j}]{drv-pmnx}
\installfonts
\installfamily{T1}{pmnw}{}
\installfontas{pmnr9d}{T1}{pmnw}{m}{n}{}
\installfont{pmnriw9d}{%#pmnri8r#%,unsetcaps,%#pmnriw7a#%,pmnri8x,newlatin}{t1j}{T1}{pmnw}{m}{it}{}
\installfontas{pmnri9d}{T1}{pmnw}{m}{sl}{}
\installfontas{pmnrc9d}{T1}{pmnw}{m}{sc}{}
\installfontas{pmnric9d}{T1}{pmnw}{m}{si}{}
\installfontas{pmns9d}{T1}{pmnw}{sb}{n}{}
\installfont{pmnsiw9d}{%#pmnsi8r#%,unsetcaps,%#pmnsiw7a#%,pmnsi8x,newlatin}{t1j}{T1}{pmnw}{sb}{it}{}
\installfontas{pmnsi9d}{T1}{pmnw}{sb}{sl}{}
\installfontas{pmnsc9d}{T1}{pmnw}{sb}{sc}{}
\installfontas{pmnsic9d}{T1}{pmnw}{sb}{si}{}
\installfontas{pmnb9d}{T1}{pmnw}{b}{n}{}
\installfontas{pmnbi9d}{T1}{pmnw}{b}{it}{}
\installfontas{pmnbi9d}{T1}{pmnw}{b}{sl}{}
\installfontas{pmnb9d}{T1}{pmnw}{b}{sc}{}
\installfontas{pmnbi9d}{T1}{pmnw}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent We read the respective base font and clear the slots of the capital letters using the metric file \path{unsetcaps.mtx}. After that we add the corresponding swash font and finally the expert font as usual. We employ \path{t1j.etx} to get hanging figures by default. Since there are only two swash fonts, the remaining shapes of the |pmnw| family are taken from |pmnj|. Our self-made metric file \path{unsetcaps.mtx} uses the |\unsetglyph| command as follows:

\begin{lstlisting}[style=fontinst,numbers=none]{}
\relax
\metrics
\unsetglyph{A}
\unsetglyph{B}
\unsetglyph{C}
...
\unsetglyph{X}
\unsetglyph{Y}
\unsetglyph{Z}
\endmetrics
\end{lstlisting}

\noindent We are merely clearing the slots of capital letters found in the English alphabet here. Capital letters with an accent are not removed because the Minion swash set does not provide accented swash capitals anyway. This means that all accented capital letters will be taken from the ordinary italic font.

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfonts
\installfamily{TS1}{pmnw}{}
\installfontas{pmnr9c}{TS1}{pmnw}{m}{n}{}
\installfontas{pmnr9c}{TS1}{pmnw}{m}{sc}{}
\installfontas{pmnri9c}{TS1}{pmnw}{m}{it}{}
\installfontas{pmnri9c}{TS1}{pmnw}{m}{sl}{}
\installfontas{pmnri9c}{TS1}{pmnw}{m}{si}{}
\installfontas{pmns9c}{TS1}{pmnw}{sb}{n}{}
\installfontas{pmns9c}{TS1}{pmnw}{sb}{sc}{}
\installfontas{pmnsi9c}{TS1}{pmnw}{sb}{it}{}
\installfontas{pmnsi9c}{TS1}{pmnw}{sb}{sl}{}
\installfontas{pmnsi9c}{TS1}{pmnw}{sb}{si}{}
\installfontas{pmnb9c}{TS1}{pmnw}{b}{n}{}
\installfontas{pmnb9c}{TS1}{pmnw}{b}{sc}{}
\installfontas{pmnbi9c}{TS1}{pmnw}{b}{it}{}
\installfontas{pmnbi9c}{TS1}{pmnw}{b}{sl}{}
\installfontas{pmnbi9c}{TS1}{pmnw}{b}{si}{}
\endinstallfonts
\end{lstlisting}

\noindent After creating a font definition file for \tsoneenc encoding, our setup for the text fonts is complete.

\section{Installing text ornaments}
\label{exppro:ornaments}

The Minion expert package also includes a dedicated ornament font, \path{pmnrp.pfb}. As discussed before in section \ref{euro:install}, we do not really need fontinst when installing symbol fonts. But since we require a map file and a font definition file as well, using fontinst is in fact easier than running \bin{afm2tfm} and creating the auxiliary files manually:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\installfonts
\installfamily{U}{pmnp}{}
\installrawfont{pmnrp}{pmnrp}{%#txtfdmns#%,%#pmnrp mtxasetx#%}{U}{pmnp}{m}{n}{}
\endinstallfonts
\end{lstlisting}

\noindent And finally, we terminate our driver properly:

\begin{lstlisting}[style=fontinst]{drv-pmnx}
\endrecordtransforms
\bye
\end{lstlisting}

\section{Extending the user interface}
\label{exppro:nfssext}

Before creating a style file for Minion, we will update \path{nfssext.sty} one more time to support its additional features. Support for swashes is easily added since the framework is already in place. Therefore, the first part of the file does not require any changes, we simply add support for swashes by defining |\swstyle| in a similar vein (\ref{exppro:nfex:a}--\ref{exppro:nfex:b}):

\begin{lstlisting}[style=latex]{nfssext3}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{nfssext}[2003/03/14 v1.2 Experimental NFSS Extensions]
\newcommand*{\exfs@tempa}{}
\newcommand*{\exfs@tempb}{}
\newcommand*{\exfs@try@family}[2][]{%
  \let\exfs@tempa\relax
  \begingroup
    \fontfamily{#2}\try@load@fontshape
    \expandafter\ifx\csname\curr@fontshape\endcsname\relax
      \edef\exfs@tempa{#1}%
      \ifx\exfs@tempa\@empty
	\PackageWarning{nfssext}{%
	  Font family '\f@encoding/#2' not available\MessageBreak
	  Ignoring font switch}%
      \else
	\PackageInfo{nfssext}{%
	  Font family '\f@encoding/#2' not available\MessageBreak
	  Font family '\f@encoding/#1' tried instead}%
        \exfs@try@family{#1}%
      \fi
    \else
      \gdef\exfs@tempa{\fontfamily{#2}\selectfont}%
    \fi
  \endgroup
  \exfs@tempa}
\def\exfs@get@base#1#2#3#4\@nil{#1#2#3}
\DeclareRobustCommand{\lnstyle}{%
  \not@math@alphabet\lnstyle\relax
  \exfs@try@family[\expandafter\exfs@get@base\f@family\@nil]%
                  {\expandafter\exfs@get@base\f@family\@nil x}}
\DeclareRobustCommand{\osstyle}{%
  \not@math@alphabet\osstyle\relax
  \exfs@try@family{\expandafter\exfs@get@base\f@family\@nil j}}
\DeclareRobustCommand{\instyle}{%
  \not@math@alphabet\instyle\relax
  \exfs@try@family{\expandafter\exfs@get@base\f@family\@nil 0}}
\DeclareRobustCommand{\sustyle}{%
  \not@math@alphabet\sustyle\relax
  \exfs@try@family{\expandafter\exfs@get@base\f@family\@nil 1}}
\DeclareRobustCommand{\%#swstyle#%}{%%*					\label{exppro:nfex:a}
  \not@math@alphabet\swstyle\relax
  \exfs@try@family{\expandafter\exfs@get@base\f@family\@nil %#w#%}}%*	\label{exppro:nfex:b}
\end{lstlisting}

\noindent Adding thorough support for italic small caps is not quite as easy. The problem is that the creators of the \nfss apparently did not think of italic small caps when putting italics and small caps in the same category. Since both variants are on the shape axis of the \nfss they are mutually exclusive. While this will not keep us from using |\fontshape| to select italic small caps explicitly, nesting |\scshape| and |\itshape| does not have the desired effect. When nested, these macros simply override each other instead of switching to italic small caps. This problem is not as exotic as it may seem because italic small caps are hardly ever used explicitly. Typically, they come into play when small caps and italics are mixed on the same line. For example, think of a page header which is set in small caps, containing a highlighted word set in italics; or an italic section heading with an acronym set in small caps. To work around this problem, we will have to redefine a few \nfss macros. But first of all, we will add a macro for explicit switching to italic small caps.

\begin{lstlisting}[style=latex]{nfssext3}
\newcommand*{\%#sidefault#%}{si}
\end{lstlisting}

\noindent Note that the \nfss does not use fixed shape codes like |it| and |sc| for the italic and the small caps shape, but rather macros like |\itdefault| and |\scdefault|. We will handle italic small caps in a similar way by defining |\sidefault|, which defaults to |si|. Now let us define |\sishape| for explicit switching to italic small caps:

\begin{lstlisting}[style=latex]{nfssext3}
\DeclareRobustCommand{\%#sishape#%}{%
  \not@math@alphabet\sishape\relax
  \fontshape\%#sidefault#%\selectfont}
\end{lstlisting}

\noindent While we are able to typeset italic small caps by selecting them explicitly, macros like |\itshape| and |\scshape| will simply ignore the new shape. Hence we redefine these macros to make them take advantage of italic small caps transparently. In order to do so, we need a macro that will merge properties of the shape axis, thereby allowing us to treat italics and small caps as if they were not on the same axis:

\begin{lstlisting}[style=latex]{nfssext3}
\newcommand*{\exfs@merge@shape}[3]{%
  \edef\exfs@tempa{#1}%
  \edef\exfs@tempb{#2}%
  \ifx\f@shape\exfs@tempb
    \expandafter\ifx\csname\f@encoding/\f@family/\f@series/#3\endcsname\relax
    \else
      \edef\exfs@tempa{#3}%
    \fi
  \fi
  \fontshape{\exfs@tempa}\selectfont}
\end{lstlisting}

\noindent This macro will switch to the font shape given as the first argument unless the current shape is identical to the one indicated by the second argument. In this case it will switch to the shape designated by the third argument instead, provided that it is available for the current font family. With this macro at hand we redefine |\itshape|:

\begin{lstlisting}[style=latex]{nfssext3}
\DeclareRobustCommand{\%#itshape#%}{%
  \not@math@alphabet\itshape\mathit
  \exfs@merge@shape{\%#itdefault#%}{%#\scdefault#%}{\%#sidefault#%}}
\end{lstlisting}

\noindent Essentially, |\itshape| will switch to the font shape |it| unless the current shape is |sc|, in which case it will switch to |si| instead, provided that |si| is available. |\scshape| does it the other way around:

\begin{lstlisting}[style=latex]{nfssext3}
\DeclareRobustCommand{\%#scshape#%}{%
  \not@math@alphabet\scshape\relax
  \exfs@merge@shape{\%#scdefault#%}{\%#itdefault#%}{\%#sidefault#%}}
\end{lstlisting}

\noindent We also redefine |\upshape| to make it switch to |sc| instead of |n| if the current shape is |si|:

\begin{lstlisting}[style=latex]{nfssext3}
\DeclareRobustCommand{\%#upshape#%}{%
  \not@math@alphabet\upshape\relax
  \exfs@merge@shape{\%#updefault#%}{\%#sidefault#%}{\%#scdefault#%}}
\end{lstlisting}

\noindent If no italic small caps are available, all of these macros will behave like they did before, making them suitable for global use. While we are at it, we also define a new macro, |\dfshape|, that will reset the current shape to the default (|n| unless |\shapedefault| has been redefined) regardless of the current shape:

\begin{lstlisting}[style=latex]{nfssext3}
\DeclareRobustCommand{\%#dfshape#%}{%
  \not@math@alphabet\dfshape\relax
  \fontshape\%#shapedefault#%\selectfont}
\end{lstlisting}

\noindent Before we add text commands for our new font switches, there is still one thing left to do. The macro |\swstyle|, which we have defined above (\ref{exppro:nfex:a}--\ref{exppro:nfex:b}), will switch to the font family providing italic swashes (for example, |pmnw|). However, it will not activate the italic shape. It would be convenient to have a macro which takes care of all of that. We first create an auxiliary macro holding the shape which provides the actual swashes:

\begin{lstlisting}[style=latex]{nfssext3}
\newcommand*{\%#swshapedefault#%}{\itdefault}
\end{lstlisting}

\noindent Then we create a macro which will call |\swstyle| and select the shape providing the italic swashes in one shot:

\begin{lstlisting}[style=latex]{nfssext3}
\DeclareRobustCommand{\%#swshape#%}{%
  \not@math@alphabet\swshape\relax
  \%#swstyle#%\fontshape\%#swshapedefault#%\selectfont}
\end{lstlisting}

\noindent Finally, we add text commands for our new font switches:

\begin{lstlisting}[style=latex]{nfssext3}
\DeclareTextFontCommand{\textln}{\lnstyle}
\DeclareTextFontCommand{\textos}{\osstyle}
\DeclareTextFontCommand{\textin}{\instyle}
\DeclareTextFontCommand{\textsu}{\sustyle}
\DeclareTextFontCommand{\%#textsi#%}{\%#sishape#%}
\DeclareTextFontCommand{\%#textdf#%}{\%#dfshape#%}
\DeclareTextFontCommand{\%#textsw#%}{\%#swshape#%}
\end{lstlisting}

\noindent As far as text is concerned, all features of Minion are readily available at this point. Using the ornaments would still require low-level commands, though.

\section{A high-level interface for ornaments}
\label{exppro:sty:orn}

Technically, ornament fonts are comparable to the euro fonts discussed in section \ref{euro:eurofont}. To typeset the first ornament of Minion, for example, we could use the following command:

\begin{lstlisting}[style=latex,numbers=none]{}
{\usefont{%#U#%}{%#pmnp#%}{%#m#%}{%#n#%}\char 97}
\end{lstlisting}

\noindent As this is rather awkward and requires looking at the \path{afm} file to find out the encoding slot of each ornament, we will implement a higher-level solution. The problem is that ornament fonts do not conform to any encoding, so there is no standard we could rely on as far as the order of the glyphs in the font is concerned. We have to provide this information explicitly in \path{minion.sty}. To facilitate this, we define the following macro:

\begin{lstlisting}[style=latex]{nfssext3}
\newcommand*{\%#DeclareTextOrnament#%}[7]{%
  \expandafter\def\csname#1@orn\@roman#2\endcsname{#3/#4/#5/#6/#7}}
\end{lstlisting}

\noindent To declare the first ornament of Minion, this macro would be employed as follows:

\begin{lstlisting}[style=latex,numbers=none]{}
\DeclareTextOrnament{pmn}{1}{%#U#%}{%#pmnp#%}{%#m#%}{%#n#%}{97}
\end{lstlisting}

\noindent We use the first three letters of the font family name as an identifier (|pmn|) and assign a number (1 in this case) to the ornament defined by the remaining arguments. These arguments form a complete font declaration with a syntax similar to that of the \nfss macro |\DeclareFontShape|. The last argument is the encoding slot of the ornament (97 here) as given in the \path{afm} file. You might wonder why we use a complete font declaration here. Since all ornaments are located in the same font, using the same encoding, series, and shape, this seems to be redundant. In this case, this is actually true. The problem is that ornaments are not necessarily provided in dedicated fonts. Adobe Garamond, for example, comes with ornaments which are included in some of the alternate text fonts so we use a complete declaration for maximum flexibility. Internally, the ornaments are saved in a format modeled after the way the \nfss handles font shapes. When typesetting an ornament later, we need a macro to parse this font declaration:

\begin{lstlisting}[style=latex]{nfssext3}
\begingroup
  \catcode`\/=12
  \gdef\exfs@split@orndef#1/#2/#3/#4/#5\@nil{%
    \def\f@encoding{#1}%
    \def\f@family{#2}%
    \def\f@series{#3}%
    \def\f@shape{#4}%
    \def\exfs@tempa{#5}}
\endgroup
\end{lstlisting}

\noindent Since we use the base of the font family name as an identifier, we also need a macro that expands to the first three letters of the current font family:

\begin{lstlisting}[style=latex]{nfssext3}
\def\exfs@base@family{\expandafter\exfs@get@base\f@family\@nil}
\end{lstlisting}

\noindent Now we can finally implement a user macro that actually typesets the ornament. We will simply call it |\ornament|:

\begin{lstlisting}[style=latex]{nfssext3}
\DeclareRobustCommand{\%#ornament#%}[1]{%
  \expandafter\ifx\csname\exfs@base@family @orn\@roman#1\endcsname\relax%*\label{exppro:nfex:c}
    \PackageWarning{nfssext}{%%*					\label{exppro:nfex:d}
      Ornament #1 undefined for font family '\exfs@base@family'\MessageBreak
      Setting debug mark}%%*						\label{exppro:nfex:e}
    \rule{1ex}{1ex}%%*							\label{exppro:nfex:f}
  \else
    \begingroup
      \edef\exfs@tempb{\csname\exfs@base@family @orn\@roman#1\endcsname}%%*\label{exppro:nfex:g}
      \expandafter\expandafter\expandafter\exfs@split@orndef
        \expandafter\string\exfs@tempb\@nil%*				\label{exppro:nfex:h}
      \selectfont\char\exfs@tempa%*					\label{exppro:nfex:i}
    \endgroup
  \fi}
\endinput
\end{lstlisting}

\noindent First of all, we check if the desired ornament has been declared (\ref{exppro:nfex:c}) and issue a warning if not (\ref{exppro:nfex:d}--\ref{exppro:nfex:e}). We also typeset a mark (\ref{exppro:nfex:f}) to facilitate debugging in this case. If it has been declared, we expand and parse the declaration (\ref{exppro:nfex:g}--\ref{exppro:nfex:h}), switch fonts, and typeset the ornament (\ref{exppro:nfex:i}). We use grouping to keep the font change local.

\section{An extended style file}
\label{exppro:styfile}

The style file for Minion is similar to the ones suggested in section \ref{scosf:styfile} and \ref{expbase:styfile}. The only difference is the declaration of the text ornaments. This is the first part of \path{minion.sty}:

\begin{lstlisting}[style=latex,emph={minion,pmnx,pmnj}]{minion.sty}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{minion}[2003/03/25 v1.0 Adobe Minion]
\RequirePackage[T1]{fontenc}
\RequirePackage{textcomp}
\RequirePackage{nfssext}
\DeclareOption{oldstyle}{\renewcommand*{\rmdefault}{pmnj}}
\DeclareOption{lining}{\renewcommand*{\rmdefault}{pmnx}}
\ExecuteOptions{oldstyle}
\ProcessOptions*
\end{lstlisting}

\noindent When declaring the text ornaments, we take the encoding slot numbers from the respective \path{afm} file:

\begin{lstlisting}[style=afm]{}
C  #97# ; WX  885 ; N #ornament1# ; B 50  -65  835 744 ;
C  #98# ; WX 1036 ; N #ornament2# ; B 50    4  986 672 ;
C  #99# ; WX 1066 ; N #ornament3# ; B 50 -106 1016 745 ;
C #100# ; WX  866 ; N #ornament4# ; B 50   98  816 534 ;
C #101# ; WX  390 ; N #ornament5# ; B 50   86  341 550 ;
\end{lstlisting}

\noindent We add a declaration for each ornament:

\begin{lstlisting}[style=latex,emph={U,pmnp}]{minion.sty}
\DeclareTextOrnament{pmn}{%#1#%}{U}{pmnp}{m}{n}{%#97#%}
\DeclareTextOrnament{pmn}{%#2#%}{U}{pmnp}{m}{n}{%#98#%}
\DeclareTextOrnament{pmn}{%#3#%}{U}{pmnp}{m}{n}{%#99#%}
\DeclareTextOrnament{pmn}{%#4#%}{U}{pmnp}{m}{n}{%#100#%}
\DeclareTextOrnament{pmn}{%#5#%}{U}{pmnp}{m}{n}{%#101#%}
\DeclareTextOrnament{pmn}{%#6#%}{U}{pmnp}{m}{n}{%#102#%}
\DeclareTextOrnament{pmn}{%#7#%}{U}{pmnp}{m}{n}{%#103#%}
\DeclareTextOrnament{pmn}{%#8#%}{U}{pmnp}{m}{n}{%#104#%}
\DeclareTextOrnament{pmn}{%#9#%}{U}{pmnp}{m}{n}{%#105#%}
\DeclareTextOrnament{pmn}{%#10#%}{U}{pmnp}{m}{n}{%#106#%}
\DeclareTextOrnament{pmn}{%#11#%}{U}{pmnp}{m}{n}{%#107#%}
\DeclareTextOrnament{pmn}{%#12#%}{U}{pmnp}{m}{n}{%#108#%}
\DeclareTextOrnament{pmn}{%#13#%}{U}{pmnp}{m}{n}{%#109#%}
\DeclareTextOrnament{pmn}{%#14#%}{U}{pmnp}{m}{n}{%#110#%}
\DeclareTextOrnament{pmn}{%#15#%}{U}{pmnp}{m}{n}{%#111#%}
\DeclareTextOrnament{pmn}{%#16#%}{U}{pmnp}{m}{n}{%#112#%}
\DeclareTextOrnament{pmn}{%#17#%}{U}{pmnp}{m}{n}{%#113#%}
\DeclareTextOrnament{pmn}{%#18#%}{U}{pmnp}{m}{n}{%#114#%}
\DeclareTextOrnament{pmn}{%#19#%}{U}{pmnp}{m}{n}{%#115#%}
\DeclareTextOrnament{pmn}{%#20#%}{U}{pmnp}{m}{n}{%#116#%}
\DeclareTextOrnament{pmn}{%#21#%}{U}{pmnp}{m}{n}{%#117#%}
\DeclareTextOrnament{pmn}{%#22#%}{U}{pmnp}{m}{n}{%#118#%}
\DeclareTextOrnament{pmn}{%#23#%}{U}{pmnp}{m}{n}{%#119#%}
\endinput
\end{lstlisting}

\noindent As mentioned before, Adobe Garamond features ornaments in the alternate text fonts, requiring a complete font declaration. In this case, the definitions would look as follows:

\begin{lstlisting}[style=latex,numbers=none,emph={U,pada,n,it}]{}
\DeclareTextOrnament{pad}{1}{U}{pada}{m}{n}{%#49#%}
\DeclareTextOrnament{pad}{2}{U}{pada}{m}{n}{%#50#%}
\DeclareTextOrnament{pad}{3}{U}{pada}{m}{it}{%#49#%}
\end{lstlisting}

\noindent Note that the ornament macro is deliberately designed to be sensitive to the active font family. When using Minion, |\ornament{1}| will typeset the first ornament of Minion. When using Adobe Garamond, the same command sequence will typeset an ornament taken from Adobe Garamond. If you would like to use the ornaments in a font independent manner, you can always go back to lower-level commands which merely depend on a font definition file (|upmnp.fd| and |upada.fd| here) for the respective ornament font:

\begin{lstlisting}[style=latex,numbers=none]{}
{\usefont{U}{pmnp}{m}{n}\char 97}
{\usefont{U}{pada}{m}{n}\char 49}
\end{lstlisting}

%\chapter{Alternates and ligatures}
%\label{alternates}
%
%contextual/stylistic alternates

\chapter{Creating map files}
\label{mapfiles}

With the advent of fontinst 1.9, the tedious and error-prone task of creating map files manually should finally be a thing of the past. As outlined in section \ref{basics:mapfile}, fontinst can now do most of the work for us. Generally speaking, \dvi and \pdf drivers do not share a common map file format. For \dvips, the syntax of map files is explained in detail in the \dvips manual.\fnurl{http://www.radicaleye.com/dvipsman/} For \pdftex, it is is explained in the \pdftex manual, and for \xdvi in the documentation that comes with the source distribution of \xdvi. As of this writing (December 2004), map file support in fontinst is restricted to \dvips and \dvipdfm. Unless the map files contain unusual \PS instructions, however, \xdvi and \pdftex are capable of using \dvips' files, hence fontinst's map file generator for \dvips covers more than just \dvips.

Since map files are a crucial part in the process of transforming a \latex source file into a screen image or a printed document, understanding their format is still a must when debugging a malfunctioning \tex installation or dealing with very unusual installation scenarios. While the other tutorials in this guide rely on fontinst's map file generator, this tutorial will focus on building a map file manually. The format presented here is a subset of the syntax supported by dvips which will also work with \pdftex and \xdvi.

\section{The syntax of map files}
\label{mapfiles:syntax}

In tutorials \ref{basics} and \ref{standard} we have dealt with a typical installation scenario, the base package of Adobe Sabon. The map file was generated by fontinst's built-in map file writer. In the following, we will go over all the steps required to build this map file manually. The Sabon base package provides four fonts: regular, regular italic, bold, and bold italic. Both the |\latinfamily| macro employed in tutorial \ref{basics} and the lower-level fontinst file introduced in tutorial \ref{standard} will create slanted versions of the upright regular and bold fonts in addition to that. Therefore, we need to provide mapping records for a total of six fonts. Let us take a look at the complete map file before going over the individual lines:

\begin{lstlisting}[style=map]{}
psbr8r  Sabon-Roman      <8r.enc <psbr8a.pfb  "TeXBase1Encoding ReEncodeFont"
psbri8r Sabon-Italic     <8r.enc <psbri8a.pfb "TeXBase1Encoding ReEncodeFont"
psbb8r  Sabon-Bold       <8r.enc <psbb8a.pfb  "TeXBase1Encoding ReEncodeFont"
psbbi8r Sabon-BoldItalic <8r.enc <psbbi8a.pfb "TeXBase1Encoding ReEncodeFont"
psbro8r Sabon-Roman      <8r.enc <psbr8a.pfb  "TeXBase1Encoding ReEncodeFont 0.167 SlantFont"
psbbo8r Sabon-Bold       <8r.enc <psbb8a.pfb  "TeXBase1Encoding ReEncodeFont 0.167 SlantFont"
\end{lstlisting}

\noindent Map files for \dvips consist of up to three segments. The first segment is the name of the raw \tex font without any file suffix:

\begin{lstlisting}[style=map]{}
#psbr8r# Sabon-Roman <8r.enc <psbr8a.pfb "TeXBase1Encoding ReEncodeFont"
\end{lstlisting}

\noindent Note that both fontinst's built-in |\latinfamily| macro and all lower-level installation recipes suggested in this guide share a fundamental step: all regular text fonts are reencoded from Adobe Standard encoding (Fontname code |8a|) to \baseone (|8r|) before any virtual fonts are built. Therefore, the name of the raw \tex font corresponds to the one of the \path{pfb} file with encoding code |8r| instead of |8a|:

\begin{lstlisting}[style=map]{}
psbr#8r#  Sabon-Roman      <8r.enc <psbr#8a#.pfb  "TeXBase1Encoding ReEncodeFont"
psbri#8r# Sabon-Italic     <8r.enc <psbri#8a#.pfb "TeXBase1Encoding ReEncodeFont"
psbb#8r#  Sabon-Bold       <8r.enc <psbb#8a#.pfb  "TeXBase1Encoding ReEncodeFont"
psbbi#8r# Sabon-BoldItalic <8r.enc <psbbi#8a#.pfb "TeXBase1Encoding ReEncodeFont"
\end{lstlisting}

\noindent The second segment is the \PS name of the font:

\begin{lstlisting}[style=map]{}
psbr8r #Sabon-Roman# <8r.enc <psbr8a.pfb "TeXBase1Encoding ReEncodeFont"
\end{lstlisting}

\noindent Do not try to guess the right name or copy it from some map file you found somewhere on the web some time ago. If your font is included in one of the foundry-specific lists of the Fontname scheme, the \PS name is given in the second column of the respective table. If it is not or if you are in doubt, the \PS name should be taken from the header of the \path{afm} file for every font. Here are a few lines from \path{psbr8a.afm}:

\begin{lstlisting}[style=postscript]{}
StartFontMetrics 2.0
Comment Copyright (c) 1989 Adobe Systems Incorporated. All Rights Reserved.
Comment Creation Date:Fri Mar 10 16:47:51 PST 1989
#FontName Sabon-Roman#
FullName 12 Sabon* Roman 05232
FamilyName Sabon
EncodingScheme AdobeStandardEncoding
\end{lstlisting}

\noindent The relevant part is the line starting with \enquote*{FontName}. The \PS name of this font is \enquote*{Sabon-Roman}. For each font, we copy this name verbatim to the map file:

\begin{lstlisting}[style=map]{}
psbr8r  #Sabon-Roman#      <8r.enc <psbr8a.pfb  "TeXBase1Encoding ReEncodeFont"
psbri8r #Sabon-Italic#     <8r.enc <psbri8a.pfb "TeXBase1Encoding ReEncodeFont"
psbb8r  #Sabon-Bold#       <8r.enc <psbb8a.pfb  "TeXBase1Encoding ReEncodeFont"
psbbi8r #Sabon-BoldItalic# <8r.enc <psbbi8a.pfb "TeXBase1Encoding ReEncodeFont"
\end{lstlisting}

\noindent The third segment of our map file consists of a list of options. Options are either files to be embedded in the \PS code or \PS instructions enclosed in double quotes:

\begin{lstlisting}[style=map]{}
psbr8r Sabon-Roman #<8r.enc <psbr8a.pfb "TeXBase1Encoding ReEncodeFont"#
\end{lstlisting}

\noindent First of all, we need to include a list of files that \dvips will embed in the \PS file. In this case, we need the \PS encoding vector \path{8r.enc} for \baseone encoding and the \path{pfb} files, since we want the fonts to be embedded in the \PS file:

\begin{lstlisting}[style=map]{}
psbr8r  Sabon-Roman      #<8r.enc <psbr8a.pfb#  "TeXBase1Encoding ReEncodeFont"
psbri8r Sabon-Italic     #<8r.enc <psbri8a.pfb# "TeXBase1Encoding ReEncodeFont"
psbb8r  Sabon-Bold       #<8r.enc <psbb8a.pfb#  "TeXBase1Encoding ReEncodeFont"
psbbi8r Sabon-BoldItalic #<8r.enc <psbbi8a.pfb# "TeXBase1Encoding ReEncodeFont"
\end{lstlisting}

\noindent Our last option is a \PS reencoding instruction. As mentioned above, the |\latinfamily| macro and our lower-level fontinst driver files reencode all fonts from Adobe Standard encoding to \baseone when creating metric files for \tex. This affects the metrics only, which are defined in the \path{tfm} files generated by fontinst, while the glyph outlines as defined in the \path{pfb} file still use the font's native encoding. Therefore, we add a reencoding directive to the map file that will instruct all applications dealing with the actual glyph outlines to reencode them accordingly:

\begin{lstlisting}[style=map,emph={8r.enc,psbr8a.pfb}]{}
psbr8r Sabon-Roman <8r.enc <psbr8a.pfb #"TeXBase1Encoding ReEncodeFont"#
\end{lstlisting}

\noindent Where do we get the string |TeXBase1Encoding| from? It is the \PS name of the encoding vector, as defined in \path{8r.enc}. If you open the file \path{8r.enc} in a text editor, you will see a header consisting of comments concerning \baseone encoding. After that, the definition of the encoding vector begins as follows:

\begin{lstlisting}[style=postscript]{}
% Comments
/#TeXBase1Encoding# [
 /.notdef /dotaccent /fi /fl
 /fraction /hungarumlaut /Lslash /lslash
\end{lstlisting}

\noindent Note that the \toneenc and \tsoneenc encodings are used for the virtual fonts only, they are what \tex will work with. A \PS file created by \dvips, however, does not contain any virtual fonts. They will have been resolved into the raw fonts they are based on by \dvips. The raw fonts used to build virtual ones were reencoded to \baseone encoding during the installation. But this reencoding step affects the font metrics only while the \path{pfb} files embedded in the \PS code still use Adobe Standard as their native encoding. Therefore every application reading the final file has to repeat the reencoding step for the font outlines before rendering the fonts. This is what the \PS reencoding instruction is all about. Since we cannot expect every application to know about \baseone encoding, we embed the respective encoding vector (\path{8r.enc}) along with the fonts. Compare the first |\transformfont| command in the verbose fontinst file discussed in section \ref{standard:fontinst} to the corresponding line of the map file:

\begin{lstlisting}[style=map]{}
\transformfont{#psbr8r#}            {\#reencodefont#{#8r#}                     {\fromafm{#psbr8a#}}}
               #psbr8r# Sabon-Roman "#TeXBase1Encoding ReEncodeFont#" <8r.enc         <#psbr8a#.pfb
\end{lstlisting}

\noindent In addition to the base fonts provided by the Sabon package, we need to tell \dvips about any slanted versions created by fontinst. We copy the lines for Sabon-Roman and Sabon-Bold and insert |o|, the Fontname code for slanted fonts, after the weight code of the \tex font name. Note that the name of the \path{pfb} file does not change:

\begin{lstlisting}[style=map]{}
psbr#o#8r Sabon-Roman <8r.enc <psbr8a.pfb "TeXBase1Encoding ReEncodeFont 0.167 SlantFont"
psbb#o#8r Sabon-Bold  <8r.enc <psbb8a.pfb "TeXBase1Encoding ReEncodeFont 0.167 SlantFont"
\end{lstlisting}

\noindent We also add a \enquote*{SlantFont} instruction. By default, |\latinfamily| uses a slant factor of 0.167 when creating the modified metrics:

\begin{lstlisting}[style=map]{}
psbr#o#8r Sabon-Roman <8r.enc <psbr8a.pfb "TeXBase1Encoding ReEncodeFont #0.167 SlantFont#"
psbb#o#8r Sabon-Bold  <8r.enc <psbb8a.pfb "TeXBase1Encoding ReEncodeFont #0.167 SlantFont#"
\end{lstlisting}

\noindent Note that the font files embedded in the \PS file are not slanted, they are upright. Fontinst performs the slanting for the font metrics only, it does not touch the font outlines at all. The slanting of the glyph outlines will be performed by a \PS printer or an interpreter like Ghostscript. After resolving the virtual fonts, all that \dvips does as far as the raw fonts are concerned is reading the files listed in the map file and embedding them along with the slanting instruction. The transformation of the glyph outlines takes place when the \PS code is rendered on screen or on paper. Both \enquote*{ReEncodeFont} and \enquote*{SlantFont} are instructions for the application performing the final rendering. The value of the slanting instruction has to correspond to the slant factor used in the fontinst file. As mentioned above, fontinst's representation of the slant factor is slightly different. The value used in the map file is a real number corresponding to fontinst's (integer) slant factor divided by 1000. Its precision is therefore limited to three decimal places. Going back to the fontinst file discussed in section \ref{standard:fontinst} once again, compare a line of the map file to the corresponding line of the fontinst file:

\begin{lstlisting}[style=map]{}
\transformfont{psbro8r}{\#slantfont#{#167#}\reencodefont{8r}              {\fromafm{psbr8a}}}
psbro8r Sabon-Roman    "#0.167 SlantFont# TeXBase1Encoding ReEncodeFont" <8r.enc <psbr8a.pfb
\end{lstlisting}

\noindent Essentially, think of map files as a way of recording all encoding and shape modifications applied to the font metrics during the installation, so that they can be repeated for the font outlines when the final \PS file is displayed or printed. This information is required for the raw fonts only because all the information concerning the virtual fonts is contained in the virtual font files. When using \dvi or \pdf as the final output format, the division of labor between the various tools involved differs since \pdftex combines the roles of \tex and \dvips, while \dvi viewers deal with both the virtual fonts and the rendering of the font outlines on screen. The principle, however, remains the same. Therefore \pdftex and \xdvi require map files as well.

Technically, so-called \scosf fonts like those discussed in tutorial \ref{scosf} are regular text fonts as well. While they are a little bit more difficult to install than other text fonts, their map file records do not differ from other fonts at all. Here is a map file for the extended Sabon set in tutorial \ref{scosf}:

\begin{lstlisting}[style=map]{}
psbr8r   Sabon-Roman         <8r.enc <psbr8a.pfb   "TeXBase1Encoding ReEncodeFont"
psbri8r  Sabon-Italic        <8r.enc <psbri8a.pfb  "TeXBase1Encoding ReEncodeFont"
psbb8r   Sabon-Bold          <8r.enc <psbb8a.pfb   "TeXBase1Encoding ReEncodeFont"
psbbi8r  Sabon-BoldItalic    <8r.enc <psbbi8a.pfb  "TeXBase1Encoding ReEncodeFont"
psbrc8r  #Sabon-RomanSC#       <8r.enc <psbrc8a.pfb  "TeXBase1Encoding ReEncodeFont"
psbrij8r #Sabon-ItalicOsF#     <8r.enc <psbrij8a.pfb "TeXBase1Encoding ReEncodeFont"
psbbj8r  #Sabon-BoldOsF#       <8r.enc <psbbj8a.pfb  "TeXBase1Encoding ReEncodeFont"
psbbij8r #Sabon-BoldItalicOsF# <8r.enc <psbbij8a.pfb "TeXBase1Encoding ReEncodeFont"
psbro8r  Sabon-Roman   <8r.enc <psbr8a.pfb  "TeXBase1Encoding ReEncodeFont 0.167 SlantFont"
psbbo8r  Sabon-Bold    <8r.enc <psbb8a.pfb  "TeXBase1Encoding ReEncodeFont 0.167 SlantFont"
psbrco8r #Sabon-RomanSC# <8r.enc <psbrc8a.pfb "TeXBase1Encoding ReEncodeFont 0.167 SlantFont"
psbboj8r #Sabon-BoldOsF# <8r.enc <psbbj8a.pfb "TeXBase1Encoding ReEncodeFont 0.167 SlantFont"
\end{lstlisting}

\noindent Note that there is a slanted version of the small caps font even though we did not make the slanted small caps available under \latex in tutorial \ref{scosf}. We need it to provide matching figures for the slanted shape of the |psbj| family, which has to take regular-weight hanging figures from the small caps font.

\section{Expert and symbol fonts}
\label{mapfiles:symbol}

Map file records for expert and symbol fonts are simpler than those of text fonts. There is no \enquote*{ReEncodeFont} instruction and no encoding vector because such fonts are usually not reencoded. A map file for the Euro fonts discussed in section \ref{euro:install}, for example, would include the following lines:

\begin{lstlisting}[style=map]{}
zpeur   EuroSerif-Regular    <zpeur.pfb
zpeuri  EuroSerif-Italic     <zpeuri.pfb
zpeub   EuroSerif-Bold       <zpeub.pfb
zpeubi  EuroSerif-BoldItalic <zpeubi.pfb
\end{lstlisting}

\noindent We still need to add \enquote*{SlantFont} instructions for the slanted shapes:

\begin{lstlisting}[style=map]{}
zpeur#o#  EuroSerif-Regular    <zpeur.pfb  "0.167 #SlantFont#"
zpeub#o#  EuroSerif-Bold       <zpeub.pfb  "0.167 #SlantFont#"
\end{lstlisting}

\noindent The Janson expert fonts discussed in tutorial \ref{expbase} would be mapped in a similar way:

\begin{lstlisting}[style=map]{}
mjnr8x  JansonExpertMT            <mjnr8x.pfb
mjnri8x JansonExpertMT-Italic     <mjnri8x.pfb
mjnb8x  JansonExpertMT-Bold       <mjnb8x.pfb
mjnbi8x JansonExpertMT-BoldItalic <mjnbi8x.pfb
mjnro8x JansonExpertMT            <mjnr8x.pfb  "0.167 SlantFont"
mjnbo8x JansonExpertMT-Bold       <mjnb8x.pfb  "0.167 SlantFont"
\end{lstlisting}

\noindent In addition to expert fonts, the Minion fonts discussed in tutorial \ref{exppro} include swash and symbol fonts which are also mapped like that because they were not reencoded:

\begin{lstlisting}[style=map]{}
pmnriw7a Minion-SwashItalic         <pmnriw7a.pfb
pmnsiw7a Minion-SwashSemiboldItalic <pmnsiw7a.pfb
pmnrp    Minion-Ornaments           <pmnrp.pfb
\end{lstlisting}

\part*{Appendix}
\appendix

\chapter{Code tables}
\label{tables}

The tables on the following pages are intended to give an idea of how the codes of the Fontname scheme relate to those used by \latex's font selection scheme (\nfss). The Fontname codes are what we use when renaming the font files during the installation while the \nfss codes are what we need when selecting a certain font under \latex later. Sticking to the \nfss codes listed below is not a technical requirement for a functional font installation. When using the |\latinfamily| macro, fontinst will indeed use these \nfss codes. When employing low-level fontinst commands, however, the \nfss font declaration is controlled by the last five arguments of the |\installfont| command. In theory, we could use an arbitrary code and the \nfss would handle that just fine. It is still highly recommended to stick to these codes to avoid confusion and incompatibility. Two dashes in one of the table cells indicate that there is no customary code for this font property in the respective scheme whereas a blank cell means that the code is omitted. Properties which are not catered for by the |\latinfamily| macro are marked with an asterisk in the last column.

Please note that Fontname codes and \nfss codes cannot be mapped on a one-to-one basis in all cases since the two schemes are rather different in concept. Weights and widths, which are treated separately by the Fontname scheme, need to be concatenated and handled as a \enquote*{series} when using the \nfss since the latter does not have independent categories (\enquote*{axes}) for weight and width. The \enquote*{variant} category of the Fontname scheme on the other hand, which embraces several different properties including shapes like italics as well as special glyph sets such as small caps or alternative figures, does not correspond to a single \nfss axis. Some variants, like italics and small caps for example, are mapped to the \enquote*{shape} axis of the \nfss. Others, such as alternative figures, are handled in completely different ways. Table \ref{tables:shapes} lists variants corresponding to the most common \nfss shapes only. When looking at the documentation of the Fontname scheme, you will find a lot more variant codes not mentioned here. Although they are used for file naming, they do not, or, at least do not necessarily correspond to a customary \nfss shape. Hanging, inferior, and superior numbers (Fontname codes |j|, |0|, and |1|), for example, are treated as \enquote*{variants} by the Fontname scheme but they are usually implemented as independent font families on the level of the \nfss. For the encodings listed in table \ref{tables:encodings} the situation is similar. For example, a virtual font in \toneenc encoding featuring expert glyphs is indicated by adding |9e| to the file name. However, on the level of the \nfss the encoding code is |T1| for all \toneenc encoded fonts and the fact that the font provides expert glyphs is expressed by adding the letter |x| to the font family name.

\begin{table}
  \centering\small
  \begin{tabularx}{\textwidth}{XL{80pt}{xx}R{80pt}{xx}@{}l}
    \toprule
    \caps{weight} &
    \multicolumn{1}{c}{\makebox[80pt][c]{\caps{fontname code}}} &
    \multicolumn{2}{c}{\makebox[80pt][c]{\caps{nfss series}}}\\
    \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-4}
    ultra light, thin, hairline	& a	& ul	& *	\\
    extra light			& j	& el	& *	\\
    light			& l	&  l	&	\\
    book			& k	&  m	&	\\
    regular			& r	&  m	&	\\
    medium			& m	& mb	&	\\
    demibold			& d	& db	&	\\
    semibold			& s	& sb	&	\\
    bold			& b	&  b	&	\\
    heavy			& h	& eb	&	\\
    black			& c	& eb	&	\\
    extra bold, extra black	& x	& eb	&	\\
    ultra bold, ultra black	& u	& ub	&	\\
    poster			& p	& -{}-	& *	\\
    \bottomrule
  \end{tabularx}
  \caption{Codes for font weights}
  \label{tables:series}
\end{table}

\begin{table}
  \centering\small
  \begin{tabularx}{\textwidth}{XL{80pt}{xx}R{80pt}{xx}@{}l}
    \toprule
    \caps{width} &
    \multicolumn{1}{c}{\makebox[80pt][c]{\caps{fontname code}}} &
    \multicolumn{2}{c}{\makebox[80pt][c]{\caps{nfss series}}}\\
    \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-4}
    ultra compressed			& u	& uc	& *	\\
    ultra condensed			& o	& uc	& *	\\
    extra compressed, extra condensed	& q	& ec	& *	\\
    compressed				& p	&  c	& *	\\
    condensed				& c	&  c	& *	\\
    narrow				& n	&  c		\\
    regular				&	&	&	\\
    extended				& x	&  x	& *	\\
    expanded				& e	&  x	& *	\\
    extra expanded			& v	& ex	& *	\\
    ultra expanded			& -{}-	& ux	& *	\\
    wide				& w	& -{}-	& *	\\
    \bottomrule
  \end{tabularx}
  \caption{Codes for font widths}
  \label{tables:widths}
\end{table}

\begin{table}
  \centering\small
  \begin{tabularx}{\textwidth}{XL{80pt}{xx}R{80pt}{xx}@{}l}
    \toprule
    \caps{variant} &
    \multicolumn{1}{c}{\makebox[80pt][c]{\caps{fontname code}}} &
    \multicolumn{2}{c}{\makebox[80pt][c]{\caps{nfss shape}}}\\
    \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-4}
    normal, upright, roman	&	&  n	&	\\
    italic			&  i	& it	&	\\
    oblique, slanted		&  o	& sl	&	\\
    small caps			&  c	& sc	&	\\
    italic small caps		& ic	& si	& *	\\
    upright italic		& -{}-	& ui	& *	\\
    outline			&  l	& ol	& *	\\
    \bottomrule
  \end{tabularx}
  \caption{Codes for font variants}
  \label{tables:shapes}
\end{table}

\begin{table}
  \centering\small
  \begin{tabularx}{\textwidth}{XL{80pt}{xx}L{80pt}{xxx}}
    \toprule
    \caps{encoding} &
    \multicolumn{1}{c}{\makebox[80pt][c]{\caps{fontname code}}} &
    \multicolumn{1}{c}{\makebox[80pt][c]{\caps{nfss encoding}}}\\
    \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
    Adobe Standard					& 8a	&  8a\\
    Expert						& 8x	&  8x\\
    \baseone						& 8r	&  8r\\
    \tex Text						& 7t	& OT1\\
    \tex Tex with expert set				& 9t	& OT1\\
    \tex Text with expert set and \osf			& 9o	& OT1\\
    Cork						& 8t	&  T1\\
    Cork with expert set				& 9e	&  T1\\
    Cork with expert set and \osf			& 9d	&  T1\\
    Text Companion					& 8c	& TS1\\
    Text Companion with expert set			& 9c	& TS1\\
    \bottomrule
  \end{tabularx}
  \caption{Codes for font encodings}
  \label{tables:encodings}
\end{table}

\chapter{Text companion symbols}
\label{textcomp}

The symbol lists in this appendix give an overview of the symbols defined in \tsoneenc encoding and the corresponding text commands provided by the \sty{textcomp} package. Please note that regular \PS fonts will not provide the full range of text companion symbols. Some parts of the \tsoneenc encoding are rather exotic and specific to fonts which were created with \tex and \tsoneenc encoding in mind.

\section{Symbols in text fonts}
\label{textcomp:standard}

The text companion symbols in the following list will usually be available when installing common \PS fonts based on Adobe Standard encoding. Some symbols are marked with an asterisk. They are not found as such in \PS text fonts but fontinst will try to fake them, using glyphs which are almost always included in such fonts. In order to create a centered asterisk, for example, fontinst uses the regular asterisk and tries to center it vertically. The quality of the result depends on the particular glyph and the given font. For example, creating a composite centigrade symbol by combining the degree sign with the capital letter \enquote*{C} should always work. On the other hand, faking something like double brackets depends on certain assumptions concerning the dimensions of the brackets provided by the font. These assumptions may or may not apply to a given font. The euro symbol is a special case since it is not included in Adobe Standard encoding. If a font provides a native euro symbol, however, it will usually be included in the base fonts. If there is no euro symbol at all, fontinst tries to fake it by overstriking the capital letter \enquote*{C} with two horizontal bars as a last resort. In this case, the quality of the result will vary significantly from typeface to typeface. Please refer to tutorial \ref{euro} for a more detailed discussion of issues related to the euro symbol.

\begingroup\small
\begin{longtable}[l]{@{}p{0.4\linewidth}@{}p{0.1\linewidth}@{}p{0.4\linewidth}@{}p{0.1\linewidth}@{}}
|\textacutedbl|			& \textacutedbl &
|\textasciiacute|		& \textasciiacute \\
|\textasciibreve|		& \textasciibreve &
|\textasciicaron|		& \textasciicaron \\
|\textasciidieresis|		& \textasciidieresis &
|\textasciigrave|		& \textasciigrave \\
|\textasciimacron|		& \textasciimacron &
|\textasteriskcentered|*	& \textasteriskcentered \\
|\textbardbl|*			& \textbardbl &
|\textbrokenbar|		& \textbrokenbar \\
|\textbullet|			& \textbullet &
|\textcelsius|*			& \textcelsius \\
|\textcent|			& \textcent &
|\textcopyright|		& \textcopyright \\
|\textcurrency|			& \textcurrency &
|\textdaggerdbl|		& \textdaggerdbl \\
|\textdagger|			& \textdagger &
|\textdegree|			& \textdegree \\
|\textdiv|			& \textdiv &
|\textdollar|			& \textdollar \\
|\texteuro|*			& \texteuro &
|\textflorin|			& \textflorin \\
|\textfractionsolidus|		& \textfractionsolidus &
|\textgravedbl|			& \textgravedbl \\
|\textinterrobangdown|*		& \textinterrobangdown &
|\textinterrobang|*		& \textinterrobang \\
|\textlbrackdbl|*		& \textlbrackdbl &
|\textlnot|			& \textlnot \\
|\textminus|			& \textminus &
|\textmu|			& \textmu \\
|\textonehalf|			& \textonehalf &
|\textonequarter|		& \textonequarter \\
|\textonesuperior|		& \textonesuperior &
|\textordfeminine|		& \textordfeminine \\
|\textordmasculine|		& \textordmasculine &
|\textparagraph|		& \textparagraph \\
|\textperiodcentered|		& \textperiodcentered &
|\textperthousand|		& \textperthousand \\
|\textpm|			& \textpm &
|\textquotesingle|		& \textquotesingle \\
|\textrbrackdbl|*		& \textrbrackdbl &
|\textregistered|		& \textregistered \\
|\textsection|			& \textsection &
|\textsterling|			& \textsterling \\
|\textthreequartersemdash|*	& \textthreequartersemdash &
|\textthreequarters|		& \textthreequarters \\
|\textthreesuperior|		& \textthreesuperior &
|\texttildelow|*		& \texttildelow \\
|\texttimes|			& \texttimes &
|\texttrademark|		& \texttrademark \\
|\texttwelveudash|*		& \texttwelveudash &
|\texttwosuperior|		& \texttwosuperior \\
|\textyen|			& \textyen \\
\end{longtable}
\endgroup

\section{Symbols specific to expert fonts}
\label{textcomp:expert}

When installing \PS fonts complemented by an expert package the text companion symbols in this list will usually be available in addition to the ones mentioned above. Apart from the dash these glyphs cannot be faked.

\begingroup\small
\begin{longtable}[l]{@{}p{0.4\linewidth}@{}p{0.1\linewidth}@{}p{0.4\linewidth}@{}p{0.1\linewidth}@{}}
|\textzerooldstyle|		& \textzerooldstyle &
|\textoneoldstyle|		& \textoneoldstyle \\
|\texttwooldstyle|		& \texttwooldstyle &
|\textthreeoldstyle|		& \textthreeoldstyle \\
|\textfouroldstyle|		& \textfouroldstyle &
|\textfiveoldstyle|		& \textfiveoldstyle \\
|\textsixoldstyle|		& \textsixoldstyle &
|\textsevenoldstyle|		& \textsevenoldstyle \\
|\texteightoldstyle|		& \texteightoldstyle &
|\textnineoldstyle|		& \textnineoldstyle \\
|\textcentoldstyle|		& \textcentoldstyle &
|\textcolonmonetary|		& \textcolonmonetary \\
|\textdollaroldstyle|		& \textdollaroldstyle &
|\textthreequartersemdash|	& \textthreequartersemdash \\
\end{longtable}
\endgroup

\section{Symbols specific to \tex fonts}
\label{textcomp:tex}

The text companion symbols in this list mostly belong to the more exotic parts of the \tsoneenc encoding. They are only provided by fonts which were created with \tex and \tsoneenc encoding in mind, for example European Computer Modern and Latin Modern.

\begingroup\small
\begin{longtable}[l]{@{}p{0.4\linewidth}@{}T{0.1\linewidth}@{}p{0.4\linewidth}@{}T{0.1\linewidth}@{}}
|\textbaht|			& \textbaht &
|\textbigcircle|		& \textbigcircle \\
|\textblank|			& \textblank &
|\textborn|			& \textborn \\
|\textcircledP|			& \textcircledP &
|\textcopyleft|			& \textcopyleft \\
|\textdblhyphenchar|		& \textdblhyphenchar &
|\textdblhyphen|		& \textdblhyphen \\
|\textdied|			& \textdied &
|\textdiscount|			& \textdiscount \\
|\textdivorced|			& \textdivorced &
|\textdong|			& \textdong \\
|\textdownarrow|		& \textdownarrow &
|\textestimated|		& \textestimated \\
|\textguarani|			& \textguarani &
|\textlangle|			& \textlangle \\
|\textleaf|			& \textleaf &
|\textleftarrow|		& \textleftarrow \\
|\textlira|			& \textlira &
|\textlquill|			& \textlquill \\
|\textmarried|			& \textmarried &
|\textmho|			& \textmho \\
|\textmusicalnote|		& \textmusicalnote &
|\textnaira|			& \textnaira \\
|\textnumero|			& \textnumero &
|\textohm|			& \textohm \\
|\textopenbullet|		& \textopenbullet &
|\textpertenthousand|		& \textpertenthousand \\
|\textpeso|			& \textpeso &
|\textpilcrow|			& \textpilcrow \\
|\textquotestraightbase|	& \textquotestraightbase &
|\textquotestraightdblbase|	& \textquotestraightdblbase \\
|\textrangle|			& \textrangle &
|\textrecipe|			& \textrecipe \\
|\textreferencemark|		& \textreferencemark &
|\textrightarrow|		& \textrightarrow \\
|\textrquill|			& \textrquill &
|\textservicemark|		& \textservicemark \\
|\textsurd|			& \textsurd &
|\textuparrow|			& \textuparrow \\
|\textwon|			& \textwon \\
\end{longtable}
\endgroup

\chapter{The GNU Free Documentation License}
\label{fdl}

%\renewcommand*{\thesection}{\arabic{section}}
\setcounter{section}{-1}

\begingroup\centering

\textbf{Version 1.2, November 2002}

\vspace{0.5\baselineskip}

\textit{Copyright © 2000, 2001, 2002 Free Software Foundation, Inc.}

\textit{59 Temple Place, Suite 330, Boston, \textsc{ma} 02111-1307 \textsc{usa}}

\endgroup

\vspace{0.5\baselineskip}

\section{Preamble}
\label{fdl:preamble}

The purpose of this license is to make a manual, textbook, or other functional and useful document \enquote*{free} in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this license preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.

This license is a kind of \enquote*{copyleft}, which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.

We have designed this license in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this license is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this license principally for works whose purpose is instruction or reference.

\section{Applicability and definitions}
\label{fdl:defs}

This license applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this license. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The \emph{document}, below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as \emph{you}. You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law.

A \emph{modified version} of the document means any work containing the document or a portion of it, either copied verbatim, or with modifications and\slash or translated into another language.

A \emph{secondary section} is a named appendix or a front-matter section of the document that deals exclusively with the relationship of the publishers or authors of the document to the document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the document is in part a textbook of mathematics, a secondary section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.

The \emph{invariant sections} are certain secondary sections whose titles are designated, as being those of invariant sections, in the notice that says that the document is released under this license. If a section does not fit the above definition of secondary then it is not allowed to be designated as invariant. The document may contain zero invariant sections. If the document does not identify any invariant sections then there are none.

The \emph{cover texts} are certain short passages of text that are listed, as front-cover texts or back-cover texts, in the notice that says that the document is released under this license. A front-cover text may be at most five words, and a back-cover text may be at most 25 words.

A \emph{transparent} copy of the document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not transparent. An image format is not transparent if used for any substantial amount of text. A copy that is not \enquote*{transparent} is called \enquote*{opaque}.

\sloppypar Examples of suitable formats for transparent copies include plain \ascii without markup, \texinfo input format, \latex input format, \textsc{sgml} or \textsc{xml} using a publicly available \textsc{dtd}, and standard-conforming simple \textsc{html}, \PS or \pdf designed for human modification. Examples of transparent image formats include \textsc{png}, \textsc{xcf} and \textsc{jpg}. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, \textsc{sgml} or \textsc{xml} for which the \textsc{dtd} and\slash or processing tools are not generally available, and the machine-generated \textsc{html}, \PS or \pdf produced by some word processors for output purposes only.

The \emph{title page} means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this license requires to appear in the title page. For works in formats which do not have any title page as such, \enquote*{title page} means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.

A section \emph{entitled \textsc{xyz}} means a named subunit of the document whose title either is precisely \textsc{xyz} or contains \textsc{xyz} in parentheses following text that translates \textsc{xyz} in another language. (Here \textsc{xyz} stands for a specific section name mentioned below, such as \enquote*{Acknowledgements}, \enquote*{Dedications}, \enquote*{Endorsements}, or \enquote*{History}.) To \enquote{preserve the title} of such a section when you modify the document means that it remains a section \enquote{entitled \textsc{xyz}} according to this definition.

The document may include warranty disclaimers next to the notice which states that this license applies to the document. These warranty disclaimers are considered to be included by reference in this license, but only as regards disclaiming warranties: any other implication that these warranty disclaimers may have is void and has no effect on the meaning of this license.

\section{Verbatim copying}
\label{fdl:verbcopy}

You may copy and distribute the document in any medium, either commercially or noncommercially, provided that this license, the copyright notices, and the license notice saying this license applies to the document are reproduced in all copies, and that you add no other conditions whatsoever to those of this license. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section \ref{fdl:masscopy}.

You may also lend copies, under the same conditions stated above, and you may publicly display copies.

\section{Copying in quantity}
\label{fdl:masscopy}

If you publish printed copies (or copies in media that commonly have printed covers) of the document, numbering more than 100, and the document's license notice requires cover texts, you must enclose the copies in covers that carry, clearly and legibly, all these cover texts: front-cover texts on the front cover, and back-cover texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the document and satisfy these conditions, can be treated as verbatim copying in other respects.

If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.

If you publish or distribute opaque copies of the document numbering more than 100, you must either include a machine-readable transparent copy along with each opaque copy, or state in or with each opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete transparent copy of the document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of opaque copies in quantity, to ensure that this transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an opaque copy (directly or through your agents or retailers) of that edition to the public.

It is requested, but not required, that you contact the authors of the document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the document.

\section{Modifications}
\label{fdl:mods}

You may copy and distribute a modified version of the document under the conditions of sections \ref{fdl:verbcopy} and \ref{fdl:masscopy} above, provided that you release the modified version under precisely this license, with the modified version filling the role of the document, thus licensing distribution and modification of the modified version to whoever possesses a copy of it. In addition, you must do these things in the modified version:

\begin{anumerate}

\item Use in the title page (and on the covers, if any) a title distinct from that of the document, and from those of previous versions (which should, if there were any, be listed in the history section of the document). You may use the same title as a previous version if the original publisher of that version gives permission.

\item List on the title page, as authors, one or more persons or entities responsible for authorship of the modifications in the modified version, together with at least five of the principal authors of the document (all of its principal authors, if it has fewer than five), unless they release you from this requirement.

\item State on the title page the name of the publisher of the modified version, as the publisher.

\item Preserve all the copyright notices of the document.

\item Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.

\item Include, immediately after the copyright notices, a license notice giving the public permission to use the modified version under the terms of this license.

\item Preserve in that license notice the full lists of invariant sections and required cover texts given in the document's license notice.

\item Include an unaltered copy of this license.

\item Preserve the section entitled \enquote*{History}, preserve its title, and add to it an item stating at least the title, year, new authors, and publisher of the modified version as given on the title page. If there is no section entitled \enquote*{History} in the document, create one stating the title, year, authors, and publisher of the document as given on its title page, then add an item describing the modified version as stated in the previous sentence.

\item Preserve the network location, if any, given in the document for public access to a transparent copy of the document, and likewise the network locations given in the document for previous versions it was based on. These may be placed in the \enquote*{History} section. You may omit a network location for a work that was published at least four years before the document itself, or if the original publisher of the version it refers to gives permission.

\item For any section entitled \enquote*{Acknowledgements} or \enquote*{Dedications}, preserve the title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and\slash or dedications given there\-in.

\item Preserve all the invariant sections of the document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.

\item Delete any section entitled \enquote*{Endorsements}. Such a section may not be included in the modified version.

\item Do not retitle any existing section to be entitled \enquote*{Endorsements} or to conflict in title with any invariant section.

\item Preserve any warranty disclaimers.

\end{anumerate}

\noindent If the modified version includes new front-matter sections or appendices that qualify as secondary sections and contain no material copied from the document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of invariant sections in the modified version's license notice. These titles must be distinct from any other section titles.

You may add a section entitled \enquote*{Endorsements}, provided it contains nothing but endorsements of your modified version by various parties~-- for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.

You may add a passage of up to five words as a front-cover text, and a passage of up to 25 words as a back-cover text, to the end of the list of cover texts in the modified version. Only one passage of front-cover text and one of back-cover text may be added by (or through arrangements made by) any one entity. If the document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.

The author(s) and publisher(s) of the document do not by this license give permission to use their names for publicity for or to assert or imply endorsement of any modified version.

\section{Combining documents}
\label{fdl:combine}

You may combine the document with other documents released under this license, under the terms defined in section \ref{fdl:mods} above for modified versions, provided that you include in the combination all of the invariant sections of all of the original documents, unmodified, and list them all as invariant sections of your combined work in its license notice, and that you preserve all their warranty disclaimers.

The combined work need only contain one copy of this license, and multiple identical invariant sections may be replaced with a single copy. If there are multiple invariant sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of invariant sections in the license notice of the combined work.

In the combination, you must combine any sections entitled \enquote*{History} in the various original documents, forming one section entitled \enquote*{History}; likewise combine any sections entitled \enquote*{Acknowledgements}, and any sections entitled \enquote*{Dedications}. You must delete all sections entitled \enquote*{Endorsements.}

\section{Collections of documents}
\label{fdl:collect}

You may make a collection consisting of the document and other documents released under this license, and replace the individual copies of this license in the various documents with a single copy that is included in the collection, provided that you follow the rules of this license for verbatim copying of each of the documents in all other respects.

You may extract a single document from such a collection, and distribute it individually under this license, provided you insert a copy of this license into the extracted document, and follow this license in all other respects regarding verbatim copying of that document.

\section{Aggregation with independent works}
\label{fdl:aggregat}

A compilation of the document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an \enquote*{aggregate} if the copyright resulting from the compilation is not used to limit the legal rights of the compilation's users beyond what the individual works permit. When the document is included in an aggregate, this license does not apply to the other works in the aggregate which are not themselves derivative works of the document.

If the cover text requirement of section \ref{fdl:masscopy} is applicable to these copies of the document, then if the document is less than one half of the entire aggregate, the document's cover texts may be placed on covers that bracket the document within the aggregate, or the electronic equivalent of covers if the document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate.

\section{Translation}

Translation is considered a kind of modification, so you may distribute translations of the document under the terms of section \ref{fdl:mods}. Replacing invariant sections with translations requires special permission from their copyright holders, but you may include translations of some or all invariant sections in addition to the original versions of these invariant sections. You may include a translation of this license, and all the license notices in the document, and any warranty disclaimers, provided that you also include the original English version of this license and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this license or a notice or disclaimer, the original version will prevail.

If a section in the document is entitled \enquote*{Acknowledgements}, \enquote*{Dedications}, or \enquote*{History}, the requirement (section \ref{fdl:mods}) to preserve its title (section \ref{fdl:defs}) will typically require changing the actual title.

\section{Termination}

You may not copy, modify, sublicense, or distribute the document except as expressly provided for under this license. Any other attempt to copy, modify, sublicense or distribute the document is void, and will automatically terminate your rights under this license. However, parties who have received copies, or rights, from you under this license will not have their licenses terminated so long as such parties remain in full compliance.

\section{Future revisions of this license}

The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.\fnurl{http://www.gnu.org/copyleft/}

Each version of the license is given a distinguishing version number. If the document specifies that a particular numbered version of this license \enquote{or any later version} applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the document does not specify a version number of this license, you may choose any version ever published (not as a draft) by the Free Software Foundation.

\chapter{Revision history}
\label{changelog}

\begin{changelog}
\item[2.14 2010-08-29]
\item Original author resigned as maintainer
\item[2.14 2004-12-05]
\item Added appendix \ref{textcomp}
\item Extended section \ref{basics:fontinst}, adding note about monowidth fonts
\item Extended section \ref{euro:eurofont}, adding note about faked euro symbol
\item Extended introduction, adding section on getting further help
\item[2.00 2004-04-18]
\item Final release for fontinst 1.9
\item Completed revision process for fontinst 1.9
\item[1.90 2004-03-14]
\item Revised tutorial \ref{exppro}
\item Updated tutorial \ref{mapfiles}
\item[1.80 2004-02-14]
\item Revised tutorial \ref{expbase}
\item Updated tutorial \ref{mapfiles}
\item[1.70 2004-01-31]
\item Revised tutorial \ref{euro}, adding section \ref{euro:install}
\item Updated tutorial \ref{mapfiles}, adding section \ref{mapfiles:symbol}
\item[1.60 2004-01-31]
\item Revised tutorial \ref{scosf}
\item Updated tutorial \ref{mapfiles}
\item[1.50 2004-01-25]
\item Revised tutorial \ref{standard}
\item Updated tutorial \ref{mapfiles}
\item[1.40 2004-01-24]
\item Started revision process for fontinst 1.9
\item Revised tutorial \ref{basics}
\item Added tutorial \ref{mapfiles}
\item Revised appendix
\item[1.23 2003-08-31]
\item Updated section \ref{basics:cm}, adding tables \ref{tables:cm-formats} and \ref{tables:cm-encodings}
\item Updated section \ref{basics:cm}, adding note about Latin Modern
\item Revised section \ref{basics:usage}
\item[1.20 2003-07-17]
\item Updated section \ref{euro:uncoded}, adding preliminary hints for fontinst 1.9
\item Updated sections \ref{scosf:styfile}, \ref{expbase:styfile}, and \ref{exppro:nfssext}, fixing bug in \path{nfssext.sty}
\item Updated section \ref{exppro:nfssext}, improving swash support in \path{nfssext.sty}
\item Revised discussion of ornaments in section \ref{exppro:styfile}
\item Revised discussion of swashes in section \ref{exppro:fontinst}
\item Added spelling corrections by William Adams\item Added spelling corrections by Adrian Burd
\item Removed note soliciting contributions
\item[1.10 2003-03-27]
\item Added GNU Free Documentation License as appendix \ref{fdl}
\item Added explicit licensing clause
\item[1.00 2003-03-25]
\item Final release for fontinst 1.8
\item Added tutorial \ref{exppro}
\item Updated notes on contributions
\item[0.80 2003-03-23]
\item Added spelling corrections and suggestions by Timothy Eyre
\item Revised section \ref{basics:usage}, splitting off section \ref{basics:cm}
\item Added section \ref{scosf:texfonts}
\item[0.68 2003-02-09]
\item Revised section \ref{euro:currency}
\item Updated notes on contributions
\item[0.66 2003-01-26]
\item Added highlighting to code listings
\item[0.65 2003-01-19]
\item Added spelling corrections by Adrian Heathcote
\item Added spelling corrections by William Adams
\item Added section \ref{standard:latinfamily}
\item Revised introduction
\item[0.60 2003-01-11]
\item Revised tutorial \ref{scosf}
\item Added discussion of kerning issues to section \ref{scosf:fontinst}
\item[0.54 2003-01-04]
\item Revised discussion of \otoneenc encoding in tutorial \ref{basics}
\item Added minor changes to appendix \ref{tables}
\item[0.52 2003-01-02]
\item Added table \ref{tables:widths} to appendix \ref{tables}
\item Revised introduction to tables in appendix \ref{tables}
\item[0.50 2002-12-30]
\item Added tutorial \ref{expbase}
\item Added appendix \ref{tables} featuring tables \ref{tables:series}, \ref{tables:shapes}, and \ref{tables:encodings}
\item Added revision history as appendix \ref{changelog}
\item[0.43 2002-10-25]
\item First public release featuring tutorials \ref{basics}--\ref{euro}
\item Added installation instructions to section \ref{euro:eurofont}
\item[0.40 2002-08-11]
\item Added tutorial \ref{euro}
\item[0.30 2002-05-12]
\item Added tutorial \ref{scosf}
\item[0.20 2002-04-17]
\item Unreleased draft featuring tutorials \ref{basics} and \ref{standard}
\end{changelog}

\end{document}
