psfonts.1 (2352B)
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)