summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man1/extractres.1
blob: 51f9330af6e58ed4ca1ddff2284abad2437d56d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.1.
.TH EXTRACTRES "1" "February 2023" "extractres 2.10" "User Commands"
.SH NAME
extractres - extract resources from a PostScript document
.SH SYNOPSIS
.B extractres
[\fI\,OPTION\/\fR...] [\fI\,INFILE \/\fR[\fI\,OUTFILE\/\fR]]
.SH DESCRIPTION
Extract resources from a PostScript document.
.TP
\fB\-m\fR, \fB\-\-merge\fR
merge resources of the same name into one file
(needed e.g. for fonts output in multiple blocks)
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-v\fR, \fB\-\-version\fR
display version information and exit
.PP
.B extractres
extracts resources (fonts, procsets, patterns, files, etc) appearing in a
PostScript document, and puts appropriate
.B %%IncludeResource
comments in the document prologue.
The extracted resources are written to files with the same name as the
resource, and an appropriate extension.
The pipeline
.sp
.RS
extractres file.ps | includeres >out.ps
.RE
.sp
will move all resources appearing in a document to the document prologue,
removing redundant copies.
The output file can then be put through page re-arrangement filters such as
.B psnup
or 
.B pstops
safely.

.SS "Exit status:"
.TP
0
if OK,
.TP
1
if arguments or options are incorrect, or there is some other problem
starting up,
.TP
2
if there is some problem during processing, typically an error reading or
writing an input or output file.
.SH AUTHOR
Written by Angus J. C. Duggan and Reuben Thomas.
.SH BUGS
.B extractres
does not alter the
.B %%DocumentSuppliedResources
comments.
.SH COPYRIGHT
Copyright \(co Reuben Thomas 2012\-2022.
.br
Copyright \(co Angus J. C. Duggan 1991\-1997.
.SH TRADEMARKS
.B PostScript
is a trademark of Adobe Systems Incorporated.
.SH "SEE ALSO"
.BR psutils (1),
.BR paper (1)