home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / SYSTEM / PGRAP207.ZIP / PROGRAP.HLP < prev    next >
Encoding:
Text File  |  1991-09-19  |  18.4 KB  |  415 lines

  1. *MENU HELP
  2. Select a menu item by moving the menubar on it and depressing the RETURN key.
  3. You may also select a menu item by typing the menu's highlighted letter.
  4. The key combination ALT-X will terminate ProGRAP immediately. ALT-X can not
  5. be used while one of the tools is running, this to prevent file damage.
  6. ALT-Z will suspend ProGRAP and return to the DOS-prompt.  To return to
  7. ProGRAP, type EXIT.
  8.  
  9. Add the following line to your AUTOEXEC.BAT :
  10.  
  11. set prograp=drive:\path
  12.  
  13. Replace drive:\path with the path where ProGRAP should look for its help and
  14. config file.
  15. If ProGRAP does not find the environment variable prograp, then it starts
  16. searching in the directories specified in the PATH instruction of your
  17. AUTOEXEC.BAT file. If not found, the root of drive c: is assumed.
  18. ProGRAP can start running without the files PROGRAP.HLP and PROGRAP.CFG,
  19. but not without the files PROGRAP.MSG and PROGRAP.SCN.
  20.  
  21. Variables found in tthe PROGRAP.CFG file (Default setup) :
  22.  
  23. ProGRAP v2.00 setup file  (C) 1990-1991 By Karl G.L. Moortgat
  24. LINELENGTH=255               Max. linelength         1-512
  25. TAB_WIDTH=4                  Max. Tab width          1- 80
  26. CASEFLAG=0                   Case sensitive search   0-  1 (0=ON, 1=OFF)
  27. EXTENTIONFLAG=0              Use extention           0-  1   "      "
  28. DIRFLAG=0                    Use directory           0-  1   "      "
  29. SCRFILPRT=1                  Screen/File/Printer     1-  3 (1=S, 2=F, 3=P)
  30. DATE_TIME=0                  Preserve time and date  0-  1 (0=YES, 1=NO)
  31. IMMSELFLAG=0                 Automatic file select   0-  1   "      "
  32. EMBSPACEFLAG=0               Replace spaces (''/"")  0-  1   "      "
  33. LINESPERPAGE=66              Lines per page         30-100  
  34. TOPBOTTOMMARGIN=2            Top and bottom margin   0- 10
  35. SPACEBETWEENLINES=0          Inter line spacing      0- 10
  36. LEFTMARGIN=0                 Left margin             0- 40
  37. RIGHTMARGIN=80               Right margin           40-192
  38. PAGEHEADER=0                 Print pageheader        0-  5 (Choice list)
  39. PAGEFOOTER=0                 Print pagefooter        0-  1 (0=NO, 1=YES)
  40. PAGENUMBERS=1                Print pagenumbers       0-  1   "      "
  41. LINENUMBERS=0                Print linenumbers       0-  1   "      "
  42. STOPEACHPAGE=0               Pause each printed page 0-  1   "      "
  43. FORMATPRINT=1                Use above print options 0-  1   "      "
  44. PRINTERPORT=0                LPT1/2 COM1/2           0-  3 (Choice list)
  45. FILE_SPEC=*.*                File select spec
  46. OUTPUT_FILE=C:\PROGRAP.PRT   ProGRAP's output file
  47. WILD_CHARACTER=.             Search wild character
  48. EXTENTION=TMP                Alternate file extention (See flag)
  49. DIRECTORY=C:\                Alternate output directory (See flag)
  50.                              ────────────┬───────────────────────────────
  51.                                          │
  52.                                          └─ Meaning of variables
  53.  
  54. The values are adjusted when out of range (Default values are used).  The
  55. order in which the variables appear is not important.  Nor is the presence
  56. of each variable.  Upper- and lowercase may both be used.
  57.  
  58.  
  59. Key usage :
  60. ═══════════
  61.  
  62. HELP
  63. ────
  64. Alt-F1       : Zoom and unzoom help window.
  65.  
  66. MENU
  67. ────
  68. CTRL + HOME  : First item.
  69. CTRL + END   : Last item.
  70. LEFT         : Previous item.
  71. RIGHT        : Next item.
  72. UP           : Move up one item.
  73. DOWN         : Move down one item.
  74. ESC          : Exit to higher-level menu.
  75. ENTER        : Select current highlighted item.
  76. LETTER       : Move to item with same selection character and select.
  77.  
  78. CHOICE LIST
  79. ───────────
  80. UP           : Move cursor up one row.
  81. DOWN         : Move cursor down one row.
  82. PGUP         : Move cursor up one page.
  83. PGDN         : Move cursor down one page.
  84. HOME         : Move cursor to first row in window or first row in list.
  85. END          : Move cursor to last row in window or last row in list.
  86. ESC          : QUIT choice list.
  87. ENTER        : Select.
  88.  
  89. FORM
  90. ────
  91. F2           : Activate choice list if present.
  92. F6           : Clear field.
  93. Shft-F3      : Undo.
  94. Shft-F6      : Clear from cursor to end of field.
  95. F7           : Previous item on the form.
  96. F8           : Next item on the form.
  97. F10          : Exit form.
  98. END          : Move cursor to end of the field.
  99. HOME         : Move cursor to beginning of the field.
  100. CTRL + HOME  : First item of the form.
  101. CTRL + END   : Last item of the form.
  102. ENTER        : Move to next item on the form.
  103. TAB          : Next item.
  104. Shft-TAB     : Previous item.
  105. SPACE        : Toggle between field values.
  106.  
  107. Shift-F1 calls an alternate help function which gives you help about which
  108. keys to use at that moment.
  109.  
  110. The top menuline shows besides the clock the status of the keyboard.
  111. It shows wheather num-lock, caps-lock or scroll-lock is turned on.
  112. Scroll-lock has a special function.  When a tool is started and scroll-lock
  113. is ON,  the tool will produce 48 lines of output and will then be halted.
  114. During this pause you can scroll thru these 48 lines using the cursor keys.
  115. To continue,  hit the spacebar,  another 48 lines will be buffered.  ESC will
  116. stop the tool.
  117. *SELECT FILES
  118. Select the files which will be used with one of the tools.  Selecting this
  119. option causes the selected file list to be cleared.  The selected file list
  120. remains active after the use of each of the tools.  A file can be viewed
  121. with F3.  Use F2 to change the file search specification.
  122. *VIEW SELECTION
  123. Pop's up a window with all the selected files.  Use the cursor keys, home,
  124. end, page up and down keys to scroll through the list.  The mouse can be
  125. used when a driver is active.
  126. *CHANGE DRIVE
  127. Change the system's current drive.  If it is not possible to change to that
  128. drive,  ProGRAP will switch to drive C:.
  129. *EXIT PROGRAP
  130. Exit from ProGRAP,  and return to the calling program or OS.
  131. *FGREP
  132. Search through the selected files for a given string.  FGREP can search for
  133. three strings at the same time.  If case sensitive search and output to
  134. screen only have been selected,  then FGREP will work fast !  Case insensi-
  135. tive search and sending the result to a file,  slows down FGREP.
  136. *GRAP
  137. Search through the selected files for a given string and replace this string
  138. with the second entered string.  Selecting case insensitive search and output
  139. to file,  slows down GRAP.
  140. *UNTAB
  141. Search through the selected files for tabulations and replace them with
  142. spaces.  The tabulation width can be changed,  select SETUP and from this
  143. list TAB-WIDTH.
  144. *TAB
  145. Replace groups of spaces by tab's.  The tabulation width can be changed,
  146. select SETUP and from this list TAB-WIDTH. It is possibble to prevent spaces
  147. between single or double quotes being replaced by tab's. See SETUP / REPL.
  148. EMBEDED SPACES.
  149. *CASE
  150. Select wheather the search for a string should be case sensitive or not.  Se-
  151. lecting sensitive search speeds up FGREP and GRAP,  but does not allow the
  152. use of wild characters.
  153. *WILDCHAR
  154. Select the wild character to be used in search functions.  This feature is
  155. only available when case insensitive search is used.
  156. *TABWIDTH
  157. Enter the number of spaces that should be used when replacing a tabulation.
  158. *EXTENSION
  159. Enter the extension that should be used when preserving the original files.
  160. For GRAP and UNTAB only.
  161. *DIRECTORY
  162. Enter the path where output files should be placed. For GRAP and UNTAB only.
  163. When this option is active,  the changed files are placed in this directory.
  164. *USE EXTENSION
  165. When this flag is turned on, GRAP and UNTAB will create a file with the ori-
  166. ginal name,  but with the extension defined with the option EXTENSION.
  167. *USE DIRECTORY
  168. When this flag is turned on, GRAP and UNTAB will send their modified files
  169. to this directory leaving the original files unchanged.  This option makes
  170. the use of an alternate extension optional.
  171. *LINELENGTH
  172. Enter the linelength that GRAP and UNTAB should preserve.  When the maximum
  173. linelength is exeeded,  the original line is written to the output file.
  174. *IMMEDIATE
  175. If this option is on,  all files will automaticly be marked when selecting
  176. files.
  177. *VIEW
  178. View ProGRAP's setup.  Shows all options which can be saved to the ProGRAP
  179. config file.
  180. *DEFAULT
  181. Use ProGRAP's default setup.  This setup will be used when no ProGRAP config
  182. file is present.
  183. *LOAD
  184. Load a previous defined ProGRAP setup.  When the ProGRAP config file exists,
  185. the file will be used at startup.
  186.  
  187. Add the following line to your AUTOEXEC.BAT :
  188.  
  189. set prograp=drive:\path
  190.  
  191. Replace drive:\path with the path where ProGRAP should look for its help and
  192. config file.
  193. *SAVE
  194. Save ProGRAP's current setup to 'C:PROGRAP.CFG'.  This file will be used at
  195. startup.
  196. *SCREEN
  197. Ouput produced by one of the tools will only appear on the screen.  This is
  198. the fastest means of output.
  199. *FILE
  200. Output produced by one of the tools will be sent to the screen and to a file
  201. *PRINTER
  202. Output produced by one of the tools will be sent to the screen and to the
  203. printer connected to the port selected under SETUP / PRINTER SETUP.  Each
  204. line is always untabed and wrapped at the selected right margin.
  205. *CASE2
  206. Select ON when sensitive search is to be in effect or OFF when each match is
  207. good.  It slows down FGREP and GRAP when turned off.  Wild characters can
  208. not be used if turned on.
  209. *TABWIDTH2
  210. Replace tab's with this number of spaces.  Range : 1 - 80.
  211. *WILDCHAR2
  212. Wild character to be used in string search functions.  Can only be used when
  213. case insensitive search is in effect.
  214. *EXTENSION2
  215. Enter any valid DOS file-extension.
  216. *DIRECTORY2
  217. Enter a valid path for GRAP and UNTAB output files.  No filename allowed.
  218. ProGRAP will check if the path is valid.
  219. *USE EXTENSION2
  220. Select YES if the original file has to be preserved by adding a different
  221. extension to the original filename.
  222. *USE DIRECTORY2
  223. Select YES if you want the original file to be preserved.  The output files
  224. of GRAP and UNTAB will be placed in the directory specified at DIRECTORY.
  225. Extension usage is optional.
  226. *LINELENGTH2
  227. Enter the maximum linelength for GRAP and UNTAB.  If this maximum length is
  228. exeeded the original line is written to the output file.
  229. Range : 1 - 512.
  230. *IMMEDIATE2
  231. Select YES if you want the files to be selected automaticly when choose the
  232. option SELECT FILES.
  233. *FILESPEC
  234. Enter the file specification to search for.  If no extention is given, fn.*
  235. is assumed.  If no filename is given *.ext is assumed.  Path or drive spe-
  236. cifications are not allowed.
  237. *OUTFILE
  238. The output file specification requires a valid dos path and filename.  The
  239. given path must exist.  The file will be created if not existing.
  240. *SEARCH
  241. Enter a string to search for.  This string may be up to 44 characters long.
  242. The search for this line is affected by the case sensitive flag.
  243. "" And '' can be used as delimitters.  They are needed when the last
  244. characters of the search string are blanks.
  245. "TEST  " Will find only TEST folowed by two blanks.
  246. TEST     Will find all appearances of TEST
  247. Conditional search :
  248.  -  Both conditions are set to OR
  249.     The search is succesful when one of the three strings is found.
  250.  -  Condition 1 is set to OR and condition 2 set to AND
  251.     The search is succesful when string 1 is found or when string 2 and 3
  252.     are found together.
  253.  -  Condition 1 is set to and and condition 2 set to OR
  254.     The search is succesful when string 1 and 2 are found together or when
  255.     string 3 is found.
  256.  -  Both conditions are set to AND
  257.     The search is succesful when the three strings are found together.
  258.  -  Placement of parentheses.
  259.     Makes only sence when condition 1 is not the same as contition 2.
  260.     
  261.     ex. (1 and 2) or 3  Finds 1 together with 2 or
  262.                         finds 3      
  263.         1 and (2 or 3)  Finds 1 together with 2 or
  264.                         finds 1 together with 3
  265. *ORGTXT
  266. Enter the original text.  GRAP will search for this line.  The search for
  267. this line is affected by the case sensitive flag.  This string may be up to
  268. 44 characters long.
  269. "" And '' can be used as delimitters.  They are needed when the last
  270. characters of the search string are blanks.
  271. "TEST  " Will find only TEST folowed by two blanks.
  272. TEST     Will find all appearances of TEST
  273. *REPTXT
  274. Enter the replacement text.  If a replacement causes the line to exeed the
  275. linelength defined,  GRAP will preserve the original line.  The replacement
  276. text may be up to 44 characters long.  The replacement text is not affected
  277. by the case sensitive flag.  If no text is entered,  then the original
  278. string is replaced with the NULL string.
  279. "" And '' can be used as delimitters.  They are needed when the last
  280. characters of the replacement string are blanks.
  281. *APPEND
  282. When this message appears,  it means the result file already exists.  There
  283. are two possibilities : YES - append the results to the existing file.
  284.                         NO  - overwrite the existing result file.
  285. *CREATE
  286. The requested output directory does not exist.  There are two possibilities :
  287. YES - create the directory.
  288. NO  - do not create the directory.
  289. *FILE SELECTION
  290. Move the selection bar with the keys : HOME, END, Page Dn, Page Up, cursor
  291. up and down.  Mark the files to be used by the tools with INS.  The + key
  292. marks all the files shown (Same as the immediate select flag).  The - key
  293. unselects all previous marked files.  The * key inverts,  all marked files
  294. become unselected and all unselected will be marked.
  295. All the files in a certain directory can be marked automaticly upon entry
  296. by turning the immediate select flag on.
  297.  
  298. - [.]  Returns to the root if selected.
  299. - [..] Select this to go up one directory.
  300.  
  301. ESC brings you back to the menu.
  302. *DRIVE SELECTION
  303. Move the selection bar with the keys : HOME, END, Page Dn, Page Up, cursor
  304. up and cursor down.  Select the drive you want to use and press the ENTER
  305. key.  If ProGRAP is unable to select this drive,  it will re-select the
  306. current drive if still valid.  If more drives are shown then present, then
  307. add the line LASTDRIVE = to your config.sys file.  If drive B is shown but
  308. not present,  contact your local dealer (Wrong dip-switch settings).
  309. *EMB_SPC
  310. Should TAB preserve spaces which are embeded between single or double
  311. quotes ?  It is not needed for regular text files but may be very impor-
  312. tant with program source files.
  313. *EMB_SPC2
  314. Select YES if you want spaces between quotes to be converted to tab's or NO
  315. if they should be preserved.
  316. *RLFTBLNK
  317. Checks lines of the selected files for the presence of leading or trailing
  318. blanks and/or tabs.  They are all removed up to the first character different
  319. from a blank or a tab character.
  320. *TOUPPER
  321. Converts each line for each of the selected files to uppercase characters.
  322. *TOLOWER
  323. Converts each line for each of the selected files to lowercase characters.
  324. *LEFTRGHT
  325. Remove leading or trailing blanks and/or tab's.  Select wheather this should
  326. be done starting from the left (Leading) or starting from the right
  327. (Trailing) or both.  Press the spacebar to toggle between left and right and
  328. hit return to start the tool.
  329. *TRUNC
  330. Truncate long lines to a given length.  Shorter lines can be lengthened using
  331. a specified character.
  332. *MAXLEN
  333. Truncate lines longer than the length specified here.  The lines will be
  334. truncated at the right side.  The length should be in the range from 1 to
  335. 512.  The default value is always 80.
  336. *FILLCHAR
  337. Define the character to be used when lines are to be filled up in case the
  338. line is shorter than the length used to truncate.  Any ASCII character may be
  339. specified here.  The default character is always a blank.
  340. *FILL
  341. Select wheather the line should be filled or not.  Change from yes to no,
  342. using the spacebar.  Pressing the enter key or cursor down key causes the 
  343. program to start.  The default is always set to NO.
  344. *PRNSETUP
  345. This form includes several parameters for printing selected files.
  346.  - Number of lines per page
  347.  - Top and bottom margins
  348.  - Space between lines
  349.  - Left and right margins
  350.    Right margin is always active when output is sent to the printer.
  351.  - Print page heading/footing ?
  352.    Possible headers :
  353.      - No headers
  354.      - Pagenumbers
  355.      - Filename and pagenumbers
  356.      - Date and pagenumbers
  357.      - Custom title and pagenumbers
  358.      - Custom title
  359.  - Print pagenumbers ?  Includes date and time, the heading is printed
  360.    in the middle.
  361.  - Print linenumbers ?
  362.  - Pause each printed page ?  This is case of manual paperfeed.
  363.  - Print formatting active.  If this option is set to No, all the selected
  364.    files are printed one after another without formfeeds at the end of each
  365.    file.  All the options on this form become active when this option is set
  366.    to YES.
  367.  - Printer port
  368.    This will always be used, even when print formatting is not active.
  369.    F2 lets you choose between LPTx and COMx.  The COMx ports are
  370.    initialized as follows :
  371.       BAUD=9600 DATA=8 STOP=1 PARITY=none
  372. *HEADER
  373. Enter the text to be printed on top of each page.
  374. The text can maximum be thirty characters long.
  375. *FOOTER
  376. Enter the text to be printed at the bottom of each page.  The text may be
  377. up to thirty characters long.
  378. *TIME_SET
  379. Should ProGRAP preserve the original time and date stamp given to an already
  380. existing file or should the system's time and date be used when a file is
  381. created.
  382. *TIME_SET2
  383. Select YES if ProGRAP has to preserve the original date and time.  Select NO
  384. when the system's time and date is to be used.
  385. This option is only useful when the extention and output directory swithes
  386. won't be used (Source and target file in the same directory, the target file
  387. receives the same name and extention as the source file).
  388. *DOS SHELL
  389. Start a DOS shell (COMMAND.COM is invoked).  ProGRAP is halted and the DOS
  390. prompt will appear.  When you are finished at the DOS prompt, type EXIT to
  391. return to ProGRAP.
  392. *SOUND
  393. Turn ProGRAP's sound ON or OFF.  In case of errors, illegal actions....
  394. *SOUND2
  395. Select ON if you want sound if errors occur or illegal actions are made.
  396. Select OFF if no sound has to be produced at all.
  397. *TSCRAMBLE
  398. The selected files will scrambled with the password entered.
  399. The files will become unreadable.
  400.  
  401. WARNING !!! If you forget your password,  it will be very hard to recover
  402.             your original file !!!!
  403. *TUNSCRAMBLE
  404. The selected files will unscrambled with the password entered.
  405. This is the opposite of SCRAMBLE.
  406.  
  407. WARNING !!! Only the password used with SCRAMBLE will recover your original
  408.             file !!!!
  409. *PASSWORD
  410. Enter your password and hit ENTER to start (un-)scrambling.  You may may
  411. enter any character.
  412. *VSEARCH
  413. Enter a search text.  Each found string be highlighted.  Press Shift-F2 to
  414. turn off search.
  415.