home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / editors / qhlpc215.arj / QHELPC.DAT < prev    next >
Text File  |  1992-02-01  |  28KB  |  823 lines

  1. *───────────────────────────────────────────────────────────────────────┐
  2. *   QHelpC.Dat ... Config File for QEdit (R) Ver 2.15  01 Feb 92, Rhg   │
  3. *───────────────────────────────────────────────────────────────────────┘
  4.  
  5. *  This file is ORDERED Alphebetically by Function
  6.  
  7. *  Specify control-key commands via: ^f1 - This means Control-F1
  8. *  Specify alt-key commands via:     @f1 - This means Alt-F1
  9. *  Specify shift-key commands via:   #f1 - This means Shift-F1
  10. *
  11. *  There is also a provision for "two key commands".
  12. *  For example, to make the Control-F1, Control-F2 sequence issue the
  13. *  exit command, try the following:
  14. *
  15. *  ^f1_^f2     Exit
  16. *
  17. *  The key here is that the commands must be separated by a '_'.
  18. *
  19. *  Multiple commands and/or text may be entered for a single key.  To do so,
  20. *  specify "MACROBegin" as the first command.  To enter text, enclose the
  21. *  text in single or double quote marks.  For example:
  22. *
  23. *  f1  MACROBegin EditFile 'help.dat' Return
  24. *
  25. *  This command would load the file 'help.dat'.  Note the return command is
  26. *  issued after the text.  This is required to terminate the QEdit prompt.
  27. *
  28. *  Following is a macro that will run make and load the results into a window:
  29. *
  30. *  MACROBegin EditFile 'errors.lst' Return Quit Dos 'make >errors.lst' Return
  31. *             Return HorizontalWindow EditFile 'errors.lst' Return
  32. *
  33. *  Following macro will run Turbo C on the current file:
  34. *
  35. *  MACROBegin GSave Dos 'tcc -y -M ' CurrentFilename Return
  36. *
  37. *  Finally, you can also use the scancode to represent "special keys", as
  38. *  long as this key returns a ascii character code of 0.
  39. *  For example Alt-F9 returns an ascii character of 0 and a scan code of
  40. *  112 decimal.  To make Alt-F9 issue the EditFile command, you could:
  41. *
  42. *  112  EditFile
  43. *      or
  44. *  @f9  EditFile
  45. *
  46. *  Either will work.  This becomes especially useful if you have a macro
  47. *  processor and/or special keyboard that has extended keys that QEdit
  48. *  doesn't have names for.  This gives you a method to use them.
  49. *
  50. *  Note that the order of this file is NOT important.  Arrange it however
  51. *  makes sense to you.
  52.  
  53. *───────────────────────────────────────────────────────────────────┐
  54. *                      BLOCK Pop Down Menu                          │
  55. *───────────────────────────────────────────────────────────────────┘
  56. * ordered by Menu occurance
  57.  
  58. @b                      MACRO_begin main_menu 'b'
  59. *                       BL ... mark Line
  60. * changed @ ver 2.15    BH ... mark cHaracter was BC ... mark Character @ ver2.1
  61. *                       BK ... mark Kolumn
  62. * changed @ ver 2.15    BC ... Copy block     was BO ... cOpy @ ver 2.1
  63. * added   @ ver 2.15    BM ... Move block
  64. *                       BD ... Delete
  65. * changed @ ver 2.15    BU ... Unmark         was BN ... uNmark @ ver 2.1
  66. * added   @ ver 2.15    BB ... mark Begin
  67. * added   @ ver 2.15    BE ... mark End
  68. * added   @ ver 2.15    BO ... copyOver
  69. * added   @ ver 2.15    BF ... Fill
  70. * added   @ ver 2.15    BS ... Sort
  71.  
  72. * deleted @ ver 2.15    BA ... pAsteover
  73. * deleted @ ver 2.15    BP ... Paste
  74. * deleted @ ver 2.15    BU ... cUt
  75.  
  76. * CASE
  77. * Lower Case ... Column Block
  78. #f2                     LOWER
  79.  
  80. * Upper Case ... Column Block
  81. #f3                     UPPER
  82.  
  83. * Change Case ... Column Block
  84. #f4                     FLIP
  85.  
  86. ^f1                     COPY_BLOCK
  87. @c                      COPY_BLOCK
  88. ^b_c                    COPY_BLOCK
  89. ^k_c                    COPY_BLOCK
  90.  
  91. ^f2                     COPY_OVER_BLOCK
  92. @z                      COPY_OVER_BLOCK
  93. ^o                      COPY_OVER_BLOCK
  94. ^b_o                    COPY_OVER_BLOCK
  95.  
  96. ^z MACROBegin           COPY_OVER_BLOCK LINE_DOWN
  97.  
  98. ^f3                     DELETE_BLOCK
  99. @d                      DELETE_BLOCK
  100. ^b_d                    DELETE_BLOCK
  101. ^k_y                    DELETE_BLOCK
  102.  
  103. @a                      DROP_ANCHOR
  104.  
  105. ^f4                     MARK_BLOCK_BEGIN
  106. ^b_b                    MARK_BLOCK_BEGIN
  107. ^k_b                    MARK_BLOCK_BEGIN
  108.  
  109. ^f5                     MARK_BLOCK_END
  110. ^b_e                    MARK_BLOCK_END
  111. ^k_k                    MARK_BLOCK_END
  112.  
  113. ^f7                     MARK_CHARACTER
  114.  
  115. ^f8                     MARK_LINE
  116. ^l_m                    MARK_LINE
  117.  
  118. ^f9                     MARK_WORD
  119. ^k_w                    MARK_WORD
  120.  
  121. ^f10                    MOVE_BLOCK
  122. @v                      MOVE_BLOCK
  123. ^v                      MOVE_BLOCK
  124. ^b_m                    MOVE_BLOCK
  125. ^k_v                    MOVE_BLOCK
  126.  
  127. @f3                     UNMARK_BLOCK
  128. @u                      UNMARK_BLOCK
  129. ^b_h                    UNMARK_BLOCK
  130. ^k_h                    UNMARK_BLOCK
  131.  
  132. * ───────────────────── Column Block Commands ───────────────────────
  133.  
  134. ^f6                     MARK_COLUMN
  135. @k                      MARK_COLUMN
  136. ^b_k                    MARK_COLUMN
  137.  
  138. * Sort Column Block
  139. #f1                     SORT
  140.  
  141. *───────────────────────────────────────────────────────────────────┐
  142. *                       BLOCK/SCRAP BUFFER                          │
  143. *───────────────────────────────────────────────────────────────────┘
  144. @f4                     COPY
  145. grey+                   COPY
  146.  
  147. @F5                     CUT
  148. grey-                   CUT
  149.  
  150. @grey- MACROBegin GotoBlockBeg CUT PASTE FillBlock ' ' return UnMarkBlock
  151.  
  152. @f6                     PASTE
  153. grey*                   PASTE
  154.  
  155. @grey+                  FillBlock
  156.  
  157. @f7                     PASTE_OVER
  158. ^prtsc                  PASTE_OVER
  159.  
  160. *───────────────────────────────────────────────────────────────────┐
  161. *                      BLOCK/SCRATCH BUFFER                         │
  162. *───────────────────────────────────────────────────────────────────┘
  163. @f8                     APPEND_SCRBUFF
  164. ^grey+                  APPEND_SCRBUFF
  165.  
  166. @F9                     GET_SCRBUFF
  167. ^grey*                  GET_SCRBUFF
  168.  
  169. @F10                    STORE_SCRBUFF
  170. ^grey-                  STORE_SCRBUFF
  171.  
  172. *───────────────────────────────────────────────────────────────────┐
  173. *                       CURSOR  Movement                            │
  174. *───────────────────────────────────────────────────────────────────┘
  175. ^pgup                   BEG_FILE
  176.  
  177. home                    BEG_LINE
  178.  
  179. ^home                   BEG_SCREEN
  180.  
  181. cursorup                CURSOR_UP
  182. cursordown              CURSOR_DOWN
  183. cursorleft              CURSOR_LEFT
  184. cursorright             CURSOR_RIGHT
  185.  
  186. end                     END_LINE
  187.  
  188. ^pgdn                   END_FILE
  189.  
  190. ^end                    END_SCREEN
  191.  
  192. ^q_e                    END_PARA
  193.  
  194. ^g_b                    GOTO_BLOCK_BEG
  195. ^q_b                    GOTO_BLOCK_BEG
  196.  
  197. ^g_e                    GOTO_BLOCK_END
  198. ^q_k                    GOTO_BLOCK_END
  199.  
  200. ^g_c                    GOTO_COLUMN
  201. greyenter               GOTO_COLUMN
  202.  
  203. ^j                      GOTO_LINE
  204. ^g_l                    GOTO_LINE
  205. ^greyenter              GOTO_LINE
  206.  
  207. @greypgdn               HALF_PG_DN
  208. @greypgup               HALF_PG_UP
  209.  
  210. @greyend                LINE_DOWN
  211. ^cursordown             LINE_DOWN
  212. ^x                      LINE_DOWN
  213.  
  214. @greyhome               LINE_UP
  215. ^cursorup               LINE_UP
  216.  
  217. ^g_n                    NEXT_PARA
  218.  
  219. pgdn                    PAGE_DOWN
  220. pgup                    PAGE_UP
  221.  
  222. ^g_p                    PREV_PARA
  223.  
  224. ^q_p                    PREV_POSITION
  225.  
  226. tab                     TAB_RT
  227. #tab                    TAB_LT
  228.  
  229. @tab                    WORD_LEFT
  230. ^cursorleft             WORD_LEFT
  231.  
  232. ^cursorright            WORD_RIGHT
  233. ^tab                    WORD_RIGHT
  234.  
  235. *───────────────────────────────────────────────────────────────────┐
  236. *                           SCROLL                                  │
  237. *───────────────────────────────────────────────────────────────────┘
  238. ^s_b                    MAKE_BOT_OF_SCREEN
  239. ^s_c                    MAKE_CTR_OF_SCREEN
  240. ^s_t                    MAKE_TOP_OF_SCREEN
  241.  
  242. @greycursordown         SCROLL_UP
  243. @greycursorup           SCROLL_DOWN
  244. @greycursorleft         SCREEN_LEFT
  245. @greycursorright        SCREEN_RIGHT
  246.  
  247. * Shift Line or Marked Block
  248. ^s_l                    SHIFT_LEFT
  249. ^s_r                    SHIFT_RIGHT
  250.  
  251. *───────────────────────────────────────────────────────────────────┐
  252. *                           EDITING                                 │
  253. *───────────────────────────────────────────────────────────────────┘
  254. *───────────────────────────────────────────────────────────────────┐
  255. *                       EDIT Pop Down Menus                         │
  256. *───────────────────────────────────────────────────────────────────┘
  257. * ordered by Menu occurance
  258.  
  259. @e                      MACRO_begin main_menu 'e'
  260. *                       EA ... Addline
  261. *                       ED ... Deleteline
  262. *  added   @ ver 2.15   EE ... delete to End of line
  263. *                       EI ... Insertline
  264. *                       EJ ... Joinline
  265. *                       ES ... Splitline
  266. *  added   @ ver 2.15   EU ... Undelete
  267.  
  268. * ───────────────────────── Edit Hot Keys ───────────────────────────
  269.  
  270. backspace               BACKSPACE
  271.  
  272. ^n                      ADD_LINE
  273. f2                      ADD_LINE
  274.  
  275. f3                      ALIGN
  276.  
  277. del                     del_ch
  278.  
  279. f5                      DEL_LINE
  280. ^y                      DEL_LINE
  281. ^del                    DEL_LINE
  282.  
  283. f6                      DEL_to_EOL
  284. ^e                      DEL_to_EOL
  285. #del                    DEL_to_EOL
  286.  
  287. ^backspace              DEL_LT_WORD
  288.  
  289. @t                      DEL_RT_WORD
  290.  
  291. f7                      DUP_LINE
  292. ^l_d                    DUP_LINE
  293.  
  294. @g                      GET_PREV
  295.  
  296. f8                      INSERT_LINE
  297. @i                      INSERT_LINE
  298. ^i                      INSERT_LINE
  299.  
  300. f9                      JOIN_LINE
  301. @j                      JOIN_LINE
  302.  
  303. #f11                    LITERAL
  304. ^p                      LITERAL
  305.  
  306. enter                   RETURN
  307.  
  308. ^-                      SHOW_ENTRY_SCREEN
  309.  
  310. f10                     SPLIT_LINE
  311. ^l_s                    SPLIT_LINE
  312.  
  313. @f1                     UNDO_CURSORLINE
  314. ^l_u                    UNDO_CURSORLINE
  315.  
  316. @f2                     UnKill
  317. ^u                      UnKill
  318.  
  319. *───────────────────────────────────────────────────────────────────┐
  320. *                              FILE                                 │
  321. *───────────────────────────────────────────────────────────────────┘
  322. *───────────────────────────────────────────────────────────────────┐
  323. *                      FILE  Pop Down Menu                          │
  324. *───────────────────────────────────────────────────────────────────┘
  325. * ordered by Menu occurance
  326.  
  327. @f                      MACRO_begin main_menu 'f'
  328. *                       FL ... Load
  329. *                       FF ... File
  330. *                       FQ ... Quitfile
  331. *                       FS ... Save
  332. *                       FN ... Next
  333. *                       FP ... Prev
  334. *                       FR ... Read
  335. *                       FC ... Changename
  336. *                       FW ... Writeblock
  337. *                       FG ... Globalfile
  338. * changed @ ver 2.15    FO ... Os shell     was FD ... Dos in ver 2.1
  339. * added @ ver 2.15      FT ... lisT
  340.  
  341. * ───────────────────────── File Hot Keys ───────────────────────────
  342.  
  343. ^d                      DOS
  344.  
  345. ^f_e                    EDIT_FILE
  346.  
  347. ^k_d                    eXit
  348.  
  349. ^k_x                    FILE
  350.  
  351. @x                      G_EXIT
  352.  
  353. ^f_g                    G_FILE
  354.  
  355. ^q_q                    G_Pquit
  356.  
  357. @y                      G_SAVE
  358.  
  359. ^k_z                    KILL_FILE
  360.  
  361. ^f_x                    NewFile
  362.  
  363. ^f_n                    NEXT_FILE
  364. @n                      NEXT_FILE
  365.  
  366. ^k_q                    P_QUIT
  367.  
  368. ^f_p                    PREV_FILE
  369. ^k_p                    PREV_FILE
  370.  
  371. ^f11                    READ_BLOCK
  372. @r                      READ_BLOCK
  373. ^b_r                    READ_BLOCK
  374.  
  375. ^k_s                    SAVE_FILE
  376.  
  377. ^f12                    WRITE_BLOCK
  378. ^b_w                    WRITE_BLOCK
  379.  
  380. *───────────────────────────────────────────────────────────────────┐
  381. *                       FIND /REPLACE                               │
  382. *───────────────────────────────────────────────────────────────────┘
  383. *───────────────────────────────────────────────────────────────────┐
  384. *                      SEARCH Pop Down Menu                         │
  385. *                ALL Functions Available from Menu                  │
  386. *───────────────────────────────────────────────────────────────────┘
  387. * ordered by Menu occurance
  388.  
  389. @s                      MACRO_begin main_menu 's'
  390. *  no change @ ver 2.15
  391. *                       SF ... Find
  392. *                       SR ... Replace
  393. *                       SA ... Again
  394.  
  395. * ───────────────────────── Find Hot Keys ───────────────────────────
  396.  
  397. #f5                     FIND
  398. ^q_f                    FIND
  399.  
  400. #f6                     FIND_REPLACE
  401. ^q_r                    FIND_REPLACE
  402.  
  403. #f7                     REPEAT_FIND
  404. ^a                      REPEAT_FIND
  405. ^q_a                    REPEAT_FIND
  406.  
  407. *───────────────────────────────────────────────────────────────────┐
  408. *                             HELP                                  │
  409. *───────────────────────────────────────────────────────────────────┘
  410.  
  411. *                       QEdit .. Internal
  412. ^h  Quick_Help
  413. *  @H TSR        HELP
  414. *  @L TSR Contex HELP
  415.  
  416. *                       MAIN MENU
  417. f1 MACRO_BEGIN dos 'QhS MM' return return
  418.  
  419. *                       Function Keys
  420. @0 MACRO_begin dos 'QhS K0' return return
  421.  
  422. *                       File Pop Down Menu
  423. @1 MACRO_begin dos 'QhS K1' return return
  424.  
  425. *                       Window Pop Down Menu
  426. @2 MACRO_begin dos 'QhS K2' return return
  427.  
  428. *                       Block Pop Down Menu
  429. @3 MACRO_begin dos 'QhS K3' return return
  430.  
  431. *                       Search Pop Down Menu
  432. @4 MACRO_begin dos 'QhS K4' return return
  433.  
  434. *                       Print Pop Down Menu
  435. @5 MACRO_begin dos 'QhS K5' return return
  436.  
  437. *                       MACRO Pop Down Menu
  438. @6 MACRO_begin dos 'QhS K6' return return
  439.  
  440. *            Edit Pop Down Menu
  441. @7 MACRO_begin dos 'QhS K7 return return
  442.  
  443. *                       Other Pop Down Menu
  444. @8 MACRO_begin dos 'QhS K8' return return
  445.  
  446. *                       Quit Pop Down Menu
  447. @9 MACRO_begin dos 'QhS K9' return return
  448.  
  449. *                       Cursor
  450. @- MACRO_begin dos 'QhS KC' return return
  451.  
  452. *                       Misc
  453. @= MACRO_begin dos 'QhS KM' return return
  454.  
  455. *                       Tabs
  456. @[ MACRO_begin dos 'QhS KT' return return
  457.  
  458. *                       Toggles
  459. @] MACRO_begin dos 'QhS KG' return return
  460.  
  461. *───────────────────────────────────────────────────────────────────┐
  462. *                             MACRO                                 │
  463. *───────────────────────────────────────────────────────────────────┘
  464. *───────────────────────────────────────────────────────────────────┐
  465. *                       MACRO  Pop Down Menu                        │
  466. *───────────────────────────────────────────────────────────────────┘
  467. * ordered by Menu occurance
  468.  
  469. @m                      MACRO_begin main_menu 'm'
  470. *                       MM ... Macro record
  471. *                       MR ... Read macro
  472. *                       MW ... Write macro
  473. *  added @ ver 2.15     ME ... Execute scrap
  474.  
  475. * ───────────────────────── MACRO Hot Keys ──────────────────────────
  476.  
  477. ^c                      CURRENT_FILENAME
  478.  
  479. ^enter                  EXECUTE_SCRAP
  480.  
  481. ^ins                    MACRO_READ
  482.  
  483. ^m                      MACRO_RECORD
  484.  
  485. @enter                  MACRO_WRITE
  486.  
  487. *───────────────────────────────────────────────────────────────────┐
  488. *                            OTHER                                  │
  489. *───────────────────────────────────────────────────────────────────┘
  490. *───────────────────────────────────────────────────────────────────┐
  491. *                       OTHER Pop Down Menu                         │
  492. *───────────────────────────────────────────────────────────────────┘
  493. * ordered by Menu occurance
  494.  
  495. @o                       MACRO_begin main_menu 'o'
  496. *                        OA ... set Autoindent     [ off/on ]
  497. *                        OI ... set Insert         [ on/off ]
  498. *                        OW ... set Wordwrap       [ on/off ]
  499. *                        OP ... set Ptabwidth
  500. *                        OC ... set Ctabwidth
  501. *                        OR ... set Right margin
  502. *                        OB ... set Backups        [ off/on ]
  503. *                        OE ... set Enter matching [ on/off ]
  504. *                        OS ... set Swap           [ on/off ]
  505. * added @ ver 2.15       OT ... ascii charT
  506.  
  507. * ───────────────────────── Other Hot Keys ──────────────────────────
  508.  
  509. f4                      CENTER_LINE
  510. centercursor            CENTER_LINE
  511. ^l_c                    CENTER_LINE
  512.  
  513. escape                  ESCAPE
  514. @escape                 ESCAPE
  515.  
  516. f11                     INSERT_DATE
  517. #ins                    INSERT_DATE
  518.  
  519. @greyins                INSERT_TIME
  520. @f11                    INSERT_TIME
  521.  
  522. ^[                      MATCH
  523. ^]                      MATCH
  524.  
  525. @f12                    RepeatCmd
  526. ^r                      RepeatCmd
  527.  
  528. #f10                    SHELL
  529.  
  530. ^w                      WRAP_PARA
  531.  
  532. *───────────────────────────────────────────────────────────────────┐
  533. *                          PRINTING                                 │
  534. *───────────────────────────────────────────────────────────────────┘
  535. *───────────────────────────────────────────────────────────────────┐
  536. *                     PRINTING Pop Down Menu                        │
  537. *                All Functions Available from Menu                  │
  538. *───────────────────────────────────────────────────────────────────┘
  539. * ordered by Menu occurance
  540.  
  541. @p                      MACRO_begin main_menu 'p'
  542. *  no change @ ver 2.15
  543. *                       PA ... print All
  544. *                       PB ... print Block
  545. *                       PF ... send Formfeed
  546. *                       PL ... set print Left margin
  547. *                       PP ... set print Page length
  548. *                       PT ... set print Top margin
  549. *                       PO ... set print bOttom margin
  550.  
  551. *───────────────────────────────────────────────────────────────────┐
  552. *                      QUIT  Pop Down Menu                          │
  553. *───────────────────────────────────────────────────────────────────┘
  554. * ordered by Menu occurance
  555.  
  556. @q                      MACRO_begin main_menu 'q'
  557. *                       QQ ... Quit all files
  558. * changed ver 2.15      QX ... eXit all files    was QE ... Exit all files
  559.  
  560. *───────────────────────────────────────────────────────────────────┐
  561. *                            TOGGLES                                │
  562. *───────────────────────────────────────────────────────────────────┘
  563.  
  564. * ───────────────────────── Toggle Hot Keys ─────────────────────────
  565.  
  566. #f9                     TOGGLE_BOX_DRAW
  567. #f8                     TOGGLE_BOX_TYPE
  568.  
  569. #f12                    TOGGLE_EGA43
  570.  
  571. ins                     TOGGLE_INSERT
  572. ^t_i                    TOGGLE_INDENT
  573.  
  574. ^t_s                    TOGGLE_SMART_TABS
  575.  
  576. ^t_e                    TOGGLE_TABS_EXPAND
  577.  
  578. ^t_o                    TOGGLE_TABS_OUT
  579.  
  580. f12                     TOGGLE_WORDWRAP
  581.  
  582. *───────────────────────────────────────────────────────────────────┐
  583. *                            WINDOW                                 │
  584. *───────────────────────────────────────────────────────────────────┘
  585. *───────────────────────────────────────────────────────────────────┐
  586. *                       WINDOW Pop Down Menu                        │
  587. *───────────────────────────────────────────────────────────────────┘
  588. * ordered by Menu occurance
  589.  
  590. @w                      MACRO_begin main_menu 'w'
  591. * no change @ ver 2.15
  592. *                       WC ... Close
  593. *                       WS ... Split
  594. *                       WN ... Next
  595. *                       WO ... One
  596. *                       WP ... Prev
  597. *                       WZ ... Zoom
  598. *                       WR ... Resize
  599.  
  600. *                       Spare Keys
  601. *                       SPECIAL KEYS
  602. `
  603. ~
  604. /
  605.  
  606. *                       CONTROL KEYS
  607. *   ^centercursor       reserved for Q TSR HOT KEY
  608.  
  609. ^\
  610.  
  611. *   ^2                  reserved for Q TSR GoBack
  612. *   ^6                  reserved for Q TSR Purge
  613.  
  614. *                       ALT KEYS
  615.  
  616. *                       other enhanced only keys
  617.  
  618. *   @grey*              reserved for Q TSR GRABBER
  619. @greydel
  620. @,
  621. @.
  622. @;
  623. @`
  624. @'
  625.  
  626. * AsciiChart         NOT assigned ( see Other Menu )
  627. * FirstNonWhite      NOT assigned
  628. * List_File          NOT assigned ( see File Menu )
  629. * GrowWindow         NOT assigned ( replaced by Resize @ Version 2.10 )
  630. * HorizontalWindow   NOT assigned ( replaced by Split  @ Version 2.10 )
  631. * ShrinkWindow       NOT assigned ( replaced by Resize @ Version 2.10 )
  632. * QUIT            do NOT ASSIGN
  633.  
  634.  
  635. * III  VERSION 2.15 - RELEASE NOTES - AUGUST, 1991
  636. * ================================================
  637.  
  638. * New Commands in QEdit Advanced 2.15 (See explanations later in this file)
  639. * -------------------------------------------------------------------------
  640.  
  641. * AsciiChart           also OTHER menu command ( @OT )
  642. * FirstNonWhite
  643. * ListFiles            also FILE menu command  ( @FT )
  644.  
  645. * isBegLine            for macro use
  646. * isCursorInBlock      for macro use
  647. * isEmptyLine          for macro use
  648. * isEndLine            for macro use
  649. * isFirstLine          for macro use
  650. * isLastLine           for macro use
  651. * RestoreSettings      for macro use
  652. * SaveSettings         for macro use
  653. * SetAutoIndentMode    for macro use
  654. * SetInsMode           for macro use
  655. * SetScreenOff         for macro use
  656. * SetScreenOn          for macro use
  657. * SetSoundOff          for macro use
  658. * SetSoundOn           for macro use
  659. * SetWordWrapMode      for macro use
  660.  
  661.  
  662. * Additions to the Menus (command names are in []):
  663. * -------------------------------------------------
  664.  
  665. *   File menu:
  666. *     "lisT"          - invokes the new [ListFiles] command
  667.  
  668. *   Block menu:
  669. *     "copyOver"      - invokes the [CopyOverBlock] command
  670. *     "Fill"          - invokes [FillBlock] command
  671. *     "Sort"          - invokes the [Sort] (block) command (a column
  672. *                       block must be marked)
  673. *   Macro menu:
  674. *     "Execute scrap" - invokes the [ExecuteScrap] (macro) command
  675.  
  676. *   Other menu:
  677. *     "ascii charT"   - invokes the new [AsciiChart] command
  678.  
  679.  
  680. * General Commands:
  681. * -----------------
  682.  
  683. * [AsciiChart]
  684. *  Displays a scrollable ASCII chart on the screen.
  685.  
  686. * [ListFiles]
  687. *  Displays a list of the currently loaded files. To switch to another
  688. *  file, move the cursor to the appropriate file and press <Enter>. To
  689. *  keep editing the current file, press <Escape>.
  690.  
  691. * [FirstNonWhite]
  692. *  Intended as a replacement and/or supplement to the [BegLine] command.
  693. *  Places the cursor at the first non-white character on the line, or
  694. *  column 1 if the line doesn't have any non-white characters. "White"
  695. *  characters are tabs or spaces. A useful macro would be:
  696.  
  697. *       Home MacroBegin BegLine JTrue done: FirstNonWhite done:
  698.  
  699. *  (Explanation: If already at the start of a line, go to the first
  700. *  non-white character on the line; otherwise, if not already at the start
  701. *  of a line, go to the start of the line.
  702.  
  703.  
  704. * Advanced Macro Commands:
  705. * ------------------------
  706. * The following new commands are intended for QEdit macro writers, to make
  707. * certain kinds of macros easier to write.
  708.  
  709. * - This group of macro commands force the indicated mode or setting. If
  710. *   the setting was already in that condition, they set QEdit's result
  711. *   code to TRUE; otherwise, they set it to FALSE.
  712.  
  713. *   In many cases, macros can behave differently based on the currently
  714. *   set QEdit modes.  The following 3 new commands give you some control
  715. *   in establishing the proper environment so that your macro will always
  716. *   work as intended.
  717.  
  718. *   [SetInsMode]
  719. *    Sets Insert mode on. To set Insert mode off (that is, set overwrite
  720. *    mode on), do the following:
  721. *         SetInsMode ToggleInsert
  722.  
  723. *   [SetAutoIndentMode]
  724. *    Sets AutoIndent mode on. To set AutoIndent mode off, do the
  725. *    following:
  726. *         SetAutoIndentMode ToggleIndent
  727.  
  728. *   [SetWordWrapMode]
  729. *    Sets WordWrap mode on. To set WordWrap mode off, do the following:
  730. *         SetWordWrapMode ToggleWordWrap
  731.  
  732.  
  733. * - The [Find] command sounds a tone when the search string cannot be
  734. *   found. This can be irritating in a long-running macro, that may
  735. *   possibly execute hundreds of finds that fail. The following commands
  736. *   allow you to selectively turn the sound on and off.
  737.  
  738. *     [SetSoundOn]
  739. *      Sets sound on.
  740.  
  741. *     [SetSoundOff]
  742. *      Sets sound off.
  743.  
  744.  
  745. * - Most macros execute dozens of QEdit commands, possibly hundreds of
  746. *   times. This can cause the screen to flash rapidly as the macro runs.
  747. *   Not only is this somewhat disconcerting to watch, it actully slows
  748. *   down the speed of some macros. The following commands allow you to
  749. *   temporarily suspend or resume screen updating, while a macro is
  750. *   running.
  751.  
  752. *   [SetScreenOn]
  753. *    Turns screen updating on.
  754.  
  755. *   [SetScreenOff]
  756. *    Turns screen updating off. You must turn screen updating back on
  757. *    before your macro prompts for input, or if there is some output from
  758. *    the macro that you want displayed on the screen.
  759.  
  760. *    NOTE: QEdit will AUTOMATICALLY turn screen updating back on when the
  761. *    macro is finished executing. Thus, it is not necessary to issue the
  762. *    SetScreenOn  command at the end of the macro.
  763.  
  764.  
  765. * - Many times, it would be nice for a macro to force a few settings, do
  766. *   its assigned task, and then restore the original settings. The
  767. *   following commands allow you to do just that. Note that each time
  768. *   [SaveSettings] is executed, the previous settings saved with
  769. *   [SaveSettings] are overwritten.
  770.  
  771. *   [SaveSettings]
  772. *    Saves the current settings of: Insert, AutoIndent, WordWrap, Sound,
  773. *    and Screen Updating.
  774.  
  775. *   [RestoreSettings]
  776. *    Restores the saved settings, listed above.
  777.  
  778.  
  779. * - The following commands set QEdit's result code to TRUE or FALSE based
  780. *   on the condition being tested. These commands make certain types of
  781. *   macro tests easier and reliable.
  782.  
  783. *   [isBegLine]
  784. *    Returns TRUE if the cursor is at column 1; otherwise, FALSE is
  785. *    returned.
  786.  
  787. *   [isEndLine]
  788. *    Returns TRUE if the cursor is past the last non-white character on
  789. *    the current line; otherwise, FALSE is returned, including the case
  790. *    when the cursor is on an empty line.
  791.  
  792. *   [isEmptyLine]
  793. *    Returns TRUE if the current line is empty or contains only white
  794. *    space; otherwise, FALSE is returned.
  795.  
  796. *   [isLastLine]
  797. *    Returns TRUE if the cursor is on the last line of the currently
  798. *    edited file; otherwise, FALSE is returned.
  799.  
  800. *   [isFirstLine]
  801. *    Returns TRUE if the cursor is on the first line of the currently
  802. *    edited file; otherwise, FALSE is returned.
  803.  
  804. *   [isCursorInBlock]
  805. *    Returns TRUE if the cursor is inside a marked block; otherwise, FALSE
  806. *    is returned.
  807.  
  808.  
  809. * - In order to tie a few of these concepts together, we present a simple
  810. *   macro to delete all the blank lines in a marked block. The cursor
  811. *   should be at the beginning of the block when the macro is invoked.
  812.  
  813. *    shift f9 MacroBegin
  814. *              SetScreenOff                  * turn off screen for speed
  815. *      begin:  isCursorInBlock jFalse done:  * exit if not in block
  816. *              isEmptyLine     jFalse next:  * skip if not empty line
  817. *              isLastLine      jTrue  last:  * special handling for last line
  818. *              DelLine         jump  begin:  * delete empty lines
  819. *      next:   CursorDown      jTrue begin:  * try next line
  820. *              jump done:                    *
  821. *      last:   DelLine                       * delete the last line
  822. *      done:                                 * that's all, folks!
  823.