PSFONTS(1)                                             PSFONTS(1)

     NAME
          psfonts, psdownload - add necessary fonts to PostScript
          document for printing

     SYNOPSIS
          psfonts [ files ... ]

          psdownload [ options ] [ files ... ]

     DESCRIPTION
          Plan 9's troff(1) and tr2post(1) use non-standard PostScript
          fonts (found in /postscript/font).  Before sending
          PostScript output from tr2post to a standard printer, code
          implementing the non-standard fonts must be added to the
          PostScript.

          Psfonts copies files (or standard input) to standard output,
          adding necessary PostScript fonts.

          Psdownload is the more general program used to implement
          psfonts. The options are:

          -c comment
               Expect the fonts used in the document to be listed in a
               comment beginning with this string (default
               %%DocumentFonts:).

          -f atend
               Expect extra fonts comments at the end of the document,
               so read the entire input before starting output (by
               default this only happens if a %%DocumentFonts: (atend)
               comment is encountered).

          -m mapfile
               Use mapfile to translate from PostScript font names to
               files.  Each line in the map has two white space-
               separated fields: a font name and the corresponding
               file.  If mapfile is not a rooted path, it is evaluated
               relative to the fontdir (see -H below).

          -p printer
               Set the name of the printer.  This option is depre-
               cated.  Its only effect is to override the -r option,
               causing fontdir/printers/printer to be used as the res-
               ident fonts list.

          -r residentfonts
               Read a list of fonts assumed to be on the printer (not
               necessary to re-download) from the file residentfonts.
               If residentfonts is not a rooted path, it is evaluated

     PSFONTS(1)                                             PSFONTS(1)

               relative to the fontdir (see -H below).

          -H fontdir
               Set the directory that is assumed to contain the
               PostScript fonts and information about printers (see
               -m, -p, and -r above; default /postscript/font).

          -T tmpdir
               Use tmpdir for storing temporary files (default
               /var/tmp).

          -D   Produce copious amounts of debugging information on
               standard error.

          -I   Continue running even after fatal errors occur.

     EXAMPLE
          See tr2post(1) for an example.

     SOURCE
          /bin/psfonts
          /src/cmd/postscript/download

     SEE ALSO
          troff(1), tr2post(1)