This is the README for the `mflogo' package by Ulrik Vieth.
-----------------------------------------------------------

DESCRIPTION:
The `mflogo' package provides a font definition file and a little
package file for LaTeX2e to access the logo fonts in terms of NFSS.
Once you have installed the font definition file provided in this
package, it is possible to access the logo fonts using NFSS-commands,
even if you do not want to use the package file provided here.

The package file defines font changing commands \logofamily and
\textlogo as well as commands \MF and \MP for the METAFONT and
METAPOST logos. The latter requires an up-to-date version of the
logo fonts that includes the letters `P' and `S'.


REQUIREMENTS:
It is assumed that you have the standard logo fonts available from
/systems/knuth/lib. Some additional METAFONT sources are provided
as part of this package in order to ensure that the logo fonts will
be available in a reasonably orthogonal range of sizes and shapes.
Optionally, some additional variants of the logo fonts available
from /systems/knuth/local/lib are also supported, but they are not
required. See the section INSTALLATION PROCEDURE for more details.


CONTENTS OF THE DISTRIBUTION:
This distribution consists of the following files that should be
located in the directory /macros/latex2e/contrib/supported/mflogo:

mflogo.readme   - this README file
mflogo.ins      - installation script for LaTeX2e
mflogo.dtx      - documented sources for LaTeX2e
logosl9.mf      - METAFONT source file, also available from
                  the directory /systems/knuth/local/lib
logosl8.mf      - METAFONT source file, adapted from logosl9

Running the installation script mflogo.ins through LaTeX2e will
produce the following files:

Ulogo.fd        - font definition file for LaTeX2e
mflogo.sty      - example package file for LaTeX2e
mflogo.drv      - documentation driver for LaTeX2e

Before you proceed, please read the section INSTALLATION PROCEDURE
which explains how to install the required fonts *before* running
the installation script through LaTeX2e. Different versions of the
font definition file will be generated, depending on whether you
have installed the addtional variants of the logo fonts.


INSTALLATION PROCEDURE:

1. Check that the METAFONT inputs directory of your TeX installation
   contains the files logo.mf and logo*.mf from /systems/knuth/lib.

   If so, make sure that you've got an up-to-date version of logo.mf
   and update it if necessary. (Note that this file has been updated
   by DEK as recently as 1993, thus your TeX installation may still
   contain an old version.)

   Otherwise, retrieve the files logo.mf and logo*.mf from the
   directory /systems/knuth/lib and install them in your METAFONT
   inputs directory.

2. Install the files logo*.mf from this directory in your METAFONT
   inputs directory as well. These fonts are provided in order
   to ensure that the logo fonts will be available in a reasonably
   orthogonal range of sizes and shapes. They are assumed to be
   present, even though they are not part of the standard fonts.

3. Optionally, if you like to install additional variants of the
   logo fonts, retrieve the file logod10.mf from the directory
   /systems/knuth/local/lib and install it in your METAFONT inputs
   directory. When running the installation script through LaTeX2e,
   you will be asked if you have this font, and different versions
   of the font definition file will be produced accordingly.

4. If you have updated the file logo.mf in step 1, you have to
   (re)generate *all* the logo fonts including the newly installed
   variants. To do so, first remove the files logo*.tfm and logo*pk
   from your TeX fonts directories and regenerate them by running
   logo*.mf through METAFONT using an appropriate local mode.

   Otherwise, i.e. if you already had an up-to-date version of logo.mf,
   it is sufficient to generate only the newly installed variants
   of the logo fonts. With some DVI-drivers, like e.g. dvips, it is
   possible to create the .pk files in the required magnifications
   automatically, but in any case you first have to generate the
   .tfm files so that TeX will find the fonts.

5. Now, after you have installed and/or updated the required fonts,
   you can run the installation script mflogo.ins through LaTeX2e.
   You will be asked if you have installed the additional font
   shapes from the directory /systems/knuth/local/lib in step 3,
   and different versions of the font definition file Ulogo.fd
   will be produced accordingly. If you get the answer wrong or
   if you change your mind, you can always redo the installation.

6. Finally, install the font definition file Ulogo.fd and the
   package file mflogo.sty in your LaTeX2e inputs directory.

7. If you want to typeset the documentation, run the documentation
   driver mflogo.drv through LaTeX2e. This requires the mflogo
   package itself since the documentation contains some examples
   of the logo fonts in various sizes and shapes. You may find
   that you have to generate additional magnifications of some
   of the logo fonts in order to print it properly.


LEGALESE:
The standard disclaimers and restrictions for LaTeX2e also apply
for this package. In particular, you are not allowed to distribute
generated files produced from this package without the accompanying
documentation. However, you are free to incorporate the code from
the example package file in your own packages without further notice
if you only want to use the font defintion file from this package.

This package is supported. Send bug reports or questions and comments
to the author's e-mail address given below. Please note that the
LaTeX3 Project Team is *not* responsible for this contributed package.


Happy TeXing,

Ulrik Vieth     E-Mail: vieth@convex.rz.uni-duesseldorf.de      94/05/21
