home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / forth / compiler / fpc / doc / chapter5.txt < prev    next >
Text File  |  1989-10-29  |  32KB  |  691 lines

  1. CHAPTER 5.   SED, THE EDITOR
  2.  
  3.  
  4.  
  5.  
  6. SED is a sequential file text editor implemented in F-PC by Tom Zimmer.
  7. It is an extremely powerful text editor optimized for user convenience
  8. and to support the F-PC programming environment.  The editor is somewhat
  9. WordStar compatible using the WordStar "Star" for cursor movement.  The
  10. keypad is also fully supported. Search, replace, and global replace are
  11. provided, along with copy and paste of lines within a file as well as
  12. between files.  There are many other interesting features like hypertext
  13. help system, character graphics, line alignment, paragraph sorting, and
  14. keystroke macros.
  15.  
  16. SED was developed to provide an easy way to create and modify source and
  17. documentation files for building applications in F-PC.  You can return
  18. the editor from F-PC and return to F-PC with very few key strokes so that
  19. programs can be modified and tested quickly.  It has the convenience of
  20. the block based F83 source loading mechanism, but is not limited by the
  21. small block size.  SED uses the standard sequential text file format
  22. common to most DOS editors and word processors.  It can read files
  23. generated by other word processors.  It generates text files which can be
  24. used by most word processors.
  25.  
  26. SED allocates as much memory as needed to store text file in RAM.  The
  27. file is edited in RAM and saved back to disk when returning to F-PC.  The
  28. maximum file size is limited only by available memory, 120K in a 640K
  29. bytes machine or 64K in an 512K byte machine.  It can also be used for
  30. simple note or letter writing.  It provides word wrap, paragraph
  31. reformat, with margin control and simple printer control for boldface and
  32. underline.  Its formatted printer output is suitable for professional
  33. program listing as it contains well laidout headers and footers.
  34.  
  35. SED provides pull-down menus for ease of operation, with on-line help for
  36. most functions. Press ESC to pop up the menu bar, then type the first
  37. letter of the menu name to see the menu. Press the first capitalized
  38. letter of a menu item to pick that item, or use the arrow keys to step
  39. over and down to the desired function and press <return>.  Press ESC
  40. again to clear the menu bar if you don't want to perform a command.  Many
  41. menu selections also have shortcut keystrokes which can be invoked
  42. quickly without going through the menus.
  43.  
  44. The on-line hypertext help is brought to the screen by pressing F1, after
  45. which you can use the arrow keys, PgUp, PgDn, and the TAB keys to select
  46. a highlighted title of a topic, and link to that topic using F9 or
  47. <return>.  All the SED utilities are linked as topics and can be accessed
  48. easily.
  49.  
  50.  
  51. SED SPECIFICATIONS
  52.  
  53.                                       640 KB System       512 KB System
  54.  
  55.    Maximum Characters in a File       120K                64K
  56.    Maximum Lines in a File            8000 lines          6000 lines
  57.  
  58.    Maximum # of Deleted Lines Saved   100 lines           20 lines
  59.                                       (48K buf)           (<48K Buf)
  60.  
  61.    Maximum Characters in a Line       132
  62.    Screen display Format              23 lines of 79 characters
  63.    Printed # of Lines on a Page       55
  64.  
  65.  
  66. 5.1.    INVOKING SED EDITOR
  67.  
  68.  
  69. There are several ways to start editing a file in SED.  Perhaps the
  70. easiest to get started with is NEWFILE. It is used as follows:
  71.  
  72.         NEWFILE <filespec> <return>
  73.  
  74. NEWFILE will look to see if <filespec> is an existing file.  If the file
  75. already exists, then it will be opened and SED will begin to edit that
  76. file. If the file does NOT exist, then it will be created and SED will
  77. start editing the new file. When the edit is complete, changes are saved,
  78. the file is closed and re-opened, and remains open when you return to the
  79. Forth command level. If you type NEWFILE without specifying a <filespec>,
  80. then you will be prompted for a file to edit. If you then simply press
  81. <return> without giving a <filespec>, no edit will be performed.
  82.  
  83. Other ways to start the editor require that a file be open before
  84. starting an edit. Ways to open a file are:
  85.         FILE <filespec> <return>
  86.         OPEN <filespec> <return>  Alias for FILE FL <filespec> <return>
  87.         Alias for FILE
  88.  
  89. If you return one of the above words without giving a <filespec>, you
  90. will see a popup file selection window from which you can pick an
  91. existing file to open. Once a file is open, you can start editing with
  92. one of the following words:
  93.  
  94.         ED <return>
  95.         ED <wordname> <return>
  96.         <linenumber>    EDIT <return>
  97.  
  98. If you are just starting to edit a file, ED will begin editing at line
  99. one. After editing  a file, if you re- return with ED, you will return to
  100. the line where you were when you left the editor. If ED is followed by a
  101. word name, the source file where the word was defined will be opened, and
  102. the word definitions is displayed for editing.  This way you don't have
  103. to remember where the word was defined.  EDIT will start editing the
  104. current file at the line number specified.
  105.  
  106. A very fancy file selection mechanism has been added in F-PC.  If you
  107. type in a file open word, and you press <return> without returning a
  108. filename, a window display will popup allowing you to select a file from
  109. the directory.  You can use the Up/Down cursor keys and PgUp/PgDn keys to
  110. select a file for editing. You can also press a letter key to step
  111. through the files starting with the letter you press.
  112.  
  113. If you are in a sub-directory and the filespec string is set to *.* when
  114. the window appears, then a file named "." and a file named ".." will
  115. appear at the top of the file list.  These files, along with any
  116. directories below the current directory, will display a graphic
  117. "infinity" symbol "░" to the right of the filename.  If you press
  118. <return> while positioned on the "." name you will select the root
  119. directory.  The ".." name will pop up one level of directory, and any
  120. other name with the "infinity" symbol next to it will step you down one
  121. level to that directory.  You can move between files in the window, with
  122. the keypad arrow keys, and select a file by pressing <return>.  Escape
  123. can be used to abort file selection.
  124.  
  125. The path and the current drive is displayed in a window to the lower
  126. right.  The path can be changed by pressing the "\" key, then editing the
  127. new path followed by the return key.
  128.  
  129. When you want to edit a word which was already compiled into the
  130. dictionary, you can simply type:
  131.  
  132.         VIEW <wordname> <return>
  133.         BROWSE <wordname> <return>
  134.  
  135. VIEW, V, and B are all aliases of BROWSE which opens the file which
  136. contains the definition of the word, enters SED,  and displays its source
  137. definition.
  138.  
  139. When you select the AUTOEDITON option in your configuration file, SED
  140. will be invoked when there is an error in loading or compiling a file.
  141. SED will display the text containing the source text where error
  142. occurred.  The editing cursor will point to the word following the word
  143. which caused the error.  This auto-editing mode is very convenient in
  144. writing and testing programs.  It can be turned off by executing
  145. AUTOEDITOFF.
  146.  
  147.  
  148. 5.2.    USING SED
  149.  
  150.  
  151. SED shows 23 lines of text in a window surrounded by a frame of single
  152. line.  The top line of the display frame shows the current edit status,
  153. starting with INSERT/OVERWRITE status, which is also shown in reverse
  154. video for insert mode.  The current line and column number are then
  155. displayed, followed by the page number, total lines in file and total
  156. characters in file.  The directory path and the name of the current file
  157. being edited appear at the bottom of the screen.  The editing cursor is
  158. placed at the top left corner of the window if the file was just opened.
  159. Otherwise, the cursor will be put at the position you last left the
  160. editor, or where a compilation error occurred.
  161.  
  162. Text is entered into the file by typing on the keyboard.  In the INSERT
  163. mode, existing text is pushed to the right.  In the OVERTYPE mode,
  164. existing text is overwritten by the new text.  The INS key toggles
  165. between the INSERT and the OVERTYPE modes.  DEL key deletes the character
  166. under the cursor.  The BackSpace key deletes the character to the left of
  167. the cursor.  The arrow keys in the keypad allow you to position the
  168. cursor anywhere in the window to enter new text. Pushing the <enter> or
  169. <return> key starts a new line.
  170.  
  171. When the cursor is moved next to an edge of the window, text beyond the
  172. window boarder, if there is any, will be scrolled into the window.  PgUp
  173. key will scroll the file down to display the previous page of the file,
  174. and PgDn does the opposite.  HOME key moves the cursor to the beginning
  175. of a line and END key moves it to the end of a line.  The use of these
  176. keys in the keypad is intuitive and very easy to get used to.
  177.  
  178. Pressing F1 function key will invoke the hypertext help system, showing
  179. various features of F-PC and editing functions in SED.  Hypertext topics
  180. are highlighted in reversed video.  You can select a topic by moving the
  181. cursor over the name of the topic, using the arrow keys, TAB, and Shift-
  182. TAB.  TAB jumps from one topic word to the next.  Shift-TAB jumps to the
  183. previous topic word. Press F9 or <return> links to the selected topic and
  184. displays the text of this topic.  You can select another topic and press
  185. F9 to investigate even deeper.  F10 allows you to unlink one level and
  186. float up to the prior topic.  Press F10 repeatedly will lead you back to
  187. SED to continuing editing work.
  188.  
  189. SED is designed to use WordStar control keys to move the cursor.
  190. However, on an IBM-PC, it is most convenient to use the cursor keys in
  191. the keypad to position the cursor and then insert new text or type over
  192. old text.  It is very easy to master this editor without much effort.
  193. The F1 help system and the menu bar are always ready for consultation.
  194. For more sophisticated operations, refer to the following sections for
  195. detailed descriptions on all the control/alternate/shift/function key
  196. functions.
  197.  
  198. Pressing ESC key leads you into a menu help system.  The top status line
  199. is replaced by a menu bar, somewhat resembling that in a Macintosh.  One
  200. of the menu items is highlighted.  You can select other menu items by
  201. pushing the left or right arrow key.  Pushing the <return> key or down
  202. arrow selects the menu and its items are pulled down under. The first
  203. menu item is highlighted. Pushing up and down arrows followed by <return>
  204. selects the highlighted menu option and performs the function.  Each menu
  205. option has a title with a single capitalized character  on the left, and
  206. possibly a alt-ctrl-shift-function key specification to the right.  When
  207. the menu is visible, you can type the capitalized character to execute
  208. the corresponding function.  When you are in editing mode, the
  209. alt-ctrl-shift-function key can be used to invoke the function without
  210. having to step through the menu bar.
  211.  
  212. Pushing ESC-Q-S or F10 terminates the editing session and returns to
  213. F-PC, after saving the modified text to disk. A backup copy with .BAK
  214. extension is saved of the previous edit. This automatic file backup
  215. feature can be selected as an configuration option BACKUPON when you
  216. install F-PC.  Unless you are operating F-PC from a floppy disk drive, it
  217. is always recommended that you choose this option.  In using the block
  218. file system in F83, you might lose four blocks of recently edited text if
  219. you crash the system.  With that experience, you will appreciate this
  220. file backup feature.  However, if you definitely do not want to save the
  221. newly edited file, type ESC-Q- D or Alt F10 to exit without changing the
  222. original file.
  223.  
  224. SED is intuitive, very friendly, and convenient.  Using the keypad you
  225. can accomplish 90% of the text selection functions.  Only rarely do you
  226. have to consult the help texts for advanced features, which are only one
  227. F1 stroke away.  The menu help system brings help functions even closer
  228. to you.
  229.  
  230.  
  231. 5.3.    MENU & MOUSE CONTROL
  232.  
  233.  
  234. SED uses Pull Down menus with fairly complete mouse support to make many
  235. functions available while editing. Press the ESC key and the menubar
  236. appears at the top of the screen.
  237.  
  238. If you have pressed the ESC key, then you are looking at a list of menu
  239. titles starting with "File" which should be shown in reverse video,
  240. through  "Help" on the right:
  241.  
  242.         File    Edit    Select  Layout  hYper   Advanced   Help
  243.  
  244. Use the keypad right arrow key to walk along the menubar. As you press
  245. right arrow, the highlighting moves along the menubar.  Continue to press
  246. right arrow until "File" is again the highlighted menu.  Press the down
  247. arrow key to pull the menu down.  Notice the last two items of the
  248. "File" menu, Exit and Quit.  To the right of these menu items, are
  249. displayed the short cut keys F10 and Alt-F10. Any menu function can be
  250. performed with the short cut key rather than moving through the menu and
  251. pressing Return.  If you press right arrow while the "File" menu is
  252. pulled down, you will walk along the menu bar with each menu "open", so
  253. you can  see what menu items are available.  You can also press the first
  254. capitalized letter of a menu item to perform the function.
  255.  
  256. The menu selection by keystroke sequence is thus:
  257.  
  258.         ESC  <menu-select-key>  <function-select-key>
  259.  
  260. Pressing ESC instead of the <menu-select-key> or <function-select-key>
  261. aborts the menu key sequence, and you will return to the main editor
  262. window.
  263.  
  264. To use a mouse in SED you must have a compatible mouse driver (like
  265. MOUSE.COM) already installed in your AUTOEXEC.BAT. When F-PC starts up,
  266. it looks for the presence of a mouse driver, and activates the mouse if
  267. the driver is present.
  268.  
  269. As you are looking at the editor screen you will see arrows to the right
  270. and lower right of the screen. These arrows can be used to scroll the
  271. screen, showing more text from the direction the arrow is pointing by
  272. clicking the left mouse button. The F10 or +1 etc. in the upper right
  273. corner can be used like the F10 key by positioning the moue and clicking
  274. the left button. You can also change the INSERT/OVERWRITE mode by
  275. clicking at the top left of the screen on INSERT. Help can be obtained by
  276. pressing HELP at the lower left. The cursor can be positioned by clicking
  277. within the edit window with the left mouse button.  The right mouse
  278. button is the same as the ESC key.
  279.  
  280.  
  281. 5.4.    FUNCTION KEYS
  282.  
  283.  
  284. SED supports a subset of the WordStar control keys used to move the
  285. editing cursor around in a document.  The keypad is also supported, as
  286. can be seen in the following diagrams.  The functions of various keys are
  287. annotated in the diagrams.  More elaborate descriptions are presented in
  288. the next few sections.  The cursor movement keys, Control
  289. A,S,D,F,E,X,C,R,W and Z have been maintained, as have the delete keys
  290. Control G,T,Y, and Del.
  291.  
  292.  
  293. CONTROL KEYS
  294.  
  295.  
  296.                                                        
  297.  
  298.  
  299.  
  300.  
  301. KEYPAD KEYS
  302.  
  303.  
  304.                                                          
  305.  
  306.  
  307.  
  308.  
  309. FUNCTION KEY ASSIGNMENTS
  310.  
  311.  
  312.  
  313.                                                        
  314.  
  315.  
  316.  
  317. 5.5.    SELECTING ANOTHER FILE TO EDIT
  318.  
  319.  
  320. Ctrl-O allows you to open or create a file.  When you are being asked to
  321. return a new filename, if you press <return> without returning a
  322. filename, a window will pop up allowing you to select a file from the
  323. directory.
  324.  
  325. If you are in a sub-directory when the window appears, then a file named
  326. "." and a file named ".." will appear at the top of the file list.  These
  327. files, along with any directories below the current directory, will
  328. display a graphic "infinity" symbol "░" to the right of the filename.  If
  329. you press <return> while positioned on the "." name you will select the
  330. root directory.  The ".." name will pop up one level of directory, and
  331. any other name with the "infinity" symbol next to it will step you down
  332. one level to that directory.  You can move between files in the list,
  333. with the keypad arrow keys, and select a file by pressing <return>.  ESC
  334. can be used to abort file selection.
  335.  
  336. While in the pop up file selection mode, you can also set the current
  337. drive by pressing a letter key between A and G.  This drive must exist
  338. and have a disk in it, or a system error will result.  The path and the
  339. current drive is displayed in the lower right.  The path can be changed
  340. by pressing the "\" key, then typing the new path followed by the return
  341. key.
  342.  
  343. Ctrl-U saves the current contents in the editor buffer to the file and
  344. continues on with editing.  Alt- W allows you to write the contents to a
  345. different file.  F-10 will save and close the current file. However, a
  346. message will be displayed on the screen asking you to type in a new file
  347. name to continue the editing.  If you press ESC, editing will terminate
  348. and you will return to F-PC.  This extra level of prompting given you
  349. better control over the editing process.  Alt-F10 will discard the
  350. changes and leaves the file unmodified.  SED will prompt you for another
  351. file before returning to F-PC.
  352.  
  353.  
  354. FILE SELECTION
  355.  
  356.         Alt-O           Save changes and continue
  357.         Ctrl-O          Open or create a file for editing.
  358.         Ctrl-U          Save changes and continue editing.
  359.         Alt-W           Write the file in memory to a new file
  360.         Alt-F1          Rotate to the next file opened.
  361.         Shift-Alt-F1    Rotate to the previous file.
  362.         F10             Save changes and leave SED, with a prompt
  363.         Alt-F10         Discard changes and leave SED, with a prompt
  364.  
  365. Through the File Open command  Ctrl-O you can open up to 20  files while
  366. in the F-PC editor. When you open more than one file F-PC  keeps track of
  367. where you were in each file, but only really edits one file at a time.
  368. Files get swapped in and out of memory as required. This is  slower than
  369. keeping all of the file in memory, but on a hard disk system the
  370. performance is still acceptable. Alt-F1 can be used to rotate through the
  371. file that have been opened. Its reverse command is Shift-Alt-F1 which
  372. will rotate through the open files in the opposite direction.  Shift- F1
  373. will popup a window for you to select a particular file directly,
  374. avoiding the time required to rotate through several files to  get to the
  375. one you want.
  376.  
  377. To leave the editor, and close all files, use the File menu command
  378. ESC-F-X.
  379.  
  380. The F10 key "unlinks" or leaves one edit/browse level. If you were
  381. editing, your changes are saved, and you will return to the previous file
  382. you were editing or browsing. If you were at the first level of editing,
  383. F10 will leave the editor.
  384.  
  385. The Shift-F10 key will take you to edit/browse level one.  This saves you
  386. from having to unlink through many levels with F10, and takes you
  387. directly  to level one.  If you were already on level one, Shift-F10 will
  388. leave the  editor.
  389.  
  390. If you are using a mouse, clicking the left mouse button on the F10, +1
  391. or +2 at the upper right hand corner will do the same as pressing the F10
  392. key.
  393.  
  394.  
  395. 5.6.    SEARCH AND REPLACE
  396.  
  397.  
  398. You can look for any sequence of characters in SED with the Search-F6
  399. key.  When F6 is pressed, you are asked to return a text string to look
  400. for.  SED will look for that string of characters when you press
  401. <return>.  When SED searches for text, it ignores the case of the
  402. letters.  If you want SED to look at the case of the text it searches,
  403. hold down SHIFT while pressing <return>.  This search is much faster.  To
  404. search for another occurrence of the same text string, press Alt-F6 (or
  405. SHIFT Alt-F6 if you want only an exact match).  See also the earlier
  406. section on Replacing Text.
  407.  
  408. Having already done a search using F6 above, you can also search
  409. backwards with Shift-F6, which searches backwards from the cursor with a
  410. case sensitive search.
  411.  
  412. After a Search has been done, you can replace the text found.  Press F8.
  413. You will be asked for a replacement string, which will be used to replace
  414. the found text, when return is pressed.  To search for the next
  415. occurrence of the same text, press Alt-F6, and to replace the next found
  416. occurrence with the same replacement text, press Alt-F8.
  417.  
  418. Having already performed a Search F6 and Replace F8 once, you can replace
  419. all occurrences of search text with replacement text by pressing
  420. Shift-F8.
  421.  
  422.  
  423. SEARCH AND REPLACE COMMANDS
  424.  
  425.         F6              Search the first time (prompts for text)
  426.         Alt-F6          Search for same again, case insensitive
  427.         Shift-F6        Search for same again BACKWARDS
  428.         Shift-Alt-F6    Search again, case sensitive
  429.  
  430.         F8              Replace the first time (prompts for text)
  431.         Alt-F8          Replace same again and search same again
  432.         Shift-Alt-F8    Same as Alt-F8, but case sensitive
  433.         Shift-F8        Replace All occurrences
  434.  
  435.  
  436. 5.7.    CUT, COPY AND PASTE
  437.  
  438.  
  439. SED can cut lines of text to another file.  With Alt-X, first go to the
  440. first line of text you want to cut, and press F3 mark to mark the start
  441. of the block cut.  Then move to the last line of text you want to cut,
  442. and press Alt-X.  This will cause all of the lines between and including
  443. the start and end line to be written out to the file TEMP.SEQ.  The lines
  444. will also be deleted from the current file.  To specify a different
  445. filename to cut to, press Shift-Alt-X, instead of Alt-X, and you will be
  446. prompted for a name to write to.  See also "Pasting from a File", and
  447. "Copying from a File".
  448.  
  449. SED can copy lines of text to another file.  With Alt-C, first go to the
  450. first line of text you want to copy, and press F3 mark to mark the start
  451. of the block copy.  Then move to the last line of text you want to cut,
  452. and press Alt-C.  This will cause all of the lines between and including
  453. the start and end line to be written out to the file TEMP.SEQ.  To
  454. specify a different filename to copy to, press Shift-Alt-C, instead of
  455. Alt-C and you will be prompted for a name to write to.  See also "Cutting
  456. text to a File", and "Copying from a File".
  457.  
  458. Text which has been cut with the Alt-X (cut) command to the TEMP.SEQ file
  459. can be pasted back with Alt-V, the paste command.  If you want to paste a
  460. file other than TEMP.SEQ, you can press Shift-Alt-V, and a window will
  461. pop-up for you to select a file from.  If you press ESC during the paste,
  462. or while in the file selection window, the import operation will be
  463. aborted.  See also "Cutting text to a File".
  464.  
  465.  
  466. CUT, COPY, PASTE AND APPEND WITH DISK
  467.  
  468.         F3              Mark first line of copy or cut
  469.         Alt-X           Cut from Mark through cursor line to TEMP.SEQ
  470.         Alt-C           Copy from Mark through cursor line to TEMP.SEQ
  471.         Alt-V           Paste Cut/Copied text at cursor line from TEMP.SEQ
  472.         Alt-A           Append from Mark through cursor line to TEMP.SEQ
  473.  
  474.         Alt-O-P         Paste the current date and time into text at cursor.
  475.  
  476.         Use Shift-Alt to specify the file to Cut, Copy, Paste or Append with.
  477.  
  478.  
  479. 5.8.    LINE AND WORD COMMANDS
  480.  
  481.  
  482. Lines can be deleted with Ctrl-Y, and un-deleted with Alt-Y.  Any lines
  483. which are deleted are saved in a line delete buffer which has room for 25
  484. lines.  This is also the number of lines deleted which can be un-deleted.
  485.  
  486. Lines can be copied from one place in a file to another, with the
  487. Mark-F3, and Copy Line-F5 commands.  Move to the first line of the block
  488. of text you wish to copy, and Mark the start of the copy with Mark-F3.
  489. Now move to the place where you want to copy the text to, and press Copy-
  490. F5 once for each line you want to copy.
  491.  
  492.  
  493. LINE AND WORD DELETE/UNDELETE
  494.  
  495.         Ctrl-Y          Delete this line and save in delete buffer
  496.         Alt-Y           Undelete a deleted line from the delete buffer
  497.         F5              Copy a line from Mark to cursor line
  498.  
  499.         Ctrl-N          Split this line at the cursor
  500.         Alt-N           Join this line with next line
  501.  
  502.         Ctrl-T          Word delete and save
  503.         Alt-U           Word Undelete *
  504.  
  505.  
  506. 5.9.    MARGIN CONTROL
  507.  
  508.  
  509. The left margin on the screen defaults to column zero, but when printing,
  510. defaults to 2 spaces, so it is not normally necessary to insert a left
  511. margin.  However, when TAB is pressed, the left margin on screen is
  512. expanded by 8 characters.  Any subsequent lines typed in will maintain
  513. this margin. The left margin can be set at any column position.  Move the
  514. cursor to the column where you want the left margin set and press Ctrl-L.
  515.  
  516. Alt-T sets the TAB key to tab to the current column, if you are on column
  517. 4, TABS will occur at column 4, 8, 12, 16, etc.
  518.  
  519. Alt-L moves all of the lines of a column of data to the right by a number
  520. of characters from 1 to 9. The specified number of spaces are inserted at
  521. the column of all lines from the current line until a blank line is
  522. encountered.
  523.  
  524. Shift-Alt-L moves all lines of the current paragraph left such that all
  525. leading blanks of all lines of the current paragraph from the cursor to
  526. the right are removed.
  527.  
  528.  
  529. MARGIN CONTROL COMMANDS
  530.  
  531.         Ctrl-L          Set left margin to current column.
  532.         Alt-L           Prompt for the number of spaces to insert before
  533.                         all lines of the current paragraph. Table move right.
  534.         Shift-Alt-L     Remove all space from the current paragraph to the
  535.                         right of the current cursor column. Table move left.
  536.         Alt-S-R         Prompt for value to set Right Margin.
  537.  
  538.         Alt-T           Set tab increment to current column value.
  539.         Alt-O-X         eXpand all TABs to spaces in the file in memory.
  540.         Home            Set cursor to column 0 and reset Left Margin to 0.
  541.  
  542. The left margin is also set at the new cursor position after pressing TAB
  543. when there are only spaces to the left of the cursor.  This is useful for
  544. maintaining or setting an indent while editing source.
  545.  
  546.  
  547. 5.10.   CASE CONVERSION
  548.  
  549.  
  550. To convert the case of the current character under the cursor, press
  551. Alt-O-C, the case of the letter under the cursor will be tested, and it
  552. will be converted to upper or lower case respectively. This is a toggle,
  553. and will do nothing if performed on a non letter character.
  554.  
  555. To convert the current line to upper case, press Alt-O (option), followed
  556. by U.  All upper case characters in the current line will be converted to
  557. upper case.
  558.  
  559. To convert the case of the current word starting at the cursor, press
  560. Alt-O-W, the case of the letter under the cursor will be tested, and the
  561. word will be converted to upper or lower case respectively. This is a
  562. toggle, and will do nothing if performed on a non letter character.
  563.  
  564.  
  565. CASE CONVERSIONS
  566.  
  567.         Alt-O-U      Convert the current cursor line to upper case.
  568.         Alt-O-L      Convert the current cursor line to lowercase.
  569.         Alt-O-W      Toggle case of word under cursor, starting at cursor.
  570.         Alt-O-C      Toggle case of the character under the cursor.
  571.  
  572.  
  573. 5.11.   LINE DRAWING
  574.  
  575.  
  576. SED provides this line drawing feature to implement some of the simple
  577. graphics used in the help system.  It allows you to design character
  578. graphics to draw attention from the user.  You can draw single lines and
  579. double lines with corners and branches as you move the drawing cursor
  580. around the screen.  The graphics can be save to a file and re-displayed
  581. when the file is displayed on the screen.  You will need an IBM
  582. compatible printer to print the graphics on paper.
  583.  
  584.  
  585. LINE DRAWING COMMANDS
  586.  
  587.         F7              Start/Stop drawing lines
  588.         Ins             Pen up/down command
  589.         -               Select single width lines (minus)
  590.         =               Select double width lines (equal)
  591.         Del             Clear char under cursor
  592.         Arrows          Move and draw a line
  593.  
  594.  
  595. 5.12.   PARAGRAPH SORTING
  596.  
  597.  
  598. An interesting although relatively slow function in SED is the Alt-F7 key
  599. that will sort the lines of the current paragraph starting on the cursor
  600. line and continuing until a blank line is encountered.  A paragraph is a
  601. group of lines separated from other paragraphs by one blank line. The
  602. sort starts at the current column, and tests the next 10 characters to
  603. perform the sort.  It is possible to create simple databases or phone
  604. lists, by placing different pieces if information at specific columns,
  605. and using Alt-F7 to sort according to these columns as needed.
  606.  
  607.  
  608. SORTING THE LINES OF A PARAGRAPH
  609.  
  610.         Alt-F7          Sort paragraph lines starting at current
  611.                         line and column. This sort is case sensitive.
  612.         Shift-Alt-F7    Sort paragraph non-case sensitive.
  613.  
  614.  
  615. 5.13.   KEYSTROKE MACROS
  616.  
  617.  
  618. SED does not have macros built into it, but a file is provided called
  619. MACROS.SEQ, which implements macros in Forth that can be used in SED.
  620. These macros work exactly the same as they work in ZED.  That is, you use
  621. Alt-M to start defining a macro, followed by one of the Alt-1 to Alt-5
  622. keys for the macro you are defining.  Next you return any keys you want
  623. included in the macro, and finally press Alt-M again to complete the
  624. macro definition.  To perform a macro, simply press one of the Alt-1
  625. through Alt-5 keys by it self, and the keys saved will be performed.
  626.  
  627.  
  628. MACROS
  629.  
  630.         Alt-M           Start and terminate a Macro.
  631.         Alt-1...8       User defined macros.
  632.         Alt-R           Repeat a macro.
  633.  
  634. Macros are powerful editing tools as you might want to make global
  635. changes to a file.  A macros can encapsulate many editing functions so
  636. that they can be executed repeatedly to reformat the entire file.
  637.  
  638.  
  639. 5.14.   PRINT A FILE
  640.  
  641.  
  642. While in SED editor, you can print the current file by pressing Alt-P to
  643. return into a printing selection screen.  In this screen, you can select
  644. various options such as the left margin, starting page number, and the
  645. number of copies to be printed.  After you are satisfied with the options
  646. you selected, press 'P' and the file will be printed on the printer
  647. connected to the PRN port on your PC. SED now also supports print
  648. redirection to a file.  Press S to set the file to print into.  A cursor
  649. will appear on the bottom menu line next to the message "Currently
  650. printing to".  Just type in a filename to print to.  Be sure to use a
  651. different name than the file you are editing. Press <return> to set the
  652. new file, or press ESC to cancel print redirection and revert to the PRN
  653. device.
  654.  
  655. Pages printed are formatted with a header above and a footer below.  The
  656. text line in the header is taken from the first line of text in the
  657. current file.  You can design the header by putting appropriate text in
  658. the first line of a file.  In the footer, important information about the
  659. file is printed, including the page number, the file and path names, and
  660. the date of printing.  A similar print format is used when you use FPRINT
  661. to print a file outside the editor.
  662.  
  663. You can insert special printing control features into the file so that
  664. selected text can be bold and/or with underline.
  665.  
  666.  
  667. USER DEFINED PRINT CONTROL
  668.  
  669.         %B              This line will be printed BOLD %B
  670.         %U              This line will be printed UNDERLINED %U
  671.         %B%U            This line will be both BOLD and UNDERLINED %U%B
  672.  
  673.         %1, %2 & %3     User defined printer attributes.
  674.                         See an example in the file PROPRINT.SEQ.
  675.  
  676.  
  677. 5.15.   OTHER HELP
  678.  
  679.  
  680.         Alt-G           Goto specified page/line or next/prev paragraph
  681.         Alt-B           Browse a word under the cursor.
  682.         Alt-E           Edit the source code of the word under cursor.
  683.         Alt-H           Shows help on the word under the cursor while editing.
  684.         Ctrl-<return>   Spawn a DOS shell.
  685.         F9              Link one level down,
  686.         Alt-F9          Link deferred word.
  687.         Shift-F9        Toggle Browse/Edit mode.
  688.         Alt-F3          Define source link.
  689.         Alt-F5          Define destination link.
  690.  
  691.