download(1)                    DG/UX R4.11MU05                   download(1)


NAME
       download - download host resident PostScript fonts

SYNOPSIS
       /usr/lib/lp/postscript/download [-f] [-p printer] [-m name] [-H dir]
       [file] ...

   where:
       printer   The (directory) name for a particular printer.
       name      A font map table.
       dir       The host font directory.
       file      A PostScript input file.

DESCRIPTION
       download prepends needed host resident fonts to each input file and
       writes the results on the standard output.  If no file is specified,
       or if - is given for any file argument, download reads from its
       standard input.  download assumes the input files make up a single
       PostScript job, and that requested fonts can be included at the start
       of each input file.

       Options are:

       -f        Force a complete scan of each input file.  Without the -f
                 option, the default scan stops immediately after the
                 PostScript header comments, unless the following explicit
                 comment appears in the header to point download to the end
                 of the file:

                      %%DocumentFonts: (atend)

       -p printer
                 Check the list of printer-resident fonts in
                 /etc/lp/printers/printer/residentfonts before downloading.
                 Any fonts found in this list are assumed to be on the
                 printer already.

       -m name   Use name as the font map table.  A name that begins with /
                 is taken as the full pathname of the map table and is used
                 as is.  Otherwise name is appended to the pathname of the
                 host font directory.

       -H dir    Use dir as the host font directory.  The default is
                 /usr/share/lib/hostfontdir.

       Requested fonts are named in a comment (marked with %%DocumentFonts:)
       in the input files.  Available fonts are listed in the map table
       selected using the -m option.

       The map table consists of space-separated fontname-filename pairs.
       The fontname is the full name of the PostScript font, exactly as it
       would appear in a %%DocumentFonts: comment.  The filename is the
       pathname of the host resident font.  A filename that begins with a /
       is used as is.  Otherwise the pathname is assumed to be relative to
       the host font directory.  Blank lines and comments are allowed in the
       map table file.  Comments are introduced by % (as in PostScript) and
       extend to the end of the current line.

       The only candidates for downloading are fonts listed in the map table
       that point download to readable files.  A font is downloaded once, at
       most.  Requests for unlisted fonts or inaccessible files are ignored.
       All requests are ignored if the map table cannot be read.

EXAMPLES
       The following map table could be used to control the downloading of
       the Bookman font family:

         %
         % The first string is the full PostScript font name.
         % The second string is the file name - relative to
         % the host font directory unless it begins with a /.
         %

           Bookman-Light            bookman/light
           Bookman-LightItalic      bookman/lightitalic
           Bookman-Demi             bookman/demi
           Bookman-DemiItalic       bookman/demiitalic


       Using the file myprinter/map (in the default host font directory) as
       the map table, you could download fonts by issuing the following
       command:

              download -m myprinter/map file

FILES
       /usr/share/lib/hostfontdir        Default host resident font
                                         directory
       /etc/lp/printers/*/residentfonts  Host resident font tables for
                                         specific printers

DIAGNOSTICS
       An exit status of 0 is returned if each file was successfully
       processed.

SEE ALSO
       dpost(1), postdaisy(1), postdmd(1), postio(1), postmd(1),
       postprint(1), posttek(1).

NOTES
       The facilities provided by download should be part of a more general
       program.

       download does not look for %%PageFonts: comments and there is no way
       to force multiple downloads of a particular font.

       We do not recommend the use of full pathnames in either map tables or
       the names of map tables.


Licensed material--property of copyright holder(s)