Return to postreverse.1 CVS log

Up to [Research Unix] / researchv10no / cmd / post.src / postreverse

Annotation of researchv10no/cmd/post.src/postreverse/postreverse.1, revision 1.1.1.1

1.1       root        1: .TH POSTREVERSE 1
                      2: .SH NAME
                      3: .B postreverse
                      4: \- reverse the page order in a PostScript file
                      5: .SH SYNOPSIS
                      6: \*(mBpostreverse\f1
                      7: .OP "" options []
                      8: .OP "" file []
                      9: .SH DESCRIPTION
                     10: .B postreverse
                     11: reverses the page order in files that conform to Adobe's
                     12: Version 1.0 or Version 2.0 PostScript file structuring conventions,
                     13: and writes the results on the standard output.
                     14: Only one input
                     15: .I file
                     16: is allowed and if no
                     17: .I file
                     18: is specified, the standard input is read.
                     19: The following
                     20: .I options
                     21: are understood:
                     22: .TP  0.75i
                     23: .OP \-o list
                     24: Select pages whose numbers are given in the comma-separated
                     25: .IR list .
                     26: The list contains single numbers
                     27: .I N
                     28: and ranges
                     29: .IR N1\-\|N2 .
                     30: A missing
                     31: .I N1
                     32: means the lowest numbered page, a missing
                     33: .I N2
                     34: means the highest.
                     35: .TP 
                     36: .OP \-r
                     37: Do not reverse the pages in
                     38: .IR file .
                     39: .TP 
                     40: .OP \-T dir
                     41: Use
                     42: .I dir
                     43: as the temporary file directory when
                     44: reading from the standard input.
                     45: By default
                     46: .I dir
                     47: is set to
                     48: .MR /tmp .
                     49: .PP
                     50: .B postreverse
                     51: can handle a limited class of files
                     52: that violate page independence,
                     53: provided all global definitions are bracketed by
                     54: .MW %%BeginGlobal
                     55: and
                     56: .MW %%EndGlobal
                     57: comments.
                     58: In addition, files that mark the end of each page with
                     59: .MW "%%EndPage:\ label\ ordinal"
                     60: comments will also reverse properly, provided the prologue and
                     61: trailer sections can be located.
                     62: If
                     63: .B postreverse
                     64: fails to find an
                     65: .MW %%EndProlog
                     66: or
                     67: .MW %%EndSetup
                     68: comment the entire
                     69: .I file
                     70: is copied, unmodified, to the standard output.
                     71: .PP
                     72: Since global definitions are pulled out of individual
                     73: pages and put in the prologue, the output file can be
                     74: minimally conforming, even if the input
                     75: .I file
                     76: was not.
                     77: .SH EXAMPLES
                     78: Select pages 1 to 100 from
                     79: .I file
                     80: and reverse the pages:
                     81: .EX
                     82: postreverse -o1-100 \f2file
                     83: .EE
                     84: Print four logical pages on each physical page
                     85: and reverse all the pages:
                     86: .EX
                     87: postprint -n4 \f2file\fP | postreverse
                     88: .EE
                     89: Produce a minimally conforming file from output
                     90: generated by dpost without reversing the pages:
                     91: .EX
                     92: dpost \f2file\fP | postreverse -r
                     93: .EE
                     94: .SH DIAGNOSTICS
                     95: A 0 exit status is returned if
                     96: .I file
                     97: was successfully processed.
                     98: .SH BUGS
                     99: No attempt has been made to deal with redefinitions of global
                    100: variables or procedures.
                    101: If standard input is used, the input
                    102: .I file
                    103: will be read three times before being reversed.
                    104: .SH SEE ALSO
                    105: .BR dpost (1),
                    106: .BR postdaisy(1),
                    107: .BR postdmd(1),
                    108: .BR postio(1),
                    109: .BR postmd(1),
                    110: .BR postprint(1),
                    111: .BR posttek(1),
                    112: .BR psencoding (1)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.