.\" $Header: /usr/jjc/dvitops/RCS/psfont.1,v 1.1 89/02/01 09:20:15 jjc Rel $
.TH PSFONT L "10 December 1988"
.SH NAME
psfont \- add fonts to PostScript document
.SH SYNOPSIS
.B psfont
.SH DESCRIPTION
.LP
.B psfont
reads a PostScript document from its standard input, determines which
downloadable fonts it requires, adds those fonts to the document, and
writes the result to the standard output.
The document must comply with the Adobe Structuring Conventions.
The
.B %%DocumentFonts
comment must not use the
.B (atend)
notation.
.LP
For each font
.I font
mentioned in the
.B %%DocumentFonts
comment
.B psfont
will look for the file
.IB font .ps
in the list of directories contained in the environment variable
.SB PSFONTS
and, if it finds it, will include it in the document.
If
.SB PSFONTS
is not set, it will look in a system-dependent list of directories.
If your file system does not permit long file names,
you can use the file
.BR psfonts.map ,
which should be installed in the same directory as the fonts,
to map PostScript font names to file names.
For example, if this file contains a line
.RB ` "Times-Roman timesr" '
then
.B psfont
will look for
.B timesr.ps
instead of
.BR Times-Roman.ps.
Fonts must be in a format suitable for inclusion in the document without
any further processing.
.SH FILES
.TP
.B /usr/local/psfonts/*.ps
font files
.TP
.B /usr/local/psfonts/psfonts.map
maps PostScript names to file names
.SH BUGS
It does not understand version 2.0 of the Structuring Conventions.
.SH AUTHOR
James Clark <jjc@jclark.uucp>