home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / pmeditor.zip / RSE.HLP (.txt) < prev    next >
OS/2 Help File  |  1990-06-15  |  26KB  |  968 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. About the RimSTAR PM Programmer's Editor ΓòÉΓòÉΓòÉ
  3.  
  4. RimSTARProgrammer ' sEditor
  5. Version 0.92 for OS/2 PM
  6. Copyright 1989,1990 RimSTAR Technology.
  7. All rights reserved.
  8.  
  9. The RimSTAR Programmer's Editor is a Presentation Manager-based editor for 
  10. software developers. Consult the Table of Contents or Index for help on a 
  11. specific topic. 
  12.  
  13. The help system is not complete for this release. 
  14.  
  15. The help facility is designed to give context-sensitive help.  It is not 
  16. intended to be a tutorial. 
  17.  
  18. For more information about using the help facility, select Help for help on the 
  19. Help pull-down. 
  20.  
  21. If you require technical support call 1-617-925-2718 between the hours of 
  22. 9:00am and 5:00pm EST Monday-Friday. Please have your serial number available 
  23. when you call.  Please register your copy(s) with RimSTAR to ensure you recieve 
  24. notification of upgrades and other important information.  Upgrades to Version 
  25. 1.0 are no charge including complete printed user manual(s) but we can not 
  26. upgrade you if you have not registered. 
  27.  
  28. Mail all correspondence to: 
  29.  
  30.  RimSTARTechnology
  31.  1 Commodores Court Suite 503
  32.  Hull, MA 02045
  33.  
  34.  
  35. ΓòÉΓòÉΓòÉ 2. The File Action Bar Choice ΓòÉΓòÉΓòÉ
  36.  
  37. The File choice on the action bar allows you to perform the following actions: 
  38.  
  39.  New 
  40.            Creates a new untitled buffer. You must give the buffer a name 
  41.            before you can save it to disk. 
  42.  
  43.  Open 
  44.            Presents a dialog box which allows you to select a file to load into 
  45.            a buffer. If the file does not exist you are prompted whether to 
  46.            create it or ignore the request. 
  47.  
  48.  Next 
  49.            Brings the next buffer into the current window. 
  50.  
  51.  Previous 
  52.            Brings the previous buffer into the current window. 
  53.  
  54.  Save 
  55.            Save the buffer displayed in the current window to disk. 
  56.  
  57.  Save as 
  58.            Renames the buffer displayed in the current window and then saves 
  59.            the buffer to disk under the new name you gave. 
  60.  
  61.  Compile 
  62.            Allows you to execute an associated executable if there is an 
  63.            extension associated with the buffer's file extentension. This 
  64.            association is established by selecting the Associate action on the 
  65.            Options pulldown menu or the ConfigAssociate command. 
  66.  
  67.  Delete 
  68.            Deletes the buffer displayed in the current window. If the buffer 
  69.            has been modified you are presented a dialog box which allows you to 
  70.            save the buffer before deleting it. 
  71.  
  72.  Print 
  73.            Prints the entire contents or the selected text in the buffer 
  74.            displayed in the current window. 
  75.  
  76.  Print setup 
  77.            This item is currently unavailable. 
  78.  
  79.  Exit 
  80.            Exits the editor, displaying a dialog box if there are unsaved 
  81.            buffers, giving you the option of saving them before exiting. 
  82.  Following the above choices is a list of all buffers.  The buffer being 
  83.  displayed in the current window has a check mark in front of it. Selecting one 
  84.  of these displays that buffer in the current window. Buffer names followed by 
  85.  an asterisk indicate that the buffer has unsaved changes. 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 2.1. Creating a New (Untitled) Buffer ΓòÉΓòÉΓòÉ
  89.  
  90. The New action on the File action bar pulldown creates an UNTITLED buffer. You 
  91. are prompted to give the buffer a name when you save the file to disk. 
  92.  
  93. If you exit the editor with an unsaved UNTITLED buffer you receive a popup 
  94. message informing you that there are unsaved UNTITLED buffers.  If you want to 
  95. save them you should cancel the exit and use the Save as... choice on the File 
  96. action bar pulldown and give the buffer a valid OS/2 path and file name. 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 2.2. Opening a file for editing ΓòÉΓòÉΓòÉ
  100.  
  101. The Open... action on the File action bar pulldown presents a dialog box which 
  102. allows you to open an existing file and load it in an edit buffer, or create a 
  103. new file if the file you specify does not exist. 
  104.  
  105.  
  106. ΓòÉΓòÉΓòÉ 2.3. Bringing next buffer into window ΓòÉΓòÉΓòÉ
  107.  
  108. The Next action on the File action bar pulldown attaches the next buffer in the 
  109. list of buffers to the currently active window.  If there is no next buffer the 
  110. first buffer in the list is attached. 
  111.  
  112.  
  113. ΓòÉΓòÉΓòÉ 2.4. Bringing previous buffer into window ΓòÉΓòÉΓòÉ
  114.  
  115. The Previous action on the File action bar pulldown attaches the previous 
  116. buffer in the list of buffers to the currently active window.  If there is no 
  117. previous buffer the last buffer in the list is attached. 
  118.  
  119.  
  120. ΓòÉΓòÉΓòÉ 2.5. Saving a modified buffer to disk ΓòÉΓòÉΓòÉ
  121.  
  122. The Save action on the File action bar pulldown saves a modified buffer to 
  123. disk.  If the buffer has not been modified a popup message informs you that the 
  124. file has not been modified and the save request is ignored. If you are saving 
  125. an UNTITLED buffer you are presented the Save As dialog box. 
  126.  
  127.  
  128. ΓòÉΓòÉΓòÉ 2.6. Save as - renaming a buffer ΓòÉΓòÉΓòÉ
  129.  
  130. The Save as... action on the File action bar pulldown presents a dialog box 
  131. which permits you to change the path and file name of the current buffer. The 
  132. buffer is saved to the new path and file name when you select the OK push 
  133. button. 
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ 2.7. Compiling ΓòÉΓòÉΓòÉ
  137.  
  138. The Compile... action on the File action bar pulldown is used to invoke an 
  139. executable program based on the current buffer's file extension.  If more than 
  140. one executable has been associated with the file extension, you are presented a 
  141. dialog box which permits you to select which program you want to start. 
  142.  
  143. Output from the invoked program is redirected to an edit buffer as the program 
  144. executes, allowing you to monitor its progress.  A window is created for the 
  145. output buffer if one does not already exist. 
  146.  
  147. See Associate for further information on associating programs with file 
  148. extensions. 
  149.  
  150.  
  151. ΓòÉΓòÉΓòÉ 2.8. Delete Buffer ΓòÉΓòÉΓòÉ
  152.  
  153. The Delete action on the File action bar pulldown delete the current buffer 
  154. attached to the currently active window.  If the buffer has unsaved 
  155. modifications you are presented a dialog box which permits you to save the 
  156. buffer before delting, delete without saving or cancel the delete buffer 
  157. operation.  The next buffer in the buffer list will be displayed in any window 
  158. which was displaying the deleted buffer. 
  159.  
  160.  
  161. ΓòÉΓòÉΓòÉ 2.9. Print ΓòÉΓòÉΓòÉ
  162.  
  163. The Print action on the File action bar pulldown prints the currently selected 
  164. text in the current buffer or the entire text of the buffer is printed if no 
  165. text is currently selected. 
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ 2.10. Exit Editor ΓòÉΓòÉΓòÉ
  169.  
  170. The Exit action on the File action bar pulldown exits the editor.  If there are 
  171. unsaved buffers a dialog box is presented which allows you to choose whether to 
  172. save all, save selected, cancel the exit request or exit without saving unsaved 
  173. buffers. 
  174.  
  175.  
  176. ΓòÉΓòÉΓòÉ 3. The Edit Action Bar Choice ΓòÉΓòÉΓòÉ
  177.  
  178. The Edit choice on the action bar allows you to perform the following actions: 
  179.  
  180.  Undo 
  181.            Undo the last editing action which moved the cursor or changed the 
  182.            contents of the buffer. Undo/Redo information is saved for each 
  183.            buffer. All your editing actions are saved.  When you save the 
  184.            buffer to disk undo/redo information is discarded (this default can 
  185.            be overridden by changing the setting in the Options - Global 
  186.            Settings dialog box.) 
  187.  
  188.  Redo 
  189.            Redo the action or actions you just backed out by using the undo 
  190.            command. 
  191.  
  192.  Cut 
  193.            Copies the selected text to the clipboard and then deletes the 
  194.            selected text from the buffer. If no text is selected the current 
  195.            line is copied to the clipboard and then deleted. 
  196.  
  197.  Copy 
  198.            Copies the selected text to the clipboard.  If no text is selected 
  199.            the current line is copied to the clipboard. 
  200.  
  201.  Paste 
  202.            Inserts the contents of the clipboard at the current cursor 
  203.            position. 
  204.  
  205.  Delete 
  206.            Deletes the selected text from the buffer. 
  207.  
  208.  
  209. ΓòÉΓòÉΓòÉ 3.1. Undo ΓòÉΓòÉΓòÉ
  210.  
  211. The Undo action on the Edit action bar pulldown undoes (backs out) the last 
  212. editing command which moved the cursor or changed the contents of the current 
  213. buffer's text.  Undo information is retained for all your editing actions 
  214. except scrolling performed by using the scroll bars. 
  215.  
  216. Undo information is separately maintained for each edit buffer. If you 
  217. accidently undo something which you wanted to keep use the Redo command to 
  218. reverse the effect of your undo action. 
  219.  
  220. By default, when you save the buffer to disk the undo information is discarded. 
  221. If you wish undo information to be retained across buffer saves, you may change 
  222. the default behavior using the Global settings choice on the Options action bar 
  223. pulldown menu. 
  224.  
  225. Undo information is saved using the virtual memory system incorporated in the 
  226. editor.  Up to 128MB of virtual memory is available to you if you have the disk 
  227. space available for the swap file. 
  228.  
  229.  
  230. ΓòÉΓòÉΓòÉ 3.2. Redo ΓòÉΓòÉΓòÉ
  231.  
  232. The Redo action on the Edit action bar pulldown redoes (reverses the effect of 
  233. undoing) the last editing command which was undone.  Redo is available only 
  234. after you have used undo, if there are undoable actions (ie. you have moved the 
  235. cursor or changed the buffer's contents since you last used undo) you will have 
  236. to undo to the point of your last undo in order to use redo. 
  237.  
  238. Redo information is separately maintained along with undo information for each 
  239. edit buffer. If you accidently redo something which you wanted to keep undone 
  240. use the Undo command to reverse the effect of your redo action. 
  241.  
  242. Note:  Once you redo what you have undone and then resume editing the undo/redo 
  243. information for what you have just redone will be discarded (ie. you can not 
  244. undo a redo after you have moved the cursor or edited the buffer.) 
  245.  
  246. By default, when you save the buffer to disk the redo information is discarded. 
  247. If you wish redo information to be retained across buffer saves, you may change 
  248. the default behavior using the Global settings choice on the Options action bar 
  249. pulldown menu. 
  250.  
  251. Undo information is saved using the virtual memory system incorporated in the 
  252. editor.  Up to 128MB of virtual memory is available to you if you have the disk 
  253. space available for the swap file. 
  254.  
  255.  
  256. ΓòÉΓòÉΓòÉ 3.3. Cut to Clipboard ΓòÉΓòÉΓòÉ
  257.  
  258.  
  259. ΓòÉΓòÉΓòÉ 4. The Search Action Bar Choice ΓòÉΓòÉΓòÉ
  260.  
  261. The Search choice on the action bar allows you to perform the following 
  262. actions: 
  263.  
  264.  Forward 
  265.            Presents a dialog box allowing you to specify the search pattern. 
  266.            Searches forward from the current cursor position. 
  267.  
  268.  Backward 
  269.            Presents a dialog box allowing you to specify the search pattern. 
  270.            Searches backward from the current cursor position. 
  271.  
  272.  Again 
  273.            Uses the last search pattern and direction to search for the next 
  274.            match in the buffer. 
  275.  ************************************************************************ 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 4.1. Regular Expression Syntax ΓòÉΓòÉΓòÉ
  279.  
  280. Current support for Regular expressions in Search Patterns are: 
  281.  
  282. BRIEF compatible regular expression syntax 
  283.  
  284.  ?         match any character except newline 
  285.  
  286.  *         match zero or more of any character except newline 
  287.  
  288.  { }       used to group regular expressions 
  289.  
  290.  @         zero or more of preceeding character or expression 
  291.  
  292.  +         one or more of preceeding character or expression 
  293.  
  294.  |         match the preceeding or following character or expression 
  295.            (expressions must be grouped between curly braces, eg. 
  296.            {hello}|{world}) 
  297.  
  298.  < or ^    Beginning of line 
  299.  
  300.  > or $    End of line 
  301.  
  302.  \c        position cursor to the character following \c in the pattern 
  303.  
  304.  \         escape (match following character literally) 
  305.  
  306.  [ ]       enclose character set (Example: [abcde] or [a-e]) 
  307.  
  308.  [^ ] OR [~ ] NOT in class (Example: [~a-z ] or [^a-z ] ) 
  309.  
  310.  UNIX EGREP regular expression syntax: 
  311.  
  312.  .         (dot/period) match any character except newline 
  313.  
  314.  ( )       used to group regular expressions 
  315.  
  316.  *         zero or more of preceeding character or expression 
  317.  
  318.  +         one or more of preceeding character or expression 
  319.  
  320.  |         match the preceeding or following character or expression 
  321.            expressions must be grouped between parenthesis 
  322.  
  323.  ^ or <    Beginning of line 
  324.  
  325.  $ or >    End of line 
  326.  
  327.  \c        position cursor to the character following \c in the pattern 
  328.  
  329.  \         escape (match following character literally) 
  330.  
  331.  [ ]       encloses character set (Example: [abcde] or [a-e]) 
  332.  
  333.  [^ ] OR [~ ] NOT in class (Example: [~a-z ] or [^a-z ] ) 
  334.  
  335.  The following escape sequences are interpreted as in C when specified within a 
  336.  character set specification: 
  337.  
  338.  \b  - backspace 
  339.  
  340.  \t  - tab 
  341.  
  342.  \f  - form feed 
  343.  
  344.  \n  - line feed 
  345.  Escape sequences of the form \xNN where NN are hex digits will be supported at 
  346.  a later date. 
  347.  
  348.  Replacement strings may include the escape sequence \'digit' where 'digit' is 
  349.  a number from 0-9. This causes the text matching the  grouped expression in 
  350.  the search string to be substituted at this point in the replacement string. A 
  351.  group expression is on enclosed by the grouping characters { } in BRIEF and ( 
  352.  ) in EGREP syntax. 
  353.  
  354.  Note:  Searching across line boundaries is not currently supported. 
  355.  
  356.  Selection of which syntax you want as the default can be made in the Global 
  357.  settings choice on the Options action bar pulldown. 
  358.  
  359.  
  360. ΓòÉΓòÉΓòÉ 5. The Replace Action Bar Choice ΓòÉΓòÉΓòÉ
  361.  
  362. The Replace choice on the action bar allows you to perform the following 
  363. actions: 
  364.  
  365.  Forward 
  366.            Presents a dialog box allowing you to specify the search pattern and 
  367.            the replacement text. Searches forward from the current cursor 
  368.            position. 
  369.  
  370.  Backward 
  371.            Presents a dialog box allowing you to specify the search pattern and 
  372.            the replacement text. Searches backward from the current cursor 
  373.            position. 
  374.  
  375.  Again 
  376.            Uses the last search pattern, replacement text, and direction to 
  377.            search for the next match in the buffer to be replaced. 
  378.  When an match is found the matching text is highlighted and a dialog box is 
  379.  displayed which permits you to Replace All, Replace One, Skip, Undo Last, or 
  380.  Cancel the operation. 
  381.  
  382.  
  383. ΓòÉΓòÉΓòÉ 6. The Window Action Bar Choice ΓòÉΓòÉΓòÉ
  384.  
  385. The Window choice on the action bar allows you to perform the following 
  386. actions: 
  387.  
  388.  Cascade 
  389.            Causes all edit windows (except for minimized windows) to be sized 
  390.            and positioned from the upper left corner of the main window towards 
  391.            the lower right corner of the main window overlapping each other so 
  392.            that just the title bar of overlapped windows is displayed. The 
  393.            current window becomes the topmost window. 
  394.  
  395.  Tile across 
  396.            Causes all edit windows (except for minimized windows) to be sized 
  397.            to fill the main window without overlapping each other.  The windows 
  398.            are sized in such a way as to give windows greater width than 
  399.            height. 
  400.  
  401.  Tile down 
  402.            Causes all edit windows (except for minimized windows) to be sized 
  403.            to fill the main window without overlapping each other.  The windows 
  404.            are sized in such a way as to give windows greater height than 
  405.            width. 
  406.  
  407.  Keep tiled 
  408.            When this selection is checked, resizing the main window, closing or 
  409.            creating an edit window causes all edit windows to be re-tiled as 
  410.            above. The tiling orientation (across or down) is that of the 
  411.            default or the last tiling orientation selected using the Tile 
  412.            across or Tile down actions. 
  413.  
  414.  Keep cascaded 
  415.            When this selection is checked, resizing the main window, closing or 
  416.            creating an edit window causes all edit windows to be re-cascaded as 
  417.            described above. 
  418.  
  419.  Next 
  420.            Makes next window the current (active) window.  This window is made 
  421.            the topmost edit window. If there is only one edit window this 
  422.            action is ignored. 
  423.  
  424.  Previous 
  425.            Makes previous window the current (active) window.  This window is 
  426.            made the topmost edit window. If there is only one edit window this 
  427.            action is ignored. 
  428.  
  429.  Duplicate 
  430.            Duplicates the current window, creating a new edit window of the 
  431.            same size and position as the current window. The new window 
  432.            displays the same buffer as the current window. The new window 
  433.            becomes the current window. If either the Keep tiled or Keep 
  434.            cascaded item is checked then all edit windows are adjusted 
  435.            accordingly. 
  436.  Following the above items is a list of all edit windows (shows the name of 
  437.  buffer associated with the window) Selecting one of these items makes that 
  438.  window the current (active) window. 
  439.  
  440.  
  441. ΓòÉΓòÉΓòÉ 7. The Options Action Bar Choice ΓòÉΓòÉΓòÉ
  442.  
  443. The Options choice on the action bar allows you to perform the following 
  444. configuration actions: 
  445.  
  446.  Global settings 
  447.            Set default tab widths, backups, state save, autosave, regular 
  448.            expression syntax, and keyboard speed. 
  449.  
  450.  Fonts 
  451.            Set default font to use for displaying buffer text. 
  452.  
  453.  Colors 
  454.            Set foreground and background colors for displaying buffer text. 
  455.  
  456.  Cursors 
  457.            Set cursor size and type for insert / overtype and virtual insert / 
  458.            virtual overtype edit modes. 
  459.  
  460.  Associate 
  461.            Associate executables with file name extensions for compiling within 
  462.            the editor. 
  463.  
  464.  
  465. ΓòÉΓòÉΓòÉ 8. Associating Programs with File Extensions ΓòÉΓòÉΓòÉ
  466.  
  467.  The Associate... choice on the Options pulldown menu allows you to tell RSE 
  468. which executable program(s) (compilers/make, etc.) to associate with a 
  469. particular filename extension. 
  470.  
  471. When you select this option a dialog box File Extension Associations showing 
  472. the current file extensions and program associations is displayed. 
  473.  
  474.  Add an extension 
  475.            To add a new filename extension click or press the Add... pushbutton 
  476.            under the Extension list box.  A dialog box will prompt you for the 
  477.            filename extension, enter the extension including the leading 
  478.            dot/period (eg. .c or .asm or .rc etc.) and press the OK pushbutton. 
  479.            The extension is added to the Extension listbox. If you change your 
  480.            mind and don't want to add an extension press the Cancel pushbutton. 
  481.  
  482.  Delete an extension 
  483.            To delete a filename extension select the extension you wish to 
  484.            delete in the Extension list box then click or press the Delete... 
  485.            pushbutton under the Extensions list box.  A dialog box prompts to 
  486.            confirm that you wish to proceed.  Pressing Yes  deletes the 
  487.            extension and all executables associated with the extension. 
  488.            Pressing No cancels the delete operation. 
  489.  
  490.  Adding an executable program to an extension 
  491.            Select the filename extension in the Extension list box with which 
  492.            to associate with the new program you are about to add. To add 
  493.            (associate) a new program to the extension currently selected in the 
  494.            Extension listbox press the Add... pushbutton under the Associated 
  495.            programs list box.  A dialog box prompts you for the following 
  496.            information: 
  497.  
  498.     Program title 
  499.               Enter a descriptive title for this program.  This description 
  500.               appears in the Associated programs list box and is used to build 
  501.               the title of the window which will display output from executing 
  502.               the program. For example: 
  503.  
  504.                                MSC 6.0 Syntax Check Only
  505.  
  506.     Path and file name 
  507.               Enter the full path and file name including the extension to the 
  508.               program to be executed. (If this program is in your PATH 
  509.               environment you may omit the path.)  Batch files (.CMD) requires 
  510.               the executable CMD.EXE. Specify the batch file name in the 
  511.               parameters field preceeded with /C.  For example: 
  512.  
  513.                             CMD.EXE
  514.                             C:\BINP\CMD.EXE
  515.  
  516.     Working directory 
  517.               If you wish to have the current working directory changed before 
  518.               invoking the program enter the directory path to be switched to. 
  519.               This field is optional. 
  520.  
  521.     Parameters 
  522.               Enter the command line arguments to pass to the program. To have 
  523.               the path and filename excluding the file's extension of the 
  524.               current buffer (file) inserted in the arguments string passed to 
  525.               the program enter %s at the appropriate position in the parameter 
  526.               field.  Please note that the extension is not inserted so if the 
  527.               program requires the extension you must place it after the %s ( 
  528.               eg. %s.c .) RSE will substitute the full path and filename 
  529.               excluding the extension for the %s.  You may omit the %s from the 
  530.               parameter string and RSE will use the Parameters just as you 
  531.               specify them.  Parameters are optional. Some examples follow: 
  532.  
  533.                             -c -AL %s.c     For CL.EXE
  534.                             -mx -zi %s.asm; For MASM.EXE
  535.                             mypjt.mak       For MAKE.EXE
  536.                             "/C DIR *.C"    For CMD.EXE
  537.                             "/C BATCH.CMD"  For CMD.EXE
  538.  
  539.               When all fields are completed press the OK pushbutton to add this 
  540.               entry to the Associated programs list box.  If you change your 
  541.               mind and don't want to perform the add, press the Cancel 
  542.               pushbutton. 
  543.  
  544.  Changing an executable program's information 
  545.            Select the extension and program in their respective list boxes and 
  546.            press the Change... pushbutton under the Associated programs list 
  547.            box.  A dialog box will present you with the current settings of the 
  548.            fields for this entry.  (See above for a description of the fields.) 
  549.            Change any fields that you wish and press the "OK" pushbutton when 
  550.            you are satisfied with your changes.  If you change your mind and 
  551.            don't want to save the changes you have made, press the Cancel 
  552.            pushbutton, any changes you have made are discarded. 
  553.  
  554.  Copying an associated program 
  555.            To copy  an Associated programs entry select the entry you wish to 
  556.            copy in the Associated programs list box and press the Copy... 
  557.            pushbutton.  You are presented a dialog box which allows you to 
  558.            choose which file extension you wish to copy the entry to.  Select 
  559.            the file extension and press the OK pushbutton.  The entry is added 
  560.            to the list of associated programs for the extension you selected. 
  561.            If you change your mind and don't want to perform the copy operation 
  562.            press the Cancel pushbutton. A fast way to add multiple entries for 
  563.            an extension is to add the first and then copy the first as many 
  564.            times as you wish and then change the copied entries. 
  565.  
  566.  Deleting an associated program 
  567.            Select the extension and program in their respective list boxes and 
  568.            press the Delete... pushbutton under the Associated programs 
  569.            listbox.  You are prompted to confirm that you really want to 
  570.            perform the deletion, press the Yes pushbuton to perform the 
  571.            deletion or No pushbutton to cancel the delete operation. 
  572.  
  573.  When you complete your modifications to the File Extension Association dialog 
  574.  box you have two choices: 
  575.  
  576.  Press the OK pushbutton to permanently save the changes to the configuration 
  577.  file. 
  578.  
  579.     OR 
  580.  
  581.  Press the Cancel pushbutton which does not perform a save to the configuration 
  582.  file, the changes you have made are retained until you change them again or 
  583.  exit the editor.  You can go back at a later time and permanently save them by 
  584.  selecting the OK pushbutton. 
  585.  
  586.  
  587. ΓòÉΓòÉΓòÉ 9. Compiling and Jump to Error ΓòÉΓòÉΓòÉ
  588.  
  589. When you invoke the "CompileCurrentBuffer" command, either from the "File" 
  590. pulldown ("Compile..." option) or via a keystroke association one of three 
  591. things will occur. 
  592.  
  593.   1. If the file extension for the current buffer (file) is not found in the 
  594.      file extension associations data you recieve a popup message telling you 
  595.      that no association exists. 
  596.  
  597.   2. If only one association exists for this extension RSE immediately executes 
  598.      the associated executable. 
  599.  
  600.   3. If more than one association exists RSE presents a dialog box from which 
  601.      you may select which executable association you want to execute.  The 
  602.      dialog box shows the "Program title" which you entered in the 
  603.      "Associate..." dialog box.  Select the title you wish to execute and press 
  604.      the "Execute" pushbutton.  Press the "Cancel" pushbutton if you change 
  605.      your mind and don't want to execute any of the selections. 
  606.  
  607.  When RSE invokes an executable the following actions are performed: 
  608.  
  609.  o If the current buffer has been modified, it is written to disk. 
  610.  
  611.  o A temporary buffer and a window for this buffer is created, if one does not 
  612.    already exist, for output from the executing program. The window's  title is 
  613.    a concatenation of the "Program title" and the full path and filename of the 
  614.    current buffer. 
  615.  
  616.    Note:  stdout and stderr are both redirected to this window. 
  617.  
  618.  o Associates the temporary buffer with the current buffer. 
  619.  
  620.  o Locks the current buffer and the temporary buffer so that they can not be 
  621.    deleted until the program completes execution.  You can delete the windows 
  622.    but not the buffers. 
  623.  
  624.  o Creates a thread which executes the program and redirects its output to the 
  625.    temporary buffer.  The program is exec'd asynchronously to RSE. 
  626.  
  627.  o Creates a thread which waits for the completion of the executing program. 
  628.  
  629.  While the program is executing, its output to stdout and stderr is redirected 
  630.  to the temporary buffer (and displayed in the window attached to this buffer, 
  631.  if any) as the program executes so you can monitor the progress of the 
  632.  executing program. 
  633.  
  634.  When the program completes execution the following actions occur: 
  635.  
  636.  o A popup message notifies you of the completion and if the program returned 
  637.    with a non-zero result code. 
  638.  
  639.  o The temporary buffer and the buffer associated with the temporary buffer are 
  640.    unlocked.  You may now delete these buffers if you wish. 
  641.  
  642.  o You may invoke multiple concurrent program executions, but each must be on 
  643.    an unlocked buffer (ie. you can not start two executions on the same buffer, 
  644.    you must wait until the first completes before starting another). If you 
  645.    attempt to do so you will receive a message telling you the buffer is locked 
  646.    by a process. 
  647.  
  648.  JUMP TO ERROR 
  649.  
  650.  RSE supports jumping to errors for programs which format their error messages 
  651.  in the same way as the Microsoft C Compiler, ie. 
  652.  
  653.   pathname(error line) : text {error}|{warning}
  654.  In the following discussion error line includes lines containing warning 
  655.  messages as well as errors. 
  656.  
  657.  Jump to error processing is performed by the "NextError" and "PrevError" 
  658.  commands.  When you invoke these commands (default key assignments are CTRL+N 
  659.  for NextError and CTRL+P for PrevError) four actions are possible: 
  660.  
  661.   1. No temporary file is associated with the current buffer - the command is 
  662.      ignored. 
  663.  
  664.   2. The end (for NextError) or beginning (for PrevError) of the temporary file 
  665.      has been reached - no action is taken.  A subsequent invocation will 
  666.      reposition to the beginning or end of file and display the first or last 
  667.      error message (ie. treats the temporary buffer as a cicular list ). 
  668.  
  669.   3. An error line is found and the error is in the current buffer - you are 
  670.      positioned to the line specified in the error message and a popup message 
  671.      box containing the contents of the error line message is displayed. 
  672.  
  673.   4. An error line is found but the file is not the current buffer's: 
  674.  
  675.      a. If the file is currently loaded in the editor a popup message box asks 
  676.         you if you want to jump to the line in error in the other file. 
  677.  
  678.      b. If the file is not currently loaded a popup message box asks you if you 
  679.         want to have the file loaded and then jump to the error in that file. 
  680.         The message box displays the file which will be jumped to/loaded if you 
  681.         press the "Yes" pushbutton. 
  682.  
  683.         If you don't want to see the error in the other file press the "No" 
  684.         pushbutton. 
  685.  
  686.         This makes it possible to step thru errors generated by a MAKE of 
  687.         multiple source files, but the current window must be the buffer with 
  688.         which the temporary (error) buffer is associated for the 
  689.         NextError/PrevError command to work. 
  690.  
  691.  
  692. ΓòÉΓòÉΓòÉ 10. Commands Assignable to Keys ΓòÉΓòÉΓòÉ
  693.  
  694. The following commands can be assigned to key combinations to customize a 
  695. keyboard for the editor. 
  696.  
  697.  SelfInsert Insert/Overtype the ascii value of the key 
  698.  
  699.  NewLine   Insert a carriage return or moves to beginning of next line 
  700.  
  701.            Note:  SelfInsert and NewLine are affected by the state of 
  702.            Insert/Overtype mode 
  703.  
  704.  DeleteChar Delete char at cursor 
  705.  
  706.  DeleteCharLeft Delete char to left of cursor (no wrap back to prev line) 
  707.  
  708.  DeleteLine Delete line cursor is on 
  709.  
  710.  DeleteLineEnd Delete from cursor to end of line 
  711.  
  712.  Left      Cursor left  (no wrap back to prev line) 
  713.  
  714.  Right     Cursor right 
  715.  
  716.  Up        Cursor up 
  717.  
  718.  Down      Cursor down 
  719.  
  720.  PageDown  Cursor down number of lines in window - 1 
  721.  
  722.  PageUp    Cursor up  number of lines in window - 1 
  723.  
  724.  Home      Triple action (LineStart/TopOfWindow/TopOfBuffer) 
  725.  
  726.  End       Triple action (LineEnd/EndOfWindow/EndOfBuffer) 
  727.  
  728.  LineStart Move cursor to start of line 
  729.  
  730.  LineEnd   Move cursor to end of line 
  731.  
  732.  WordLeft  Move cursor to beginning of previous word or number 
  733.  
  734.  WordRight Move cursor to beginning of next word or number 
  735.  
  736.  TopOfWindow Move cursor to beginning of top line in window 
  737.  
  738.  EndOfWindow Move cursor to end of last line in window 
  739.  
  740.  TopOfBuffer Move cursor to start of buffer 
  741.  
  742.  EndOfBuffer Move cursor to end of buffer 
  743.  
  744.  ScrollUp  Scroll contents of window up 
  745.  
  746.  ScrollDown Scroll contents of window down 
  747.  
  748.  GotoLine  Prompts for line to jump to (+ and - for relative jump) 
  749.  
  750.  Undo      Back out last cursor movement or editing change 
  751.  
  752.  Redo      Put back what was just undone 
  753.  
  754.  MarkBlock Toggles block marking 
  755.  
  756.  MarkLine  Toggles line marking 
  757.  
  758.  MarkColumn Toggles column marking 
  759.  
  760.            Note:  If another marking mode is selected the above will change the 
  761.            mark type to that which the command specifies. 
  762.  
  763.  CutClipboard Copy to clipboard then delete selected text 
  764.  
  765.  CopyClipboard Copy selected text to clipboard 
  766.  
  767.  PasteClipboard Insert contents of clipboard at cursor position 
  768.  
  769.  DeleteBlock Delete selected text 
  770.  
  771.  WriteCurrentBuffer Save buffer to disk 
  772.  
  773.  WriteMarkedRegion Save selected text to disk 
  774.  
  775.  Write     Save buffer or selected text to disk 
  776.  
  777.            Note:  Write combines the action of WriteCurrentBuffer and 
  778.            WriteMarked region. If text is selected (marked) you receive a 
  779.            dialog box to give the path and file name to which the selected text 
  780.            should be written. If no text is selected the entire buffer is 
  781.            written to disk if the buffer has been modified. 
  782.  
  783.  DeleteCurrentBuffer Deletes the current buffer, if it has unsaved changes you 
  784.            are given the opportunity to save before deleting, delete without 
  785.            saving or cancel the request. 
  786.  
  787.  ExitEditor Exits the editor. If unsaved buffers exist you recieve a dialog box 
  788.            giving you the opportunity to save all, selected, or none of the 
  789.            unsaved buffers, exit without saving, or cancel the request. 
  790.  
  791.  SaveAllAndExit Saves any unsaved buffers and exits the editor 
  792.  
  793.  NewFile   Creates an UNTITLED buffer 
  794.  
  795.  OpenFile  Presents a dialog for you to select the file you wish to load into 
  796.            buffers. 
  797.  
  798.  ReadFile  Presents a dialog box  for you to select a file to be read into the 
  799.            current buffer at the current cursor position. 
  800.  
  801.  RenameBuffer (Save as) allows you to change the path and file name of a load 
  802.            buffer. The buffer is then written to disk. 
  803.  
  804.  NextBuffer Brings next buffer in the buffer list into the current window. 
  805.  
  806.  PrevBuffer Brings the previous buffer in the buffer list into the current 
  807.            window. 
  808.  
  809.  Print     Print the selected text or if no text is selected the entire buffer. 
  810.  
  811.  CompileCurrentBuffer Invokes an executable which has been associated with the 
  812.            extension of the buffer's file name. If more than one association 
  813.            exists you are presented a dialog box from which to select the 
  814.            program you wish to run.  Stdout and stderr are redirected to a 
  815.            temporary buffer which is created for you.  Undo/redo information is 
  816.            not retained for the temporary buffer and the temporary buffer can 
  817.            not be saved to disk or renamed. 
  818.  
  819.  NextError If a temporary buffer is associated with the  current buffer 
  820.            searches forward  for an error/warning message conforming to the 
  821.            Microsoft 'C' compiler's error format. If a line is found a popup 
  822.            message displays the error/warning line and jumps to the line in 
  823.            error. If the error is located in a different file you will be 
  824.            notified. If the file is not loaded it will load the file and then 
  825.            jump to the line in error or if the file is loaded you can jump to 
  826.            the line in error. 
  827.  
  828.  PrevError If a temporary buffer is associated with the  current buffer 
  829.            searches backward for an error/warning message conforming to the 
  830.            Microsoft 'C' compiler's error format. If a line is found a popup 
  831.            message displays the error/warning line and jumps to the line in 
  832.            error. 
  833.  
  834.  TileWindows Uses the current tiling orientation to tile all windows which are 
  835.            not minimized. 
  836.  
  837.  TileAcross Tile windows giving preference to window sizing wider than they are 
  838.            high. 
  839.  
  840.  TileDown  Tile windows giving preference to window sizing taller than wide. 
  841.  
  842.  ToggleKeepTiled Toggle whether windows should be kept tiled when the main 
  843.            window is sized or windows are created or deleted. When the toglle 
  844.            goes from off to on the windows are tiled. 
  845.  
  846.  CascadeWindows Arrange all non-minimized windows so that they overlap. 
  847.  
  848.  ToggleKeepCascaded Toggle whether windows should be kept cascaded when the 
  849.            main window is sized or windows are created or deleted. When the 
  850.            toglle goes from off to on the windows are cascaded. 
  851.  
  852.  NextWindow Make next window in the window list the current 
  853.            (active) window. 
  854.  
  855.  PrevWindow Make the previous window in the window list the current (active) 
  856.            window. 
  857.  
  858.  DuplicateWindow Make a copy of the current window. The window overlays the 
  859.            current window and displays the same buffer.  If KeepTiled or 
  860.            KeepCascaded is on then all windows are resized and positioned. 
  861.  
  862.  DeleteCurrentWindow Deletes the current window. The buffer that was attached 
  863.            to the window is not deleted. 
  864.  
  865.  DeleteWindowAndBuffer Deletes the current window and the buffer displayed in 
  866.            the current window. Any other windows attached to this buffer will 
  867.            have the next buffer in the buffer list attached to them. 
  868.  
  869.  ToggleRecordMacro Toggles keystroke macro recording. If toggling to on, a 
  870.            dialog box prompts for the name of the file to which to save the 
  871.            macro. 
  872.  
  873.  PlayMacro Presents a dialog box prompting for the file name of the macro you 
  874.            wish to play. 
  875.  
  876.  PlayMacroAgain Plays the last recorded macro, or the last macro that was 
  877.            played again. 
  878.  
  879.  SearchForward Presents a dialog box prompting for the search expression. You 
  880.            may also change the state of the Ignore regular expression and 
  881.            Ignore case flags. Searches forward from the current cursor 
  882.            position. 
  883.  
  884.  SearchBackward Presents a dialog box prompting for the search expression. You 
  885.            may also change the state of the Ignore regular expression and 
  886.            Ignore case flags. Searches backward from the current cursor 
  887.            position. 
  888.  
  889.  SearchAgain Uses last search expression and search direction to search. 
  890.            Searches from one character position away from the current cursor 
  891.            position. 
  892.  
  893.  ReplaceForward Presents a dialog box prompting for the search expression and 
  894.            replace expression. You may also change the state of the Ignore 
  895.            regular expression and Ignore case flags. Searches forward from the 
  896.            current cursor position. 
  897.  
  898.  ReplaceBackward Presents a dialog box prompting for the search expression and 
  899.            replace expression. You may also change the state of the Ignore 
  900.            regular expression and Ignore case flags. Searches backward from the 
  901.            current cursor position. 
  902.  
  903.  ReplaceAgain Uses last search and replace expressions and search direction to 
  904.            search. Searches from one character position away from the current 
  905.            cursor position. 
  906.  
  907.  ToggleInsert Toggles insert/overtype mode. 
  908.  
  909.  ToggleTabs Toggles whether to use tab characters or an appropriate number of 
  910.            spaces when the tab character is inserted into the text. 
  911.  
  912.  ToggleBackups Toggles whether backup files will be created when you save a 
  913.            buffer to disk. 
  914.  
  915.  ConfigGlobals Presents the Editor Configuration dialog box. 
  916.  
  917.  ConfigFonts Presents the Font Selection dialog box. 
  918.  
  919.  ConfigColors Presents the Color Selection dialog box. 
  920.  
  921.  ConfigCursors Presents the Cursor Settings dialog box. 
  922.  
  923.  ConfigAssoc Presents the File Extension Association dialog box 
  924.  
  925.  HelpForHelp Invokes help system for help on using help 
  926.  
  927.  HelpExtended Displays extended help for item if available 
  928.  
  929.  HelpKeys  Displays keys help 
  930.  
  931.  HelpIndex Displays the help index 
  932.  
  933.  AboutEditor Displays the About RimSTAR Editor dialog box 
  934.  
  935.  InvalidKey Beeps when key is pressed. 
  936.  
  937.  
  938. ΓòÉΓòÉΓòÉ 11. The Help Action Bar Choice ΓòÉΓòÉΓòÉ
  939.  
  940. The Help choice on the action bar allows you to get help on the  following 
  941. items: 
  942.  
  943.  Help for help 
  944.            Help on how to use the Help system. 
  945.  
  946.  Extended help 
  947.            Displays extended help (if it is available) for a topic. 
  948.  
  949.  Keys help 
  950.            Gives help on editor functions and key assignments 
  951.  
  952.  Help index 
  953.            Presents an index of help entries for the editor 
  954.  
  955.  
  956. ΓòÉΓòÉΓòÉ 12. Help for Help index ΓòÉΓòÉΓòÉ
  957.  
  958. Select Help index on the Help pull-down to see the help index for the RimSTAR 
  959. PM Editor. 
  960.  
  961.  
  962. ΓòÉΓòÉΓòÉ 13. Help for Keys help ΓòÉΓòÉΓòÉ
  963.  
  964. Select Keys help on the Help pull-down for help on the keys you use to perform 
  965. a specific task. 
  966.  
  967. When you select this item, you are presented a list of key groups.  Double 
  968. click on one of the groups to see the keys you use to perform the task.