1 058b0118 2005-01-03 devnull .TH PSFONTS 1
  2 058b0118 2005-01-03 devnull .SH NAME
  3 058b0118 2005-01-03 devnull psfonts, psdownload \- add necessary fonts to PostScript document for printing
  4 058b0118 2005-01-03 devnull .SH SYNOPSIS
  5 058b0118 2005-01-03 devnull .B psfonts
  6 058b0118 2005-01-03 devnull [
  7 058b0118 2005-01-03 devnull .I files ...
  8 058b0118 2005-01-03 devnull ]
  9 058b0118 2005-01-03 devnull .PP
 10 058b0118 2005-01-03 devnull .B psdownload
 11 058b0118 2005-01-03 devnull [
 12 058b0118 2005-01-03 devnull .B options
 13 058b0118 2005-01-03 devnull ]
 14 058b0118 2005-01-03 devnull [
 15 058b0118 2005-01-03 devnull .I files ...
 16 058b0118 2005-01-03 devnull ]
 17 058b0118 2005-01-03 devnull .SH DESCRIPTION
 18 058b0118 2005-01-03 devnull Plan 9's
 19 d32deab1 2020-08-16 rsc .MR troff (1)
 20 058b0118 2005-01-03 devnull and
 21 d32deab1 2020-08-16 rsc .MR tr2post (1)
 22 058b0118 2005-01-03 devnull use non-standard PostScript fonts
 23 058b0118 2005-01-03 devnull (found in
 24 c3674de4 2005-01-11 devnull .BR \*9/postscript/font ).
 25 058b0118 2005-01-03 devnull Before sending PostScript output from
 26 058b0118 2005-01-03 devnull .I tr2post
 27 058b0118 2005-01-03 devnull to a standard printer, code implementing
 28 058b0118 2005-01-03 devnull the non-standard fonts must be added to the PostScript.
 29 058b0118 2005-01-03 devnull .PP
 30 058b0118 2005-01-03 devnull .I Psfonts
 31 058b0118 2005-01-03 devnull copies 
 32 058b0118 2005-01-03 devnull .I files
 33 058b0118 2005-01-03 devnull (or standard input)
 34 058b0118 2005-01-03 devnull to standard output, adding necessary PostScript fonts.
 35 058b0118 2005-01-03 devnull .PP
 36 058b0118 2005-01-03 devnull .I Psdownload
 37 058b0118 2005-01-03 devnull is the more general program used to implement
 38 058b0118 2005-01-03 devnull .IR psfonts .
 39 058b0118 2005-01-03 devnull The options are:
 40 058b0118 2005-01-03 devnull .TP
 41 058b0118 2005-01-03 devnull .BI -c " comment
 42 058b0118 2005-01-03 devnull Expect the fonts used in the document to be listed in
 43 058b0118 2005-01-03 devnull a comment beginning with this string
 44 058b0118 2005-01-03 devnull (default
 45 058b0118 2005-01-03 devnull .BR %%DocumentFonts: ).
 46 058b0118 2005-01-03 devnull .TP
 47 058b0118 2005-01-03 devnull .BI -f " atend
 48 058b0118 2005-01-03 devnull Expect extra fonts comments at the end of the document,
 49 058b0118 2005-01-03 devnull so read the entire input before starting output
 50 058b0118 2005-01-03 devnull (by default this only happens if a
 51 058b0118 2005-01-03 devnull .B %%DocumentFonts:
 52 058b0118 2005-01-03 devnull .B (atend)
 53 058b0118 2005-01-03 devnull comment is encountered).
 54 058b0118 2005-01-03 devnull .TP
 55 058b0118 2005-01-03 devnull .BI -m " mapfile
 56 058b0118 2005-01-03 devnull Use
 57 058b0118 2005-01-03 devnull .I mapfile
 58 058b0118 2005-01-03 devnull to translate from PostScript font names to files.
 59 058b0118 2005-01-03 devnull Each line in the map has two white space-separated
 60 058b0118 2005-01-03 devnull fields: a font name and the corresponding file.
 61 058b0118 2005-01-03 devnull If
 62 058b0118 2005-01-03 devnull .I mapfile
 63 058b0118 2005-01-03 devnull is not a rooted path, it is evaluated relative to the
 64 058b0118 2005-01-03 devnull .I fontdir
 65 058b0118 2005-01-03 devnull (see
 66 058b0118 2005-01-03 devnull .B -H
 67 058b0118 2005-01-03 devnull below).
 68 058b0118 2005-01-03 devnull .TP
 69 058b0118 2005-01-03 devnull .BI -p " printer
 70 058b0118 2005-01-03 devnull Set the name of the printer.
 71 058b0118 2005-01-03 devnull This option is deprecated.  Its only effect is to override the
 72 058b0118 2005-01-03 devnull .B -r
 73 058b0118 2005-01-03 devnull option, causing
 74 058b0118 2005-01-03 devnull .IB fontdir /printers/ printer
 75 058b0118 2005-01-03 devnull to be used as the resident fonts list.
 76 058b0118 2005-01-03 devnull .TP
 77 058b0118 2005-01-03 devnull .BI -r " residentfonts
 78 058b0118 2005-01-03 devnull Read a list of fonts assumed to be on the printer
 79 058b0118 2005-01-03 devnull (not necessary to re-download) from the file
 80 058b0118 2005-01-03 devnull .IR residentfonts .
 81 058b0118 2005-01-03 devnull If
 82 058b0118 2005-01-03 devnull .I residentfonts
 83 058b0118 2005-01-03 devnull is not a rooted path, it is evaluated relative to the
 84 058b0118 2005-01-03 devnull .I fontdir
 85 058b0118 2005-01-03 devnull (see
 86 058b0118 2005-01-03 devnull .B -H
 87 058b0118 2005-01-03 devnull below).
 88 058b0118 2005-01-03 devnull .TP
 89 058b0118 2005-01-03 devnull .BI -H " fontdir
 90 058b0118 2005-01-03 devnull Set the directory that is assumed to contain the PostScript fonts
 91 058b0118 2005-01-03 devnull and information about printers
 92 058b0118 2005-01-03 devnull (see
 93 058b0118 2005-01-03 devnull .BR -m ,
 94 058b0118 2005-01-03 devnull .BR -p ,
 95 058b0118 2005-01-03 devnull and
 96 058b0118 2005-01-03 devnull .B -r
 97 058b0118 2005-01-03 devnull above;
 98 058b0118 2005-01-03 devnull default
 99 c3674de4 2005-01-11 devnull .BR \*9/postscript/font ).
100 058b0118 2005-01-03 devnull .TP
101 058b0118 2005-01-03 devnull .BI -T " tmpdir
102 058b0118 2005-01-03 devnull Use
103 058b0118 2005-01-03 devnull .I tmpdir
104 058b0118 2005-01-03 devnull for storing temporary files
105 058b0118 2005-01-03 devnull (default
106 058b0118 2005-01-03 devnull .BR /var/tmp ).
107 058b0118 2005-01-03 devnull .B 
108 058b0118 2005-01-03 devnull .TP
109 058b0118 2005-01-03 devnull .BI -D
110 058b0118 2005-01-03 devnull Produce copious amounts of debugging information on standard error.
111 058b0118 2005-01-03 devnull .TP
112 058b0118 2005-01-03 devnull .BI -I
113 058b0118 2005-01-03 devnull Continue running even after fatal errors occur.
114 058b0118 2005-01-03 devnull .PD
115 058b0118 2005-01-03 devnull .SH EXAMPLE
116 058b0118 2005-01-03 devnull See
117 d32deab1 2020-08-16 rsc .MR tr2post (1)
118 058b0118 2005-01-03 devnull for an example.
119 058b0118 2005-01-03 devnull .SH SOURCE
120 c3674de4 2005-01-11 devnull .B \*9/bin/psfonts
121 058b0118 2005-01-03 devnull .br
122 c3674de4 2005-01-11 devnull .B \*9/src/cmd/postscript/download
123 058b0118 2005-01-03 devnull .SH SEE ALSO
124 d32deab1 2020-08-16 rsc .MR troff (1) ,
125 d32deab1 2020-08-16 rsc .MR tr2post (1)