DOWNLOAD(1)         RISC/os Reference Manual          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 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. 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
               Check the list of printer-resident fonts in
               /etc/lp/printers/printer/residentfonts before
               downloading.

     -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 direc-
               tory.

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



                        Printed 11/19/92                   Page 1

DOWNLOAD(1)         RISC/os Reference Manual          DOWNLOAD(1)



EXAMPLES
     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:

          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 pro-
     gram.

     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                 Printed 11/19/92