.SPACING 3
###
.BLANK 4
.CENTER
^^FLY
.CENTER
FILE LISTING YOU-TILITY
.CENTER
^^LOCAL DOCUMENTATION
.BLANK 2
.SPACING 1
^^NOTE:\\  ^THIS IS A LOCALLY WRITTEN AND MAINTAINED DOCUMENT.  ^IT IS
WRITTEN SPECIFICALLY FOR THE CONVENIENCE OF  GENERAL ^^RSX\\ USERS,
 AND IS MEANT TO BE INFORMATIVE AND EASY TO UNDERSTAND.  ^HOWEVER, IF
ANY PART OF THIS DOCUMENT IS UNCLEAR OR INSUFFICIENT, PLEASE BRING THIS
TO THE ATTENTION OF THE DOCUMENT MAINTAINER, NAMED BELOW.  ^ANY CONSTRUCTIVE
CRITICISM OR ADVISE ON THE OPERATION OF ^^FLY\\ IS WELCOME.
.BLANK 1
^DOCUMENT ^MAINTAINER: ^GORDON ^E. ^WARNKE
.BLANK 1
^LAST UPDATE:  ^^14-JUL-77
.BLANK 3
T\\HIS PROGRAM SUPPORTED BY THE STAFF OF THE ^ALBERTA ^HAIL
^PROJECT.
.TITLE ^^FLY\\
.SUBTITLE ^INTRODUCTION
.PAGE
.CENTER
^^FLY\\
.INDEX ^INTRODUCTION
.SKIP 1
.PARAGRAPH
^^FLY\\ IS A PROGRAM WHICH WILL CONVERT FILES TO A MULTI-COLUMN
FORMAT.  ^THIS WILL SAVE PAPER AND TIME WHEN LISTING FILES CONSISTING
OF SHORT LINES, SUCH AS DIRECTORIES.
.SKIP 4
.CENTER
^^OPERATION OF FLY\\
.SKIP 1
.INDEX ^USAGE
.PARAGRAPH
^^FLY\\ IS INVOKED BY TYPING "^^FLY\\".  ^THE PROGRAM WILL THEN IDENTIFY
ITSELF, AND WAIT FOR A COMMAND STRING IN THE STANDARD ^^CSI\\ FORMAT.
^^FLY\\ WILL ACCEPT ONE INPUT FILE (WITH OPTIONAL SWITCHES) (^NOTE THAT AN INPUT FILE
MUST BE SPECIFIED) AND ONE OUTPUT FILE (IF NONE SPECIFIED 
^^FLY.DMP\\ IS
USED BY DEFAULT) OR DEVICE (E.G. ^T^I:).  
^UPON COMPLETION OF THE LISTING, ^^FLY\\ WILL ASK FOR ANOTHER COMMAND
STRING AND THE PROCESS MAY BE REPEATED. ^ALL COMMAND STRINGS SHOULD TAKE ONE OF THE FOLLOWING FORMS:
.BLANK 1
.CENTER
FILESPEC
.CENTER
FILESPEC[/SW]
.CENTER
FILESPEC[/SW:N]
.CENTER
OR: [FILESPEC]=FILESPEC[/SW:N]
.BLANK 1
WHERE SW MAY BE ANY COMBINATION OF THE FOLLOWING:
.BLANK 4
.INDEX ^SWITCHES
.INDEX ^C^L
.INDEX ^COLUMN ^SPECIFICATION
^C^L (COLUMN SPECIFICATION)
.BLANK 1
.PARAGRAPH
^THE ^CO^LUMN SPECIFICATION SWITCH IS USED TO SPECIFY THE
NUMBER OF COLUMNS PER PAGE IN THE FINAL OUTPUT FILE. ^IF THIS SWITCH IS
NOT PRESENT OR NO SWITCH VALUE IS SPECIFIED, THE DEFAULT IS 
AS MANY COLUMNS AS WILL FIT ON THE PAGE. ^NOTE THAT THE SWITCH VALUE
MUST BE BETWEEN ZERO AND NINE, AND ANY VALUE LESS THAN OR EQUAL TO
ZERO WILL PRODUCE THE SAME RESULT AS
NO SWITCH VALUE. ^A SWITCH VALUE OF GREATER THAN NINE
WOULD BE TAKEN AS BEING A NINE.
.BLANK 1
.SUBTITLE ^SWITCHES
.CENTER
^EXAMPLES
.LEFT MARGIN 28
.TAB STOPS 28
.INDENT -24
.BLANK 1
FILESPEC/^C^L:3	WOULD PRODUCE THE OUTPUT FILE ^^FLY.DMP\\ HAVING THREE
COLUMNS.
.INDENT -24
.BLANK 1
FILESPEC=FILESPEC/^C^L	WOULD PRODUCE THE SPECIFIED OUTPUT FILE HAVING AS
MANY COLUMNS PER PAGE AS WOULD FIT.
.INDENT -24
.BLANK 1
FILESPEC=FILESPEC/^C^L:12	WOULD PRODUCE THE SPECIFIED OUTPUT FILE WITH NINE
COLUMNS PER PAGE.
.SUBTITLE ^SWITCHES
.BLANK 2
.INDEX ^^NH\\
.LEFT MARGIN 0
.INDEX ^NO ^HEADER
^N^H (NO HEADER)
.BLANK 1
.PARAGRAPH
^THE ^NO ^HEADER SWITCH IS USED TO SUPRESS OUTPUT OF THE ^^FLY\\
 HEADER, GIVING TWO EXTRA LINES OF OUTPUT PER PAGE.  ^IF THIS SWITCH IS NOT
PRESENT, A HEADER WILL BE SUPPLIED, IDENTIFYING THE INPUT FILE, AND
GIVING THE DATE AND PAGE NUMBERS.
.BLANK 1
.CENTER
^EXAMPLE
.LEFT MARGIN 28
.BLANK 1
.INDENT -24
FILESPEC=FILESPEC/^N^H	WOULD CAUSE THE SUPRESSION OF THE HEADER
ALLOWING TWO MORE LINES OF OUTPUT ON EACH PAGE OF THE SPECIFIED
OUTPUT FILE.
.BLANK 2
.INDEX ^S^P
.INDEX ^SPOOL
.LEFT MARGIN 0
.INDEX -^S^P
^S^P OR -^S^P (SPOOL OR NO SPOOL)
.BLANK 1
.INDENT 5
^THE ^S^POOL SWITCH IF SPECIFIED CAUSES THE OUTPUT FILE TO BE SPOOLED,
THE NEGATION OF THIS SWITCH CAUSES THE OUPUT FILE NOT TO BE SPOOLED.
^NOTE THAT IF THIS SWITCH IS NOT SPECIFIED THE OUTPUT FILE WILL BE SPOOLED
BY DEFAULT.
.BLANK 1
.CENTER
^EXAMPLES
.LEFT MARGIN 28
.BLANK 1
.INDENT -24
FILESPEC=FILESPEC/^S^P	WILL CAUSE THE OUTPUT FILE
SPECIFIED TO BE SPOOLED.
.BLANK 1
.INDENT -24
FILESPEC=FILESPEC/-^S^P	WOULD CAUSE THE SPECIFIED OUTPUT FILE
NOT TO BE SPOOLED.
.LEFT MARGIN 0
.BLANK 2
.INDEX ^T^R
.INDEX ^TRUNCATE
^T^R (^TRUNCATE)
.BLANK 1
.PARAGRAPH
^THE ^T^RUNCATE SWITCH, IF PRESENT, WILL CAUSE ^^FLY\\ TO TRUNCATE
LINES THAT ARE TO LONG TO FIT IN THE COLUMNS.  ^IF THIS SWITCH IS NOT
PRESENT, ^^FLY\\ WILL CONTINUE LONG LINES WITH THE CONTINUATION
SEQUENCE "-->" AT THE BEGINNING OF LINES AFTER THE FIRST.
.BLANK 1
.CENTER 
^EXAMPLE
.BLANK 1
.LEFT MARGIN 28
.INDENT -24
FILESPEC/^T^R	WOULD CAUSE THE DEFAULT OUTPUT FILE ^^FLY.DMP\\
TO HAVE ANY LINE TOO LONG FOR THE COLUMN TO BE TRUNCATED.
.BLANK 2
.LEFT MARGIN 0
.INDEX ^W^D
.INDEX  ^WIDTH OF PAGE
^W^D (WIDTH OF PAGE)
.PARAGRAPH
^THE ^WI^DTH SWITCH IF SPECIFIED CAUSES THE PAGE WIDTH TO BE
SET TO N (WHERE N IS THE SWITCH VALUE SPECIFIED).  ^ALTHOUGH ^W^D IS
A SWITCH SPECIFICALLY FOR SETTING PAGE WIDTH, IT IS NOT NEEDED IF ANY 
ONE OF ^S^P, ^T^R, OR ^N^H IS SPECIFIED, FOR IF A SWITCH VALUE IS INCLUDED WITH ANY OF THIS SWITCHES, IT IS TAKEN TO BE
THE DESIRED PAGE WIDTH.  ^NOTE THAT THE PAGE WIDTH MUST LIE BETWEEN
TWENTY AND ONE HUNDRED THIRTY.  ^ANY VALUE SMALLER WILL BE TAKEN AS TWENTY
 AND ANY VALUE BIGGER WILL BE TAKEN AS ONE HUNDRED THIRTY.  
^ALSO, NOTE THAT A HEADER WILL NOT BE PRINTED IF PAGE WIDTH IS LESS THAN
FORTY.  ^IF A PAGE WIDTH SWITCH VALUE IS NOT SPECIFIED
THE DEFAULT WIDTH IS ONE HUNDRED THIRTY.  ^FOR EXAMPLES SEE
NEXT SECTION.
.BLANK 2
.CENTER
^^EXAMPLES OF COMMAND STRINGS AND THEIR MEANING\\
.LEFT MARGIN 5
.INDENT -5
.BLANK 2
.NOFILL
FILESPEC
.FILL
^WOULD CAUSE OUTPUT FILE ^^FLY.DMP\\ TO BE PRODUCED AND SPOOLED WITH NO
TRUNCATION, A HEADER, PAGE WIDTH OF 130, AND AS MANY COLUMNS AS WILL FIT.
.BLANK 1
.INDENT -5
.NOFILL
FILESPEC=FILSPEC/^S^P:100
.FILL
^WOULD CAUSE THE SPECIFIED OUTPUT FILE TO BE PRODUCED AND SPOOLED WITH A PAGE
WIDTH OF 100, A HEADER, NO TRUNCATION,  AND AS MANY COLUMNS AS WOULD FIT.
.BLANK 1
.INDENT -5
.NOFILL
FILSPEC=FILSPEC/^W^D:80/-^S^P/^T^R/^N^H/^C^L:2
.FILL
^WOULD CAUSE THE SPECIFIED OUTPUT FILE TO BE PRODUCED BUT NOT SPOOLED,
WITH A PAGE WIDTH OF 80, NO HEADER, TRUNCATION OF LINES WICH WERE
TOO LONG, AND 2 COLUMNS PER PAGE.
.BLANK 5
.CENTER
^^SUMMARY OF SWITCHES\\
.BLANK 2
.NOFILL
/^C^L[:N]	PRINT N COLUMNS PER PAGE
/^N^H[:W]	NO HEADER
/^S^P[:W] 	SPOOL OUTPUT FILE
/-^S^P[:W]	DON'T SPOOL OUTPUT FILE
/^T^R[:W]	TRUNCATE LINES THAT ARE TOO LONG
/^W^D[:W]	SET PAGE WIDTH TO W CHARACTERS
.INDEX ^SWITCH ^SUMMARY
.INDEX ^EXAMPLES
.PAGE
.LEFT MARGIN 0
.FILL
.CENTER
^^PECULIARITIES\\
.BLANK 2
.PARAGRAPH
^DUE TO THE FORMAT OF ^^PIP\\ CREATED FILES (E.G. DIRECTORIES), ^^FLY\\
IS UNABLE TO PROCESS THEM.  ^HOWEVER, ^BILL ^KORENDYK HAS WRITTEN A 
INDIRECT COMMAND FILE WHICH USES ^^TECO\\ TO REFORMAT THE ^^PIP\\ FILE INTO
A FORM THAT ^^FLY\\ CAN HANDLE.  ^THE INDIRECT COMMAND FILE ASKS FOR THE NAME
OF THE FILE TO BE LISTED, THEN PROCESSES IT, AND THEN CALLS ^^FLY\\ TO
MULTI-COLUMN FORMAT IT AND SPOOL IT.  ^THE DIRECTORY LISTING FILE CAN CONTAIN ANY NUMBER OF 
DIRECTORIES, AND CAN BE ON ANY OF THE THREE DISKS.
  ^IN ORDER, TO USE ^BILL'S FILE SIMPLY
TYPE:
.BLANK
.CENTER
 ^^@DK1:[111,13]FLY.CMD\\
.BLANK
 FOLLOWED BY A CARRAGE RETURN.
 ^USERS ARE ENCOURAGED TO USE ^BILL'S
FILE, SINCE MULTI-COLUMN FORMATTING A LONG DIRECTORY LISTING SAVES A
CONSIDERABLE AMMOUNT OF PAPER, AND IS EASY TO READ.
.SUBTITLE ^INDEX
.LEFT MARGIN 0
.PAGE
.PRINT INDEX