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