Content-type: text/html Man page of makepsres

makepsres

Section: User Commands (1)
Updated: 20 Jul 1991
Index Return to Main Contents
 

NAME

makepsres - Build PostScript resource directory file.  

SYNOPSIS

makepsres [ option ] directory ...  

DESCRIPTION

makepsres creates a PSres.upr file containing all the resources in all the directory pathnames on the command line. If the list of directories 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 common 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 .upr files to assist in resource typing. Its normal mode of operation is to create a new PSres.upr file containing:

1)
Resource files found in the directories on the command line,
2)
Resource files pointed to by PostScript resource database files in the directories on the command line, and
3)
Resource entries found in the input PostScript resource database files. These entries 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 PostScript resource database files; the output file consists solely of entries 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:

1)
Be identified by the user by running makepsres in interactive mode,
2)
Be preloaded into a PostScript resource database file used for input, or
3)
Begin with the line:
       %!PS-Adobe-3.0 Resource-<resource-type>

Consult the documentation for your Adobe PostScript system software for further details on the use of PostScript resource directory files.  

OPTIONS

-o filename
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.
-f filename
Uses the specified file, which must be in PostScript resource database file format, as information to assist resource 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.
-dir filename
Specifies that the filename is a directory. Needed only if the directory name would be confused with an option.
-e
Marks the resulting PSres.upr file as exclusive. This makes the associated subroutines run more quickly since they do not have to look for other .upr files; however, makepsres must be run whenever new resources are added to the directory, even if the resources come with their own ".upr" file.
-i
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.
-q
Be quiet: do not warn about unidentifiable files, just ignore them.
-nr
Specifies non-recursive. If -nr is present, makepsres does not look in subdirectories for resource files.
-nb
If the output file already exists, do not back it up.
-s
Specifies strict mode. If -s is present makepsres terminates with an error when encountering an unidentifiable file.
-p
Specifies no directory prefix. If -p is present, makepsres does not try to find a common directory prefix among the specified directories.
-d
Specifies discard mode.
-k
Specifies keep mode.
 

EXAMPLE

$ makepsres /usr/local/lib/ps/fonts  

SEE ALSO

installresource(1), unixfont(1)

PostScript Language Reference Manual and the product-specific documentation 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 reserved.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
SEE ALSO
AUTHOR
NOTES

This document was created by man2html, using the manual pages.
Time: 02:42:45 GMT, October 02, 2010