download(1)     UNIX System V(Line Printer Spooling Utilities)      download(1)


NAME
      download - host resident PostScript font downloader

SYNOPSIS
      download [options] [files]

DESCRIPTION
      download prepends host resident fonts to files and writes the results on
      the standard output.  If no files are specified, or if - is one of the
      input files, the standard input is read.  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.  The following options are
      understood:

      -f          Force a complete scan of each input file.  In the absence of
                  an explicit comment pointing download to the end of the file,
                  the default scan stops immediately after the PostScript
                  header comments.

      -p printer  Before downloading, check the list of printer-resident fonts
                  in /etc/lp/printers/printer/residentfonts.

      -m name     Use name as the font map table.  A name that begins with / is
                  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/lib/lp/postscript.

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

      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
      %%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 relative to the host font directory.  Comments are
      introduced by % (as in PostScript) and extend to the end of the 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 can't be read.

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





10/89                                                                    Page 1

download(1)     UNIX System V(Line Printer Spooling Utilities)      download(1)


        %
        % 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

DIAGNOSTICS
      An exit status of 0 is returned if files were successfully processed.

NOTES
      The download program 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.

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
























Page 2                                                                    10/89