README for MacFont 1.1                                         20 Aug 1993

This is a beta test release.

No warranty of any kind is offered with this software.  See the file `COPYING'
for more information.

MacFont converts Macintosh Type 1 fonts into standard ASCII format.  In order
to use MacFont, you must transfer the `resource forks' of the Macintosh font
onto your PC or workstation.  This can generally be accomplished by archiving
the font on the Macintosh and extracting the archive with `macunpack' or a
similar non-Mac tool on your workstation.

MacFont creates PFA files from the `POST' resource and AFM files from the FOND
resource(s).  It can also create BDF files from the NFNT resource(s).  The AFM
and BDF files will be named appropriately based upon the font name extracted
from the FOND resource.  If your file system cannot create long names, use the
`-s' option to name the AFM files sequentially and the BDF files with short
names.  The PFA file name must be specified with the -p option.  Note: the
FontName, FontFullName, and FamilyName in the AFM file may not match the
corresponding lines in the PFA file.  You should edit one or the other to make
them the same. 

Note: starting with version 1.1, there are no default output files.  In version
1.0, if you didn't specify -a or -p, you got both.  That is no longer the
case.

Options supported by v1.1:

 -a        Extract AFM files from FOND resources

 -b        Extract BDF files from NFNT resources

 -p file   Extract a PFA file from the POST resources.  The PFA file will
           have the name `file'.

 -d        Dump the Mac resource data.  This is basically a debugging option.

 -e file   Load the encoding vector from `file'.  The encoding vector is
           a plain text file with 256 names, one per line.  These names will
	   be used in the AFM file.  If the `-d' option is used, the encoding 
	   vector actually loaded will be displayed on the screen.   

 -E name   Change EncodingScheme name in AFM file.  The default scheme is
           `AppleStandard'.  If you specify an encoding file with `-e', the
	   default scheme name becomes `FontSpecific'.  In either case, you
	   can specify a particular name with `-E'.

 -s        Extract AFM files with sequential names.  Rather than using the
           font name from the FOND resource, use the names `macfont.1', 
	   `macfont.2', etc.

 -w wght   Change Weight to `wght' in the AFM file.  The default weight is
           `Normal'.

Please report any problems that you have to Norman Walsh <walsh@cs.umass.edu>.

                                                  Be seeing you...
                                                    norm