


                                  LISTRS 2.0
                  Program/Directory Lists With Action Options
                Copyright (c) 1995-1996 by David M. Wincelberg


                               Table of Contents

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

       Appendices:

       A.    Command-Line Switches ..................................  4
       B.    Initialization File (LISTRS.INI) .......................  5
       C.    Registration-Reminder Screens ..........................  6
       D.    Troubleshooting ........................................  6
       E.    Other FileJockey Software Products .....................  7
       F.    License Agreement ......................................  8


       I.  Introduction

       LISTRS is a pair of DOS programs to help users find DOS programs
       (.EXE, .COM or .BAT files) and subdirectories within a directory.
       ProgList can run a selected program with or without parameters.
       It looks inside files to exclude Windows 3.x/95 programs.
       DirList can show a selected subdirectory's files and change to
       it.  Both programs ignore Windows 95 long-filename directory
       entries.

            ProgList presents a scrollable, combined list of the DOS
       programs in a directory.  Its options include type & run the
       program, type & wait, and 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.)
       ProgList will change to the drive and directory of a selected
       program instead of assuming that the program is in the current
       directory or on the path.  This avoids the "Bad command or file
       name" message.

            Use the <Up>, <Down>, <PgUp>, <PgDn>, <Home> and <End> keys
       to navigate through a list using the keyboard.  For mouse
       navigation, notice that the highlighted line follows the mouse
       cursor (just as in Windows 95).  To scroll beyond the listed
       items, position the mouse on the first or last item and hold down
       the right mouse button.




            The other program, DirList, presents a scrollable 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 scrollable
       list of its files, changing to it and removing it from your
       computer if it is empty.

            Both programs sort alphanumerically.  For example, FILE_2
       comes before FILE_10.  In contrast, DOS would place FILE_10
       before FILE_2 since "1" is less than "2".  Programmers can add
       alphanumeric sorting to their programs by ordering the library or
       source code from FileJockey Software.  The order form is in
       SORTAN.FRM.

            These programs are safe to run on a Pentium processor since
       they do not perform any floating point divisions of large
       numbers.  In addition, FileJockey Software does not release
       products with known bugs.

            If you decide to keep this program, paying the $10 license
       and registration fee will result in your receiving technical
       support, receiving a code to bypass reminder screens (see
       Appendix C), being notified of updates and bug fixes, promoting
       future product development, and using this program legally.
       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.

            Please send comments, suggestions and problem reports to me
       at 71573,1023 by CompuServe e-mail, at 71573.1023@compuserve.com
       by Internet e-mail, or at my postal address, even if you are not
       currently a customer.  By the second quarter of 1996, my e-mail
       address will also be FileJockey@compuserve.com.

            LISTRS requires DOS 3.3 or later and a hard disk with drive
       letter C.  (It does not have to be installed on this disk.)


       II.  How to Use

       II.A.  ProgList

       To generate a list of DOS 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




                                    Page 2




       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 present you with
       the Program Options screen.  The option buttons on this screen
       are: type & Run, type & Wait, review List, Cancel, and Edit file.
       The last option only appears 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 containing the word "type" result in changing to
       selected program's path and placing the 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.

            By default, the edit option invokes the MS-DOS editor (of
       DOS 5.0 or later).  You may change the path or select another
       editor by modifying LISTRS.INI.  For example, change the line

                                  Editor=EDIT

       to

                                  Editor=LIST

       to run LIST instead.  If ProgList cannot run the selected editor,
       it will allow you to select another one.  For example, ProgList
       cannot run internal DOS commands such as TYPE.


       II.B.  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 present you with the



                                    Page 3




       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 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.


       Appendices

       A.  Command-Line Switches

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

       PROGLIST [pattern] [switches]

       pattern        Wildcard pattern for restricting the program list
       /T             Type names directly on the screen
       /P             Pause after each screen of information
       /W             Use wide screen display -- 5 names per line
       /S             Display SiteCode (and re-write LISTRS.REG)
       /I:initname    Alternate initialization filename (with path)

       The directory name may be a full or partial path name.  Using /T,
       /P or /W results in the program typing the directory list on the
       screen instead of presenting a scrollable pick list and options
       for the selected directory.  The SiteCode is described in
       Appendix C.  It is used to bypass registration-reminder screens.
       ProgList and DirList look for the initialization file in the same
       directory as where they are located.  Use the /I switch to
       specify another location or name for this file.

            Entering DIRLIST /? produces a similar summary:

       DirList [directory] [switches]

       /T             Type names directly on the screen
       /P             Pause after each screen of information



                                    Page 4




       /W             Use wide screen display -- 5 names per line
       /S             Print SiteCode and modify LISTRS.REG
       /I:initname    Alternate initialization filename (with path)


       B.  Initialization File (LISTRS.INI)

       As shipped, the initialization file looks like this:

       [Registration]
       RegKey=
       Notified=NO

       [ProgList]
       Editor=EDIT
       WinExclude1=WINSTUB.EXE
       DOSInclude1=PARADOX.EXE

       In order to turn off the registration-reminder screens (see
       Appendix C), you need to place the right code after the equal
       sign on the "RegKey=" line.  This code depends on information
       about your computer that is summarized in a SiteCode.  SiteCodes
       are not affected by installing or deleting programs, creating or
       deleting files, or changing configuration files.

            Once you place a code on that line, the program will test it
       and tell you whether or not it is correct.  Afterwards, Notified
       will be set to YES.  This feature is useful since the random
       occurrences of the registration-reminder screen prevent easily
       determining if the registration key is correct.

            To select another editor, replace EDIT with its name.  If
       the editor can be run from any directory, you do not need to
       include its path.

            ProgList identifies Windows 3.x/95 programs by looking for
       codes within .EXE files.  Occasionally, a Windows program may not
       have these codes and a DOS program may have them.  As a result,
       there are provisions to exclude unrecognized Windows programs and
       to include mis-identified DOS programs.  The formats for these
       (left-justified) lines are:

                   WinExcludeN=[[drive:]path]filename[.EXE]
                   DOSIncludeN=[[drive:]path]filename[.EXE]

       where N is a consecutive integer (1, 2, ..., 10, ...) and
       brackets signify what parts of the full filename are optional.
       For example, you do not need to include the path unless you
       specify the drive letter and colon.





                                    Page 5




            Both DirList and ProgList will look for LISTRS.INI in the
       same directory containing these programs unless you use the /I
       switch.  If they do not find this file, they will give you the
       option of either editing the path and file name or not reading
       it.


       C.  Registration-Reminder Screens

       To inspire you to register LISTRS, both ProgList and DirList may
       display a two-part reminder screen at the beginning and/or end of
       a program run.  This screen will not appear every time since its
       use is affected by a random-number generator.  Registered users
       can bypass this screen with the system-specific registration key
       (RegKey).  The key for your computer depends on a four-character
       code (SiteCode) that is printed on the first screen.  SiteCodes
       are not affected by installing or deleting programs, creating or
       deleting files, or changing configuration files.

            One of the buttons on the first screen will produce a
       version of LISTRS.REG that contains your SiteCode.  To force this
       screen to appear, enter PROGLIST/S or DIRLIST/S.  Selecting the
       Continue button will usually display a second screen in which you
       signal your understanding of the shareware concept by typing the
       displayed word, such as AGREE.  (Your typing will appear in upper
       case.)

            In response to your payment and SiteCode, you will receive
       the appropriate RegKey by e-mail or postal mail, depending on
       whether or not you include an e-mail address.  Place this key on
       the "RegKey=" line of LISTRS.INI.


       D.  Troubleshooting

       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.




                                    Page 6




       E.  Other FileJockey Software Products

       FileJockey Software products include those listed below.  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.  Some of these products are also available from ZDNet and
       SimTel archives.


       E.1.  System Tool (DOS)

       WRDGRB 1.3 -- Copies Words From DOS Screen to Command Line:

       WordGrab v1.3 is a 23K memory-resident program for quickly
       copying text from the DOS screen to the command line using a
       mouse.  After displaying a directory list, you can paste a
       filename to the command line in the form required by DOS using a
       double click followed by a single click (for confirmation).
       WordGrab also works in a full-screen DOS session under Windows.
       Enhancements include: mouse-only way to separate filenames.  Free
       upgrade for implemented significant suggestions or bug fixes.
       (GO PCUTIL, Library 3, $30)


       E.2.  Programmer Tools (DOS, Windows)

       YEARIN 1.0 -- Handles 2-Digit Year Input for Beyond 1999

       YEARIN demonstrates a routine that properly handles two-digit
       year inputs now and will do so in the 21st century.  For example,
       98 converts to 1998 and 3 becomes 2003, regardless of when in the
       next few decades those numbers are entered.  Also enclosed is a
       free Microsoft C/C++ .OBJ file containing this routine.  YEARIN
       requires Windows 3.1 or higher.  Free program by FileJockey
       Software.  (GO PCPROG, Library 8, $0)


       SRLIB 1.1 -- LIB: Alphanumeric Filename Sorting:

       SRLIB is a set of library routines to sort filenames
       alphanumerically.  For example, it places FILE_2 before FILE_10
       and can handle long file names, leading zeros and spaces.  SRLIB
       is compiled for Microsoft C/C++'s and Borland TC++'s small and
       large memory models.  (See SRDEMO in MSLANG, Lib. 3.)  New: case-
       insensitive routine, 3rd space-handling option, commas-within-
       numbers handling, and more.  SRDEMO.C, included in SRLIB.ZIP,
       reads a directory once even for an unknown number of files.  GO
       SWREG (#5947) to purchase SRLIB on-line.  Site licenses and




                                    Page 7




       source code are available.  No known bugs.  ($24 plus $1 S/H (by
       e-mail) or $24 plus CA tax plus $4 S/H (by disk))
       ** Plans for next version: Windows-based demo.  (This product
       will be renamed and its demo may be stored in a different
       location.)


       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.  (GO PCPROG, Library 6, $10)
       ** Plans for next version: making it Windows based, adding an
       option to create only the spell-check file, and including better
       file-extension mapping to file types.


       E.3.  BBS-Session Tool (DOS)

       FRMDSK 1.1 -- Enters Text From Disk With Line Preview & Edit:

       Use FRMDSK when BBS software (or another program) requires you to
       type in text instead of allowing you to upload a file.  It copies
       lines from a file to your program after giving you preview, edit,
       and other options.  Works only with DOS text programs that use
       standard keyboard reading, such as VendEdit (mentioned with
       permission).  New features include: safe command-line unloading
       and selectable hotkey sequence.  Free upgrade for implemented
       significant suggestions or bug fixes.  37K or 63K TSR.
       FileJockey shareware.  (GO PCCOM, Library 2, $5)


       F.  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 2.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



                                    Page 8




       charge, if any, does not include the license fee.  The attached
       VENDINFO data record is hereby incorporated by reference.  Any
       distribution satisfying all the distribution requirements
       expressed in that data record is hereby authorized.

       3.   Licensor hereby alerts Licensee that the Software and
       accompanying documentation are provided "AS IS" without warranty
       of any kind.  Licensee 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.






















                                    Page 9

