home *** CD-ROM | disk | FTP | other *** search
- *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.