Return to postreverse.8 CVS log

Up to [Research Unix] / researchv10dc / man / mana

Annotation of researchv10dc/man/mana/postreverse.8, revision 1.1.1.1

1.1       root        1: .TH POSTREVERSE 8 local
                      2: .SH NAME
                      3: postreverse \- reverse the page order in a postscript file
                      4: .SH SYNOPSIS
                      5: .B postreverse
                      6: [ options ] [ file ]
                      7: .SH DESCRIPTION
                      8: .I Postreverse
                      9: reverses the page order in a minimally conforming PostScript
                     10: .I file
                     11: and writes the results on the standard output.
                     12: If no
                     13: .I file
                     14: is specified, the standard input is read.
                     15: The following
                     16: .I options
                     17: are understood:
                     18: .TP 1.0i
                     19: .BI \-o list
                     20: Select pages whose numbers are given in the comma-separated
                     21: .IR list .
                     22: The list contains single numbers
                     23: .I N
                     24: and ranges
                     25: .IB N1 \- N2.
                     26: A missing 
                     27: .I N1
                     28: means the lowest numbered page, a missing
                     29: .I N2
                     30: means the highest.
                     31: .TP 1.0i
                     32: .B \-r
                     33: Don't reverse the pages in
                     34: .I file.
                     35: .TP 1.0i
                     36: .BI \-T dir
                     37: Use
                     38: .I dir
                     39: as the temporary file directory when
                     40: reading from the standard input.
                     41: By default
                     42: .I dir
                     43: is set to /tmp.
                     44: .PP
                     45: .I Postreverse
                     46: can handle files the violate page independence,
                     47: provided all global definitions are bracketed by
                     48: \&\f(CW%%BeginGlobal\fP and \&\f(CW%%EndGlobal\fP
                     49: comments.
                     50: In addition files that mark the end of each page
                     51: with \&\f(CW%%EndPage: label ordinal\fP comments
                     52: will also reverse properly, provided the prologue and
                     53: trailer sections can be located.
                     54: If the end of the prologue isn't found, the entire
                     55: .I file
                     56: is copied, unmodified, to the standard output.
                     57: .PP
                     58: Since global definitions are pulled out of individual
                     59: pages and put in the prologue, the output file can be
                     60: minimally conforming, even if the input
                     61: .I file
                     62: wasn't.
                     63: .SH EXAMPLES
                     64: Select pages 1 to 100 from
                     65: .B file
                     66: and reverse the pages,
                     67: .PP
                     68: .RS
                     69: \f(CWpostreverse -o1-100 file\fP
                     70: .RE
                     71: .PP
                     72: Print 4 logical pages on each physical page
                     73: and reverse all the pages,
                     74: .PP
                     75: .RS
                     76: \f(CWpostprint -n4 file | postreverse\fP
                     77: .RE
                     78: .PP
                     79: Produce a minimally conforming file from output
                     80: generated by dpost without reversing the pages,
                     81: .PP
                     82: .RS
                     83: \f(CWdpost file | postreverse -r\fP
                     84: .RE
                     85: .PP
                     86: .SH DIAGNOSTICS
                     87: 0 exit status is returned if
                     88: .I file
                     89: was successfully processed.
                     90: .SH BUGS
                     91: No attempt has been made to deal with redefinitions of global
                     92: variables or procedures.
                     93: If standard input is used, the input
                     94: .I file
                     95: will be read three times before being reversed.
                     96: .SH SEE ALSO
                     97: dpost(1), postprint(1), posttek(1), postbgi(1), postdmd(1)

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