makepsres



MAKEPSRES(1)                                                      MAKEPSRES(1)




NAME

       makepsres - Build PostScript resource database file.



SYNOPSIS

       makepsres [ options ] directory ...



DESCRIPTION

       makepsres   creates   PostScript   language  resource  database  files.
       Resource database  files  can  be  used  to  specify  the  location  of
       resources  that  are  used  by the font selection panel and other Adobe
       software.  For a complete description of the resource location  facili-
       ties in the Display PostScript system, see Appendix A and Appendix B of
       "Display  PostScript  Toolkit  for  X"  in  Programming   the   Display
       PostScript System with X.

       makepsres  creates  a  resource database file named PSres.upr that con-
       tains all the resources in all the directory path  names  specified  on
       the command line.

          If  the  list of directories contains - , makepsres reads from stdin
          and expects a list of directories separated by space, tab,  or  new-
          line.

          If  the  list of directories is empty, it is taken to be the current
          directory.

          If all specified directories have a common initial prefix, makepsres
          extracts it as a directory prefix in the new resource database file.

       makepsres normally acts recursively; it looks  for  resource  files  in
       subdirectories  of  any specified directory. This behavior can be over-
       ridden with the command line option -nr.

       makepsres uses existing resource database files to assist in  identify-
       ing  files.  By default, makepsres creates a new resource database file
       containing all of the following that apply:

          Resource files found in the directories on the command line.

          Resource files pointed to by the  resource  database  files  in  the
          directories on the command line.

          Resource  entries  found in the input resource database files. These
          entries are copied if the files they specify  still  exist  and  are
          located in directories not specified on the command line.

       If  you run makepsres in discard mode (with the -d option), it does not
       copy resource entries from the input resource database files.  In  that
       case,  the output file consists only of entries from the directories on
       the command line.  The input resource database files are only  used  to
       assist in identifying files.

       If  you run makepsres in keep mode (with the -k option), it includes in
       the output file all resource entries in  the  input  resource  database
       files,  even  entries  for files that no longer exist or are located in
       directories specified on the command line.

       makepsres uses various heuristics to identify files. A file that is  of
       a private resource type or that does not conform to the standard format
       for a resource file must be specified in one of the following ways:

          By running makepsres in interactive mode

          By preloading the file into a resource database file used for input

          By beginning the file with the following line:

            %!PS-Adobe-3.0 Resource-<resource-type>



OPTIONS

       -o filename
              Writes the output to the specified filename.   The  construction
              "-o  -"  writes  to  stdout.  If the -o option is not specified,
              makepsres creates a PSres.upr file in the current directory  and
              writes the output to that file.

       -f filename
              Uses  information  from the specified file to assist in resource
              typing.  The file must be  in  resource  database  file  format.
              Multiple  -f  options  may be specified. The construction "-f -"
              uses stdin as an input file and may not be used if "-" is speci-
              fied as a directory on the command line.

       -dir dirname
              Specifies that dirname is a directory. Needed only in rare cases
              when dirname is the same as a command-line option such as -nb.

       -d     Specifies discard  mode.  The  resulting  output  file  consists
              solely of entries from the directories on the command line.

       -e     Marks  the  resulting  PSres.upr file as exclusive.  This option
              makes the resource location library run more  quickly  since  it
              does  not  have  to  look  for other resource database files. It
              becomes  necessary,  however,  to  run  makepsres  whenever  new
              resources are added to the directory, even if the resources come
              with their own resource database file.

       -i     Specifies interactive mode. In interactive  mode,  you  will  be
              queried  for  the  resource  type  of  any encountered file that
              makepsres cannot identify.  If -i is  not  specified,  makepsres
              assumes an unidentifiable file is not a resource file.

       -k     Specifies keep mode.

       -nb    If the output file already exists, do not back it up.

       -nr    Specifies  nonrecursive  mode.   makepsres  normally acts recur-
              sively: it looks for resource files  in  subdirectories  of  any
              specified  directory. If -nr is used, makepsres does not look in
              subdirectories for resource files.

       -p     Specifies no directory prefix.  If -p is  used,  makepsres  does
              not  try  to  find a common directory prefix among the specified
              directories.

       -q     Quiet mode: ignores  unidentifiable  files  instead  of  warning
              about them.

       -s     Specifies strict mode.  If -s is used, makepsres terminates with
              an error if it encounters a file it cannot identify.



EXAMPLES

       makepsres .
              Creates a resource database file that contains all the resources
              in the current directory.

       makepsres -i -o local.upr /usr/local/lib/ps/fonts
              Runs  makepsres  in  interactive  mode  and  creates  a resource
              database file named local.upr, which contains all the  resources
              in the directory /usr/local/lib/ps/fonts.



SEE ALSO

       Programming  the  Display PostScript System with X (Addison-Wesley Pub-
       lishing Company, Inc., 1993).



AUTHOR

       Adobe Systems Incorporated



NOTES

       PostScript and Display  PostScript  are  trademarks  of  Adobe  Systems
       Incorporated which may be registered in certain jurisdictions.

       Copyright   (c)  1989-1994  Adobe  Systems  Incorporated.   All  rights
       reserved.




Adobe Systems                     13 May 1993                     MAKEPSRES(1)

Man(1) output converted with man2html