1 files changed, 175 insertions, 0 deletions
diff --git a/static/unix-v10/man1/download.1 b/static/unix-v10/man1/download.1
new file mode 100644
index 00000000..72ff6730
--- /dev/null
+++ b/static/unix-v10/man1/download.1
@@ -0,0 +1,175 @@
+.ds dH /usr/lib/font/postscript
+.TH DOWNLOAD 1 "DWB 3.2"
+.SH NAME
+download \- host-resident PostScript font download
+.SH SYNOPSIS
+\*(mBdownload\f1
+.OP "" options []
+.OP "" files []
+.SH DESCRIPTION
+.B download
+prepends host-resident fonts to
+.I files
+and writes the results on the standard output.
+If no
+.I files
+are specified, or if
+.OP \-
+is one of the input
+.IR files ,
+the standard input is read.
+.B download
+assumes the input
+.I files
+are a single PostScript job and that requested fonts
+can be included at the start of each input
+.IR file .
+The following
+.I options
+are understood:
+.TP 1.0i
+.OP \-f
+Force a complete scan of each input
+.I file.
+In the absence of an explicit comment pointing
+.I download
+to the end of the file, the default scan stops
+immediately after the PostScript header comments.
+.TP 1.0i
+.OP \-m name
+Use
+.I name
+as the font map table.
+A
+.I name
+that begins with
+.MW /
+is the full pathname of the
+map table.
+Otherwise
+.I name
+is relative to the host font directory.
+.TP 1.0i
+.OP \-p printer
+Read the printer-resident font list from file
+.br
+.MI /etc/lp/printers/ printer /residentfonts \f1.
+.br
+Fonts named in this file will not be downloaded.
+The
+.OP \-p
+option is for use with Unix 4.0 lp.
+Other spoolers should use the
+.OP \-r
+option.
+.TP 1.0i
+.OP \-r file
+Read the list of printer-resident fonts from
+.I file.
+Fonts named in this file will not be downloaded.
+.TP 1.0i
+.OP \-H dir
+Use
+.I dir
+as the host font directory.
+The default is
+.MR \*(dH .
+.TP 1.0i
+.OP \-T dir
+Use
+.I dir
+as the temporary file directory.
+Only used to make a copy of standard input.
+By default
+.I dir
+is set to
+.MR /tmp .
+.PP
+Requested fonts are named in a
+.MW %%DocumentFonts:
+comment in the input
+.IR files .
+Available fonts are the ones listed in the map table
+selected using the
+.OP \-m
+option.
+.PP
+The map table consists of fontname\-filename pairs.
+The fontname is the full name of the PostScript font,
+exactly as it would appear in a
+.MW %%DocumentFonts:
+comment.
+The filename is the pathname of the host resident font.
+A filename that begins with a
+.MW /
+is used as is,
+otherwise the pathname is relative to the host font
+directory.
+Comments are introduced by
+.MW %
+(as in PostScript) and
+extend to the end of the line.
+.PP
+The only candidates for downloading are fonts listed
+in the map table that point
+.B download
+to readable files.
+A font is downloaded at most once per job.
+Requests for unlisted fonts or inaccessible files
+are ignored.
+All requests are ignored if the map table can't be read.
+.SH EXAMPLES
+A map table used to control the downloading
+of the Bookman font family might be,
+.EX -1
+%
+% The first string is the full PostScript font name. The second string
+% is the file name - relative the host font directory unless it begins
+% with a /.
+%
+
+  Bookman-Light            KR
+  Bookman-LightItalic      KI
+  Bookman-Demi             KB
+  Bookman-DemiItalic       KX
+.EE
+Use file
+.MW myprinter
+(in the default host font directory) as the
+map table:
+.EX
+download -m myprinter \f2file
+.EE
+Set the host font directory to
+.MW /tmp/font
+and use
+.MW /tmp/font/xxx
+as the map table:
+.EX
+download -H /tmp/font -mxxx \f2file
+.EE
+.SH DIAGNOSTICS
+0 exit status is returned if
+.I files
+were successfully processed.
+.SH BUGS
+.B download
+should be part of a more general program.
+.PP
+.B download
+does not look for
+.MW %%PageFonts:
+comments
+and there is no way to force multiple downloads of
+a particular font.
+.PP
+Using full pathnames, either in map tables or for the map table
+name, is not often recommended.
+.SH SEE ALSO
+.BR dpost (1),
+.BR postdaisy (1),
+.BR postdmd (1),
+.BR postio (1),
+.BR postmd (1),
+.BR postprint (1),
+.BR posttek (1)