summaryrefslogtreecommitdiff
path: root/static/unix-v10/man8/postreverse.8
diff options
context:
space:
mode:
Diffstat (limited to 'static/unix-v10/man8/postreverse.8')
-rw-r--r--static/unix-v10/man8/postreverse.897
1 files changed, 97 insertions, 0 deletions
diff --git a/static/unix-v10/man8/postreverse.8 b/static/unix-v10/man8/postreverse.8
new file mode 100644
index 00000000..4b16537e
--- /dev/null
+++ b/static/unix-v10/man8/postreverse.8
@@ -0,0 +1,97 @@
+.TH POSTREVERSE 8 local
+.SH NAME
+postreverse \- reverse the page order in a postscript file
+.SH SYNOPSIS
+.B postreverse
+[ options ] [ file ]
+.SH DESCRIPTION
+.I Postreverse
+reverses the page order in a minimally conforming PostScript
+.I file
+and writes the results on the standard output.
+If no
+.I file
+is specified, the standard input is read.
+The following
+.I options
+are understood:
+.TP 1.0i
+.BI \-o list
+Select pages whose numbers are given in the comma-separated
+.IR list .
+The list contains single numbers
+.I N
+and ranges
+.IB N1 \- N2.
+A missing
+.I N1
+means the lowest numbered page, a missing
+.I N2
+means the highest.
+.TP 1.0i
+.B \-r
+Don't reverse the pages in
+.I file.
+.TP 1.0i
+.BI \-T dir
+Use
+.I dir
+as the temporary file directory when
+reading from the standard input.
+By default
+.I dir
+is set to /tmp.
+.PP
+.I Postreverse
+can handle files the violate page independence,
+provided all global definitions are bracketed by
+\&\f(CW%%BeginGlobal\fP and \&\f(CW%%EndGlobal\fP
+comments.
+In addition files that mark the end of each page
+with \&\f(CW%%EndPage: label ordinal\fP comments
+will also reverse properly, provided the prologue and
+trailer sections can be located.
+If the end of the prologue isn't found, the entire
+.I file
+is copied, unmodified, to the standard output.
+.PP
+Since global definitions are pulled out of individual
+pages and put in the prologue, the output file can be
+minimally conforming, even if the input
+.I file
+wasn't.
+.SH EXAMPLES
+Select pages 1 to 100 from
+.B file
+and reverse the pages,
+.PP
+.RS
+\f(CWpostreverse -o1-100 file\fP
+.RE
+.PP
+Print 4 logical pages on each physical page
+and reverse all the pages,
+.PP
+.RS
+\f(CWpostprint -n4 file | postreverse\fP
+.RE
+.PP
+Produce a minimally conforming file from output
+generated by dpost without reversing the pages,
+.PP
+.RS
+\f(CWdpost file | postreverse -r\fP
+.RE
+.PP
+.SH DIAGNOSTICS
+0 exit status is returned if
+.I file
+was successfully processed.
+.SH BUGS
+No attempt has been made to deal with redefinitions of global
+variables or procedures.
+If standard input is used, the input
+.I file
+will be read three times before being reversed.
+.SH SEE ALSO
+dpost(1), postprint(1), posttek(1), postbgi(1), postdmd(1)