COMPAG COMPAG Manual Page 2 ------ V2 1.0 Using COMPAG: A Page Combining Utility Compag is run by typing Manual Edition 2 .R COMPAG 8-May-80 * C G Wilson, 71 Galatea St, Charleville 4470, Australia. It expects a standard RT-11 CSI command line in reply - viz. /switches=[,...] COMPAG provides the ability to easily combine pages so they The default input extension is .DOC, and the default output may be spread across a printer form rather than taking up a extension is .LST. Multiple input files are read as though page each. It can cope with up to 8 columns within the they were one contiguous file. output page, the size of each column being determined by the width of that page. Alternatively a series of left margins may be specified, one for each column in sequence. 2.0 What it does: There is no provision for resequencing a file in a manner suitable for booklet production. This must be performed (eg Input data is read and organized into pages. A page is by a TECO macro) before applying COMPAG. terminated either on receipt of a form-feed character or when the number of lines read in is sufficient to fill the COMPAG requires the file I/O utility IO.MAC (also provided length of the page (see /P switch). The input lines are on the RUNOFF distribution disc), and may use the file organized into a multi-column page for output. The first KEV11.MAC for assembly for a system with a KEV11 extended page usually starts at column 0, then the second page arithmetic option. further across the page horizontally, and so on until the specified number of columns has been filled. Then that page is written and the next one set up. Thus, to get a copy of this manual with two pages on each printer page type: .RUN RUNOFF COMPAG COMPAG .RUN COMPAG *COMPAG=COMPAG * This will produce COMPAG.LST in the desired format, for a 60 line by 132 column printer page. 3.0 Switches: Switches may be appended to either the output file or any of the input files. 3.1 /H - help This switch causes printing of a list of available switches and their actions. Anything else on the command line is not used. COMPAG Manual Page 3 COMPAG Manual Page 4 3.2 /W[:n] - set page width 3.7 /C:n - number of columns for output format This switch sets the number of columns available in the The default number of columns is 2. Up to 8 columns may be output format. The default value is 132, and if /W is specified. The width of each column depends on the number specified without a value, 120. This width is used for of columns desired and the width of the printer page. The calculating the spread of the columns - for example with a number of spaces left between columns depends on the number 132 column page the first section will start at column 0 and of columns specified. the second (if two only are desired) will start on column 71. With a 120 character page the second section will start Number of Inter-column on column 65. Columns Gap 2 or 3 10 4 or 5 8 3.3 /P[:n] - set page length 6 to 8 6 This sets the number of lines available in each output page. It should be noted that there is no checking of the number The default value is 60, but becomes 46 (suitable for a of columns in the input data. Should this exceed the size teletype model 43) if /P is specified without a value. of the column into which it is being formatted, it simply continues across the page where it may be written over by the next column, or wraps around to the next line if it passes the right hand margin. 3.4 /B - ignore all leading blank lines Compag is designed to be used with RUNOFF. Runoff has a nasty habit of leaving stray line-feeds at the start of each 3.8 /L:n[:n,...] - specify left margins page. Generally Compag will ignore this line but allow other blank lines at the start of a page. If /B is This switch allows the user to override the automatic specified, any blank lines at the start of any page will be determination of column positions by actually specifying ignored. where he wants the margin to be for each column. The first column of a page is column 0. The values need not be in ascending order - if you particularly need to set columns up from right to left it will work in this manner, or if you 3.5 /N - ignore no blank lines have a basic form in one file into which you wish to insert various different data available in other files but with the (See discussion re /B) - If /N is specified any blank lines same left hand margin, then /L:0:0 may be helpful. at the start of a page will be included in the output page. 4.0 Underscoring: 3.6 /T - utilize VT100 132-column mode The underscore character ("_", ascii 137) is recognized, and This switch assumes the user is using a VT100 terminal, and characters underscored (either by an overprinted line or by is usually used when output is to be directed to that the use of backspaces) in the input will remain underscored terminal. Before processing the file it sends the codes to (by use of an overprinting line) in the output. An set the VT100 into 132 column mode, and after processing underscore alone will, however, be printed as a single switches to 80 column mode. character rather than on its own special line.