download(1)

NAME

     download - host resident PostScript font downloader

SYNOPSIS

     download   [-f]   [-p printer]   [-m name]    [-H directory]
     [file...]

     /usr/lib/lp/postscript/download

DESCRIPTION

     download prepends host resident fonts to  files  and  writes
     the  results  on the standard output. If no files are speci-
     fied, 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.

     Requested fonts are named in a comment (marked with  %%Docu-
     mentFonts:) 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-file pairs. The  fontname
     is the full name of the PostScript font, exactly as it would
     appear in a %%DocumentFonts: comment. The file is the  path-
     name  of the host resident font. A file 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 not be read.

OPTIONS

     -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  immedi-
           ately after the PostScript header comments.

     -p printer
           Check  the   list   of   printer-resident   fonts   in
           /etc/lp/printers/printer/residentfonts   before  down-
           loading.

     -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  path-
           name of the host font directory.

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

EXAMPLES

     Example 1: Examples of the download command.

     The following  map table could be used to control the  down-
     loading 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:

     example% download -m myprinter/map file

EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     non-zero
           An error occurred.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWpsf                     |
    |_____________________________|_____________________________|

SEE ALSO

     dpost(1), postdaisy(1),  postdmd(1),  postio(1),  postmd(1),
     postprint(1), posttek(1), attributes(5)

NOTES

     The download program should be part of a more  general  pro-
     gram.

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

     Using full pathnames in either map tables or  the  names  of
     map tables is not recommended.