This concept was inspired by Roger Clarke's wonderful program Mercury, the multi-platform compiled Arexx program that many people have used with DLG.
FileGuide, however, was written in conjunction with FileList for DLG, completely from scratch and optimized for use specificaly with DLG.
YOU MUST RUN MAKEINDEX BEFORE USING THIS PROGRAM!!!!
The listed file names are limited to 18 characters. File names that exceed 18 characters are followed by a * -- this conforms to DLGFreq's ability to understand * wildcards. Filenames in generated REQ files are full-length.
Otherwise, identical to FileList
YOU MUST RUN MAKEINDEX BEFORE USING THIS PROGRAM!!!!
FileList -q -i <filename> -o <filename> [-l <level>] [-e] [-d <days>] [-f <pattern>] [-p <pattern>] [-m] -[-a <area list>] [-v <lines>] [-w <width>] [-> <size>] [-< <size>]
-q | If this flag is specified, FileList does not report its progress to the shell. Error conditions are reported regardless. |
-i <filename> | This specifies a file to be used as an introduction. It will be prepended to the list at the head of the resulting output file. This is an optional parameter. |
-o <filename> | This specifies the file that will be created. Program will not execute if this is not specified. |
-l <level> | If specified, this indicates what level to access the file database with. File areas that are not accessable by this level of user will not be listed. Also, file areas that are not auto-access will not be listed UNLESS the level specified is 255 (sysop level). |
-e | If specified, this flag instructs the program to list files in areas regardless of whether they are freqable or not. Normally, the program restricts itself to areas that are freqable. |
-d <days> | If specified, FileList will only list files uploaded to the BBS in the last "x" days, where the argument following -d is the number of days to go back. This is useful to generate a "new files" list. |
-f <pattern> -p <pattern> | These two flags spcify a pattern to search for in the filename, or the filename AND short description, respectively. If the pattern is matched, the file will be listed. |
-m | If this flag is specified, FileList will not list magic file names. |
-a <areas> | If this flag is used, it must be followed by a list of areas to search. Many formats are
valid:
lists file areas 1 2 and 3.
does the same thing.
lists file areas 1 through 10 if they exist.
lists all extant file areas numbering 100 and greater. All of the above formats can be combined, too.
will list file areas 1, 10, 100, all file areas between 150 and 200, and all file areas 900 and greater. If any spaces are used, the list must be included in quotes, otherwise it need not be. |
-v <lines> | Use long descriptions. If followed by a number, the number is how many lines to limit the long
description to. A value of 0 equals no limit.
NOTE WELL: this method takes more than 7 times as long to generate a list of the same file areas! |
-w <width> | The width to limit the generated file to. Minimum acceptable value is 40, maximum is 132. Only the file descriptions, divider bars, and centered text is affected. File names and file sizes are not adjusted. |
-> <size> -< <size> | List only files that are greater than (>) or less than (<) the specified size in bytes. |
The listed file names are limited to 18 characters. File names that exceed 18 characters are followed by a * -- this conforms to DLGFreq's ability to understand * wildcards.
File sizes are restricted to 4 digits. If the file size is less than 10K, its size in bytes will be listed. If it exceeds 10K but not 1M, the size will be expressed in kBytes, with a trailing k. If the file size exceeds 1 Mb, the file size will be expressed in Mb, with a trailing M.
Short file description is restricted to 50 characters. If the description exceeds 50 characters, it will be truncated but trailed with an elipses ("..." to indicate that a longer description exists.
Files are listed by file area, and sorted alphabetically within those areas.
MakeIndex [-q]
the -q flag simply supresses all output from the program.
File:FileIndex.BBS
.