.PAPER SIZE 50,65
.LEFT MARGIN 5
.RIGHT MARGIN 60
.NOJUSTIFY
.TITLE ^^LIST-11\\
.SUBTITLE ^VERSION 3.10
.NUMBER 1
.FILL
.SPACING 1
.CENTER
^^LIST-11\\
.SKIP 2
.INDENT 5
^^LIST-11\\ IS A PROGRAM FOR REFORMATTING ^^ASCII\\ FILES.
^IT CAN PUT UP TO 10 COLUMNS OF TEXT ON A SINGLE PAGE.
^TO RUN ^^LIST-11\\, THE USER TYPES:
.SKIP 1
.INDENT 2
^^LST [FILEOUT=FILEIN]\\
.SKIP 1
^THE COMPUTER WILL RESPOND WITH:
.SKIP 1
.INDENT 2
^^LST>\\
.SKIP 1
^THE USER SHOULD NOW TYPE THE SPECIFICATION FOR THE FILE TO BE
PRINTED IN THE GENERAL FORM:
.SKIP 1
.INDENT 2
OUTDEV:OUTFILE.OUTEXT<INDEV:INFILE.INEXT/SWITCH:VALUE
.SKIP 2
^SWITCHES
.SKIP 1
.INDENT 5
^THE NUMBER OF COLUMNS WHICH SHOULD BE USED IS SPECIFIED BY THE
/^C^OLUMNS SWITCH. ^ITS VALUE IS A NUMBER FROM 0 TO 10,
WHICH INDICATES THE NUMBER OF DESIRED COLUMNS. ^IF THE NUMBER IS 0,
AS MANY COLUMNS AS WILL FIT WILL BE USED, UP TO A MAXIMUM OF 10.
^THE NUMBER OF COLUMNS IS RESET TO ZERO AFTER EVERY FILE IS
LISTED AND MUST BE SPECIFIED ANEW IF IT SHOULD BE SET OTHERWISE.
^PAPER SIZES (^L^ENGTH AND ^W^IDTH) ARE NOT CHANGED BETWEEN LISTINGS,
SO THAT THESE NEED BE SPECIFIED ONLY WHERE THEY MUST BE DIFFERENT
FROM THE DEFAULT, OR ON THE FIRST LISTING. ^ALL OTHER SWITCHES ARE
RESET BETWEEN FILES.
.SKIP 1
.INDENT 5
^THE /^T^R SWITCH, IF PRESENT, CAUSES LINES WHICH ARE TOO WIDE FOR
THE SPECIFIED NUMBER OF COLUMNS TO BE TRUNCATED.
^IF IT IS NOT SPECIFIED, LINES WHICH ARE TOO LONG WILL BE SPLIT
AND ALL BUT THE FIRST PART WILL BE PRECEDED BY A "-->".
.SKIP 1
.INDENT 5
^THE /^N^H SWITCH, IF PRESENT, CAUSES THE TWO LINE ^^LIST-11\\
HEADER TO BE OMITTED.
.SKIP 1
.INDENT 5
^THE /^F^F SWITCH, IF PRESENT, CAUSES A FORM FEED IN THE
INPUT FILE TO START A NEW COLUMN IN THE OUTPUT FILE.
^IF THE /^F^F SWITCH IS NOT SPECIFIED, FORM FEEDS IN
THE INPUT FILE ARE IGNORED.
.SKIP 1
.INDENT 5
^THE /^C^T SWITCH, IF PRESENT, CAUSES A TAB TO BE CHANGED
INTO A SPACE, INSTEAD OF SKIPPING TO THE NEXT COLUMN.
.SKIP 1
.INDENT 5
^THE OUTPUT PAGE SIZE MAY BE SPECIFIED BY THE /^W^IDTH AND
/^L^ENGTH SWITCHES, WHICH SPECIFY THE NUMBER OF AVAILABLE
PRINT COLUMNS AND LINES, RESPECTIVELY. ^ONCE A PAGE SIZE HAS
BEEN SPECIFIED, IT IS RETAINED UNTIL SPECIFICALLY CHANGED
BY ANOTHER SWITCH SPECIFICATION.
.SKIP 1
.INDENT 5
^THE /^P^AUSE SWITCH WILL CAUSE OUTPUT TO STOP AT THE END OF EACH
PAGE. ^THE OUTPUT WILL BE RESTARTED WHEN SOMETHING IS TYPED
TO THE COMMAND INPUT DATASET.
^LIST-11 WILL PROMPT FOR THE INPUT BY TYPING THE SPECIAL
PROMPT:
.SKIP 1
^^LIST PAUSE>\\
.SKIP 1
AFTER WHICH ANY INPUT IS LEGAL AND SERVES ONLY TO END THE PAUSE.
^A CONTROL-^Z AT A PAUSE ENDS THE CURRENT LISTING AND WILL CAUSE
^^LIST\\-11 TO PROMPT WITH ANOTHER "^L^S^T>" FOR A NEW SET OF
FILE SPECIFIERS.
.SKIP 1
.INDENT 5
^THE /^E^D SWITCH WILL CAUSE THE TOP OF FORMS CHARACTER TO BE
CHANGED FROM A FORM FEED TO A CONTROL ^D.
.SKIP 1
.INDENT 5
^THE /^R^O:N SWITCH CAUSES THE OUTPUT TO FORCE EACH PAGE
TO BE N LINES LONG. ^THIS IS INTENDED FOR USE WITH
ROLL PAPER. ^IN ADDITION, THE FORM FEEDS ARE REPLACED
BY A LINE OF "=" TO DELIMIT THE PAGES. ^BOTH THE SWITCH
AND N MUST BE SPECIFIED FOR EACH FILE.
.SKIP 1
.INDENT 5
^THE /^R^L:N SWITCH CAUSES EACH LINE TO BE EXACTLY N
CHARACTERS LONG (FOLLOWED BY A ^C^R AND ^L^F).
^THIS IS INTENDED TO ALLOW OUTPUT TO BE
OBTAINED FROM THE ^VERSATEK PRINTER WHEN
IT GETS INTO THE "IGNORE ^C^R MODE"; IN THIS CASE, N
SHOULD BE 132. ^BOTH THE SWITCH AND N MUST BE
SPECIFIED FOR EACH FILE.
.SKIP 1
.INDENT 5
^THE /^U^C SWITCH CAUSES LOWER CASE LETTERS TO BE TRANSLATED
TO THE CORRESPONDING UPPER CASE CHARACTERS. ^THIS IS HELPFUL
WHEN LISTING ON A DEVICE NOT CONTAINING THE FULL 96-CHARACTER
^^ASCII\\ CHARACTER SET.
.SKIP 1
.INDENT 5
^THE /^N^P SWITCH CAUSES PAGINATION TO BE SUPPRESSED; THAT IS,
NO HEADERS ARE PRODUCED AND NO FORMFEEDS OR OTHER PAGE DIVIDERS
ARE INSERTED IN THE FILE. ^THIS MODE MAY BE USED (POSSIBLY IN
CONJUNCTION WITH THE /^^RL\\:NNN SWITCH) TO PRODUCE A FILE
OF KNOWN MAXIMUM LINE WIDTH.
.SKIP 1
.INDENT 5
^THE /^S^L:NN SWITCH CAUSES ^^LST\\ TO ^SKIP ^LETTERS IN THE INPUT FILE.
^IT WILL SKIP THE FIRST "NN" LETTERS OF EACH RECORD OF THE INPUT FILE,
PERMITTING ONE TO EASILY RETRIEVE DATA THAT HAS BEEN OFFSET. ^IT MAY
BE USED, FOR EXAMPLE, TO GENERATE ASSEMBLER FILES FROM ASSEMBLY OR
^^FORTRAN\\ LISTINGS.
.SKIP 1
.INDENT 5
^THE /^M^S SWITCH CAUSES MULTIPLE SPACES IN THE INPUT TO BE CHANGED
TO SINGLE SPACES PRIOR TO LISTING. ^NOTE THAT THE TAB COMPRESSION INTO
SPACES WILL NOT GENERATE MULTIPLE SPACES FOR THIS OPERATION, BUT
MULTIPLE SPACES IN THE SOURCE WILL. ^A SECOND PASS THROUGH ^^LIST\\ WILL
ALLOW SUCH SPACES TO BE HANDLED CORRECTLY.
.SKIP 1
.INDENT 5
^THE /^B^S SWITCH PERMITS THE COLUMN SEPARATOR TO BE A SPACE RATHER THAN
THE USUAL EXCLAMATION POINT (!) WHEN SPECIFIED.
.SKIP 1
.INDENT 5
^THE /^S^C:CHAR SWITCH SPECIFIES THE COLUMN SEPARATOR CHARACTER. ^ANY
PRINTABLE ^^ASCII\\ CHARACTER MAY BE USED AND WILL REPLACE THE USUAL
EXCLAMATION POINT. ^IF NEITHER /^S^C NOR /^B^L IS SPECIFIED, AN EXCLAMATION
POINT WILL BE USED. ^IF BOTH ARE SPECIFIED, THE SEPARATOR GIVEN (OR !) WILL
BE USED, BUT THE EXTRA SPACE USED IN SEPARATING COLUMNS WILL BE LEFT
OUT. ^THIS WILL MAKE THE PAGE SOMEWHAT NARROWER THAN OTHERWISE, SO
IT MAY BE DESIRABLE TO SET THE /^^WI\\DTH SWITCH TO A LARGER VALUE TO
ALLOW THE EXTRA SPACE TO BE RECLAIMED. ^UP TO 18 COLUMNS MAY BE SPECIFIED
IN ^VERSION 3.2 OF ^^LIST-11\\.
.SKIP 2
^EXAMPLE:
.SKIP 1
.INDENT 2
^^MCR>LST
.INDENT 2
LST>LP:=PROG.SRC/TR/CO:3
.INDENT 2
MCR>LST LP:=MANUAL.DOC/NH/FF/CO:2
.SKIP 1
^T\\HE FIRST FILE, ^^DK:PROG.SRC\\, IS PRINTED ON THE LINE PRINTER,
IN A 3 COLUMNS PER PAGE FORMAT.
^THE FILE ^^MANUAL.DOC\\ IS THEN PRINTED WITHOUT A HEADER
AND EACH "PAGE" BEGINNING AT THE TOP OF THE NEXT COLUMN. ^THIS
IS USEFUL FOR LISTING ^^RUNOFF\\ OUTPUT FILES IN A TWO COLUMNS
PER PAGE FORMAT.