MAKEPSRES(1)						      General Commands Manual						      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 facilities 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 contains 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 newline.

	 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 identifying 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 specified as a direc-
	      tory 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 recursively: 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 directo-
	      ries.

       -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 Publishing 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)