% \iffalse meta-comment
%
% Copyright 1999--2002 the fontinst maintenance team and any individual
% authors listed elsewhere in this file.  All rights reserved.
%
% This file is part of the fontinst system version 1.9.
% -----------------------------------------------------
%
% It may be distributed under the terms of the LaTeX Project Public
% License, as described in lppl.txt in the base LaTeX distribution.
% Either version 1.0 or, at your option, any later version.
%
%<*driver>
\documentclass{ltxdoc}

\addtolength{\oddsidemargin}{-1.5cm}
\addtolength{\evensidemargin}{-1.5cm}
\addtolength{\textwidth}{1.5cm}
\addtolength{\marginparwidth}{-1.5cm}

% Flexible and-mechanism
\makeatletter
\newcount\number@of@ands
\newcommand\printanded[1]{%
   \global\number@of@ands=\z@
   \def\and{\global\advance\number@of@ands\@ne}%
   \sbox\z@{#1}%
   \ifnum\number@of@ands=\@ne
      \def\and{ and }%
   \else
      \def\and{%
         \global\advance\number@of@ands\m@ne
         \ifnum\number@of@ands>\z@
            ,\ %
         \else
            , and %
         \fi
      }%
   \fi
   #1%
}%
\makeatother

\DeclareRobustCommand\package[1]{\textsf{#1}}
\newenvironment{file}[2]{%
   \trivlist
   \item[\hskip\labelsep{\bfseries
      File:\ \texttt{\ignorespaces #1\unskip}%
   }]%
   #2%
}{\endtrivlist}
\newcommand\fileitem[1]{%
   \item[\texttt{\ignorespaces #1\unskip}]%
}
\newcommand\original[2]{%
   \textit{Current version #1, last updated #2.}%
   \def\versionstr{#1}\def\datestr{#2}%
}
\makeatletter
\newcommand\generated[1]{\textit{%
   Generated file, current version
   \@ifundefined{ver-#1}{%
      \textnormal{\textbf{??}}%
      \protect\G@refundefinedtrue
      \@latex@warning{Reference `#1' on page \thepage\space
         undefined}%
   }{\@nameuse{ver-#1}},
   last updated
   \@ifundefined{date-#1}{%
      \textnormal{\textbf{??}}
      \protect\G@refundefinedtrue
      \@ifundefined{ver-#1}{}{\@latex@warning{Reference `#1' on page
         \thepage\space undefined}}%
   }{\@nameuse{date-#1}}.%
}}
\newcommand\verlabel[1]{%
   \@bsphack
   \protected@write\@auxout{}%
       {\string\updatelabel{#1}{\versionstr}{\datestr}}%
   \@esphack
}
\newcommand\updatelabel[3]{%
   \@ifundefined{ver-#1}{\global\@namedef{ver-#1}{#2}}{%
      \ifdim \@nameuse{ver-#1}pt<#2pt\global\@namedef{ver-#1}{#2}\fi
   }%
   \@ifundefined{date-#1}{\global\@namedef{date-#1}{#3}}{%
      \edef\datestr{\csname date-#1\endcsname}%
      \iflater\datestr{#3}{}{\global\@namedef{date-#1}{#3}}%
   }%
}
% These are from the LaTeX kernel, but I can't use the kernel's
% defintions since they are preamble-only.
\newcommand\iflater[2]{%
  \ifnum\expandafter\parseversion#1//00\@nil<%
        \expandafter\parseversion#2//00\@nil
    \expandafter\@secondoftwo
  \else
    \expandafter\@firstoftwo
  \fi}
\def\parseversion#1/#2/#3#4#5\@nil{#1#2#3#4 }
\makeatother

\title{The \package{fontinst} system---description of files}
\author{Lars Hellstr\"om}
\date{v\,1.9x}
\begin{document}
\maketitle
\DocInput{manifest.tex}
\end{document}
%</driver>
% \fi
%
% \begin{abstract}
%   This paper lists and give short descriptions of the files that
%   constitute the \package{fontinst} system. It is meant to be
%   updated whenever new files are added or old files are updated.
% \end{abstract}
%
%
% \iffalse
%<*manifest>

The following files form the fontinst v1.9x distribution as of
2002/05/23. Note that the files listed below do not form a complete
fontinst system; they are merely the files which have been updated
for the current version  of fontinst.

The following files are, with the exception of trig.dtx and trig.sty, 
covered by the License at the end of this file. trig.dtx and trig.sty 
are covered by the License for the files in the LaTeX graphics 
bundle (see CTAN:macros/latex/required/graphics). At the time of 
writing there are no differences between the conditions, however.

% \fi
%
% \section{Files in the same directory as this file}
% \iffalse

%

In this directory:

% \fi
%
% \begin{file}{
     manifest.tex
% }{\original{1.915}{2002/05/23}}
%   \verlabel{manifest}
%   This is the file you are reading right now.
% \end{file}
%
% \begin{file}{
     manifest.txt
% }{\generated{manifest}}
%   This is a raw ASCII version of the file you are reading right now.
%   It contains no descriptions of files, it just lists them.
% \end{file}
%
%
% \section{Inputs}
%
% The input files reside in the \texttt{inputs} directory subtree of
% the \package{fontinst} distribution. When installing
% \package{fontinst}, one should either make sure that these files are
% placed somewhere that \TeX\ scans for input files or include these
% directories in \TeX's input file search path.
% 
%
% \subsection{The \texttt{inputs/etx} directory}
% \iffalse

%

In the inputs/etx directory:

% \fi
% The \texttt{inputs/etx} directory contains the encoding files.
% \package{fontinst} uses these files to relate glyphs (which are
% identified by names) to slots (character numbers). If the encoding
% file is used to generate a font (e.g., it's the third argument of
% |\installfont|), it also contains the code which specifies font
% dimensions, ligatures, and a couple of other things.
%
% The following are the files in this directory which have had some
% update for v\,1.9. These are only a subset of all the files in this
% directory.
%
% \begin{file}{
     8r.etx
% }{\original{1.915}{2002/05/22}}
%   This file specifies the \texttt{8r} (TeXBase1) encoding.
% \end{file}
%
% \begin{file}{
     8y.etx
% }{\original{1.915}{2002/05/23}}
%   This file specifies the \texttt{8y}/\texttt{LY1} encoding.
% \end{file}
%
% \begin{file}{
     ot1.etx
% }{\original{1.910}{1999/11/07}}
%   This file specifies the old \TeX\ text (\texttt{OT1})
%   encoding---both the normal text variant (codingscheme \texttt{TEX
%   TEXT}) and the typewriter text variant (codingscheme \texttt{TEX
%   TYPEWRITER TEXT}).
% \end{file}
%
% \begin{file}{
     ot1c.etx
% }{\original{1.909}{1999/10/26}}
%   This file specifies the \texttt{OT1} encoding for some small caps
%   fonts. It merely sets some defaults and calls \texttt{ot1.etx}.
% \end{file}
%
% \begin{file}{
     ot1cj.etx
% }{\original{1.909}{1999/10/27}}
%   This file specifies the \texttt{OT1} encoding for some small caps
%   fonts with hanging (oldstyle) figures. It merely sets some defaults
%   and calls \texttt{ot1.etx}.
% \end{file}
%
% \begin{file}{
     ot1ctt.etx
% }{\original{1.910}{1999/11/04}}
%   This file specifies the typewriter version of the \texttt{OT1}
%   encoding for some small caps fonts. It merely sets some defaults
%   and calls \texttt{ot1c.etx}.
% \end{file}
%
% \begin{file}{
     ot1i.etx
% }{\original{1.909}{1999/10/27}}
%   This file specifies the \texttt{OT1} encoding for italic fonts. It
%   merely sets some defaults and calls \texttt{ot1.etx}.
% \end{file}
%
% \begin{file}{
     ot1ij.etx
% }{\original{1.909}{1999/10/27}}
%   This file specifies the \texttt{OT1} encoding for italic fonts with
%   hanging (oldstyle) figures. It merely sets some defaults and calls
%   \texttt{ot1.etx}.
% \end{file}
%
% \begin{file}{
     ot1itt.etx
% }{\original{1.910}{1999/11/04}}
%   This file specifies the typewriter version of the \texttt{OT1}
%   encoding for italic fonts. It merely sets some defaults
%   and calls \texttt{ot1.etx}.
% \end{file}
%
% \begin{file}{
     ot1j.etx
% }{\original{1.909}{1999/10/27}}
%   This file specifies the \texttt{OT1} encoding for fonts with
%   hanging (oldstyle) figures. It merely sets some defaults and calls
%   \texttt{ot1.etx}.
% \end{file}
%
% \begin{file}{
     ot1tt.etx
% }{\original{1.910}{1999/11/04}}
%   This file specifies the typewriter version of the \texttt{OT1}
%   encoding. It merely sets some defaults and calls \texttt{ot1.etx}.
%   This file is by default used for interpreting PL files with
%   codingscheme \texttt{TEX TYPEWRITER TEXT}.
% \end{file}
%
% 
% \subsection{The \texttt{inputs/mathetx} directory}
% \iffalse

% 

In the inputs/mathetx directory:

% \fi
% The \texttt{inputs/mathetx} directory contains encoding definition 
% (ETX) files for fonts that are primarily math fonts.
%
% \begin{file}{
     euex.etx
% }{\original{1.915}{2000/10/26}}
%   Encoding definition file describing the encoding of the AMS Euler 
%   Extension fonts (\texttt{euex}$*$). The codingscheme is
%   \texttt{EULER SUBSTITUTIONS ONLY}).
% \end{file}
% 
% \begin{file}{
     eufrak.etx
% }{\original{1.915}{2000/10/26}}
%   Encoding definition file describing the encoding of the AMS Euler 
%   Fraktur fonts (\texttt{eufrak}$*$). The codingscheme is
%   \texttt{TEX TEXT SUBSET}, and it is a subset of \texttt{TEX TEXT}
%   (\texttt{OT1}), but the glyph names specified by the encoding are 
%   different.
% \end{file}
% 
% \begin{file}{
     eurm.etx
% }{\original{1.915}{2000/10/26}}
%   Encoding definition file describing the encoding of the AMS Euler 
%   Roman fonts (\texttt{eurm}$*$). The codingscheme is
%   \texttt{TEX MATH ITALIC SUBSET}, and it is a subset of 
%   \texttt{TEX MATH ITALIC} (\texttt{OML}), but some of the glyph names 
%   specified by the encoding are different.
% \end{file}
% 
% \begin{file}{
     euscr.etx
% }{\original{1.915}{2000/10/26}}
%   Encoding definition file describing the encoding of the AMS Euler 
%   Script fonts (\texttt{euscr}$*$). The codingscheme is
%   \texttt{TEX MATH SYMBOLS SUBSET}, and it is a subset of 
%   \texttt{TEX MATH SYMBOLS} (\texttt{OMS}), but some of the glyph names 
%   specified by the encoding are different.
% \end{file}
% 
% \begin{file}{
     oml.etx
% }{\original{1.915}{2000/10/06}}
%   Encoding definition file for the \texttt{OML} (old math letters) 
%   encoding (codingscheme \texttt{TEX MATH ITALIC}).
% \end{file}
% 
% \begin{file}{
     oms.etx
% }{\original{1.915}{2000/10/06}}
%   Encoding definition file for the \texttt{OMS} (old math symbols) 
%   encoding (codingscheme \texttt{TEX MATH SYMBOLS}).
% \end{file}
% 
% \begin{file}{
     omx.etx
% }{\original{1.915}{2000/10/10}}
%   Encoding definition file for the \texttt{OMX} (old math extensions) 
%   encoding (codingscheme \texttt{TEX MATH EXTENSION}).
% \end{file}
% 
% \begin{file}{
     rsfs.etx
% }{\original{1.801}{1998/06/29}}
%   Encoding definition file for Ralph Smith's Formal Script fonts 
%   (\texttt{rsfs}$*$). Codingscheme is \texttt{RAS SCRIPT}.
% \end{file}
% 
% 
% \subsection{The \texttt{inputs/mathmtx} directory}
% \iffalse

% 

In the inputs/mathmtx directory:

% \fi
% The \texttt{inputs/mathmtx} directory contains MTX files for 
% constructing some glyphs for fonts that are primarily math fonts.
% 
% \begin{file}{
     mathex.mtx
% }{\original{1.915}{2000/10/16}}
%   This file builds some glyphs for \texttt{OMX}-encoded fonts.
% \end{file}
% 
% \begin{file}{
     mathit.mtx
% }{\original{1.915}{2000/10/16}}
%   This file builds some glyphs for \texttt{OML}-encoded fonts. Most 
%   of this building consists of marking them as \cs{unfakable}, but a 
%   handfull of glyphs are faked.
% \end{file}
% 
% \begin{file}{
     mathsy.mtx
% }{\original{1.915}{2000/10/16}}
%   This file builds some glyphs for \texttt{OMS}-encoded fonts.
% \end{file}
% 
%
% \subsection{The \texttt{inputs/misc} directory}
% \iffalse

% 

In the inputs/misc directory:

% \fi
% The \texttt{inputs/misc} directory contains a couple of files that 
% traditionally (well, more or less) can be found in the 
% \package{fontinst} distribution and which do not fit in any of the 
% other directories. Most of them are small fixes for commonly appearing 
% problems.
% 
% \begin{file}{
     glyphoff.mtx
% }{\original{1.915}{2000/09/11}}
%   Inputting this file makes |\setrawglyph| and |\setscaled|\-|rawglyph| 
%   behave like |\setnot|\-|glyph| and |\set|\-|scaled|\-|not|\-|glyph| 
%   respectively. 
%   Inputting \texttt{glyphon.mtx} undoes this effect.
% \end{file}
% 
% \begin{file}{
     glyphon.mtx
% }{\original{1.915}{2000/09/11}}
%   Inputting this file restores the normal definitions of \cs{setrawglyph} 
%   and \cs{setscaledrawglyph}.
% \end{file}
% 
% \begin{file}{
     kernoff.mtx
% }{\original{1.915}{2000/09/11}}
%   Inputting this file turns \cs{setkern} into a no-op (makes it 
%   gobble its arguments but do nothing more). Inputting 
%   \texttt{kernon.mtx} undoes this effect.
% \end{file}
% 
% \begin{file}{
     kernon.mtx
% }{\original{1.915}{2000/09/11}}
%   Inputting this file restores the normal definition of \cs{setkern}. 
% \end{file}
% 
% 
% \section{Old directories}
% 
% The following lists the directories that are (as yet) unchanged from 
% the v\,1.914 distribution.
%
%
% \subsection{The \texttt{inputs/mtx} directory}
% \iffalse

%

In the inputs/mtx directory:

% \fi
% The \texttt{inputs/mtx} directory contains metric files used to
% achieve certain effects, as opposed to the metric files describing
% each font that \package{fontinst} generates from AFM or PL files.
%
% The following are the files in this directory which have had some
% update for v\,1.9. These are only a subset of all the files in this
% directory.
%
%
% \begin{file}{
     8r.mtx
% }{\original{1.910}{1999/11/10}}
%   The purpose of this file is to slightly modify the metrics of a raw
%   \texttt{8r}-encoded font (mainly by adding kerns) so that it becomes
%   more suitable for typesetting.
% \end{file}
%
% \begin{file}{
     8y.mtx
% }{\original{1.910}{1999/11/13}}
%   The purpose of this file is to slightly modify the metrics of a raw
%   \texttt{8y}-encoded font (mainly by adding kerns) so that it becomes
%   more suitable for typesetting.
% \end{file}
%
% \begin{file}{
     latin.mtx
% }{\original{1.909}{1999/11/14}}
%   This file contains the commands for making the glyphs used in latin
%   text fonts, primarily \texttt{OT1}- and \texttt{T1}-encoded fonts.
% \end{file}
%
% \begin{file}{
     latinsc.mtx
% }{\original{1.909}{1999/11/14}}
%   This file has the same basic purpose as \texttt{latin.mtx}, but it
%   is better suited than that file for building small caps and/or
%   hanging (oldstyle) figures virtual fonts using glyphs from expert
%   fonts.
% \end{file}
%
% \begin{file}{
     textcomp.mtx
% }{\original{1.909}{1999/11/14}}
%   This file contains the commands for making the glyphs used in
%   \texttt{TS1} encoded fonts. (The file names comes from that the
%   codingscheme name for this encoding is \texttt{TEX TEXT COMPANION
%   SYMBOLS 1---TS1}. ``Companion'' refers to \textit{The \LaTeX
%   \ Companion}.)
% \end{file}
%
% \subsection{The \texttt{inputs/tex} directory}
% \iffalse

%

In the inputs/tex directory:

% \fi
% The \texttt{inputs/tex} directory contains the input files that are
% neither encoding nor metric files. In particular it contains the
% input code for the \package{fontinst} utility.
%
% \paragraph{Flavours of \package{fontinst}}
% The bulk of code in the \package{fontinst} utility is unvariable, but
% there are a few sections which are optional and which can be changed
% to modify some aspects of \package{fontinst}'s behaviour. This is more
% thouroghly covered in the subsection \textit{Modules} in
% \texttt{fisource.tex}. There are however three such variants of
% \package{fontinst} which are already generated in the distribution,
% namely
% \begin{description}
%   \fileitem{
     fontinst.sty
%   }\generated{fontinst}
%     This is the standard form of \package{fontinst}.
%   \fileitem{
     cfntinst.sty
%   }\generated{fontinst}
%     This file contains some extra code to support the old (up to
%     version 1.801) interface for word boundary ligatures and kerns.
%     It also uses more memory on \TeX's save stack.
%   \fileitem{
     xfntinst.sty
%   }\generated{fontinst}
%     This file contains some extra code which causes the |\latinfamily|
%     command to search for a few more fonts when it generates fonts
%     with oldstyle digits.
% \end{description}
% The creation of further variants is possible, even though it is highly
% unlikely that you really need to. Further details can be found in
% \texttt{fisource.tex} and \texttt{fontinst.ins}.
%
%
% \begin{file}{
     fontdoc.sty
% }{\generated{fontdoc}}
%   This is the file containing the \package{fontdoc} package.
% \end{file}
%
% \begin{file}{
     fontinst.ini
% }{\generated{ini}}
%   This file contains some extra definitions used if \package{fontinst}
%   is run under ini\TeX.
% \end{file}
%
% \begin{file}{
     finstmsc.sty
% }{\generated{misc}}
%   The main function in this file is the automatic map file fragment
%   generator. It also contains the PostScript encoding file to 
%   \package{fontinst} encoding file converter which used to be a part of 
%   \texttt{fontinst.sty}.
% \end{file}
%
% \begin{file}{
     csc2x.tex
% }{\generated{reglyph}}
%   This file contains code for setting up a common reglyphing
%   conversion of metric files.
% \end{file}
%
% \begin{file}{
     csckrn2x.tex
% }{\generated{reglyph}}
%   This file contains code for setting up a common reglyphing
%   conversion of metric files.
% \end{file}
%
% \begin{file}{
     trig.sty
% }{\generated{trig}}
%   This file contains the \package{trig} package by David Carlisle.
%   This package is not a part of \package{fontinst} as such, but
%   \package{fontinst} uses \package{trig} to convert the italic angle
%   (as specified in AFM files) to an italic slope (as needed for TFM
%   files).
%
%   Note that this file is not covered by the license for
%   \package{fontinst}, but by the licence for the \LaTeX\ graphics 
%   bundle.
% \end{file}
%
%
% \section{The \texttt{source} directory}
% \iffalse

%

In the source directory:

% \fi
% The documented source files reside in the \texttt{source} directory
% subtree of the \package{fontinst} distribution.
%
% \begin{file}{
     fibasics.dtx
% }{\original{1.914}{2000/05/30}}
%   \verlabel{fontinst}\verlabel{ini}\verlabel{fontdoc}\verlabel{misc}
%   This file contains most of the basic definitions in
%   \package{fontinst}.
% \end{file}
%
% \begin{file}{
     ficonv.dtx
% }{\original{1.914}{2000/06/05}}
%   \verlabel{fontinst}\verlabel{misc}\verlabel{reglyph}
%   This file contains the conversion routines in \package{fontinst}.
% \end{file}
%
% \begin{file}{
     figglo.ist
% }{\original{1.10}{1999/05/30}}
%   This file is a variant of the standard \LaTeX\ file
%   \texttt{gglo.ist} (see the \package{doc} package documentation for
%   details about that file) that assumes some of the declarations in
%   \texttt{fisource.sty} have been made. Using \texttt{figglo.ist}
%   rather than \texttt{gglo.ist} for sorting \package{fontinst}'s list
%   of changes improves formatting.
% \end{file}
%
% \begin{file}{
     filtfam.dtx
% }{\original{1.903}{1999/05/13}}
%   \verlabel{fontinst}
%   This file contains the implementation of the |\lainfamily| command.
% \end{file}
%
% \begin{file}{
     fimain.dtx
% }{\original{1.914}{2000/05/30}}
%   \verlabel{fontinst}\verlabel{fontdoc}\verlabel{misc}
%   This file contains the main part of \package{fontinst}---the
%   routines for constructing new fonts. It also contains most of the
%   command definitions for the \package{fontdoc} package.
% \end{file}
%
% \begin{file}{
     fimapgen.dtx
% }{\original{1.914}{2000/06/05}}
%   \verlabel{fontinst}\verlabel{misc}
%   This file contains the code for the automatic map file fragment
%   generator and its interface to main \package{fontinst}.
%   \textit{Comments on the contents of this file are particularly
%   welcome.}
% \end{file}
%
% \begin{file}{
     fisource.sty
% }{\original{1.38}{2000/06/05}}
%   This file is a \LaTeX\ package which contains some declarations
%   common to all the source files.
% \end{file}
%
% \begin{file}{
     fisource.tex
% }{\original{1.914}{2000/06/05}}
%   This is the main file for the documented \package{fontinst} source.
%   It does not contain any code itself, but it contains lots of notes on
%   the code, how it has changed, how it can be used, what might be done
%   in the future, and so on.
% \end{file}
%
% \begin{file}{
     fontinst.ins
% }{\original{1.914}{2000/05/31}}
%   This is the \package{docstrip} installation script for
%   \package{fontinst}.
% \end{file}
%
% \begin{file}{
     trig.dtx
% }{\original{1.09}{1999/03/16}}
%   \verlabel{trig}
%   This file contains the code for the \package{trig} package by David 
%   Carlisle.
% \end{file}
%
% \section{License}
% \iffalse

%

License
=======

% \fi
%
% \package{fontinst} is free software that can be redistributed and/or
% modified under the terms of the \LaTeX\ Project Public License---either
% version 1.1 of the License, or (at your option) any later version---as
% specified in the file \texttt{lppl.txt} in the base \LaTeX\
% distribution, which can be fetched by anonymous FTP from CTAN archives
% directory \texttt{macros}\slash \texttt{latex}\slash \texttt{base}.
%
% \iffalse
fontinst is free software that can be redistributed and/or modified
under the terms of the LaTeX Project Public License--either version 1.1
of the License, or (at your option) any later version--as specified
in the file lppl.txt in the base LaTeX distribution, which can be
fetched by anonymous FTP from CTAN archives directory macros/latex/base.


%</manifest>
% \fi
\endinput
