home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / pmeditor.zip / RSEDOC.TXT < prev    next >
Text File  |  1990-06-15  |  61KB  |  1,651 lines
  1.    
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                    RimSTAR Programmer's Editor
  23.                   for OS/2 Presentation Manager
  24.  
  25.                      PRELIMINARY USER GUIDE
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. Copyright (C) 1990 by RimSTAR Technology.  All rights reserved.
  73.  
  74. Reproduction or redistribution by any means is a violation of
  75. applicable law.
  76.  
  77.  
  78. Rimstar is a trademark of Rimstar Technology.
  79. IBM, OS/2, PM, Presentation Manager are trademarks or registered
  80. trademarks of International Business Machines Corp.
  81. BRIEF is a registered trademark of Underware, Inc.
  82.                           TABLE OF CONTENTS
  83.  
  84. Introduction . . . . . . . . . . . . . . . . . . . . . . . .    1
  85.  
  86. Installing the Editor  . . . . . . . . . . . . . . . . . . .    3
  87.  
  88. Buffering and Windowing Concepts   . . . . . . . . . . . . .    5
  89.  
  90. Windowing behavior . . . . . . . . . . . . . . . . . . . . .    6
  91.  
  92. Starting the Editor  . . . . . . . . . . . . . . . . . . . .    7
  93.  
  94. Using a Mouse  . . . . . . . . . . . . . . . . . . . . . . .    8
  95.  
  96. Supplied Key Mappings (Bindings) . . . . . . . . . . . . . .    9
  97.  
  98. Syntax of Keyboard Definition File . . . . . . . . . . . . .    9
  99.  
  100. Dynamic assignment of Accelerator Keys to Pulldown Menu
  101.      Items . . . . . . . . . . . . . . . . . . . . . . . . .   10
  102.  
  103. Configuring the Editor . . . . . . . . . . . . . . . . . . .   11
  104.  
  105. Saving and Restoring the state of the editor . . . . . . . .   11
  106.  
  107. File Action Bar Choices  . . . . . . . . . . . . . . . . . .   13
  108.      New . . . . . . . . . . . . . . . . . . . . . . . . . .   14
  109.      Open  . . . . . . . . . . . . . . . . . . . . . . . . .   14
  110.      Next  . . . . . . . . . . . . . . . . . . . . . . . . .   14
  111.      Previous  . . . . . . . . . . . . . . . . . . . . . . .   14
  112.      Save  . . . . . . . . . . . . . . . . . . . . . . . . .   14
  113.      Save as . . . . . . . . . . . . . . . . . . . . . . . .   14
  114.      Compile . . . . . . . . . . . . . . . . . . . . . . . .   15
  115.      Delete  . . . . . . . . . . . . . . . . . . . . . . . .   15
  116.      Print . . . . . . . . . . . . . . . . . . . . . . . . .   15
  117.      Exit  . . . . . . . . . . . . . . . . . . . . . . . . .   15
  118.  
  119. Edit Action Bar Choices  . . . . . . . . . . . . . . . . . .   17
  120.      Undo  . . . . . . . . . . . . . . . . . . . . . . . . .   17
  121.      Redo  . . . . . . . . . . . . . . . . . . . . . . . . .   18
  122.  
  123. Search Action Bar Choices  . . . . . . . . . . . . . . . . .   19
  124.  
  125. Replace Action Bar Choices . . . . . . . . . . . . . . . . .   19
  126.  
  127. Regular Expression Syntax  . . . . . . . . . . . . . . . . .   21
  128.  
  129. Window Action Bar Choices  . . . . . . . . . . . . . . . . .   23
  130.  
  131. Option Action Bar Choices  . . . . . . . . . . . . . . . . .   25
  132.  
  133. Associating a Program with a File Extension  . . . . . . . .   27
  134.  
  135. Compiling Within the Editor  . . . . . . . . . . . . . . . .   31
  136.  
  137. Jumping to Errors in the Source File . . . . . . . . . . . .   33
  138.  
  139. The Virtual Memory System  . . . . . . . . . . . . . . . . .   35
  140.  
  141. Getting HELP . . . . . . . . . . . . . . . . . . . . . . . .   35
  142.  
  143. LIST OF ALL FUNCTIONS WHICH CAN BE BOUND TO KEYS . . . . . .   37
  144.  
  145. BRIEF Key Mapping Quick Reference  . . . . . . . . . . . . .   43
  146. Introduction
  147.  
  148.  
  149.      This is a pre 1.0 version of the RimSTAR PM Programmer's Editor
  150. for OS/2 Version 1.2 or later.
  151.  
  152.      All registered users will receive free upgrades to the Version
  153. 1.0 release.  This includes complete printed user documentation.
  154.  
  155.      Interim releases will be made available free via BIX (Byte
  156. Information Exchange) or for the cost of materials & shipping
  157. (approx. $5.00).  Bug fixes are supplied at no charge.
  158.  
  159.  
  160. Features not available in this release:
  161.  
  162.      Extension language (macro language)
  163.      User coded dynamic link library extensions
  164.      Code folding
  165.      Template editing & smart indenting
  166.  
  167.  
  168. Version 1.0's planned release date is July 1990.
  169.  
  170.  
  171.      Technical support is available Monday-Friday 9:00am - 6:00pm
  172. EST. Call 1-617-925-2718.  There are no charges for technical
  173. support.  Please have the serial number printed on the master
  174. disk available when you call.
  175.  
  176.      If you are a BIX user you may e-mail support questions to
  177. 'rimstar' We plan to have a dedicated conference on BIX in the
  178. future for on-line technical support.
  179.  
  180.      Please register your copy(s).  We will not be able to
  181. provide upgrades if you have not registered.
  182.  
  183.      We solicit your requests for features, bug reports, and any
  184. comments you may have.  We want you to be a satisfied customer
  185. and we will do all we can to assist you.  Thank you for selecting
  186. RimSTAR for your programmer's editor. Installing the Editor
  187.  
  188.  
  189.      The distribution disk contains the following files: 
  190.  
  191.      R.EXE          -    Editor executable 
  192.      RSFONTS.FON    -    Custom RimStar font(s) (only 1 for now) 
  193.      KEYCOMP.EXE    -    Keyboard definition compiler 
  194.      NEWKEY.CMD     -    Batch file which invokes KEYCOMP.EXE on
  195.                          RSE.KEY to produce RSE.KBD 
  196.      RSE.KEY        -    Keyboard definitions for BRIEF keyboard
  197.                          layout. 
  198.      RSE.KBD        -    Compiled version of RSE.KEY 
  199.      RSE.HLP        -    Help library
  200.      RSE_CFG.INI    -    Configuration file (sample)
  201.  
  202.  
  203.      Installing the editor is straightforward.
  204.  
  205. 1)   Copy the files on the distribution disk to the directory of
  206.      your choice, we suggest \RSE.
  207.  
  208. 2)   Copy RSFONTS.FON to C:\OS2\DLL or let the CONTROL PANEL do
  209.      it.  Install RSFONTS.FON using the CONTROL PANEL.  Set your
  210.      PATH statement to include the directory in which R.EXE is 
  211.      located. Note the keyboard file RSE.KBD must reside in the
  212.      same subdirectory as R.EXE.
  213.  
  214.      RSFONTS.FON is not required, it is a small font that gives
  215.      you 40 lines in a maximized window in VGA mode.  By default
  216.      Courier 8 is selected, the configuration file saves the
  217.      current font selection when written.  If no fixed size font
  218.      is available the editor will give you an error message and
  219.      exit.  If this occurs install the COURIER font (supplied
  220.      with OS/2) or the RimSTAR font.
  221.  
  222. 3)   Copy RSE.HLP to C:\OS2\HELP or one of the directories
  223.      specified in the HELP environment variable in the CONFIG.SYS
  224.      file.  ( HELP=C:\OS2\HELP is placed in CONFIG.SYS when you
  225.      installed OS/2.) 
  226.  
  227.      The HELP system is incomplete in this release.  If you are
  228.      familiar with BRIEF's keyboard layout you should have very
  229.      little trouble coming up to speed.  Take a look at the
  230.      RSE.KEY file, there are a couple of changes to the key
  231.      bindings but nothing major, except for Alt+F10 to compile
  232.      within the editor being changed to SHIFT+F10.
  233.  
  234.      Of course you can customize the keyboard any way you like. 
  235.      See RSE.KEY for a description of the key definition syntax. 
  236.      RSE.KEY  also contains the default keyboard configuration
  237.      (BRIEF).
  238.  
  239. 4)   Add the directory path to R.EXE to your PATH environment
  240.      variable in CONFIG.SYS. Buffering and Windowing Concepts 
  241.  
  242.  
  243.      A buffer is the term used to describe a file which has been
  244. loaded into the editor.  Some buffers are temporary and are not
  245. associated with a file that resides on disk (eg. compiler
  246. output).  A buffer is the editable entity in the editor.
  247.  
  248.      A window displays the contents of a specific buffer.  The
  249. buffer is said to be "attached" to the window.
  250.  
  251.      The current window is the window which PM considers the
  252. active window.
  253.  
  254.      The current buffer is the buffer attached to the current
  255. window.
  256.  
  257.      A buffer does not have to be attached to a window.
  258.  
  259.      A window always has a buffer attached to it.
  260.  
  261.      The same buffer can be attached to multiple windows.
  262.  
  263.      Undo/redo information is retained for each buffer.
  264.  
  265.      The current marking state is retained for a buffer not a
  266. window.
  267.  
  268.      You may have one window with many buffers loaded.  The
  269. window displays only the current buffer.  You can rotate the
  270. buffers through a window using the Next/Previous Buffer commands.
  271.  
  272.      You may have multiple windows and only one buffer.  You can
  273. change the current window by using the Next/Previous Window
  274. commands.
  275.  
  276.      You can have multiple windows and multiple buffers.  Each
  277. window can change the buffer associated with that window using
  278. the Next/Previous Buffer commands or by selecting a buffer by
  279. name from the "File" pulldown menu,  which contains a list of all
  280. available buffers.
  281.  
  282.      Untitled buffers created with the "New" command must be
  283. renamed before you can save them to disk.
  284.  
  285.      Buffers created by the editor to hold output from programs
  286. executed by the editor can not be renamed or saved to disk.  If
  287. you want to save the information in one of these buffers copy it
  288. to a "normal" buffer. Windowing behavior
  289.  
  290.  
  291.      The initial window is sized to fill the main window's client
  292. area unless the editor state is restored, or the Keep tiled or
  293. Keep cascaded options are set in the config file.
  294.  
  295.      Keep tiled or Keep cascaded maintain the tiling or cascaded
  296. state when you create or delete a window. They do not interfere
  297. with you sizing the windows individually, until you create or
  298. delete a window or resize the main window.  These settings are
  299. saved in the state restore file so they will be restored when you
  300. invoke the editor without command line arguments and you have
  301. "Save Editor State" enabled.  They are also saved along with the
  302. state of "Open In Current Window" setting (set in the Open File
  303. dialog box) to the RSE_CFG.INI file when you permanently save the
  304. global settings, .
  305.  
  306.      "Duplicating" a window will exactly copy the size and
  307. position of the current window, unless Keep tiled or Keep
  308. cascaded is in effect.
  309.  
  310.      Resizing the main window will resize maximized file windows
  311. to maintain maximized sizing unless Keep tiled or Keep cascaded
  312. is in effect, in which case all windows will be re-sized.
  313.  
  314.  
  315. Starting the Editor
  316.  
  317.  
  318.      Invoking the editor:
  319.  
  320.      R [filename(s)...]
  321.  
  322.      eg:   R *.c *.h
  323.  
  324. loads all files with .c or .h file extensions in the current
  325. directory.
  326.  
  327.      Invoking the editor with no file names will cause one of two
  328. actions:
  329.  
  330.      1)   If editor state restore is enabled and a state file
  331.           exists the editor will use the information contained in
  332.           the state file to restore the edit state to that
  333.           contained in the state file.  If no state file can be
  334.           found then...
  335.  
  336.      2)   The editor loads with the settings specified in the
  337.           RSE_CFG.INI file and opens an UNTITLED buffer and a
  338.           single window attached to this buffer.  If no
  339.           configuration file is found the editor loads with
  340.           default settings. Using a Mouse
  341.  
  342.  
  343.      Button 1 is the left-most mouse button.  Button 2 is the
  344. right button on a 2 button mouse and the center button on a 3
  345. button mouse. 
  346.  
  347.      Clicking Button 1 positions the cursor to the mouse pointer. 
  348. Dragging the mouse while Button 1 is down begins block marking.
  349. Hold down the SHIFT key, press Button 1 and begin dragging to
  350. start line marking, hold down the CTRL key, press Button 1, and
  351. begin dragging to start column marking.
  352.  
  353.      You DO NOT have to continue to hold the SHIFT or CTRL key
  354. while holding Button 1 down, once marking has begun that mark
  355. type stays in effect until marking is turned off. 
  356.  
  357.      Clicking Button 2 while still holding Button 1 down will
  358. cause the marked text to be COPIED to the clipboard. 
  359.  
  360.      Clicking Button 2 when marking is on will turn marking off. 
  361.  
  362.      Clicking Button 2 when there is text in the clipboard will
  363. PASTE the text into the document at the mouse pointer position. 
  364.  
  365.      You can continue marking after you have released Button 1 by
  366. pressing Button 1 again, the marked area will be extended to the
  367. new cursor location set when you press Button 1.  You can
  368. continue to hold down Button 1 and drag select. Supplied Key Mappings (Bindings)
  369.  
  370.      The supplied key mappings are for BRIEF compatibility.  The
  371. file RSE.KEY contains these key definitions.
  372.  
  373.      Keyboard definition files are compiled by the keyboard
  374. definition compiler KEYCOMP.EXE.  The keyboard definition
  375. compiler allows multi-key sequences to be mapped (bound /
  376. assigned) to an editor function/command.
  377.  
  378.      The keyboard definition compiler creates a file which can be
  379. loaded by the editor at start-up time.  The editor uses the
  380. keyboard mappings to process the keystrokes you enter.  Compiled
  381. keyboard definition files have the extension .KBD.  The editor
  382. looks for the file RSE.KBD when it starts and loads the
  383. definition file.
  384.  
  385.      You may customize the source keyboard definition file
  386. RSE.KEY and recompile it to produce a new keyboard mapping or you
  387. can create one from scratch.
  388.  
  389.      To invoke the keyboard definition compiler enter the
  390. following command:
  391.  
  392.      [drive:pathname\] KEYCOMP [drive:pathname\]filename.ext
  393.  
  394. KEYCOMP creates a compiled keyboard definition file with the same
  395. filename and the extension .KBD.
  396.  
  397.  
  398. Syntax of Keyboard Definition File
  399.  
  400.      A semicolon begins a comment (like assembly language), the
  401. remainder of the line following a semicolon is ignored
  402.  
  403.      Format of a key definition line:
  404.  
  405.   [ [ [[SHIFT+][CTRL+][ALT+]] KEY ]...]  = function_name
  406.  
  407.  
  408.      White-space is ignored between tokens.
  409.  
  410.      Multiple shift keys may be specified, eg. :
  411.  
  412.      CTRL + ALT + 'C' = SomeFunctionName
  413.  
  414.   Multi-keystroke sequences can be defined, eg. :
  415.  
  416.      CTRL + 'K' + CTRL + 'X' = ExitEditor
  417.      CTRL + 'X' + CTRL + 'X' = SaveAllAndExit
  418.  
  419.   
  420.     The following keys are reserved for system menu accelerator
  421. or action bar keys and should not be defined, as the definitions
  422. will be ignored:
  423.  
  424.  
  425. F1             Invokes HELP subsystem
  426. F10            Activates the action bar
  427. ALT + SPACE    Activate the main window's system menu
  428. ALT + F4       Close the application (ExitEditor)
  429. ALT + F5       Restore the application main window
  430. ALT + F7       Move the application main window
  431. ALT + F8       Size the application main window
  432. ALT + F9       Minimize the application main window
  433. ALT + F10      Maximize the application main window
  434. CTRL + SPACE   Activate the current edit window's system menu
  435. CTRL + F4      Close the current edit window
  436. CTRL + F5      Restore the current edit window
  437. CTRL + F7      Move the current edit window
  438. CTRL + F8      Size the current edit window
  439. CTRL + F9      Minimize the current edit window
  440. CTRL + F10     Maximize the current edit window
  441.  
  442.  
  443.  
  444. Dynamic assignment of Accelerator Keys to Pulldown Menu Items
  445.  
  446.  
  447.      When the editor is loaded accelerator (short-cut) keys are
  448. added to the pulldown menu items if a key assignment has been
  449. made for a the editor function assigned to the pulldown item.
  450.  
  451. This is done by scanning the current keyboard key assignments and
  452. using the first key assignment to the function matching the
  453. pulldown item.
  454.  
  455.  
  456.  
  457. Configuring the Editor
  458.  
  459.  
  460.      The configuration file RSE_CFG.INI is created in the same
  461. directory which R.EXE is located.  This file holds the settings
  462. you make in the dialog boxes presented by the "Options" pulldown
  463. menu choices.
  464.  
  465.      When the editor starts it reads this file and sets the
  466. editor up according to the settings in the file.
  467.  
  468.      If NO config file is found or it is invalid the editor uses
  469. default settings.
  470.  
  471.      Configuration settings can be changed using the dialog boxes
  472. presented by the "Options" pulldown menu selections.
  473.  
  474.      When you invoke the editor for the first time you should set
  475. the configurable settings to your liking and check the
  476.  
  477.      "Permanently save settings" 
  478.  
  479. check-box in the dialog box and press the Enter key.  The config
  480. file will be written at this point.
  481.  
  482. NOTE: Autosave is unimplemented in this release.
  483.  
  484.  
  485.  
  486. Saving and Restoring the state of the editor
  487.  
  488.  
  489.      You may enable or disable this feature from the "Options"
  490. "Global settings..." dialog box.  It is disabled by default.
  491.  
  492.      Each file you were editing along with windowing information
  493. and your current position in the file is saved in the state
  494. restore file RS_STATE.INI.  The path and file name used to name
  495. the state file can be changed using the "Options" "Global
  496. settings..." dialog box.
  497.  
  498.      Other information retained in the state file:
  499.  
  500.      The last search expression 
  501.      The last search & replace expressions 
  502.      The Ignore Case and Ignore Regular Expression settings 
  503.      Open in current window setting (set from the Open File
  504.      dialog box) 
  505.      Keep tiled / Keep cascaded settings 
  506.      Tiling Orientation (across or down) 
  507.  
  508.      The position and size of the editor's main window is saved
  509. in the OS2.INI file whether you have "Save Editor State" enabled
  510. or not.  The editor recognizes the Desktop Manger "Save" request,
  511. and will save the main window size and position.
  512. File Action Bar Choices
  513.  
  514.      The File choice on the action bar allows you to perform the
  515. following actions:
  516.  
  517. New       Creates a new untitled buffer.  You must give the
  518.           buffer a name before you can save it to disk.
  519.  
  520. Open      Presents a dialog box which allows you to select a file
  521.           to load into a buffer.  If the file does not exist you
  522.           are prompted whether to create it or ignore the
  523.           request.
  524.  
  525. Next      Brings the next buffer into the current window.
  526.  
  527. Previous  Brings the previous buffer into the current window.
  528.  
  529. Save      Save the buffer displayed in the current window to
  530.           disk.
  531.  
  532. Save as   Renames the buffer displayed in the current window and
  533.           then saves the buffer to disk under the new name you
  534.           gave.
  535.  
  536. Compile   Allows you to execute an associated executable if there
  537.           is an extension associated with the buffer's file
  538.           extension.  This association is established by
  539.           selecting the Associate action on the Options pulldown
  540.           menu or the ConfigAssociate command.
  541.  
  542. Delete    Deletes the buffer displayed in the current window.  If
  543.           the buffer has been modified you are presented a dialog
  544.           box which allows you to save the buffer before deleting
  545.           it.
  546.  
  547. Print     Prints the entire contents or the selected text in the
  548.           buffer displayed in the current window.
  549.  
  550. Print setup         This item is currently unavailable.
  551.  
  552. Exit      Exits the editor, displaying a dialog box if there are
  553.           unsaved buffers, giving you the option of saving them
  554.           before exiting.
  555.  
  556.  
  557.      Following the above choices is a list of all buffers.  The
  558. buffer being displayed in the current window has a check mark in
  559. front of it.  Selecting one of these displays that buffer in the
  560. current window.  Buffer names followed by an asterisk indicate
  561. that the buffer has unsaved changes.
  562.  
  563. New
  564.  
  565.      The New action on the File action bar pulldown creates an
  566. UNTITLED buffer.  You are prompted to give the buffer a name when
  567. you save the file to disk.
  568.  
  569.      If you exit the editor with an unsaved UNTITLED buffer you
  570. receive a pop-up message informing you that there are unsaved
  571. UNTITLED buffers.  If you want to save them you should cancel the
  572. exit and use the Save as... choice on the File action bar
  573. pulldown and give the buffer a valid OS/2 path and file name. 
  574. Uses the NewFile command.
  575.  
  576.  
  577. Open
  578.  
  579.      The Open... action on the File action bar pulldown presents
  580. a dialog box which allows you to open an existing file and load
  581. it in an edit buffer, or create a new file if the file you
  582. specify does not exist.  Uses the OpenFile command.
  583.  
  584.  
  585. Next
  586.  
  587.      The Next action on the File action bar pulldown attaches the
  588. next buffer in the list of buffers to the currently active
  589. window.  If there is no next buffer the first buffer in the list
  590. is attached.  Uses the NextBuffer command.
  591.  
  592.  
  593. Previous
  594.  
  595.      The Previous action on the File action bar pulldown attaches
  596. the previous buffer in the list of buffers to the currently
  597. active window.  If there is no previous buffer the last buffer in
  598. the list is attached.  Uses the PreviousBuffer command.
  599.  
  600.  
  601. Save
  602.  
  603.      The Save action on the File action bar pulldown saves a
  604. modified buffer to disk.  If the buffer has not been modified a
  605. pop-up message informs you that the file has not been modified
  606. and the save request is ignored.  If you are saving an UNTITLED
  607. buffer you are presented the Save As dialog box.  Uses the
  608. WriteCurrentBuffer command.
  609.  
  610.  
  611. Save as
  612.  
  613.      The Save as... action on the File action bar pulldown
  614. presents a dialog box which permits you to change the path and
  615. file name of the current buffer.  The buffer is saved to the new
  616. path and file name when you select the OK push button.  Uses the
  617. RenameBuffer command. Compile
  618.  
  619.      The Compile... action on the File action bar pulldown is
  620. used to invoke an executable program based on the current
  621. buffer's file extension.  If more than one executable has been
  622. associated with the file extension, you are presented a dialog
  623. box which permits you to select which program you want to start.
  624.  
  625.      Output from the invoked program is redirected to an edit
  626. buffer as the program executes, allowing you to monitor its
  627. progress.  A window is created for the output buffer if one does
  628. not already exist.
  629.  
  630.      See Associate for further information on associating
  631. programs with file extensions.  Uses the CompileCurrentBuffer
  632. command.
  633.  
  634.  
  635. Delete
  636.  
  637.      The Delete action on the File action bar pulldown deletes
  638. the current buffer attached to the currently active window.  If
  639. the buffer has unsaved modifications you are presented a dialog
  640. box which permits you to save the buffer before deleting, delete
  641. without saving or cancel the delete buffer operation.  The next
  642. buffer in the buffer list will be displayed in any window which
  643. was displaying the deleted buffer.  Uses the DeleteCurrentBuffer
  644. command.
  645.  
  646.  
  647. Print
  648.  
  649.      The Print action on the File action bar pulldown prints the
  650. currently selected text in the current buffer or the entire text
  651. of the buffer is printed if no text is currently selected.  Uses
  652. the Print command.
  653.  
  654.  
  655. Exit
  656.  
  657.      The Exit action on the File action bar pulldown exits the
  658. editor.  If there are unsaved buffers a dialog box is presented
  659. which allows you to choose whether to save all, save selected,
  660. cancel the exit request or exit without saving unsaved buffers. 
  661. Uses the ExitEditor command. Edit Action Bar Choices
  662.  
  663.      The Edit choice on the action bar allows you to perform the
  664. following actions:
  665.  
  666.  
  667. Undo      the last editing action which moved the cursor or
  668.           changed the contents of the buffer.  Undo/Redo
  669.           information is saved for each buffer.  All your editing
  670.           actions are saved.  When you save the buffer to disk
  671.           undo/redo information is discarded (this default can be
  672.           overridden by changing the setting in the Options
  673.           Global Settings dialog box.)
  674.  
  675. Redo      Redo the action or actions you just backed out by using
  676.           the undo command.
  677.  
  678. Cut       Copies the selected text to the clipboard and then
  679.           deletes the selected text from the buffer.  If no text
  680.           is selected the current line is copied to the clipboard
  681.           and then deleted.
  682.  
  683. Copy      Copies the selected text to the clipboard.  If no text
  684.           is selected the current line is copied to the
  685.           clipboard.
  686.  
  687. Paste     Inserts the contents of the clipboard at the current
  688.           cursor position.
  689.  
  690. Delete    Deletes the selected text from the buffer.
  691.  
  692.  
  693. Undo
  694.  
  695.      The Undo action on the Edit action bar pulldown undoes
  696. (backs out) the last editing command which moved the cursor or
  697. changed the contents of the current buffer's text.  Undo
  698. information is retained for all your editing actions except
  699. scrolling performed by using the scroll bars.
  700.  
  701.      Undo information is separately maintained for each edit
  702. buffer.  If you accidentally undo something which you wanted to
  703. keep use the Redo command to reverse the effect of your undo
  704. action.
  705.  
  706.      By default, when you save the buffer to disk the undo
  707. information is discarded.  If you wish undo information to be
  708. retained across buffer saves, you may change the default behavior
  709. using the Global settings choice on the Options action bar
  710. pulldown menu.
  711.  
  712.      Undo information is saved using the virtual memory system
  713. incorporated in the editor.  Up to 128MB of virtual memory is
  714. available to you if you have the disk space available for the
  715. swap file. Redo
  716.  
  717.      The Redo action on the Edit action bar pulldown redoes
  718. (reverses the effect of undoing) the last editing command which
  719. was undone.  Redo is available only after you have used undo, if
  720. there are undoable actions (ie. you have moved the cursor or
  721. changed the buffer's contents since you last used undo) you will
  722. have to undo to the point of your last undo in order to use redo.
  723.  
  724.      Redo information is separately maintained along with undo
  725. information for each edit buffer.  If you accidentally redo
  726. something which you wanted to keep undone use the Undo command to
  727. reverse the effect of your redo action.
  728.  
  729.      Note:     Once you redo what you have undone and then resume
  730.                editing the undo/redo information for what you
  731.                have just redone will be discarded (ie. you can
  732.                not undo a redo after you have moved the cursor or
  733.                edited the buffer.)
  734.  
  735.      By default, when you save the buffer to disk the redo
  736. information is discarded.  If you wish redo information to be
  737. retained across buffer saves, you may change the default behavior
  738. using the Global settings choice on the Options action bar
  739. pulldown menu.
  740.  
  741.      Redo information is saved using the virtual memory system
  742. incorporated in the editor.  Up to 128MB of virtual memory is
  743. available to you if you have the disk space available for the
  744. swap file.
  745.  
  746.  
  747. Search Action Bar Choices
  748.  
  749.      The Search choice on the action bar allows you to perform
  750. the following actions:
  751.  
  752.  
  753. Forward   Presents a dialog box allowing you to specify the
  754.           search pattern.  Searches forward from the current
  755.           cursor position.
  756.  
  757. Backward  Presents a dialog box allowing you to specify the
  758.           search pattern.  Searches backward from the current
  759.           cursor position.
  760.  
  761. Again     Uses the last search pattern and direction to search
  762.           for the next match in the buffer.
  763.  
  764.  
  765. Replace Action Bar Choices
  766.  
  767.      The Replace choice on the action bar allows you to perform
  768. the following actions:
  769.  
  770.  
  771. Forward   Presents a dialog box allowing you to specify the
  772.           search pattern and the replacement text.  Searches
  773.           forward from the current cursor position.
  774.  
  775. Backward  Presents a dialog box allowing you to specify the
  776.           search pattern and the replacement text.  Searches
  777.           backward from the current cursor position.
  778.  
  779. Again     Uses the last search pattern, replacement text, and
  780.           direction to search for the next match in the buffer to
  781.           be replaced.
  782.  
  783.  
  784.      When an match is found the matching text is highlighted and
  785. a dialog box is displayed which permits you to Replace All,
  786. Replace One, Skip, Undo Last or Cancel the operation. Regular Expression Syntax
  787.  
  788.  
  789.      BRIEF compatible regular expression syntax: 
  790.  
  791.      ?         match any single character except newline
  792.      *         match zero or more of any character except newline
  793.      {}        used to group expressions
  794.      @         zero or more of preceding character or expression
  795.      +         one or more of preceding character or expression
  796.      |         match the preceding or following character or
  797.                expression, expressions must be grouped between
  798.                curly braces.
  799.      < or ^    Beginning of line
  800.      > or $    End of line
  801.      \c        position cursor to the character following \c in
  802.                the pattern
  803.      \         escape (match following character literally)
  804.      [ ]       enclose a character set (Example: [abcde] or
  805.                [a-e])
  806.      [^ ] [~ ] NOT in class (Example: [~a-z] or [^a-z] )
  807.  
  808.  
  809.      UNIX EGREP regular expression syntax:
  810.  
  811.      .         (dot/period) match any single character except
  812.                newline
  813.      ()        used to group expressions
  814.      *         zero or more of preceding character or expression
  815.      +         one or more of preceding character or expression
  816.      |         match the preceding or following character or
  817.                expression, expressions must be grouped between
  818.                parenthesis.
  819.      ^ or <    Beginning of line
  820.      $ or >    End of line
  821.      \c        position cursor to the character following \c in
  822.                the pattern
  823.      \         escape (match following character literally)
  824.      [ ]       enclose a character set (Example: [abcde] or
  825.                [a-e])
  826.      [^ ] [~ ] NOT in class (Example: [~a-z] or [^a-z] )
  827.  
  828.  
  829.      The following escape sequences are interpreted as in the 'C'
  830. language when specified within a character set specification:
  831.  
  832.      \b   - backspace 
  833.      \t   - tab 
  834.      \f   - form feed 
  835.      \n   - line feed 
  836.  
  837.      Escape sequences of the form \xNN where NN are hex digits
  838. will be supported at a later date.
  839.  
  840.      Replacement strings may include the escape sequence \'digit'
  841. where 'digit' is a number from 0-9. This causes the text matching
  842. the grouped expression in the search string to be substituted at
  843. this point in the replacement string.  A group expression is one
  844. enclosed by the grouping characters {} in BRIEF and () in EGREP
  845. syntax.
  846.  
  847.      NOTE: Searching across line boundaries is not currently
  848. supported.
  849.  
  850.      Selection of which syntax you want as the default can be
  851. made in the "Options" "Global settings..." dialog box.  BRIEF is
  852. selected by default. Window Action Bar Choices
  853.  
  854.      The Window choice on the action bar allows you to perform
  855. the following actions:
  856.  
  857. Cascade        Causes all edit windows (except for minimized
  858.                windows) to be sized and positioned from the upper
  859.                left corner of the main window towards the lower
  860.                right corner of the main window overlapping each
  861.                other so that just the title bar of overlapped
  862.                windows is displayed. The current window becomes
  863.                the topmost window.
  864.  
  865. Tile across    Causes all edit windows (except for minimized
  866.                windows) to be sized to fill the main window
  867.                without overlapping each other.  The windows are
  868.                sized in such a way as to give windows greater
  869.                width than height.
  870.  
  871. Tile down      Causes all edit windows (except for minimized
  872.                windows) to be sized to fill the main window
  873.                without overlapping each other.  The windows are
  874.                sized in such a way as to give windows greater
  875.                height than width.
  876.  
  877. Keep tiled     When this selection is checked, resizing the main
  878.                window, closing or creating an edit window causes
  879.                all edit windows to be re-tiled as above. The
  880.                tiling orientation (across or down) is that of the
  881.                default or the last tiling orientation selected
  882.                using the Tile across or Tile down actions.
  883.  
  884. Keep cascaded  When this selection is checked, resizing the main
  885.                window, closing or creating an edit window causes
  886.                all edit windows to be re-cascaded as described
  887.                above.
  888.  
  889. Next           Makes next window the current (active) window. 
  890.                This window is made the topmost edit window.  If
  891.                there is only one edit window this action is
  892.                ignored.
  893.  
  894. Previous       Makes previous window the current (active) window. 
  895.                This window is made the topmost edit window.  If
  896.                there is only one edit window this action is
  897.                ignored.
  898.  
  899. Duplicate      Duplicates the current window, creating a new edit
  900.                window of the same size and position as the
  901.                current window.  The new window displays the same
  902.                buffer as the current window.  The new window
  903.                becomes the current window.  If either the Keep
  904.                tiled or Keep cascaded item is checked then all
  905.                edit windows are adjusted accordingly.
  906.  
  907.  
  908.      Following the above items is a list of all edit windows
  909. (shows the name of buffer associated with the window).  Selecting
  910. one of these items makes that window the current (active) window. Option Action Bar Choices
  911.  
  912.      The Options choice on the action bar allows you to perform
  913. the following configuration actions:
  914.  
  915.  
  916. Global settings
  917.  
  918.                Set default tab widths, backups, state save,
  919.                autosave, regular expression syntax and keyboard
  920.                speed.
  921.  
  922. Fonts          Set default font to use for displaying buffer
  923.                text.
  924.  
  925. Colors         Set foreground and background colors for
  926.                displaying buffer text.
  927.  
  928. Cursors        Set cursor size and type for insert / overtype and
  929.                virtual insert / virtual overtype edit modes.
  930.  
  931. Associate      Allows you to tell RSE which executable program(s)
  932.                (compilers/make, etc.) to associate with a
  933.                particular filename extension.  When you select
  934.                this option a dialog box File Extension
  935.                Associations showing the current file extensions
  936.                and program associations is displayed.
  937.  
  938.  
  939. Associating a Program with a File Extension
  940.  
  941.      The File Extension Associations dialog box allows you to
  942. tell RSE which executable program(s) (compilers/make, etc.) to
  943. associate with a particular filename extension.  When you select
  944. this option a dialog box File Extension Associations showing the
  945. current file extensions and program associations is displayed.
  946.  
  947.  
  948. Add an extension
  949.  
  950.      To add a new filename extension click or press the Add...
  951.      pushbutton under the Extension list box.  A dialog box will
  952.      prompt you for the filename extension, enter the extension
  953.      including the leading dot/period (eg. .c or .asm or .rc
  954.      etc.) and press the OK pushbutton.  The extension is added
  955.      to the Extension listbox.  If you change your mind and don't
  956.      want to add an extension press the Cancel pushbutton.
  957.  
  958.  
  959. Delete an extension
  960.  
  961.      To delete a filename extension select the extension you wish
  962.      to delete in the Extension list box then click or press the
  963.      Delete... pushbutton under Extension list box.  A dialog box
  964.      prompts to confirm that you wish to proceed.  Pressing the
  965.      Yes pushbutton deletes the extension and all executables
  966.      associated with the extension.  Pressing No cancels the
  967.      delete operation.
  968.  
  969.  
  970. Adding an executable program to an extension
  971.  
  972.      Select the filename extension in the Extension list box with
  973.      which to associate with the new program you are about to
  974.      add.  To add (associate) a new program to the extension
  975.      currently selected in the Extension listbox press the Add...
  976.      pushbutton under the Associated programs list box.  A dialog
  977.      box prompts you for the following information:
  978.  
  979.  
  980.      Program title
  981.  
  982.           Enter a descriptive title for this program.  This
  983.           description appears in the Associated programs list box
  984.           and is used to build the title of the window which will
  985.           display output from executing the program. For example:
  986.  
  987.           MSC 6.0 Syntax Check Only
  988.  
  989.  
  990.           Path and file name
  991.  
  992.           Enter the full path and file name including the
  993.           extension to the program to be executed. (If this
  994.           program is in your PATH environment you may omit the
  995.           path.)  Batch files (.CMD) requires the executable
  996.           CMD.EXE.  Specify the batch file name in the parameters
  997.           field preceded with /C.  For example:
  998.  
  999.           CMD.EXE
  1000.           C:\BINP\CMD.EXE
  1001.  
  1002.  
  1003.      Working directory
  1004.  
  1005.           If you wish to have the current working directory
  1006.           changed before invoking the program enter the directory
  1007.           path to be switched to.  This field is optional.
  1008.  
  1009.  
  1010.      Parameters
  1011.  
  1012.           Enter the command line arguments to pass to the
  1013.           program.  To have the path and filename excluding the
  1014.           file's extension of the current buffer (file) inserted
  1015.           in the arguments string passed to the program enter %s
  1016.           at the appropriate position in the parameter field. 
  1017.           Please note that the extension is not inserted so if
  1018.           the program requires the extension you must place it
  1019.           after the %s ( eg. %s.c .) RSE will substitute the full
  1020.           path and filename excluding the extension for the %s. 
  1021.           You may omit the %s from the parameter string and RSE
  1022.           will use the Parameters just as you specify them. 
  1023.           Parameters are optional. Some examples follow:
  1024.  
  1025.           -c -AL %s.c     For CL.EXE
  1026.           -mx -zi %s.asm; For MASM.EXE
  1027.           mypjt.mak       For MAKE.EXE
  1028.           "/C DIR *.C"    For CMD.EXE
  1029.           "/C BATCH.CMD"  For CMD.EXE
  1030.  
  1031.  
  1032.      When all fields are completed press the OK pushbutton to add
  1033.      this entry to the Associated programs list box.  If you
  1034.      change your mind and don't want to perform the add, press
  1035.      the Cancel pushbutton.
  1036.  
  1037.  
  1038. Changing an executable program's information
  1039.  
  1040.      Select the extension and program in their respective list
  1041.      boxes and press the Change... pushbutton under the
  1042.      Associated programs list box.  A dialog box will present you
  1043.      with the current settings of the fields for this entry. 
  1044.      (See above for a description of the fields.) Change any
  1045.      fields that you wish and press the OK pushbutton when you
  1046.      are satisfied with your changes.  If you change your mind
  1047.      and don't want to save the changes you have made, press the
  1048.      Cancel pushbutton, any changes you have made are discarded.
  1049.  
  1050.  
  1051. Copying an associated program
  1052.  
  1053.      To copy an Associated programs entry select the entry you
  1054.      wish to copy in the Associated programs list box and press
  1055.      the Copy... pushbutton.  You are presented a dialog box
  1056.      which allows you to choose which file extension you wish to
  1057.      copy the entry to.  Select the file extension and press the
  1058.      OK pushbutton.  The entry is added to the list of associated
  1059.      programs for the extension you selected.  If you change your
  1060.      mind and don't want to perform the copy operation press the
  1061.      Cancel pushbutton.  A fast way to add multiple entries for
  1062.      an extension is to add the first and then copy the first as
  1063.      many times as you wish and then change the copied entries.
  1064.  
  1065.  
  1066. Deleting an associated program
  1067.  
  1068.      Select the extension and program in their respective list
  1069.      boxes and press the Delete... pushbutton under the
  1070.      Associated programs listbox.  You are prompted to confirm
  1071.      that you really want to perform the deletion, press the Yes
  1072.      pushbutton to perform the deletion or No pushbutton to
  1073.      cancel the delete operation.
  1074.  
  1075.  
  1076. When you complete your modifications to the File Extension
  1077. Association dialog box you have two choices:
  1078.  
  1079.      Press the OK pushbutton to permanently save the changes to
  1080.      the configuration file.
  1081.  
  1082.           OR
  1083.  
  1084.      Press the Cancel pushbutton which does not perform a save to
  1085.      the configuration file, the changes you have made are
  1086.      retained until you change them again or exit the editor. 
  1087.      You can go back at a later time and permanently save them by
  1088.      selecting the OK pushbutton. Compiling Within the Editor
  1089.  
  1090.      When you invoke the "CompileCurrentBuffer" command, either
  1091. from the "File" pulldown ("Compile..." option) or via a keystroke
  1092. association one of three things will occur.
  1093.  
  1094.  
  1095.      1)   If the file extension for the current buffer (file) is
  1096.           not found in the file extension associations data you
  1097.           receive a pop-up message telling you that no
  1098.           association exists.
  1099.  
  1100.      2)   If only one association exists for this extension RSE
  1101.           immediately executes the associated executable.
  1102.  
  1103.      3)   If more than one association exists RSE presents a
  1104.           dialog box from which you may select which executable
  1105.           association you want to execute.  The dialog box shows
  1106.           the "Program title" which you entered in the
  1107.           "Associate..." dialog box.  Select the title you wish
  1108.           to execute and press the "Execute" pushbutton.  Press
  1109.           the "Cancel" pushbutton if you change your mind and
  1110.           don't want to execute any of the selections.
  1111.  
  1112.  
  1113.      When RSE invokes an executable the following actions are
  1114. performed:
  1115.  
  1116.  
  1117.      o    If the current buffer has been modified, it is written
  1118.           to disk.
  1119.  
  1120.      o    A temporary buffer and a window for this buffer is
  1121.           created, if one does not already exist, for output from
  1122.           the executing program.  The window's  title is a
  1123.           concatenation of the "Program title" and the full path
  1124.           and filename of the current buffer.
  1125.  
  1126.      Note: stdout and stderr are both redirected to this window.
  1127.  
  1128.      o    Associates the temporary buffer with the current
  1129.           buffer.
  1130.  
  1131.      o    Locks the current buffer and the temporary buffer so
  1132.           that they can not be deleted until the program
  1133.           completes execution.  You can delete the windows but
  1134.           not the buffers.
  1135.  
  1136.      o    Creates a thread which executes the program and
  1137.           redirects its output to the temporary buffer.  The
  1138.           program is exec'd asynchronously to RSE.
  1139.  
  1140.      o    Creates a thread which waits for the completion of the
  1141.           executing program.
  1142.  
  1143. While the program is executing, its output to stdout and stderr
  1144. is redirected to the temporary buffer (and displayed in the
  1145. window attached to this buffer, if any) as the program executes
  1146. so you can monitor the progress of the executing program.
  1147.  
  1148. When the program completes execution the following actions occur:
  1149.  
  1150.      o    A pop-up message notifies you of the completion and if
  1151.           the program returned with a non-zero result code.
  1152.  
  1153.      o    The temporary buffer and the buffer associated with the
  1154.           temporary buffer are unlocked.  You may now delete
  1155.           these buffers if you wish.
  1156.  
  1157.      o    You may invoke multiple concurrent program executions,
  1158.           but each must be on an unlocked buffer (ie. you can not
  1159.           start two executions on the same buffer, you must wait
  1160.           until the first completes before starting another).  If
  1161.           you attempt to do so you will receive a message telling
  1162.           you the buffer is locked by a process.
  1163.  
  1164. Jumping to Errors in the Source File
  1165.  
  1166.      RSE supports jumping to errors for programs which format
  1167. their error messages in the same way as the Microsoft C Compiler,
  1168. ie.:
  1169.  
  1170.      pathname(error line #) : text {error}|{warning}
  1171.  
  1172.  
  1173.      In the following discussion error line includes lines
  1174. containing warning messages as well as errors.
  1175.  
  1176.      Jump to error processing is performed by the "NextError" and
  1177. "PrevError" commands.  When you invoke these commands (default
  1178. key assignments are CTRL+N for NextError and CTRL+P for
  1179. PrevError) four actions are possible:
  1180.  
  1181.  
  1182.      1)   No temporary file is associated with the current buffer
  1183.           the command is ignored.
  1184.  
  1185.      2)   The end (for NextError) or beginning (for PrevError) of
  1186.           the temporary file has been reached - no action is
  1187.           taken.  A subsequent invocation will reposition to the
  1188.           beginning or end of file and display the first or last
  1189.           error message (ie. treats the temporary buffer as a
  1190.           circular list).
  1191.  
  1192.      3)   An error line is found and the error is in the current
  1193.           buffer - you are positioned to the line specified in
  1194.           the error message and a pop-up message box containing
  1195.           the contents of the error line message is displayed.
  1196.  
  1197.      4)   An error line is found but the file is not the current
  1198.           buffer's:
  1199.  
  1200.           A)   If the file is currently loaded in the editor a
  1201.                pop-up message box asks you if you want to jump to
  1202.                the line in error in the other file.
  1203.  
  1204.           B)   If the file is not currently loaded a pop-up
  1205.                message box asks you if you want to have the file
  1206.                loaded and then jump to the error in that file.
  1207.  
  1208.           The message box displays the file which will be jumped
  1209.           to/loaded if you press the "Yes" pushbutton.
  1210.  
  1211.           If you don't want to see the error in the other file
  1212.           press the "No" pushbutton.
  1213.  
  1214. This makes it possible to step through errors generated by a MAKE
  1215. of multiple source files, but the current window must be the
  1216. buffer with which the temporary (error) buffer is associated for
  1217. the NextError/PrevError command to work. The Virtual Memory System
  1218.  
  1219.  
  1220.      The virtual memory system supports an address space up to
  1221. 128MB if you have the space available on your hard drive for the
  1222. swap file.
  1223.  
  1224.      The virtual memory swap file is placed in the drive/dir
  1225. specified by the TMP environment variable or the root of the
  1226. current drive if no TMP variable is found. If you have any
  1227. comments on the use of the TMP environment variable, please let
  1228. us know. This could be a problem if TMP points to a ram disk,
  1229. since they are usually not very large.  The virtual memory system
  1230. is used to retain all undo/redo and text buffer contents, which
  1231. can cause quite large swap files.
  1232.  
  1233.  
  1234.  
  1235. Getting HELP
  1236.  
  1237.  
  1238.      The beginnings of a complete on-line context sensitive help
  1239. system are in place using the IPF functions new to OS/2 Version
  1240. 1.2.  RSE.HLP contains the IPF help library.  This file should be
  1241. copied to one of the directories associated with the HELP
  1242. environment variable, or you can add the directory containing
  1243. RSE.HLP to the HELP path. OS/2 by default creates a
  1244. HELP=C:\OS2\HELP entry in CONFIG.SYS.
  1245.  
  1246.      Pressing the F1 key invokes the help subsystem.  Help is
  1247. currently available for action bar choices and some of the
  1248. pulldown menu items.  Consult the table of contents or index for
  1249. help on other topics. LIST OF ALL FUNCTIONS WHICH CAN BE BOUND TO KEYS
  1250.  
  1251. SelfInsert     Insert/Overtype the ascii value of the key
  1252.  
  1253. NewLine        Insert a carriage return or moves to beginning of
  1254.                next line
  1255.  
  1256.      Note:     SelfInsert and NewLine are affected by the state
  1257.                of Insert/Overtype mode
  1258.  
  1259. DeleteChar     Delete char at cursor
  1260.  
  1261. DeleteCharLeft Delete char to left of cursor (no wrap back to
  1262.                previous line)
  1263.  
  1264. DeleteLine     Delete line cursor is on
  1265.  
  1266. DeleteLineEnd  Delete from cursor to end of line
  1267.  
  1268. Left           Move cursor left one position (does not wrap back
  1269.                to previous line)
  1270.  
  1271. Right          Move cursor right one position (does not wrap to
  1272.                next line)
  1273.  
  1274. Up             Move cursor up to previous line
  1275.  
  1276. Down           Move cursor down to next line
  1277.  
  1278. PageDown       Move cursor down number of lines in window - 1
  1279.  
  1280. PageUp         Move cursor up number of lines in window - 1
  1281.  
  1282. Home           Triple action (LineStart/TopOfWindow/TopOfBuffer)
  1283.  
  1284. End            Triple action (LineEnd/EndOfWindow/EndOfBuffer)
  1285.  
  1286. LineStart      Move cursor to start of line
  1287.  
  1288. LineEnd        Move cursor to end of line
  1289.  
  1290. WordLeft       Move cursor to beginning of previous word or
  1291.                number
  1292.  
  1293. WordRight      Move cursor to beginning of next word or number
  1294.  
  1295. TopOfWindow    Move cursor to beginning of top line in window
  1296.  
  1297. EndOfWindow    Move cursor to end of last line in window
  1298.  
  1299. TopOfBuffer    Move cursor to start of buffer
  1300.  
  1301. EndOfBuffer    Move cursor to end of buffer
  1302.  
  1303. ScrollUp       Scroll contents of window up
  1304.  
  1305. ScrollDown     Scroll contents of window down
  1306.  
  1307. GotoLine       Prompts for line to jump to (precede line number
  1308.                with a + or - for to jump relative to current
  1309.                line)
  1310.  
  1311.  
  1312. Undo           Back out last cursor movement or editing change
  1313.  
  1314. Redo           Put back what was just undone
  1315.  
  1316.  
  1317. MarkBlock      Toggle block marking
  1318.  
  1319. MarkLine       Toggle line marking
  1320.  
  1321. MarkColumn     Toggle column marking
  1322.  
  1323.      Note:     If another marking mode is selected the above will
  1324.                change the mark type to that which the command
  1325.                specifies.
  1326.  
  1327. CutClipboard   Copy to clipboard then delete selected text
  1328.  
  1329. CopyClipboard  Copy selected text to clipboard
  1330.  
  1331. PasteClipboard Insert contents of clipboard at cursor position
  1332.  
  1333. DeleteBlock    Delete selected text
  1334.  
  1335.  
  1336. WriteCurrentBuffer
  1337.                Save buffer to disk
  1338.  
  1339. WriteMarkedRegion
  1340.                Save selected text to disk
  1341.  
  1342. Write          Save buffer or selected text to disk
  1343.  
  1344.      Note:     Write combines the action of WriteCurrentBuffer
  1345.                and WriteMarkedRegion.  If text is selected
  1346.                (marked) you receive a dialog box to give the path
  1347.                and file name to which the selected text should be
  1348.                written.  If no text is selected the entire buffer
  1349.                is written to disk if the buffer has been
  1350.                modified.
  1351.  
  1352. DeleteCurrentBuffer
  1353.                Deletes the current buffer, if it has unsaved
  1354.                changes you are given the opportunity to save
  1355.                before deleting, delete without saving or cancel
  1356.                the request.
  1357.  
  1358. ExitEditor     Exits the editor.  If unsaved buffers exist you
  1359.                receive a dialog box giving you the opportunity to
  1360.                save all, selected, or none of the unsaved
  1361.                buffers, exit without saving, or cancel the
  1362.                request.
  1363.  
  1364. SaveAllAndExit Saves any unsaved buffers and exits the editor
  1365.  
  1366. NewFile        Creates an UNTITLED buffer
  1367.  
  1368. OpenFile       Presents a dialog for you to select the file you
  1369.                wish to load into buffers.
  1370.  
  1371. ReadFile       Presents a dialog box for you to select a file to
  1372.                be read into the current buffer at the current
  1373.                cursor position.
  1374.  
  1375. RenameBuffer   (Save as) allows you to change the path and file
  1376.                name of a loaded buffer. The buffer is then
  1377.                written to disk.
  1378.  
  1379. NextBuffer     Brings next buffer in the buffer list into the
  1380.                current window.
  1381.  
  1382. PrevBuffer     Brings the previous buffer in the buffer list into
  1383.                the current window.
  1384.  
  1385. Print          Print the selected text or if no text is selected
  1386.                the entire buffer.
  1387.  
  1388.  
  1389. CompileCurrentBuffer
  1390.                Invokes an executable which has been associated
  1391.                with the extension of the buffer's file name.  If
  1392.                more than one association exists you are presented
  1393.                a dialog box from which to select the program you
  1394.                wish to run.  Stdout and stderr are redirected to
  1395.                a temporary buffer which is created for you. 
  1396.                Undo/redo information is not retained for the
  1397.                temporary buffer and the temporary buffer can not
  1398.                be saved to disk or renamed.
  1399.  
  1400. NextError      If a temporary buffer is associated with the
  1401.                current buffer searches forward for an
  1402.                error/warning message conforming to the Microsoft
  1403.                'C' compiler's error format.  If a line is found a
  1404.                pop-up message displays the error/warning line and
  1405.                jumps to the line in error.  If the error is
  1406.                located in a different file you will be notified.
  1407.                If the file is not loaded it will load the file
  1408.                and then jump to the line in error or if the file
  1409.                is loaded you can jump to the line in error.
  1410.                        
  1411.                        
  1412. PrevError      If a temporary buffer is associated with the
  1413.                current buffer searches backward for an
  1414.                error/warning message conforming to the Microsoft
  1415.                'C' compiler's error format.  If a line is found a
  1416.                pop-up message displays the error/warning line and
  1417.                jumps to the line in error.
  1418.  
  1419.  
  1420. TileWindows    Uses the current tiling orientation to tile all
  1421.                windows which are not minimized.
  1422.  
  1423. TileAcross     Tile windows giving preference to window sizing
  1424.                wider than they are high.
  1425.  
  1426. TileDown       Tile windows giving preference to window sizing
  1427.                taller than wide.
  1428.  
  1429. ToggleKeepTiled
  1430.                Toggle whether windows should be kept tiled when
  1431.                the main window is sized or windows are created or
  1432.                deleted. When the toggle goes from off to on the
  1433.                windows are tiled.
  1434.  
  1435. CascadeWindows Arrange all non-minimized windows so that they
  1436.                overlap.
  1437.  
  1438. ToggleKeepCascaded
  1439.                Toggle whether windows should be kept cascaded
  1440.                when the main window is sized or windows are
  1441.                created or deleted. When the toggle goes from off
  1442.                to on the windows are cascaded.
  1443.  
  1444. NextWindow     Make next window in the window list the current  
  1445.                (active) window.
  1446.  
  1447. PrevWindow     Make the previous window in the window list the
  1448.                current (active) window.
  1449.  
  1450. DuplicateWindow
  1451.                Make a copy of the current window. The window
  1452.                overlays the current window and displays the same
  1453.                buffer.  If KeepTiled or KeepCascaded is on then
  1454.                all windows are re-sized and positioned.
  1455.  
  1456. DeleteCurrentWindow
  1457.                Deletes the current window.  The buffer that was
  1458.                attached to the window is not deleted.
  1459.  
  1460. DeleteWindowAndBuffer
  1461.                Deletes the current window and the buffer
  1462.                displayed in the current window.  Any other
  1463.                windows attached to this buffer will have the next
  1464.                buffer in the buffer list attached to them.
  1465.  
  1466. ToggleRecordMacro
  1467.                Toggle keystroke macro recording.  If toggling to
  1468.                on, a dialog box prompts for the name of the file
  1469.                to which to save the macro.
  1470.  
  1471. PlayMacro      Presents a dialog box prompting for the file name
  1472.                of the macro you wish to play.
  1473.  
  1474. PlayMacroAgain Plays the last recorded macro, or the last macro
  1475.                that was played, again.
  1476.  
  1477. SearchForward  Presents a dialog box prompting for the search
  1478.                expression.  You may also change the state of the
  1479.                Ignore regular expression and Ignore case flags. 
  1480.                Searches forward from the current cursor position.
  1481.  
  1482. SearchBackward Presents a dialog box prompting for the search
  1483.                expression.  You may also change the state of the
  1484.                Ignore regular expression and Ignore case flags. 
  1485.                Searches backward from the current cursor
  1486.                position.
  1487.  
  1488. SearchAgain    Uses last search expression and search direction
  1489.                to search.  Searches from one character position
  1490.                away from the current cursor position.
  1491.  
  1492.  
  1493. ReplaceForward Presents a dialog box prompting for the search
  1494.                expression and replace expression.  You may also
  1495.                change the state of the Ignore regular expression
  1496.                and Ignore case flags.  Searches forward from the
  1497.                current cursor position.
  1498.  
  1499. ReplaceBackward
  1500.                Presents a dialog box prompting for the search
  1501.                expression and replace expression.  You may also
  1502.                change the state of the Ignore regular expression
  1503.                and Ignore case flags.  Searches backward from the
  1504.                current cursor position.
  1505.  
  1506. ReplaceAgain   Uses last search and replace expressions and
  1507.                search direction to search.  Searches from one
  1508.                character position away from the current cursor
  1509.                position.
  1510.  
  1511. ToggleInsert   Toggle insert/overtype mode.
  1512.  
  1513. ToggleTabs     Toggle whether to use tab characters or an
  1514.                appropriate number of spaces when the TAB key is
  1515.                pressed.
  1516.  
  1517. ToggleBackups  Toggle whether backup files will be created when
  1518.                you save a buffer to disk.
  1519.  
  1520. ConfigGlobals  Presents the Editor Configuration dialog box.
  1521.  
  1522. ConfigFonts    Presents the Font Selection dialog box.
  1523.  
  1524. ConfigColors   Presents the Color Selection dialog box.
  1525.  
  1526. ConfigCursors  Presents the Cursor Settings dialog box.
  1527.  
  1528. ConfigAssoc    Presents the File Extension Association dialog box
  1529.  
  1530.  
  1531. HelpForHelp    Invokes help system for help on using help
  1532.  
  1533. HelpExtended   Displays extended help for item if available
  1534.  
  1535. HelpKeys       Displays keys help
  1536.  
  1537. HelpIndex      Displays the help index
  1538.  
  1539. AboutEditor    Displays the About RimSTAR Editor dialog box
  1540.  
  1541.  
  1542. InvalidKey     Beeps when key is pressed. BRIEF Key Mapping Quick Reference
  1543.  
  1544. NewLine        ENTER or KP_ENTER
  1545.  
  1546. DeleteChar     DELETE or KP_DELETE (note: deletes block if text
  1547.                is marked)
  1548.  
  1549. DeleteCharLeft BACKSPACE
  1550. DeleteLine     ALT + D
  1551. DeleteLineEnd  ALT + K
  1552.  
  1553. Left           LEFT or KP_LEFT
  1554. Right          RIGHT or KP_RIGHT
  1555. Up             UP or KP_UP
  1556. Down           DOWN or KP_DOWN
  1557. PageDown       PGDN or KP_PGDN
  1558. PageUp         PGUP or KP_PGUP
  1559. Home           HOME or KP_HOME (Triple action)
  1560. End            END or KP_END (Triple action)
  1561. LineStart      CTRL + Q + CTRL + S (like WordStar)
  1562. LineEnd        CTRL + Q + CTRL + D (like WordStar)
  1563. WordLeft       CTRL + LEFT or CTRL + KP_LEFT
  1564. WordRight      CTRL + RIGHT or CTRL + KP_RIGHT
  1565. TopOfWindow    not assigned
  1566. EndOfWindow    not assigned
  1567. TopOfBuffer    CTRL + HOME
  1568. EndOfBuffer    CTRL + END
  1569. ScrollUp       CTRL + U
  1570. ScrollDown     CTRL + D
  1571. GotoLine       ALT + G
  1572.  
  1573. Undo           ALT + U or KP_STAR
  1574. Redo           ALT + R or SHIFT + KP_STAR
  1575.  
  1576. MarkBlock      ALT + M
  1577. MarkLine       ALT + L
  1578. MarkColumn     ALT + C
  1579.  
  1580. CutClipboard   KP_MINUS
  1581. CopyClipboard  KP_PLUS
  1582. PasteClipboard INSERT or KP_INSERT
  1583. DeleteBlock    DELETE or KP_DELETE (if text marked)
  1584.  
  1585. WriteCurrentBuffer  CTRL + S
  1586. WriteMarkedRegion   not assigned
  1587. Write               ALT + W
  1588.  
  1589. ExitEditor     ALT + X
  1590. SaveAllAndExit CTRL + X
  1591.  
  1592. NewFile             not assigned
  1593. OpenFile            ALT + E
  1594. ReadFile            CTRL + R (note BRIEF uses ALT + R for this)
  1595. RenameBuffer        ALT + O
  1596. DeleteCurrentBuffer CTRL + -
  1597.  
  1598. NextBuffer     ALT + N
  1599. PrevBuffer     ALT + -
  1600.  
  1601. Print          ALT + P
  1602.  
  1603. CompileCurrentBuffer     SHIFT + F10
  1604. NextError                CTRL + N
  1605. PrevError                CTRL + P
  1606.  
  1607. TileWindows         SHIFT + CTRL + F1
  1608. TileAcross          not assigned
  1609. TileDown            not assigned
  1610. ToggleKeepTiled     not assigned
  1611. CascadeWindows      not assigned
  1612. ToggleKeepCascaded  not assigned
  1613.  
  1614. NextWindow               SHIFT + F1
  1615. PrevWindow               CTRL + F1
  1616. DuplicateWindow          F3
  1617. DeleteCurrentWindow      F4
  1618. DeleteWindowAndBuffer    SHIFT + CTRL + -
  1619.  
  1620. ToggleRecordMacro   F7
  1621. PlayMacro           F8
  1622. PlayMacroAgain      SHIFT + F8
  1623.  
  1624. SearchForward  F5
  1625. SearchBackward SHIFT + CRL + F5 (note: different from BRIEF)
  1626. SearchAgain    SHIFT + F5
  1627.  
  1628. ReplaceForward  F6
  1629. ReplaceBackward SHIFT + CTRL + F6 (note: different from BRIEF)
  1630. ReplaceAgain    SHIFT + F6
  1631.  
  1632. ToggleInsert   ALT + I
  1633. ToggleTabs     not assigned
  1634. ToggleBackups  CTRL + W
  1635.  
  1636. ConfigGlobals  not assigned
  1637. ConfigFonts    not assigned
  1638. ConfigColors   not assigned
  1639. ConfigCursors  not assigned
  1640. ConfigAssoc    not assigned
  1641.  
  1642.  
  1643. HelpForHelp    not assigned
  1644. HelpExtended   not assigned
  1645. HelpKeys       not assigned
  1646. HelpIndex      not assigned
  1647. AboutEditor    ALT + V
  1648.  
  1649. InvalidKey     not assigned
  1650. 
  1651.