![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to download.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10no / cmd / post.src / download|
Return to download.1 CVS log | Up to [Research Unix] / researchv10no / cmd / post.src / download |
1.1 root 1: .ds dH /usr/lib/font/postscript
2: .TH DOWNLOAD 1 "DWB 3.2"
3: .SH NAME
4: download \- host-resident PostScript font download
5: .SH SYNOPSIS
6: \*(mBdownload\f1
7: .OP "" options []
8: .OP "" files []
9: .SH DESCRIPTION
10: .B download
11: prepends host-resident fonts to
12: .I files
13: and writes the results on the standard output.
14: If no
15: .I files
16: are specified, or if
17: .OP \-
18: is one of the input
19: .IR files ,
20: the standard input is read.
21: .B download
22: assumes the input
23: .I files
24: are a single PostScript job and that requested fonts
25: can be included at the start of each input
26: .IR file .
27: The following
28: .I options
29: are understood:
30: .TP 1.0i
31: .OP \-f
32: Force a complete scan of each input
33: .I file.
34: In the absence of an explicit comment pointing
35: .I download
36: to the end of the file, the default scan stops
37: immediately after the PostScript header comments.
38: .TP 1.0i
39: .OP \-m name
40: Use
41: .I name
42: as the font map table.
43: A
44: .I name
45: that begins with
46: .MW /
47: is the full pathname of the
48: map table.
49: Otherwise
50: .I name
51: is relative to the host font directory.
52: .TP 1.0i
53: .OP \-p printer
54: Read the printer-resident font list from file
55: .br
56: .MI /etc/lp/printers/ printer /residentfonts \f1.
57: .br
58: Fonts named in this file will not be downloaded.
59: The
60: .OP \-p
61: option is for use with Unix 4.0 lp.
62: Other spoolers should use the
63: .OP \-r
64: option.
65: .TP 1.0i
66: .OP \-r file
67: Read the list of printer-resident fonts from
68: .I file.
69: Fonts named in this file will not be downloaded.
70: .TP 1.0i
71: .OP \-H dir
72: Use
73: .I dir
74: as the host font directory.
75: The default is
76: .MR \*(dH .
77: .TP 1.0i
78: .OP \-T dir
79: Use
80: .I dir
81: as the temporary file directory.
82: Only used to make a copy of standard input.
83: By default
84: .I dir
85: is set to
86: .MR /tmp .
87: .PP
88: Requested fonts are named in a
89: .MW %%DocumentFonts:
90: comment in the input
91: .IR files .
92: Available fonts are the ones listed in the map table
93: selected using the
94: .OP \-m
95: option.
96: .PP
97: The map table consists of fontname\-filename pairs.
98: The fontname is the full name of the PostScript font,
99: exactly as it would appear in a
100: .MW %%DocumentFonts:
101: comment.
102: The filename is the pathname of the host resident font.
103: A filename that begins with a
104: .MW /
105: is used as is,
106: otherwise the pathname is relative to the host font
107: directory.
108: Comments are introduced by
109: .MW %
110: (as in PostScript) and
111: extend to the end of the line.
112: .PP
113: The only candidates for downloading are fonts listed
114: in the map table that point
115: .B download
116: to readable files.
117: A font is downloaded at most once per job.
118: Requests for unlisted fonts or inaccessible files
119: are ignored.
120: All requests are ignored if the map table can't be read.
121: .SH EXAMPLES
122: A map table used to control the downloading
123: of the Bookman font family might be,
124: .EX -1
125: %
126: % The first string is the full PostScript font name. The second string
127: % is the file name - relative the host font directory unless it begins
128: % with a /.
129: %
130:
131: Bookman-Light KR
132: Bookman-LightItalic KI
133: Bookman-Demi KB
134: Bookman-DemiItalic KX
135: .EE
136: Use file
137: .MW myprinter
138: (in the default host font directory) as the
139: map table:
140: .EX
141: download -m myprinter \f2file
142: .EE
143: Set the host font directory to
144: .MW /tmp/font
145: and use
146: .MW /tmp/font/xxx
147: as the map table:
148: .EX
149: download -H /tmp/font -mxxx \f2file
150: .EE
151: .SH DIAGNOSTICS
152: 0 exit status is returned if
153: .I files
154: were successfully processed.
155: .SH BUGS
156: .B download
157: should be part of a more general program.
158: .PP
159: .B download
160: does not look for
161: .MW %%PageFonts:
162: comments
163: and there is no way to force multiple downloads of
164: a particular font.
165: .PP
166: Using full pathnames, either in map tables or for the map table
167: name, is not often recommended.
168: .SH SEE ALSO
169: .BR dpost (1),
170: .BR postdaisy (1),
171: .BR postdmd (1),
172: .BR postio (1),
173: .BR postmd (1),
174: .BR postprint (1),
175: .BR posttek (1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.