![[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 / postscript / download|
Return to download.1 CVS log | Up to [Research Unix] / researchv10no / cmd / postscript / 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: \fBdownload\f1
7: .BI "" options []
8: .BI "" 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: .BI \-
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: .BI \-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: .BI \-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: .BI \-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 are printer-resident and
59: will not be downloaded.
60: .TP 1.0i
61: .BI \-H dir
62: Use
63: .I dir
64: as the host font directory.
65: The default is
66: .MR \*(dH .
67: .TP 1.0i
68: .BI \-T dir
69: Use
70: .I dir
71: as the temporary file directory.
72: Only used to make a copy of standard input.
73: By default
74: .I dir
75: is set to
76: .MR /tmp .
77: .PP
78: Requested fonts are named in a
79: .MW %%DocumentFonts:
80: comment in the input
81: .IR files .
82: Available fonts are the ones listed in the map table
83: selected using the
84: .BI \-m
85: option.
86: .PP
87: The map table consists of fontname\-filename pairs.
88: The fontname is the full name of the PostScript font,
89: exactly as it would appear in a
90: .MW %%DocumentFonts:
91: comment.
92: The filename is the pathname of the host resident font.
93: A filename that begins with a
94: .MW /
95: is used as is,
96: otherwise the pathname is relative to the host font
97: directory.
98: Comments are introduced by
99: .MW %
100: (as in PostScript) and
101: extend to the end of the line.
102: .PP
103: The only candidates for downloading are fonts listed
104: in the map table that point
105: .B download
106: to readable files.
107: A font is downloaded at most once.
108: Requests for unlisted fonts or inaccessible files
109: are ignored.
110: All requests are ignored if the map table can't be read.
111: .SH EXAMPLES
112: A map table used to control the downloading
113: of the Bookman font family might be,
114: .EX -1
115: %
116: % The first string is the full PostScript font name. The second string
117: % is the file name - relative the host font directory unless it begins
118: % with a /.
119: %
120:
121: Bookman-Light KR
122: Bookman-LightItalic KI
123: Bookman-Demi KB
124: Bookman-DemiItalic KX
125: .EE
126: Use file
127: .MW myprinter
128: (in the default host font directory) as the
129: map table:
130: .EX
131: download -m myprinter \f2file
132: .EE
133: Set the host font directory to
134: .MW /tmp/font
135: and use
136: .MW /tmp/font/xxx
137: as the map table:
138: .EX
139: download -H /tmp/font -mxxx \f2file
140: .EE
141: .SH DIAGNOSTICS
142: 0 exit status is returned if
143: .I files
144: were successfully processed.
145: .SH BUGS
146: .B download
147: should be part of a more general program.
148: .PP
149: .B download
150: does not look for
151: .MW %%PageFonts:
152: comments
153: and there is no way to force multiple downloads of
154: a particular font.
155: .PP
156: Using full pathnames, either in map tables or for the map table
157: name, is not often recommended.
158: .SH SEE ALSO
159: .BR dpost (1),
160: .BR postdaisy (1),
161: .BR postdmd (1),
162: .BR postio (1),
163: .BR postmd (1),
164: .BR postprint (1),
165: .BR posttek (1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.