.PAPER SIZE 50,65
.LEFT MARGIN 5
.RIGHT MARGIN 60
.NOJUSTIFY
.TITLE ^^LIST-11\\
.SUBTITLE ^VERSION 3.22
.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.EXT/OUTSW:VAL=INDEV:INFILE.INEXT/SWITCH:VAL
.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 15,
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 15.
^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^H:"TEXT" SWITCH WILL ALLOW A SECOND HEADER OF UP
TO 80 CHARACTERS TO BE PLACED BELOW THE FIRST HEADER LINE
IN A LISTING.
.SKIP 1
.INDENT 5
^THE /^E^D:NNN SWITCH WILL CAUSE THE TOP OF FORMS CHARACTER TO BE
CHANGED FROM A FORM FEED TO THE VALUE GIVEN IN ^^OCTAL\\ IN THE "NNN"
SWITCH VALUE. ^THIS MAY BE A 7 FOR A BELL BETWEEN PAGES, A 4 FOR A
CONTROL ^D, OR WHATEVER ELSE IS DESIRED. ^THE CONTROL ^D WAS FOR
USE WITH THE OLD ^^VT01\\ DEVICE, WHERE IT SPECIFIED THAT THE
SCREEN SHOULD BE ERASED AT EACH NEW PAGE.
.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.
^NOTE THAT A LENGTH OF 1 IS LEGAL WHERE THE /^N^P SWITCH HAS
BEEN GIVEN. ^IT IS USEFUL FOR PRODUCING FILES WITH NO EXTRA
BLANK LINES AT THE END BUT WITH TABS CONVERTED TO SPACES. ^SINCE
THE "PAGE" IS THEN SO SHORT, THE /^C^O SWITCH SHOULD BE USED
TO SPECIFY THE NUMBER OF COLUMNS EXPLICITLY.
.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 /^R^I:NN SWITCH CAUSES THE OUTPUT TO BE "RIGHT SHIFTED"
BY NN SPACES (THOUGH THE HEADER IF ANY IS NOT), LEAVING SOME
WHITESPACE TO THE LEFT OF THE OUTPUT TEXT. ^THE VALUE OF NN MAY
NOT BE LARGER THAN 31 AND IS MASKED TO 31 BEFORE USE. ^NOTE THAT
TEXT MAY WRAP AROUND IF TRUNCATE MODE IS NOT IN EFFECT AND THAT
THIS CAN CAUSE TEXT TO APPEAR AT THE NORMAL LEFT MARGIN. ^THE
EFFECT OF THE /^M^S SWITCH WITH THE ^^RI\\ SWITCH IS TO INTERFERE.
^THE EFFECT IS OBTAINED BY MODIFICATION OF THE TEXT AS SEEN
BY ^^LST\\.
.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 1
.INDENT 5
^THE /^L^C SWITCH WILL CAUSE ALL OUTPUT CHARACTERS TO BE CONVERTED
TO ^^LOWER\\ CASE. ^THIS IS OCCASIONALLY USEFUL AND WAS DONE BECAUSE
IT WAS EASY. ^THE ^^ASCII\\ CODES FROM ^A TO ^Z ARE AFFECTED, NOT
SPECIAL CHARACTERS.
.SKIP 1
.INDENT 5
^THE /^F^A:CCC SWITCH WILL SET THE "CONTINUATION LINE" MARKER CHARACTERS
TO "CCC". THESE DEFAULT TO "-->" BUT MAY BE MADE OTHER CHARACTERS
TO TREAT CONTINUATION LINES IN THE WAY YOU WANT.
.SKIP 1
.CENTER
^^OUTPUT SWITCHES\\
.PARAGRAPH
^OUTPUT SWITCHES MAY BE SPECIFIED TO MODIFY ACTION TAKEN ON THE
OUTPUT FILE. THERE ARE CURRENTLY TWO SWITCHES.
.PARAGRAPH
^THE /^A^P SWITCH CAUSES THE OUTPUT FILE TO BE OPENED FOR APPEND
RATHER THAN CREATE. ^THE FILE MUST ALREADY EXIST, AND NEW OUTPUT WILL
BE ADDED TO IT AT THE END. ^THIS ALLOWS SEVERAL ^^LST\\ LISTINGS TO
BE MERGED FOR SPOOLING WITHOUT ADDING REDUNDANT HEADERS ON EACH FILE
IN THE PRINT SPOOLER.
.PARAGRAPH
^THE /^S^P:NUMBER SWITCH SPECIFIES THAT THE OUTPUT FILE IS TO BE
SPOOLED WHEN CLOSED. ^THE "NUMBER" DEFAULTS TO 1 BUT UNDER
^^RSX11D\\ OR ^^IAS\\ IT MAY BE UP TO 32 AND SPECIFIES HOW MANY COPIES
OF THE FILE ARE TO BE SPOOLED.
^NOTE THAT BECAUSE THE SPOOL MACROS DO NOT PERMIT ANY DELETIONS, THE
FILE SPOOLED WILL NOT BE DELETED BY THE SPOOLERS IN CURRENT VERSIONS
OF ^^RSX\\ OR ^^IAS\\. ^MULTIPLE COPIES MAY OR MAY NOT WORK.
.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.
.SKIP 2
.P
^^BUGS\\
.BR
^^LST\\ SOMETIMES CRASHES AT THE LAST PAGE IN A DOCUMENT IN VARIABLE
COLUMN SIZE MODE. ^IF THIS HAPPENS, TRY SETTING A FIXED NUMBER OF
COLUMNS.