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 .

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