Return to bscpr.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc

Annotation of cci/usr/src/usr.bin/bsc/doc/bscpr.1, revision 1.1

1.1     ! root        1: '\" t
        !             2: .TH BSCPR 1C DLBA 1.1
        !             3: .SH NAME 
        !             4: bscpr \- BISYNC Batch File Print Utility
        !             5: .SH SYNOPSIS 
        !             6: bscpr [-ascii] [-page=pp] [chan=lineno ...] [file]
        !             7: .SH DESCRIPTION 
        !             8: .P
        !             9: The 
        !            10: .I bscpr 
        !            11: utility is used to paginate a file which
        !            12: contains IBM 2780 or 3780 terminal control characters and escape sequences.
        !            13: These terminals have line printers which utilize a paper tape loop
        !            14: and holes punched in certain locations to control paper motion. The
        !            15: loop of paper tape contains twelve channels; an escape code is used
        !            16: to tell the printer to skip to a position on the page corresponding
        !            17: to a hole in a certain "channel". Usually, channel 1 corresponds
        !            18: to the top of the form, channel 12 to the bottom, and the remainder
        !            19: correspond to the vertical equivalent of horizontal tab stops in
        !            20: that they represent a physical line number on a page.
        !            21: .P
        !            22: The 
        !            23: .I -ascii 
        !            24: parameter specifies that the escape
        !            25: sequences used for printer positioning were of the ASCII style; the
        !            26: default is the EBCDIC style (differences are slight, see the table below).
        !            27: The 
        !            28: .I -page=pp 
        !            29: parameter is used to specify the page length to be used.
        !            30: The 
        !            31: .I chan=lineno 
        !            32: parameters give the correspondence of channel numbers to line numbers on a page.
        !            33: The page length defaults to 66 lines, and channel 1 always corresponds to
        !            34: line 1; skipping to unspecified channels results in no action.
        !            35: .P
        !            36: The following table shows the escape sequences which may appear at
        !            37: the beginning of a line to control paper positioning. If there is
        !            38: not an escape sequence at the beginning of a line, single spacing
        !            39: is automatically selected for that line.
        !            40: .P
        !            41: .TS
        !            42: center;
        !            43: c c c
        !            44: c c c
        !            45: l l l.
        !            46: Carriage Operation     EBCDIC Code     ASCII Code
        !            47: After Printing Sequence        Sequence  
        !            48: _
        !            49: Single Space   ESC /   ESC Q
        !            50: Double Space   ESC S   ESC R
        !            51: Triple Space   ESC T   ESC S
        !            52: Space Suppress*        ESC M   ESC M
        !            53: 
        !            54: Skip to Channel 1      ESC A   ESC A
        !            55: Skip to Channel 2      ESC B   ESC B
        !            56: Skip to Channel 3      ESC C   ESC C
        !            57: Skip to Channel 4      ESC D   ESC D
        !            58: Skip to Channel 5      ESC E   ESC E
        !            59: Skip to Channel 6      ESC F   ESC F
        !            60: Skip to Channel 7      ESC G   ESC G
        !            61: Skip to Channel 8      ESC H   ESC H
        !            62: Skip to Channel 9*     ESC I   ESC I
        !            63: Skip to Channel 10*    ESC J   ESC J
        !            64: Skip to Channel 11*    ESC K   ESC K
        !            65: Skip to Channel 12*    ESC L   ESC L
        !            66: .TE
        !            67: .P
        !            68: * These operations do not apply to the IBM 2780
        !            69: Data Transmission Terminal.
        !            70: .P
        !            71: .I Bscpr 
        !            72: keeps track of the current line number as
        !            73: it displays the lines of the received file.
        !            74: Normally, each line is terminated with the necessary number of newlines
        !            75: (one for single spacing, two for double, three for triple,
        !            76: and the difference between
        !            77: the current line and line corresponding to a specific channel in
        !            78: a skip to channel operation).
        !            79: Space suppress results in a line terminated via a carriage return,
        !            80: and the current line number is not incremented.
        !            81: Any attempt to move past the bottom of the page via spacing or skipping
        !            82: will result in a carriage return and form feed (ASCII FF).
        !            83: An attempt via skipping
        !            84: to a channel to position to a line number less than the current line
        !            85: number will result in a form feed, then line feeds to get to the
        !            86: proper line on the new page.
        !            87: .P
        !            88: .SH "SEE ALSO"
        !            89: .nf
        !            90: bscbatch(1c) \- batch file submission / queue query
        !            91: .I
        !            92: Component Description: IBM 2780 Data Transmission Terminal,
        !            93: IBM document GA27-3005 
        !            94: .I
        !            95: Component Information for the IBM 3780 Data Communication Terminal, 
        !            96: IBM document GA27-3063
        !            97: .fi
        !            98: .SH DIAGNOSTICS
        !            99: .P
        !           100: bscpr: unrecognized option (<flag>)
        !           101: .IP
        !           102: The option <flag> is not a valid parameter as shown in the synopsis.
        !           103: .P
        !           104: bscpr: not a numeric (<parameter>)
        !           105: .IP
        !           106: The number of lines for the 
        !           107: .I -page 
        !           108: parameter or the channel or line number for the 
        !           109: .I chan=lineno 
        !           110: parameter is not a numeric.
        !           111: .P
        !           112: bscpr: channel number not 2 to 12 (<parameter>)
        !           113: .IP
        !           114: The channel number given is not in the range 2 to 12, inclusive.
        !           115: There are only escape sequences for channels in this range, not counting
        !           116: the channel 1 specification, which is always set to line 1.
        !           117: .P
        !           118: bscpr: line assignment for channel <chan> is greater than page length
        !           119: .IP
        !           120: Channel assignments for line numbers must be between line 1 and the
        !           121: last line on the page (given by 
        !           122: .I -page 
        !           123: or defaults to 66).
        !           124: .P
        !           125: bscpr: <file> not found
        !           126: .IP
        !           127: The file name parameter <file> could not be opened for reading.
        !           128: Either it does not exist, or the mode does not permit reading.

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