Manual Page Result
0
Command: makepsres | Section: 1 | Source: Digital UNIX | File: makepsres.1.gz
makepsres(1) makepsres(1)
NAME
makepsres - Build PostScript resource directory file.
SYNOPSIS
makepsres [option] directory...
OPTIONS
Writes the output to the specified filename. -o - writes to stdout.
If the -o option is not specified, makepsres creates a PSres.upr file
in the current directory. Uses the specified file, which must be in
PostScript resource database file format, as information to assist re-
source typing. Multiple -f options may be specified. -f - uses stdin
as an input file and may not be used if "-" is specified as a directory
on the command line. Specifies that the filename is a directory.
Needed only if the directory name would be confused with an option.
Marks the resulting PSres.upr file as exclusive. This makes the asso-
ciated subroutines run more quickly since they do not have to look for
other files; however, makepsres must be run whenever new resources are
added to the directory, even if the resources come with their own
".upr" file. Specifies interactive mode. In interactive mode, the
user 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. Be quiet: do not warn
about unidentifiable files, just ignore them. Specifies non-recursive.
If -nr is present makepsres does not look in subdirectories for re-
source files. If the output file already exists, do not back it up.
Specifies strict mode. If -s is present makepsres terminates with an
error when encountering an unidentifiable file. Specifies no directory
prefix. If -p is present, makepsres does not try to find a common di-
rectory prefix among the specified directories. Specifies discard
mode. Specifies keep mode.
DESCRIPTION
makepsres creates a PSres.upr file containing all the resources in all
the directory pathnames on the command line. If the list of directo-
ries contains "-", stdin is read and assumed to be a space-, tab-, or
newline- separated list of directories. If the list of directories is
empty, it is taken to be ".". If all specified directories have a com-
mon initial prefix, makepsres extracts it as a directory prefix in the
PSres.upr file.
makepsres normally acts recursively; it looks for resource files in
subdirectories of any specified directory. This can be overridden with
the command line option -nr. makepsres uses existing files to assist
in resource typing. Its normal mode of operation is to create a new
PSres.upr file containing: Resource files found in the directories on
the command line, Resource files pointed to by PostScript resource
database files in the directories on the command line, and Resource en-
tries found in the input PostScript resource database files. These en-
tries are copied whenever the files they specify still exist and are
located in directories not specified on the command line.
There are two other modes of operation. If run in "discard" mode (see
below), makepsres does not copy resource entries from the input Post-
Script resource database files; the output file consists solely of en-
tries from the directories on the command line. The input PSres.upr
files are only used to assist in identifying files. If run in "keep"
mode, makepsres includes in the output file all resource entries in the
input PSres.upr files, even entries for files that no longer exist or
are located in directories specified on the command line.
makepsres uses various heuristics to type files. A file that is of a
private resource type or that does not conform to the standard format
for a resource file can be: Identified by the user by running makepsres
in interactive mode, Preloaded into a PostScript resource database file
used for input, or Begin with the line: %!PS-Adobe-3.0 Resource-<re-
source-type>
Consult the documentation for your Adobe PostScript system software for
further details on the use of PostScript resource directory files.
EXAMPLE
$ makepsres /usr/local/lib/ps/fonts
SEE ALSO
PostScript Language Reference Manual and the product-specific documen-
tation for your Adobe PostScript system software.
AUTHOR
Adobe Systems Incorporated
NOTES
PostScript is a registered trademark of Adobe Systems Incorporated.
Copyright (c) 1989-1991 Adobe Systems Incorporated. All rights re-
served.
makepsres(1)