*MENU HELP
Select a menu item by moving the menubar on it and depressing the RETURN key.
You may also select a menu item by typing the menu's highlighted letter.
The key combination ALT-X will terminate ProGRAP immediately. ALT-X can not
be used while one of the tools is running, this to prevent file damage.
ALT-Z will suspend ProGRAP and return to the DOS-prompt.  To return to
ProGRAP, type EXIT.

Add the following line to your AUTOEXEC.BAT :

set prograp=drive:\path

Replace drive:\path with the path where ProGRAP should look for its help and
config file.
If ProGRAP does not find the environment variable prograp, then it starts
searching in the directories specified in the PATH instruction of your
AUTOEXEC.BAT file. If not found, the root of drive c: is assumed.
ProGRAP can start running without the files PROGRAP.HLP and PROGRAP.CFG,
but not without the files PROGRAP.MSG and PROGRAP.SCN.

Variables found in tthe PROGRAP.CFG file (Default setup) :

ProGRAP v2.00 setup file  (C) 1990-1991 By Karl G.L. Moortgat
LINELENGTH=255               Max. linelength         1-512
TAB_WIDTH=4                  Max. Tab width          1- 80
CASEFLAG=0                   Case sensitive search   0-  1 (0=ON, 1=OFF)
EXTENTIONFLAG=0              Use extention           0-  1   "      "
DIRFLAG=0                    Use directory           0-  1   "      "
SCRFILPRT=1                  Screen/File/Printer     1-  3 (1=S, 2=F, 3=P)
DATE_TIME=0                  Preserve time and date  0-  1 (0=YES, 1=NO)
IMMSELFLAG=0                 Automatic file select   0-  1   "      "
EMBSPACEFLAG=0               Replace spaces (''/"")  0-  1   "      "
LINESPERPAGE=66              Lines per page         30-100  
TOPBOTTOMMARGIN=2            Top and bottom margin   0- 10
SPACEBETWEENLINES=0          Inter line spacing      0- 10
LEFTMARGIN=0                 Left margin             0- 40
RIGHTMARGIN=80               Right margin           40-192
PAGEHEADER=0                 Print pageheader        0-  5 (Choice list)
PAGEFOOTER=0                 Print pagefooter        0-  1 (0=NO, 1=YES)
PAGENUMBERS=1                Print pagenumbers       0-  1   "      "
LINENUMBERS=0                Print linenumbers       0-  1   "      "
STOPEACHPAGE=0               Pause each printed page 0-  1   "      "
FORMATPRINT=1                Use above print options 0-  1   "      "
PRINTERPORT=0                LPT1/2 COM1/2           0-  3 (Choice list)
FILE_SPEC=*.*                File select spec
OUTPUT_FILE=C:\PROGRAP.PRT   ProGRAP's output file
WILD_CHARACTER=.             Search wild character
EXTENTION=TMP                Alternate file extention (See flag)
DIRECTORY=C:\                Alternate output directory (See flag)
                             ────────────┬───────────────────────────────
                                         │
                                         └─ Meaning of variables

The values are adjusted when out of range (Default values are used).  The
order in which the variables appear is not important.  Nor is the presence
of each variable.  Upper- and lowercase may both be used.


Key usage :
═══════════

HELP
────
Alt-F1       : Zoom and unzoom help window.

MENU
────
CTRL + HOME  : First item.
CTRL + END   : Last item.
LEFT         : Previous item.
RIGHT        : Next item.
UP           : Move up one item.
DOWN         : Move down one item.
ESC          : Exit to higher-level menu.
ENTER        : Select current highlighted item.
LETTER       : Move to item with same selection character and select.

CHOICE LIST
───────────
UP           : Move cursor up one row.
DOWN         : Move cursor down one row.
PGUP         : Move cursor up one page.
PGDN         : Move cursor down one page.
HOME         : Move cursor to first row in window or first row in list.
END          : Move cursor to last row in window or last row in list.
ESC          : QUIT choice list.
ENTER        : Select.

FORM
────
F2           : Activate choice list if present.
F6           : Clear field.
Shft-F3      : Undo.
Shft-F6      : Clear from cursor to end of field.
F7           : Previous item on the form.
F8           : Next item on the form.
F10          : Exit form.
END          : Move cursor to end of the field.
HOME         : Move cursor to beginning of the field.
CTRL + HOME  : First item of the form.
CTRL + END   : Last item of the form.
ENTER        : Move to next item on the form.
TAB          : Next item.
Shft-TAB     : Previous item.
SPACE        : Toggle between field values.

Shift-F1 calls an alternate help function which gives you help about which
keys to use at that moment.

The top menuline shows besides the clock the status of the keyboard.
It shows wheather num-lock, caps-lock or scroll-lock is turned on.
Scroll-lock has a special function.  When a tool is started and scroll-lock
is ON,  the tool will produce 48 lines of output and will then be halted.
During this pause you can scroll thru these 48 lines using the cursor keys.
To continue,  hit the spacebar,  another 48 lines will be buffered.  ESC will
stop the tool.
*SELECT FILES
Select the files which will be used with one of the tools.  Selecting this
option causes the selected file list to be cleared.  The selected file list
remains active after the use of each of the tools.  A file can be viewed
with F3.  Use F2 to change the file search specification.
*VIEW SELECTION
Pop's up a window with all the selected files.  Use the cursor keys, home,
end, page up and down keys to scroll through the list.  The mouse can be
used when a driver is active.
*CHANGE DRIVE
Change the system's current drive.  If it is not possible to change to that
drive,  ProGRAP will switch to drive C:.
*EXIT PROGRAP
Exit from ProGRAP,  and return to the calling program or OS.
*FGREP
Search through the selected files for a given string.  FGREP can search for
three strings at the same time.  If case sensitive search and output to
screen only have been selected,  then FGREP will work fast !  Case insensi-
tive search and sending the result to a file,  slows down FGREP.
*GRAP
Search through the selected files for a given string and replace this string
with the second entered string.  Selecting case insensitive search and output
to file,  slows down GRAP.
*UNTAB
Search through the selected files for tabulations and replace them with
spaces.  The tabulation width can be changed,  select SETUP and from this
list TAB-WIDTH.
*TAB
Replace groups of spaces by tab's.  The tabulation width can be changed,
select SETUP and from this list TAB-WIDTH. It is possibble to prevent spaces
between single or double quotes being replaced by tab's. See SETUP / REPL.
EMBEDED SPACES.
*CASE
Select wheather the search for a string should be case sensitive or not.  Se-
lecting sensitive search speeds up FGREP and GRAP,  but does not allow the
use of wild characters.
*WILDCHAR
Select the wild character to be used in search functions.  This feature is
only available when case insensitive search is used.
*TABWIDTH
Enter the number of spaces that should be used when replacing a tabulation.
*EXTENSION
Enter the extension that should be used when preserving the original files.
For GRAP and UNTAB only.
*DIRECTORY
Enter the path where output files should be placed. For GRAP and UNTAB only.
When this option is active,  the changed files are placed in this directory.
*USE EXTENSION
When this flag is turned on, GRAP and UNTAB will create a file with the ori-
ginal name,  but with the extension defined with the option EXTENSION.
*USE DIRECTORY
When this flag is turned on, GRAP and UNTAB will send their modified files
to this directory leaving the original files unchanged.  This option makes
the use of an alternate extension optional.
*LINELENGTH
Enter the linelength that GRAP and UNTAB should preserve.  When the maximum
linelength is exeeded,  the original line is written to the output file.
*IMMEDIATE
If this option is on,  all files will automaticly be marked when selecting
files.
*VIEW
View ProGRAP's setup.  Shows all options which can be saved to the ProGRAP
config file.
*DEFAULT
Use ProGRAP's default setup.  This setup will be used when no ProGRAP config
file is present.
*LOAD
Load a previous defined ProGRAP setup.  When the ProGRAP config file exists,
the file will be used at startup.

Add the following line to your AUTOEXEC.BAT :

set prograp=drive:\path

Replace drive:\path with the path where ProGRAP should look for its help and
config file.
*SAVE
Save ProGRAP's current setup to 'C:PROGRAP.CFG'.  This file will be used at
startup.
*SCREEN
Ouput produced by one of the tools will only appear on the screen.  This is
the fastest means of output.
*FILE
Output produced by one of the tools will be sent to the screen and to a file
*PRINTER
Output produced by one of the tools will be sent to the screen and to the
printer connected to the port selected under SETUP / PRINTER SETUP.  Each
line is always untabed and wrapped at the selected right margin.
*CASE2
Select ON when sensitive search is to be in effect or OFF when each match is
good.  It slows down FGREP and GRAP when turned off.  Wild characters can
not be used if turned on.
*TABWIDTH2
Replace tab's with this number of spaces.  Range : 1 - 80.
*WILDCHAR2
Wild character to be used in string search functions.  Can only be used when
case insensitive search is in effect.
*EXTENSION2
Enter any valid DOS file-extension.
*DIRECTORY2
Enter a valid path for GRAP and UNTAB output files.  No filename allowed.
ProGRAP will check if the path is valid.
*USE EXTENSION2
Select YES if the original file has to be preserved by adding a different
extension to the original filename.
*USE DIRECTORY2
Select YES if you want the original file to be preserved.  The output files
of GRAP and UNTAB will be placed in the directory specified at DIRECTORY.
Extension usage is optional.
*LINELENGTH2
Enter the maximum linelength for GRAP and UNTAB.  If this maximum length is
exeeded the original line is written to the output file.
Range : 1 - 512.
*IMMEDIATE2
Select YES if you want the files to be selected automaticly when choose the
option SELECT FILES.
*FILESPEC
Enter the file specification to search for.  If no extention is given, fn.*
is assumed.  If no filename is given *.ext is assumed.  Path or drive spe-
cifications are not allowed.
*OUTFILE
The output file specification requires a valid dos path and filename.  The
given path must exist.  The file will be created if not existing.
*SEARCH
Enter a string to search for.  This string may be up to 44 characters long.
The search for this line is affected by the case sensitive flag.
"" And '' can be used as delimitters.  They are needed when the last
characters of the search string are blanks.
"TEST  " Will find only TEST folowed by two blanks.
TEST     Will find all appearances of TEST
Conditional search :
 -  Both conditions are set to OR
    The search is succesful when one of the three strings is found.
 -  Condition 1 is set to OR and condition 2 set to AND
    The search is succesful when string 1 is found or when string 2 and 3
    are found together.
 -  Condition 1 is set to and and condition 2 set to OR
    The search is succesful when string 1 and 2 are found together or when
    string 3 is found.
 -  Both conditions are set to AND
    The search is succesful when the three strings are found together.
 -  Placement of parentheses.
    Makes only sence when condition 1 is not the same as contition 2.
    
    ex. (1 and 2) or 3  Finds 1 together with 2 or
                        finds 3      
        1 and (2 or 3)  Finds 1 together with 2 or
                        finds 1 together with 3
*ORGTXT
Enter the original text.  GRAP will search for this line.  The search for
this line is affected by the case sensitive flag.  This string may be up to
44 characters long.
"" And '' can be used as delimitters.  They are needed when the last
characters of the search string are blanks.
"TEST  " Will find only TEST folowed by two blanks.
TEST     Will find all appearances of TEST
*REPTXT
Enter the replacement text.  If a replacement causes the line to exeed the
linelength defined,  GRAP will preserve the original line.  The replacement
text may be up to 44 characters long.  The replacement text is not affected
by the case sensitive flag.  If no text is entered,  then the original
string is replaced with the NULL string.
"" And '' can be used as delimitters.  They are needed when the last
characters of the replacement string are blanks.
*APPEND
When this message appears,  it means the result file already exists.  There
are two possibilities : YES - append the results to the existing file.
                        NO  - overwrite the existing result file.
*CREATE
The requested output directory does not exist.  There are two possibilities :
YES - create the directory.
NO  - do not create the directory.
*FILE SELECTION
Move the selection bar with the keys : HOME, END, Page Dn, Page Up, cursor
up and down.  Mark the files to be used by the tools with INS.  The + key
marks all the files shown (Same as the immediate select flag).  The - key
unselects all previous marked files.  The * key inverts,  all marked files
become unselected and all unselected will be marked.
All the files in a certain directory can be marked automaticly upon entry
by turning the immediate select flag on.

- [.]  Returns to the root if selected.
- [..] Select this to go up one directory.

ESC brings you back to the menu.
*DRIVE SELECTION
Move the selection bar with the keys : HOME, END, Page Dn, Page Up, cursor
up and cursor down.  Select the drive you want to use and press the ENTER
key.  If ProGRAP is unable to select this drive,  it will re-select the
current drive if still valid.  If more drives are shown then present, then
add the line LASTDRIVE = to your config.sys file.  If drive B is shown but
not present,  contact your local dealer (Wrong dip-switch settings).
*EMB_SPC
Should TAB preserve spaces which are embeded between single or double
quotes ?  It is not needed for regular text files but may be very impor-
tant with program source files.
*EMB_SPC2
Select YES if you want spaces between quotes to be converted to tab's or NO
if they should be preserved.
*RLFTBLNK
Checks lines of the selected files for the presence of leading or trailing
blanks and/or tabs.  They are all removed up to the first character different
from a blank or a tab character.
*TOUPPER
Converts each line for each of the selected files to uppercase characters.
*TOLOWER
Converts each line for each of the selected files to lowercase characters.
*LEFTRGHT
Remove leading or trailing blanks and/or tab's.  Select wheather this should
be done starting from the left (Leading) or starting from the right
(Trailing) or both.  Press the spacebar to toggle between left and right and
hit return to start the tool.
*TRUNC
Truncate long lines to a given length.  Shorter lines can be lengthened using
a specified character.
*MAXLEN
Truncate lines longer than the length specified here.  The lines will be
truncated at the right side.  The length should be in the range from 1 to
512.  The default value is always 80.
*FILLCHAR
Define the character to be used when lines are to be filled up in case the
line is shorter than the length used to truncate.  Any ASCII character may be
specified here.  The default character is always a blank.
*FILL
Select wheather the line should be filled or not.  Change from yes to no,
using the spacebar.  Pressing the enter key or cursor down key causes the 
program to start.  The default is always set to NO.
*PRNSETUP
This form includes several parameters for printing selected files.
 - Number of lines per page
 - Top and bottom margins
 - Space between lines
 - Left and right margins
   Right margin is always active when output is sent to the printer.
 - Print page heading/footing ?
   Possible headers :
     - No headers
     - Pagenumbers
     - Filename and pagenumbers
     - Date and pagenumbers
     - Custom title and pagenumbers
     - Custom title
 - Print pagenumbers ?  Includes date and time, the heading is printed
   in the middle.
 - Print linenumbers ?
 - Pause each printed page ?  This is case of manual paperfeed.
 - Print formatting active.  If this option is set to No, all the selected
   files are printed one after another without formfeeds at the end of each
   file.  All the options on this form become active when this option is set
   to YES.
 - Printer port
   This will always be used, even when print formatting is not active.
   F2 lets you choose between LPTx and COMx.  The COMx ports are
   initialized as follows :
      BAUD=9600 DATA=8 STOP=1 PARITY=none
*HEADER
Enter the text to be printed on top of each page.
The text can maximum be thirty characters long.
*FOOTER
Enter the text to be printed at the bottom of each page.  The text may be
up to thirty characters long.
*TIME_SET
Should ProGRAP preserve the original time and date stamp given to an already
existing file or should the system's time and date be used when a file is
created.
*TIME_SET2
Select YES if ProGRAP has to preserve the original date and time.  Select NO
when the system's time and date is to be used.
This option is only useful when the extention and output directory swithes
won't be used (Source and target file in the same directory, the target file
receives the same name and extention as the source file).
*DOS SHELL
Start a DOS shell (COMMAND.COM is invoked).  ProGRAP is halted and the DOS
prompt will appear.  When you are finished at the DOS prompt, type EXIT to
return to ProGRAP.
*SOUND
Turn ProGRAP's sound ON or OFF.  In case of errors, illegal actions....
*SOUND2
Select ON if you want sound if errors occur or illegal actions are made.
Select OFF if no sound has to be produced at all.
*TSCRAMBLE
The selected files will scrambled with the password entered.
The files will become unreadable.

WARNING !!! If you forget your password,  it will be very hard to recover
            your original file !!!!
*TUNSCRAMBLE
The selected files will unscrambled with the password entered.
This is the opposite of SCRAMBLE.

WARNING !!! Only the password used with SCRAMBLE will recover your original
            file !!!!
*PASSWORD
Enter your password and hit ENTER to start (un-)scrambling.  You may may
enter any character.
*VSEARCH
Enter a search text.  Each found string be highlighted.  Press Shift-F2 to
turn off search.
