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     ! 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.