   LISTRS -- Directory/Program List Makers With Action Options
            Copyright (c) 1995 by David M. Wincelberg


                        Table of Contents

I.   Introduction ............................................. 1
II.  How to Use ............................................... 2

Appendices:
A.   Command Line Switches .................................... 3
B.   Trouble-shooting ......................................... 4
C.   Other FileJockey Software Products ....................... 4
D.   License Agreement ........................................ 5


I.   Introduction

     Thank you for trying LISTRS.  LISTRS is a pair of programs
to help you find directories and program files.  In addition,
these programs provide you with several options for a selected
directory or program.  The first one, DIRLIST, presents a
directory list that is more accurate than that produced by "dir
*." since directories may have an extension and other files might
not.  Options for a selected directory include showing a list of
its files, changing to it and removing it from your computer if
it is empty.

     The other program, PROGLIST, shows the current directory's
program files (those with extensions EXE, COM or BAT) in one
listing to help you find the name of the program file to run.
This is helpful since, when you have not used a DOS program in a
while, you might not remember what extension the program file
has.  Its options include type & run the program, type & wait and
view or edit .BAT files.  The first option places the selected
program on the command line and "presses" <Enter> while the
second option allows you to add parameters or switches before
running the program.  Neither of these options takes any memory
away from your program.  (The program name is stored in a
reserved area of memory called the keyboard buffer and PROGLIST
is cleared from memory before DOS reads this name.)

     Both programs correctly sort numbers within filenames.  For
example, FILE2 would appear before FILE10 if you have files by
these names in a directory.  In contrast, DOS and every other
program I am aware of, would place FILE10 before FILE2 since "1"
is less than "2".

     These programs are safe to run on a Pentium processor since,
as far as I am able to determine, they do not perform any
floating point divisions of large numbers.

     If you decide to keep this program after 30 days, you are
required to pay the $10 license and registration fee in order to
use this program legally, receive technical support and be
notified of updates and bug fixes.  (FileJockey Software does not
release products with known bugs.)  Otherwise, you may not keep
the individual files on your PC but you may keep the .ZIP file.
A registration form containing my postal address is provided for
you in the file LISTRS.REG.

     Send comments, suggestions and problem reports to me at
71573,1023 by CompuServe (not Internet) e-mail or at my postal
address.  I plan to read each one, but, if I receive a large
amount of mail, I may not be able to reply to each letter.
     
     You may share this program with others.  Please tell the
recipient(s) that the amount you are charging, if any, does not
include the license and registration fee.  This product is not
available directly from me.  It is only available from bulletin
boards, friends, shareware distributors, etc.

     LISTRS requires DOS 2.1 or higher.


II.  How to Use

A.   DIRLIST

To generate an accurate list of directories in the current
directory, enter:
                             DIRLIST
Unlike using "dir *.", DIRLIST does not include files that have
no extension and does include directories with extensions.  If
you just want this list to be typed on your screen, enter:
                           DIRLIST /T
You may also use the /W and /P switches for a wide display and
pausing between pages, respectively.

     If you don't use command line switches, DIRLIST will ask you
to select a directory from the list and then presents you with
the Directory Options screen.  The option buttons on this screen
are: change To, Show files, Remove, Cancel, and review List.  You
may select an option using the mouse, using the arrow keys to
highlight a choice and pressing <Enter>, or by pressing the
capitalized letter of the desired button.  Also, pressing the
<Esc> key is equivalent to selecting Cancel.

     After reviewing the sorted list of files generated by
selecting Show files, press <Esc> or select any file to return to
the Directory Options screen.  No use is made of the selected
file.  If you choose Remove and the directory is not empty, you
will receive a warning message and will be returned to the
Directory Options screen after you press <Enter> or click the
mouse to select the Continue button.

     Finally, you may specify a directory other than the current
one by typing its name on the command line.  This name may appear
before, after or in between switches.


B.   PROGLIST

To generate a list of programs (those with extensions EXE, COM or 
BAT) in the current directory, enter:
                            PROGLIST
If you just want this list to be typed on your screen, enter:
                           PROGLIST /T
You may also use the /W and /P switches for a wide display and
pausing between pages, respectively.

     If you don't use command line switches, PROGLIST will ask
you to select a program from the list and then presents you with
the Program Options screen.  The option buttons on this screen
are: type & Run, review List, type & Wait, Cancel, View file, and
Edit file.  The last two options only appear if the selected
program has extension BAT.  You may select an option using the
mouse, using the arrow keys to highlight a choice and pressing
<Enter>, or by pressing the capitalized letter of the desired
button.  Also, pressing the <Esc> key is equivalent to selecting
Cancel.
     
     The options including the word "type" cause the program to
place the selected program name on the command line.  Choose type
& Run if you want this program to run immediately and choose type
& Wait if you want to add parameters or switches after the
program name.  The view and edit options invoke a full screen
viewer/editor (that does not respond to mouse commands).  To exit
this editor, press <Esc> and answer "Y" (or "y") to the question
"Are You Sure (Y/N)?".  In addition to the normal cursor
positioning commands, this editor responds to the following:

<Alt>-F             Find a word or phrase

<Alt>-L             Load in another file

In edit mode, the editor also responds to <Insert>, <Delete>,
<BackSpace>, as well as the following:

<Alt>-D             Delete the current row

<Alt>-R             Rename the file

<Alt>-S             Save the file

     If instead of <Alt>-S you press <Esc>, you will be given a
chance to save the file.  If you do so in this manner, the
program will make a backup file with extension BAK.


Appendices

A.   Command Line Switches

Entering DIRLIST /? produces the following summary of command
line switches:

               Lists Subdirectories With Action Options

DIRLIST [directory] [switches]

/T             Type names directly on the screen
/P             Pause after each screen of information
/W             Use wide display -- 5 names per line
               /P and /W only apply when /T is used

The directory name may be a full or partial name.  Using /T
results in the program typing the directory list on the screen
instead of presenting a scrollable pick list and options for the
selected directory.

     Entering PROGLIST /? produces a similar summary:

               Lists Programs With Action Options

PROGLIST [switches]

/T             Type names directly on the screen
/P             Pause after each screen of information
/W             Use wide display -- 5 names per line
               /P and /W only apply when /T is used


B.   Trouble-shooting

Cannot remove directory:
DIRLIST does not delete directories that contain files or
directories other than "." and "..".  However, tools such as DOS
DELTREE do remove non-empty directories.

Out of memory:
If possible, stop another program and try DIRLIST or PROGLIST
again.  Alternatively, you may wish to use a memory management
package to move some programs to high memory.  (See your DOS
manual for further details.)

File/directory read or write errors:
Try a disk repair utility to fix your disk.  There are now such
utilities in recent versions of DOS.  For serious problems, you
may wish to consider a third party product.


C.   Other FileJockey Software Products

Following is a list of current FileJockey Software products.  All
of the compressed files for these products have extension ZIP.
In parentheses after the descriptions are the locations where the
programs may be found on CompuServe and the registration/license
fees.

1.   Cyberspace/CompuServe Tools

CFWRAP 1.1 -- Word Wrapping Tuned for BBS Capture Files:
Prepares BBS capture files for editing by removing page pause
lines ("Press <CR> for more !", etc.) and word-wrapping various
types of paragraphs (including each line starting with ">>" and
indented paragraphs).  Many page pause lines are in a user-
changeable .INI file.  Version 1.1 improvements include multi-BBS
support, better word wrapping, dialog boxes and mouse support.
Pentium safe.  (GO PCCOM, Library 2, $15)

FRMDSK 1.0 -- Enters Text From Disk With Line Preview & Edit:
Use FRMDSK when a BBS requires you to type in lines instead of
allowing you to upload a file.  It copies lines from a file to
your BBS software (or other program) after giving you options.
These options include edit line, finish file, wait, cancel,
next/previous line and another file.  Works only with DOS text
programs that read the keyboard in the standard way.  Pentium
safe 66K TSR.  (GO PCCOM, Library 2, $15)


2.   Programmer Tool

PROGCR 1.0 -- Prepares Programs for Copyrighting:
Protects the privacy of your C/C++ or PASCAL source code
copyright deposit by removing comments after each file's header
(which should primarily consist of your copyright notice) from
copies of the original files.  Also, copies words displayed by
standard or user-specified print commands to a file for spell
checking.  Pentium safe. (GO PCPROG, Library 6, $10)


D.   License Agreement

This is a legal agreement between you ("Licensee") and FileJockey
Software ("Licensor").  Licensor owns all worldwide rights,
title, copyright and other interests in and to the computer
program identified as LISTRS 1.0 ("Software").  By using the
Software, you are agreeing to be bound by the following terms:

1.   Licensor grants to Licensee the non-exclusive and non-
assignable right to use the Software for a period of 30 days
without paying a fee to Licensor.  After 30 days, Licensee may
continue this right by paying $10 to Licensor.

2.   Licensee may distribute copies of the Software and related
files to others provided Licensee informs the recipients that the
Software is subject to a license agreement and that the fee you
charge, if any, does not include the license fee.

3.   Licensor hereby alerts Licensee that the Software and
accompanying documentation are provided "AS IS" without warranty
of any kind.  Licensor assumes all risks involving use of the
Software and its results and performance.

4.   Licensee hereby acknowledges that Licensor bears no
responsibility or liability which may arise or result from
Licensee's use of the Software.  Licensee hereby waives and
releases Licensor from any and all claims for damages, losses and
costs therefrom.  In no event shall Licensor's liability for any
damages ever exceed the price paid for license and registration,
regardless of the form of the claim.

5.   This license agreement shall be construed and enforced in
accordance with the laws of the State of California.  This
agreement may not be modified except by written instrument signed
by both parties.  If any provisions of this agreement are found
to be invalid or unenforceable by the operation of the law, then
invalidity or unenforceability of such provision(s) shall not
affect the validity or enforceability of the other provisions of
this agreement.  Any dispute arising from this agreement shall be
submitted to California courts located in Los Angeles County, and
Licensee hereby submits to the jurisdiction of such courts.


All (registered) trademarks and (registered) service marks are
properties of their respective companies.
