% \iffalse meta-comment
%
% Copyright (C) 1993 by LaTeX3 project.  All rights reserved.
% For additional copyright information see further down in this file.
% 
% This file is part of the LaTeX2e system (PRELIMINARY TEST RELEASE)
% ------------------------------------------------------------------
% 
%  This system 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.
% 
% 
% IMPORTANT NOTICE:
% 
% For error reports in case of UNCHANGED versions see readme files.
% 
% Please do not request updates from us directly.  Distribution is
% done through Mail-Servers and TeX organizations.
% 
% You are not allowed to change this file.
% 
% You are allowed to distribute this file under the condition that
% it is distributed together with all files mentioned in 00readme.l2e.
% 
% If you receive only some of these files from someone, complain!
% 
% You are NOT ALLOWED to distribute this file alone.  You are NOT
% ALLOWED to take money for the distribution or use of either this
% file or a changed version, except for a nominal charge for copying
% etc.
% \fi
\def\fileversion{v2.1c}
\def\filedate{1993/12/13}
\def\docdate {1993/11/10}

% \CheckSum{59}
%
% \iffalse
% Copyright (C) 1993 Frank Mittelbach,
% all rights reserved.
% \fi
% 
% \changes{v2.0d}{1993/05/15}{Changed file names}
% \changes{v2.0c}{1993/04/23}{Changed external font names}
% \changes{v2.1a}{1993/11/10}{Update for \LaTeXe}
%
% \title{The \texttt{pandora} fonts for use with \LaTeXe}
% \author{Frank Mittelbach}
% \date{\filedate}
%
%
% \def\dst{\expandafter{\normalfont\scshape docstrip}}
% \setcounter{StandardModuleDepth}{1}
%
%
% \maketitle
%
% \section{Introduction}
%
% This file defines the font shape groups for the pandora fonts
% designed by Nazeen N. Billawala \cite{StanCS:NBi89,Stanford:NBi89}
% as well as a package file for loading Pandora Roman with the |\rmfamily|
% command and Pandora Sans with the |\sffamily| command.
%
% To make Pandora the main document font specify the \texttt{pandora}
% minor option in a |\usepackage| command.
%
% \StopEventually{
% \begin{thebibliography}{1}
%
% \bibitem{StanCS:NBi89}
%   Nazeen~N. Billawala.
% \newblock Metamarks: Preliminary studies for a pandora's box of
%    shapes.
% \newblock Technical Report STAN-CS-89-1256, Stanford University,
%    Department of Computer Science, Stanford, California 94305, 1989.
%
% \bibitem{Stanford:NBi89}
% Neenie Billawala.
% \newblock {{Opening Pandora's Box}}.
% \newblock In Christina Thiele, editor, {\em 1989 Conference
%     Proceedings}, volume 10\#4 of {TUG}boat, pages 481--489. {\TeX}
%     Users Group, December 1989.
% 
% \end{thebibliography}
%
%^^A   \bibliographystyle{plain}
%^^A   \bibliography{string,techrep,proceed}
% }
%
%
% \section{The \dst{} modules}
%
% The following modules are used in the implementation to direct
% \dst{} in generating the external files:
% \begin{center}
% \begin{tabular}{ll}
%   driver & produce a documentation driver file \\
%   package  & produce a package file \\
%   fd     & produce a font definition file \\[2pt]
% \end{tabular}
% \end{center}
%
%
% \section{The Implementation}
%
% \subsection{Identification}
%
% We start by writing to the VDU and the transcript file.
%    \begin{macrocode}
%<*package>
\NeedsFormat{LaTeX2e}
\ProvidesPackage{pandora}[\filedate\space\fileversion\space
                          standard LaTeX2e package]
\typeout{Standard Package: `pandora'
  \fileversion\space\space <\filedate> (FMi)}
\typeout{English Documentation
  \@spaces\@spaces\space <\docdate> (FMi)}
%    \end{macrocode}
%
% \subsection{Options}
%
% This package does not support options.
%
% \subsection{The Main Package Code}
%
%    We change the ensure that |OT1| is the default encoding and also
%    change the substitution defaults for the this encoding. If
%    |\familydefault| is not changed directly, then the change to
%    |\rmdefault| will automatically change the main font too.
% \changes{v2.0b}{1993/03/09}{Added missing backslash}
%    \begin{macrocode}
\renewcommand{\encodingdefault}{OT1}
\DeclareFontSubstitution{OT1}{panr}{m}{n}
%    \end{macrocode}
%    Default for |\rmfamily| will be Pandora Roman and for |\sffamily|
%    Pandora Sans.
%    \begin{macrocode}
\renewcommand{\rmdefault}{panr}
\renewcommand{\sfdefault}{pss}
\renewcommand{\bfdefault}{b}
\renewcommand{\itdefault}{sl}
%</package>
%    \end{macrocode}
%
%    We assume that for \LaTeX{} use at least the standard
%    magifications are available. If you don't like that setup copy
%    the corresponding code into your own font shape definition file
%    and make adjustments.
%
%  \subsection{The Font-Definition Files}
%
%    We introduce the |.fd| files
%    in the \textsf{log} file. The explicit spaces are necessary in an
%    |.fd| file and the |\string| guards against situations where |`|,
%    |<| or |>| is active.
%    \begin{macrocode}
%<*fd>
\wlog{Fontdef\space file\space produced\space from:\space
 \string`pandora.dtx'\space \fileversion\space
 \string<\filedate\string>\space (FMi\space and\space RmS)}
%</fd>
%    \end{macrocode}
%    The Pandora Roman family exists with in medium and bold series
%    and contains in the medium series a slanted shape beside the
%    normal one. We define a substitution shape for italic to point to
%    the slanted one so that a request for |\itshape| will be partly
%    honored.
%    \begin{macrocode}
%<*panr>
\DeclareFontFamily{OT1}{panr}{}
\DeclareFontShape{OT1}{panr}{m}{n}{
   <5> <6> <7> <8> <9> <10> <10.95> <12>
   <14.4> <17.28> <20.74> <24.88> pnr10  }{}
\DeclareFontShape{OT1}{panr}{b}{n}{
   <5> <6> <7> <8> <9> <10> <10.95> <12>
   <14.4> <17.28> <20.74> <24.88> pnb10  }{}
\DeclareFontShape{OT1}{panr}{m}{sl}{
   <5> <6> <7> <8> <9> <10> <10.95> <12>
   <14.4> <17.28> <20.74> <24.88> pnsl10 }{}
\DeclareFontShape{OT1}{panr}{m}{it}{ <-> sub * panr/m/sl }{}
%</panr>
%    \end{macrocode}
%
%    The Pandora Sans family has the same members.
%    \begin{macrocode}
%<*pss>
\DeclareFontFamily{OT1}{pss}{}
\DeclareFontShape{OT1}{pss}{m}{n}{
   <5> <6> <7> <8> <9> <10> <10.95> <12>
   <14.4> <17.28> <20.74> <24.88> pnss10  }{}
\DeclareFontShape{OT1}{pss}{b}{n}{
   <5> <6> <7> <8> <9> <10> <10.95> <12>
   <14.4> <17.28> <20.74> <24.88> pnssb10 }{}
\DeclareFontShape{OT1}{pss}{m}{sl}{
   <5> <6> <7> <8> <9> <10> <10.95> <12>
   <14.4> <17.28> <20.74> <24.88> pnssi10 }{}
\DeclareFontShape{OT1}{pss}{m}{it}{ <-> sub * pss/m/sl }{}
%</pss>
%    \end{macrocode}
%
% \section{A driver for this document}
%
% The next bit of code contains the documentation driver file for
% \TeX{}, i.e., the file that will produce the documentation you are
% currently reading. It will be extracted from this file by the 
% \dst{} program.
%    \begin{macrocode}
%<*driver>
\documentclass{ltxdoc}

\DisableCrossrefs

 %\OnlyDescription  % comment out for implementation details

\begin{document}
   \DocInput{pandora.dtx}
\end{document}
%</driver>
%    \end{macrocode}
%
%
%    The next line goes into all files and in addition prevents \dst{}
%    from adding any further code from the main source file (such as a
%    character table.
%    \begin{macrocode}
\endinput
%    \end{macrocode}
%
% \Finale
%
%
%% \CharacterTable
%%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%%   Digits        \0\1\2\3\4\5\6\7\8\9
%%   Exclamation   \!     Double quote  \"     Hash (number) \#
%%   Dollar        \$     Percent       \%     Ampersand     \&
%%   Acute accent  \'     Left paren    \(     Right paren   \)
%%   Asterisk      \*     Plus          \+     Comma         \,
%%   Minus         \-     Point         \.     Solidus       \/
%%   Colon         \:     Semicolon     \;     Less than     \<
%%   Equals        \=     Greater than  \>     Question mark \?
%%   Commercial at \@     Left bracket  \[     Backslash     \\
%%   Right bracket \]     Circumflex    \^     Underscore    \_
%%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%%   Right brace   \}     Tilde         \~}