.PAPER SIZE 50,65
.LEFT MARGIN 5
.RIGHT MARGIN 60
.NOJUSTIFY
.TITLE ^^LIST-11\\
.SUBTITLE ^VERSION 3.02
.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
^^LIS [FILEOUT=FILEIN/SWITCHES]\\
.SKIP 1
^IF NO INPUT/OUTPUT SPEC IS GIVEN, THE COMPUTER WILL RESPOND WITH:
.SKIP 1
.INDENT 2
^^LIS>\\
.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^I^S>" 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 /^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
^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 2
^EXAMPLE:
.SKIP 1
.INDENT 2
^^MCR>LIS
.INDENT 2
LIS>LP:=PROG.SRC/TR/CO:3
.INDENT 2
MCR>LIS 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.