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