JLSCAN-CPC Version 1.0

                        Jerry McReynolds
                         J&L Consulting
                     8501 Willows Road #228
                        Redmond, WA 98052


     Any and all contributions are gratefully accepted. I ask for a 
     $20 registration fee if you use this program regularly.

     You are free to distribute JLSCAN.ARC in its complete state, this
     file JLSCAN.TXT and JLSCAN.EXE. Do not distribute JLSCAN.EXE alone.

     This is a user-supported program.  If I receive no support, I will
     not release future updates into the Shareware Market. Custom modules 
     are available to registered users.

     JLSCAN is a text file scanning program that has many more features
     than the popular BROWSE and LIST type of programs. It allows 
     the user to have access to multiple files during a JLSCAN session.  

     The command line syntax for JLSCAN is:

     JLSCAN (filespec)

     Where (filespec) can contain the DOS wild card characters * and ?
     and can be repeated. Example: JLSCAN \c\*.c \include\*.h  will
     scan all the files in the \c directory that have an extension of .c
     and will also scan all the files in the \include directory  that
     have an extension of .h.

 __________________________________________________________________________

                JLSCAN KEYSTROKE COMMANDS


     The following is a list of keys that perform special functions  in
     JLSCAN.  To activate any of the functions, simply touch the  key
     that is associated with that function.  Detailed explanations
     of each command follow this summary.

     A - Append a new file         F1 - Export marked block.
     C - Choose a file to scan.    F2 - Save current defaults.
     D - Display file statistics.  F3 - Set colors.
     F - Find string.              F4 - Set scroll values.
     G - Goto line number.         F5 - Set Marker style.
     H - Display this screen.      F6 - Set Status Line position.
     L - Length of current line.   F7 - Mark beginning of block.
     M - Merge new file.           F8 - Mark end of block
     R - Repeat last find.         F9 - Enter scroll going up.
     S - Toggle case sense.        F10 - Enter scroll going down.
     V - Display Version No.       Alt-F5 - Marker anchor toggle
     ! - View DOS screen.          Alt-X - Exit JLSCAN - no prompt.
     # - Toggle line numbers.      Esc - Exit JLSCAN with prompt.


     Alt-B  Delete marked block.   Alt-D  Discard lines.
     Alt-F  Select files.          Alt-M  Delete selected files.
     Alt-W  Delete blank lines.


     The cursor control keys perform the following functions:

       KEY                       FUNCTION

     Up Arrow      Scroll text one line towards the top of the file.
     Down Arrow    Scroll text one line towards the bottom of the file.
     Right Arrow   Scroll text one character towards the right margin.
     Ctrl-Right    Move 79 characters to right.
     Left Arrow    Scroll text one character towards the left margin.
     Ctrl-Left     Move 79 characters to left.
     Home          Scroll text to the top of the file.
     Ctrl-Home     Move to top of marked block.
     End           Scroll text to the bottom of the file.
     Ctrl-End      Move to end of marked block.
     PgUp          Scroll text 24 lines towards the top of the file.
     PgDn          Scroll text 24 lines towards the bottom of the file.
     Return        Move text to the left margin.
     Del           Delete current line.


_____________________________________________________________________________

           DETAILED DESCRIPTIONS OF JLSCAN COMMANDS


     A - Append a file.

     Select another file and add it to the end of the current file.
     When the window opens, type the new filename and press <Enter>.

     C - Choose a file to scan.

     To select from the list of files given on the command line,  touch
     the 'C' key. This action will open a window in the middle of the
     screen, the screen will display the currently-loaded file.
     To select a different file use the up and down arrow keys, to load
     that file, touch <Enter>.  To abort the choose function, touch Esc.

     D - Display file statistics.

     This function will open a window at the top of the screen and dis-
     play statics about the file that is currently being scanned.
     The statistics are laid out as follows:

     Filename  File Date Stamp    File Time Stamp   File Size   Lines

     F - Find string.

     This  function will open a window and prompt the user for a 
     string to search for.   Simply type in  the desired  string 
     and touch the return key.  The search will take place from 
     the current marker position and work towards the end of
     the file.  If the function finds the string, it will place that
     line on the current marker line and return to the scan  session.
     If the function does not find the string,  it will open a window
     at the top of the screen and tell the user that it could not find
     the string.  The case sense of the find function can be toggled
     by touching the 'S' key.  To abort the find function, simply sup-
     ply the find function with an empty string.

     G - Goto line number.

     This  function will open a window at the bottom of the string  and
     prompt the user for a line number to go to.  Simply type in a num-
     ber and touch return.  To abort, touch return.

     H - Display the Help screen.

     L - Display the length of the current line in characters.

     M - Merge file.

     This function opens a window and asks for a filename. If you have
     entered more than one file on the command line, you can use the
     Page Up or Page Down keys to scroll through the files.  Otherwise
     just type in the desired path and filename.  The file will be
     inserted at the current marker position.

     R - Repeat last find.

     This function will search again for the text specified in the
     previous search.  This works even if you have performed other
     functions between searches.

     S - Toggle case sense

     This function toggles the case sensitivity of the (F)ind command.
     A window will open, showing whether case sensitivity is on or off, 
     and ask you if you want to change it.

     V - Display Version number of JLSCAN.

     # - Toggle line numbers On/Off.

     JLSCAN will display the file with or without line numbers.  If you
     wish to see line numbers, simply touch the '#'  (shifted 3)  key,
     this  will cause all lines to be display along with the line  num-
     bers.  To get rid of the line numbers, touch the '#' key again.

     ! - View DOS screen.

     To see the screen as it was when JLSCAN was called, simply touch the
     '!'  (shifted 1) key.  This will display that screen, to return to
     JLSCAN, touch the spacebar.


     F1 - Export marked block.

     To export a marked block to another file or to  the printer,
     simply mark a block (the first line is always marked on entry 
     to JLSCAN), then touch  the 'F1'  key.  JLSCAN will open a 
     window at the bottom of the screen and prompt the user for a 
     file name. Examples of legal file names are: REPLY.TXT,
     \user\comm\answer.txt, a:save.dat.  To abort the export
     function, simply supply an empty file name.  To print your marked
     text, type PRN as the filename.  To Export or print the entire
     file, mark the first line as the beginning of the block, and
     the last line as the end, then press F1 and enter PRN as the
     filename.  Make sure your printer is on and loaded with paper.

     F2 - Save current defaults.

     This will cause JLSCAN to save the current colors, line number 
     display,  marker position,  status line position,  and
     case sensing to the filename that is in the JLSCAN system variable.
     JLSCAN will use these values for the next scan session.

     F3 - Set colors.

     This function will allow the user to change the colors for  normal
     text,  marked text, dialogue boxes, and status line.  The function
     will  take  the user to a screen that is used to set the colors.
     Once in that screen, touching the return key will move the marker,
     touching the up or down arrow keys will change the foreground
     color for the selected item, touching the left or right arrow keys
     will change the background color for the selected item.  To  exit
     the function, touch Esc.

     F5 - Set marker style

     By pressing this key, you can choose one of three marker types.
     The first is an arrow in the left screen border.  Next is a 
     highlighted bar which marks the current line. The last option is 
     no marker at all.  Each time you press the key, the marker changes
     to the next option.

     Alt-F5 - Set marker anchor

     This command switches the marker from a fixed position, with the 
     text scrolling, to a moving marker.  Press it again, and it changes
     to the previous mode.

     F6 - Set Status Line position.

     To change the position of the status line,  simply touch the  'F6'
     key.   The  status line can appear at the top or bottom of  the
     screen and can also be removed.  The format of the status line is
     as follows:

     XXXXX < Current Line  Start: BBBBB  Stop: EEEEE  Lines LLLLL  NAME

         Symbol       Meaning     

         XXXXX     Current line.
         BBBBB     The beginning line of the marked block.
         EEEEE     The ending line of the marked block.
         LLLLL     The total number of lines in the file.
         NAME      The current file name.

     F7 - Mark beginning of block.

     To mark the beginning of a block, touch the 'F7' key.   The mark
     will appear at the marker location, if the marker is displayed.  If the
     marker is not displayed, the top line on the screen is marked.

     F8 - Mark end of block.

     To mark the end of a block, touch the 'F8' key.  
     The marks are ex-plained above.

     Esc - Exit Scan.

     When  you touch the Esc key while in the scan mode,  JLSCAN will
     open a window and prompt the user.   To exit JLSCAN touch the 'Y'
     key, any other key will remove the window and return to scan mode.

     Alt-B - Delete block.

     This function deleted the block you have marked.  It only deletes
     the block in memory, not in the original file.

     Alt-D - Discard lines.

     This command will delete all lines containing text you supply.
     A window will open, asking you to enter text.  A prompt asks for 
     confirmation before deleting the lines.

     Alt-F - Set Mass Delete file Name

     This function allows you to name files for deletion while 
     using JLSCAN.  You can use DOS wildcards with this command.
     Enter your file specifications in the window.

     Alt-M - Mass Delete

     This command deletes the files you named with the Alt-F 
     function.  This is a powerful command, so be careful not to
     delete files you want to save.

     Alt-W - Delete blank lines.

     This command is designed to help you clean up blank lines in
     files before exporting them to another file, or to the printer.
     JLSCAN will report how many lines have been deleted.

     Alt-X

     This function exits JLSCAN immediately, without a prompt allowing
     you to abort.

_____________________________________________________________________________

     Please send any questions, suggestions, or registration to:

                         J&L Consulting
                     8501 Willows Road #228
                       Redmond, WA  98052
                         (206) 883-6817
_____________________________________________________________________________
 

              JLSCAN-CPC, Version 1.0 USER REGISTRATION



     NAME:   ________________________________________________________

     ADDRESS: _______________________________________________________

     CITY:    _______________________________________________________

     STATE:   _______________________________________________________

     ZIP:     _______________________________________________________

     FEE: $20.00


     This registration entitles you to the current registered users'
     version and puts you on the update list.  You will receive notice
     of any updates or new versions of JLSCAN. If you have a function 
     that you would like to see in JLSCAN, let me know and I will see 
     what I can do to implement your ideas.

     Thank you for your support!

     Jerry McReynolds.