============================================================
                      mathpple  v0.97
      Mathematical typesetting with the Palatino fonts
============================================================
                                              Walter Schmidt
                                            <wschmi@ibm.net>
                                                  1999-01-07


------------------------------------------------------------
This is a preliminary test version.  Please, report bugs or
problems to the above address!
------------------------------------------------------------


The LaTeX macro package `mathpple' defines the PostScript
font family `Palatino' (ppl) as the default roman font and
will use the `mathpple' fonts for typesetting math.  These
virtual fonts have been create for typesetting math in a 
style that suits the Palatino text fonts.

The mathpple fonts make use of the CM, Adobe Symbol and
Euler fonts as far as the required glyphs are not provided
in Palatino.  The AMS fonts, when used additionally, will be
scaled to fit Palatino.

The current distribution comprises the package mathpple.sty,
the mathpple virtual fonts, and .fd files for scaling the
font family Helvetica to suit Palatino, too.  The fontinst
sources of the mathpple fonts are icnliuded, too.

Additionally, the Euler fonts are required in PostScript
(Type1) format, which are available from he CTAN -- see
below.



============================================================
                        Installation
============================================================

The names of the fonts and fonts families do not collide
with the older `mathppl' fonts; both may be installed in
parallel.

* Copy all files from latex/ to a directory where LaTeX
  searches for style files.  In a TDS compliant system this
  should be 
             texmf/tex/latex/mathpple
  
* Copy all files from tfm/ to a directory where TeX searches
  for font metrics.  In a TDS compliant system this should
  be
             texmf/fonts/tfm/public/mathpple
  
* Copy all files from vf/ to a directory where dvips
  searches for virtual fonts.  In a TDS compliant system
  this should be
             texmf/fonts/vf/public/mathpple

* The Euler fonts must be provided in Type 1 (PostScript)
  format.  In the CTAN you can find them in the archive
  fonts/amsfonts/ps-type1/amsps-pc.zip . Copy at least the
  files
             eurm10.pfb 
             eurb10.pfb 
  to a directory where dvips searches for PostScript fonts.
  In a TDS compliant system this should be
             texmf/fonts/type1/ams/euler 
             
  ( The mathpple fonts have been tested with these Type1
  versions of the Euler fonts provided by the AMS.  Besides,
  the BaKoMa distribution of Type1 fonts, too, comprises
  Euler. )
  
* Copy the file dvips/mathpple.map to a directory where
  dvips keeps its map files; make dvips read this file, too.
  In case you have installed _all_ the Type1 fonts from the
  AMS distribution, dvips must read both this file
  mathpple.map and the map file psfonts.amz which is part of
  the AMS distribution.

The directory fontinst/ contains the fontinst sources of the
virtual fonts.  You need these files only in case you want
to rebuild or modify the fonts.



============================================================
                           Usage
============================================================

Load the package as usual:

        \usepackage{mathpple}
        
This will make the font family `ppl' (Adobe Palatino) the
default roman family, and `zpple' (the mathhpple fonts) will
be used for math.

Only the following fonts will be used beside Palatino:
eurm10, eurb10, cmr10, cmbx10, cmmi10, cmmib10, cmsy10,
cmbsy10, cmex10, Adobe Symbol.  All are available in Type1
format, so that one can create documents which do not
require any bitmap fonts.


Package options
---------------
[slantedGreek]  Uppercase Greek will be typset slanted, too.


New commands
------------
* The package defines a new command \mathbold to typeset
math variables, incl.  greek, in a slanted boldface style,
e.g:

         \mathbold{k}
         
(\mathbold is a so-called `math alphabet'.)

* Regardless of the option `slantedGreek' the commands

        \upDelta 
        \upOmega 

always provide an upright \Delta and \Omega.


Selecting the font encoding
---------------------------
mathpple.sty does NOT change the default output font
encoding from OT1.  It is, however, recommended to use 
PostScript fonts in the extended T1 and TS1 (text 
symbols) encodings.  This is enabled by the following
commands:

        \usepackage[T1]{fontenc}
        \usepackage{textcomp}
        
  
Selecting a suitable sans serif font
------------------------------------
mathpple.sty does NOT change the default sans serif font
which is used for \sffamily and \textsf.  In case you want
Helvetica to be used instead of CM Sans, do NOT load the
package helvet.sty, bacause Helvetica is slightly larger
than Palatino when used at the same nominal size

The distribution contains .fd files for a font family named
'phvv', which is indeed Helvetica, scaled down to 95%.  You
can use this font family as the default sans serif one by
redefining the macro \sfdefault:

        \renewcommand{\sfdefault}{phvv}
        
Caution:  `phvv' is defined for the T1 and TS1 encodings 
only.

(Please, note that `phvv' can be used regardless of the
mathpple package, of course!)


Selecting a typewriter font
---------------------------
The package mathpple does not change the default typewriter 
font from `cmtt'.  In order to specify a different one, e.g. 
`pcr' (Adobe Courier), just redefine the macro \ttdefault:

        \renewcommand{\ttdefault}{pcr}
        

Using the AMS fonts
-------------------
The AMS fonts, when used in conjunction with mathpple.sty,
will automatically be scaled to fit Palatino.  Do NOT
specify the option [psamsfonts] when loading amsfonts.sty or
amssymb.sty!  Yet the package mathpple ensures that the AMS
fonts will be loaded at those design sizes only, which are
provided in Type1 format, too.


Calligraphic alphabet
---------------------
The package mathpple does not change the \mathcal alphabet
from CM Symbol.  A special package like calrsfs or euscript
must be loadeded additionally in order to use a different
font for this purpose.



============================================================
                Known bugs and deficiencies
============================================================

* the \coprod symbol is not available.

* There is no boldface version of the \partial symbol.
  
* Positioning of accents on upright Greek capitals could be
  better.  Since there is no \skewchar defined for the
  `operators' font, I don't know how to fix that.
  


============================================================
              Credits, where credits are due!
============================================================

The mathpple fonts are based on fontinst scripts by Aloysius
Helminck which were distributed in conjunction with fontinst
v1.335, but are no longer available from the CTAN.  The main
changes with regard to Helminck's model are:

* italic Greek letters from the Euler fonts;
* \mathcal from CM instead of Zapf Chancery;
* positioning of math accents substantially improved;
* improved spacing;
* cmex9 isn't used any more, because there is no Type1
  version of this font in the AMS distribution.

Special thanks also to Daniel Schlieper, who proposed the
project, wrote the very first version of the style file,
contributed many good ideas and helped me with testing.


-- finis

