1download(1) User Commands download(1)
2
3
4
6 download - host resident PostScript font downloader
7
9 download [-f] [-p printer] [-m name] [-H directory]
10 [file]...
11
12
13 /usr/lib/lp/postscript/download
14
15
17 download prepends host resident fonts to files and writes the results
18 on the standard output. If no files are specified, or if − is one of
19 the input files, the standard input is read. download assumes the input
20 files make up a single PostScript job and that requested fonts can be
21 included at the start of each input file.
22
23
24 Requested fonts are named in a comment (marked with %%DocumentFonts:)
25 in the input files. Available fonts are the ones listed in the map ta‐
26 ble selected using the -m option.
27
28
29 The map table consists of fontname−file pairs. The fontname is the full
30 name of the PostScript font, exactly as it would appear in a %%Docu‐
31 mentFonts: comment. The file is the pathname of the host resident font.
32 A file that begins with a / is used as is. Otherwise the pathname is
33 relative to the host font directory. Comments are introduced by % (as
34 in PostScript) and extend to the end of the line.
35
36
37 The only candidates for downloading are fonts listed in the map table
38 that point download to readable files. A font is downloaded once, at
39 most. Requests for unlisted fonts or inaccessible files are ignored.
40 All requests are ignored if the map table can not be read.
41
43 -f Force a complete scan of each input file. In the
44 absence of an explicit comment pointing download to the
45 end of the file, the default scan stops immediately
46 after the PostScript header comments.
47
48
49 -p printer Check the list of printer-resident fonts in
50 /etc/lp/printers/printer/residentfonts before download‐
51 ing.
52
53
54 -m name Use name as the font map table. A name that begins with
55 / is the full pathname of the map table and is used as
56 is. Otherwise name is appended to the pathname of the
57 host font directory.
58
59
60 -H directory Use dir as the host font directory. The default is
61 /usr/lib/lp/postscript.
62
63
65 Example 1 Examples of the download command.
66
67
68 The following map table could be used to control the downloading of
69 the Bookman font family:
70
71
72 %
73 % The first string is the full PostScript font name. The second string
74 % is the file name - relative to the host font directory unless it begins
75 % with a /.
76 %
77 Bookman-Light bookman/light
78 Bookman-LightItalic bookman/lightitalic
79 Bookman-Demi bookman/demi
80 Bookman-DemiItalic bookman/demiitalic
81
82
83
84
85 Using the file myprinter/map (in the default host font directory) as
86 the map table, you could download fonts by issuing the following com‐
87 mand:
88
89
90 example% download -m myprinter/map file
91
92
93
95 The following exit values are returned:
96
97 0 Successful completion.
98
99
100 non-zero An error occurred.
101
102
104 See attributes(5) for descriptions of the following attributes:
105
106
107
108
109 ┌─────────────────────────────┬─────────────────────────────┐
110 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
111 ├─────────────────────────────┼─────────────────────────────┤
112 │Availability │SUNWpsf │
113 └─────────────────────────────┴─────────────────────────────┘
114
116 dpost(1), postdaisy(1), postdmd(1), postio(1), postmd(1), postprint(1),
117 posttek(1), attributes(5)
118
120 The download program should be part of a more general program.
121
122
123 download does not look for %%PageFonts: comments and there is no way to
124 force multiple downloads of a particular font.
125
126
127 Using full pathnames in either map tables or the names of map tables is
128 not recommended.
129
130
131
132SunOS 5.11 9 Sep 1996 download(1)