home *** CD-ROM | disk | FTP | other *** search
Text File | 1990-09-27 | 99.9 KB | 2,999 lines
File Window Buffer Keymap Marks search/Replace Options System Help Open Save Read Print Close Exit edit_file_key 1 write_block_key read_file_key print_buffer delete_buffer_key done Switch Restore resiZe Minimize maXimize Organize Close window toggle Borders toggle Linenumbers next_window restore_window adjust_window collapse_window expand_window organize_windows delete_window_key toggle_borders toggle_linenumbers List buffers orGanize buffers neXt Previous Output name Delete Tabs toggle Real/Virt space toggle Backups buffer_list organize_buffers next_buffer prev_buffer change_output_name delete_buffer tabs toggle_real_space toggle_file_backup Native mode emulate Vi emulate Epsilon emulate Wordstar emulate Brief emulate MS word Print bindings Function bindings insert Quoted native vi epsilon wordstar brief msword print_bindings keys insert_quoted_key Goto drop Line anchor drop columN anchor drop Inclusive anchor drop Exclusive anchor Copy to scrap cUt to scrap Paste from scrap indent Spaces indent Tabs Outdent spaces outDent tabs goto_line_key set_line_mark set_column_mark set_inclusive_mark set_exclusive_mark copy_to_scrap_key delete_to_scrap insert_scrap indent_columns index_tabs outdent_columns outdent_tabs Search Replace toggle Direction toggle regeX searching toggle Case sensitivity toggle Block searching regular expression Syntax sf_search sf_replace toggle_search_forward toggle_search_regex toggle_search_case toggle_search_block toggle Auto indent toggle Clock toggle Dialog window toggle Line drawing toggle Electric toggle Help toggle Word processing toggle Pvcs toggle_auto_indent toggle_clock toggle_dialog toggle_drawing toggle_electric help_install wp toggle_pvcs Setup Debug Compile Pvcs 43/50-lines 25-lines dos sHell dos Buffer dos Function setup debug compile_buffer pvcs_menu toggle_display 1 toggle_display 0 system dos_buffer system_key Help on help... Reference manual library open OPEN FILE ───────────────────────────────────────────────────────────── Open a file from disk and read it into a newly created buffer. This buffer will become the currently active buffer in the current window. The new file's name can be entered when the prompt ╒════════════════════════════════════╕ │ FILE:_ │ ╘════════════════════════════════════╛ is displayed. If the file has already been opened and read into a buffer, it will not be reopened; however, the buffer containing the file will become the current buffer. If for some reason the file cannot be opened, an error message will be displayed and execution will continue. Prompt history is provided for this command by using the up and down arrow keys. Directory listings and filename completion is provided when the TAB key is pressed. save SAVE FILE ───────────────────────────────────────────────────────────── Save the current buffer to the file specified by the "buffer_filename" variable. If no assignment has been made to this variable, it will contain the same name and path of the file when it was originally opened. If a block of text is currently selected, the following prompt will appear requesting the name of the file to write the block to. ╒════════════════════════════════════╕ │ Write block as:_ │ ╘════════════════════════════════════╛ The BUFFER_MODIFIED bit in "buffer_flags" will be cleared if the write is successful. read READ FILE ───────────────────────────────────────────────────────────── Read a file from disk into the current buffer at the current cursor position. The cursor position will not change; however, the character at the cursor will now appear after the block which was read. The following prompt will appear requesting a file to read when this command is executed: ╒════════════════════════════════════╕ │ File to read:_ │ ╘════════════════════════════════════╛ Prompt history is provided for this command by using the up and down arrow keys. Directory listings and filename completion are provided when the TAB key is pressed. print PRINT FILE ───────────────────────────────────────────────────────────── Print the current buffer or currently marked block to the file associated with "stdprn". Initially, "stdprn" is directed to the device attached to LPT1. The message "Printing complete." will appear when the command has completed writing the data. close CLOSE FILE ───────────────────────────────────────────────────────────── Close the file associated with the current buffer. In essence, the is the same as the delete_buffer() function described in the "LIBRARY REFERENCE MANUAL". Once the file has been closed (i.e. the buffer deleted), the previous non-system buffer in the list becomes current. exit EXIT EDITOR ───────────────────────────────────────────────────────────── Exit the editor and save the files which have been modified. If any regular buffers have been modified, a confirmation message will appear asking whether or not to save the current edit files. Example: If 3 files are being edited and 2 have been modified, the following message will appear: ╒═════════════════════════════════════════════╕ │ 2 buffers have been modified, Exit[ynw]? _ │ ╘═════════════════════════════════════════════╛ One of the following responses is required before the editor will exit: ESC - abort the operation and return to editing y - exit without saving n - return to editing w - write all modified buffers and exit switch SWITCH WINDOWS ───────────────────────────────────────────────────────────── Change the current window making another window current. The message "Select new current window" will appear. At this point, use the arrow keys () to point to the new window to become current. If no window exists in that direction, the current window will remain current. Below are a few other ways to change the current windows. 1) use SHIFT-arrow to selected a window in a specified direction 2) F10, next_window() -or- F10, prev_window() 3) Press the left mouse button when the mouse cursor is displayed in the new window to become current. restore RESTORE WINDOW ───────────────────────────────────────────────────────────── Restore the current window back to its original size. If the window is an icon, it is expanded to a normal window. If the window is expanded to a full screen window, it becomes a normal sized window. resize RESIZE WINDOW ───────────────────────────────────────────────────────────── Resize the current window using the cursor keys. The message "Select side to move" will first appear requesting an arrow key () to be pressed indicating the side of the window to resize. Once a side has been selected, use the arrow keys to move the edge of the window. When finished, press any key other than an arrow. For most windows, pressing the left mouse button with the mouse cursor positioned over the lower right corner of the window and sliding, will cause dynamic resizing of the window. Pressing ESC at any time will abort the resizing operation. minimize MINIMIZE WINDOW ───────────────────────────────────────────────────────────── Minimize the current window making it an icon. This command has no effect if the window is already minimized. The icon can then be moved by pressing the left mouse button when positioned on the icon. To expand the icon, press the right mouse button when positioned on the left edge of the icon (on the "" character). maximize MAXIMIZE WINDOW ───────────────────────────────────────────────────────────── Maximize the current window making it a full screen window. This command has no effect if the window is already maximized. organize ORGANIZE WINDOWS ───────────────────────────────────────────────────────────── Organize all of the non-system windows by making them icons and displaying them in an organized manner. The current window before the organization will become the current icon afterwards. The icon can then be moved by pressing the left mouse button when positioned on the icon. To expand the icon, press the right mouse button when positioned on the left edge of the icon (on the "" character). close window CLOSE WINDOW ───────────────────────────────────────────────────────────── Close the current window. The previous non-system window will become current. If there are no other non-system windows, the current window will not be closed. list buffers LIST BUFFERS ───────────────────────────────────────────────────────────── List all of the non-system buffers in a window. Example: ┌────────────────────────────────────────────┐ Buffer List │ ├────────────────────────────────────────────┤ │C:\BIN\READ1.ME* │ │C:\BIN\READ2.ME(RO) │ │C:\BIN\READ3.ME │ │ │ │ │ │ │ │ │ │ │ └────────────────────────────────────────────┘ Where: * - File has been modified. (RO) - The buffer is read-only (this may not reflect the status of the file). Valid Keys: - Select a new buffer. <Enter> - Make the selected buffer current. D - Delete the selected buffer. W - Write the selected buffer. R - Change the R/W status of the selected buffer. Esc - Exit the buffer list. organize buffers ORGANIZE BUFFERS ───────────────────────────────────────────────────────────── Organize the all of the non-system buffers by making them icons and displaying them in an organized manner. The current buffer before the organization will become the current icon afterwards. The icon can then be moved by pressing the left mouse button when positioned on the icon. To expand the icon, press the right mouse button when positioned on the left edge of the icon (on the "" character). next NEXT BUFFER ───────────────────────────────────────────────────────────── Make the next non-system buffer current. previous PREVIOUS BUFFER ───────────────────────────────────────────────────────────── Make the previous non-system buffer current. output name OUTPUT NAME ───────────────────────────────────────────────────────────── Change the output file name associated with the current buffer. No validation is done on this name until an attempt to write the buffer to a file has been made. delete DELETE BUFFER ───────────────────────────────────────────────────────────── Delete the current buffer. Once the current buffer has been deleted, the previous non-system buffer will become current. If no other non-system buffers exist, no buffers will be deleted. tabs TABS ───────────────────────────────────────────────────────────── Change the tabs setting for the current buffer only. The message "Enter tab stop settings: " will appear at which time the tab stop values (separated by spaces) may be entered. The values should appear in ascending order. If for some reason the values are invalid, the setting will not be changed. toggle real/virt space TOGGLE REAL/VIRTUAL SPACE ───────────────────────────────────────────────────────────── Enable or disable the access of the cursor position into virtual space. Virtual space is the space where no characters exists. This includes space past the end of a line, past the end of the buffer, and between tabs. When real-space-only is set, the cursor will not be allowed to enter virtual space. When virtual space is allowed, the cursor is free to be moved anywhere. toggle backups TOGGLE BACKUPS ───────────────────────────────────────────────────────────── Enable or disable the creation of backup files. If enabled, backup files will be created for each file when written to disk. The files will be written to the directory specified by the variable "backup_directory". Initially, "backup_directory" is set to "." (the current working directory). native mode emulate native native NATIVE SAGEEDIT KEYMAP ────────────────────── Key: ╘ with Scroll Lock off ╒ with Scroll Lock on Cursor Movement Keystroke ────────────────────────────┬──────────────── │ Beginning of buffer │ Ctrl-PgUp Beginning of line │ HOME Beginning of next line │ keypad + Beginning of previous line │ keypad - │ keypad * Bottom of window │ Ctrl-End Column left │ ╘ │ Shift Column right │ ╘ │ Shift End of buffer │ Ctrl-PgDn End of line │ End Go to bookmark or line no. │ Alt-G Line down │ ╘ Line up │ ╘ Next word │ Ctrl Page down │ PgDn Page up │ PgUp Place numbered bookmark │ Alt-<n> n ε {0..9} Previous word │ Ctrl Scroll column left │ Ctrl-L Scroll column right │ Ctrl-R Scroll line down │ Ctrl-D │ ╒ Scroll line to bottom │ Ctrl-B Scroll line to center │ Ctrl-C Scroll line to top │ Ctrl-T Scroll line up │ Ctrl-U │ ╒ Top of window │ Ctrl-Home ────────────────────────────┴──────────────── Text Editing Keystroke ────────────────────────────┬──────────────── │ Delete character at cursor │ Del Delete character left │ BKSP Delete line or lines │ Shift-Del Delete to end of line │ Alt-K Insert key literally │ Ctrl-Q Insert new line │ Enter Insert scrap │ Ins Join two lines into one │ Alt-J Paste lines from scrap │ Shift-Ins Play recorded keystrokes │ F8 Redo last Undo │ Alt-Y Toggle insert mode │ Alt-I Toggle keystroke recording │ F7 Undo last edit │ Alt-U ────────────────────────────┴──────────────── Block Operations Keystroke ────────────────────────────┬──────────────── │ Begin block of lines │ Alt-L Begin normal block │ Alt-A Copy to scrap │ Alt-C Delete block │ Del Delete block to scrap │ Alt-D Insert scrap │ Ins Mark block delimited by {}, │ [] or () │ Alt-M Read block from file │ Alt-R Write block to file │ Alt-W ────────────────────────────┴──────────────── Buffer Commands Keystroke ────────────────────────────┬──────────────── │ Buffers menu │ Alt-B Change output filename │ Alt-O Delete current buffer │ Alt-Minus Load new buffer │ Alt-E Next buffer │ Alt-N │ F4 Previous buffer │ F3 Reorganize buffers │ Shift-F4 ────────────────────────────┴──────────────── Word Processing Keystroke ────────────────────────────┬──────────────── │ Reformat paragraph │ Alt-P Space indent line or block │ Space Space outdent line or block │ Alt-Space Tab indent line or block │ Tab Tab outdent line or block │ Shift-Tab │ Alt-Tab ────────────────────────────┴──────────────── Searching Keystroke ────────────────────────────┬──────────────── │ Replace forward │ Alt-T Search again backward │ Alt-F5 Search again forward │ Alt-F6 Search backward │ F5 Search forward │ F6 │ Alt-S ────────────────────────────┴──────────────── Window Commands Keystroke ────────────────────────────┬──────────────── │ Create window │ Alt-F3 Delete tiled window │ Alt-F4 Delete window │ F4 Enlarge window │ Shift-F2 Next window │ F2 Previous window │ F1 Reorganize windows │ Shift-F3 Shrink window │ Shift-F1 Split window horizontally │ Alt-F1 Split window vertically │ Alt-F2 ────────────────────────────┴──────────────── Programming Keystroke ────────────────────────────┬──────────────── │ Compile current buffer │ Alt-F10 Display compile errors │ Shift-F7 Go to next error position │ Shift-F8 ────────────────────────────┴──────────────── Miscellaneous Keystroke ────────────────────────────┬──────────────── │ Display output filename │ Alt-F Display SPE ver. no. │ Alt-V Execute a DOS command │ F9 Invoke Help system │ Alt-H PolyAWK command │ F10 Quit with verify save │ Alt-X │ Alt-Q Shell out │ Alt-Z Toggle pause between mesg. │ Ctrl-P ────────────────────────────┴──────────────── emulate vi vi mode vi VI KEYMAP ────────── Files and Miscellaneous Keystroke ────────────────────────────┬──────────────── │ Change current file name │ :f name Edit next buffer │ :n Edit previous buffer │ :p Load new buffer from file │ :e name Overwrite file with changes │ :w! Quit SPE │ :q Quit SPE, abandon changes │ :q! Read file into buffer │ :r name Reload buffer,discard chgs │ :e! Run shell │ :sh Run shell or shell command │ :! Show current file and line │ :f Undo or redo previous edit │ :u Write changes to disk │ :w End editing process │ Alt-Q │ ZZ Restore previous keymap │ Q Show current file and line │ Ctrl-G ────────────────────────────┴──────────────── Positioning The Cursor Keystroke ────────────────────────────┬──────────────── │ Beginning of line │ Home │ 0 Beginning of text ext line │ + │ Enter Bottom of buffer │ Ctrl-PgDn │ G Character to the left │ h │ BackSp │ Character to the right │ l │ Space │ End of line │ $ │ End End of word │ (punctuation delimited) │ e End of word │ (white space delimited) │ E Find char x on line backward│ F<x> Find char x on line forward │ f<x> Find matching brace │ % First non-whitespace │ on current line │ ^ Go to column no. n │ <n>| Go to line no. n │ <n>G Line down │ j │ │ Ctrl-N Line up │ k │ │ Ctrl-P Move "upto" x backward │ T<x> Move "upto" x forward │ t<x> Next paragraph │ } Next sentence │ ) Next word │ (punctuation delimited) │ Ctrl │ w Next word │ (whitespace delimited) │ W Previous line │ - Previous paragraph │ { Previous sentence │ ( Previous word │ (punctuation delimited) │ Ctrl │ b Previous word │ (whitespace delimited) │ B Repeat inverse of last find │ (F,f,T,t) │ , Repeat last find (F,f,T,t) │ ; Repeat last pattern match │ n Search backward for str │ ?<str> Search forward for str │ /<str> Top of buffer │ Ctrl-PgUp │ 1G ────────────────────────────┴──────────────── Marking and Moving Marks Keystroke ────────────────────────────┬──────────────── │ Goto first non-blank at mark│ `<x> Goto line at mark x │ '<x> Place mark x │ m<x> ────────────────────────────┴──────────────── Screen and Windows Keystroke ────────────────────────────┬──────────────── │ Home window line │ H Last window line │ L Middle window line │ M Output recent changes │ Ctrl-R Page down (forward screen) │ Ctrl-F or [PgDn] │ Page up (backward screen) │ Ctrl-B │ PgUp Redraw the screen │ Ctrl-L Scroll down half window hght│ Ctrl-D Scroll line to window bottom│ z- Scroll line to window middle│ z. Scroll line to window top │ zEnter Scroll up half window height│ Ctrl-U Scroll window down one line │ Ctrl-E Scroll window up one line │ Ctrl-Y ────────────────────────────┴──────────────── Entering Insert Mode Keystroke ────────────────────────────┬──────────────── │ Append after cursor │ a Append at end of line │ A Change rest of line │ C Insert at beginning of line │ I Insert before the cursor │ i Open a line above current │ O Open a line below current │ o Replace single char with x │ r<x> ────────────────────────────┴──────────────── Insert Mode Commands Keystroke ────────────────────────────┬──────────────── │ Erase previous word │ Ctrl-W End insertion │ Esc Erase current line │ Ctrl-U Erase previous character │ BKSP Quote non-printing character│ Ctrl-V ────────────────────────────┴──────────────── Yank and Put Keystroke ────────────────────────────┬──────────────── │ Put back lines after │ p Put back lines before │ P Yank lines before current │ Y Yank lines following to buff│ y ────────────────────────────┴──────────────── Undo and Redo Keystroke ────────────────────────────┬──────────────── │ Restore current line │ U Undo last change │ u ────────────────────────────┴──────────────── Editing Operations Keystroke ────────────────────────────┬──────────────── │ Delete characters │ before cursor │ X Delete characters │ following cursor │ x Delete to end of line │ D Join lines │ J Reverse case of characters │ ~ Substitute chars │ s Substitute lines │ S ────────────────────────────┴──────────────── emulate wordstar wordstart mode wordstar WORDSTAR KEYMAP ─────────────── Cursor Movement Keystroke ────────────────────────────┬──────────────── │ Beginning of buffer │ Ctrl-Qr Beginning of line │ Home │ Ctrl-Qs Beginning of window │ Ctrl-Qe Column left │ │ Ctrl-S Column right │ │ Ctrl-D End of buffer │ Ctrl-Qc End of line │ End │ Ctrl-Qd End of window │ Ctrl-Qx Line down │ Down │ Ctrl-X Line up │ │ Ctrl-E Next word │ Ctrl-F │ Ctrl Page down │ PgDn │ Ctrl-C Page up │ PgUp │ Ctrl-R Previous word │ Ctrl-A │ Ctrl Scroll line down │ Ctrl-Z Scroll line up │ Ctrl-W ────────────────────────────┴──────────────── Text Editing Keystroke ────────────────────────────┬──────────────── │ Delete character at cursor │ Del │ Ctrl-G Delete character left │ BKSP Delete line │ Ctrl-Y Delete next word │ Ctrl-t Delete to end of line │ Ctrl-Qy Insert new line │ Enter Insert scrap │ Ins Open new line │ Ctrl-N Play recorded keystrokes │ F8 Toggle keystroke recording │ F7 Toggle insert mode │ Ctrl-V Undo last edit │ Alt-U │ keypad * ────────────────────────────┴──────────────── Block Operations Keystroke ────────────────────────────┬──────────────── │ Begin block of lines │ Ctrl-Kl Begin column block │ Ctrl-Kn Begin inclusive block │ Ctrl-Ki Begin normal block │ Ctrl-Kb Copy block from scrap │ Ctrl-Kc Copy to scrap │ keypad + Delete block │ Ctrl-Ky Delete block to scrap │ keypad - End block, copy to scrap │ Ctrl-Kk Move block │ Ctrl-Kv Read block from file │ Ctrl-Kr Toggle hidden block │ Ctrl-Kh Write block to file │ Ctrl-Kw ────────────────────────────┴──────────────── Buffer Commands Keystroke ────────────────────────────┬──────────────── │ Buffers menu │ Alt-F3 Delete current buffer │ Alt-Minus Load new buffer │ F3 Next buffer │ Alt-n Previous buffer │ Alt-p Print buffer │ Ctrl-Kp Save and continue │ Ctrl-Ks Save with new name │ Alt-Fw ────────────────────────────┴──────────────── Word Processing Keystroke ────────────────────────────┬──────────────── │ Indent line or block │ Tab Outdent line or block │ Shift-TAB Reformat paragraph │ Ctrl-B Toggle auto-indent │ Ctrl-Oi ────────────────────────────┴──────────────── Searching Keystroke ────────────────────────────┬──────────────── │ Find │ Ctrl-Qf Find again │ Ctrl-L Find and replace │ Ctrl-Qa Incrementing string search │ Ctrl-Qi ────────────────────────────┴──────────────── Window Commands Keystroke ────────────────────────────┬──────────────── │ Create window │ Shift-F9 Delete tiled window │ Alt-F4 Delete window │ F4 Next window │ Alt-F1 Previous window │ Alt-F2 Zoom window │ F5 ────────────────────────────┴──────────────── Programming Keystroke ────────────────────────────┬──────────────── │ Compile current buffer │ F9 Display compile errors │ Shift-F7 ────────────────────────────┴──────────────── Miscellaneous Keystroke ────────────────────────────┬──────────────── │ Abandon edits │ Ctrl-Kq Change directory │ Alt-Fc Display directory │ Alt-Fd PolyAWK command │ F10 Quit with verify save │ Alt-x Save and edit new │ Ctrl-Kd Save and exit │ Ctrl-Kx Shell out │ Alt-Fo ────────────────────────────┴──────────────── emulate ms word msword ms word msword mode ms word mode MS WORD KEYMAP ─────────────── Cursor Movement Keystroke ────────────────────────────┬──────────────── │ Beginning of buffer │ [Ctrl][PgUp] Beginning of line │ [Home] Column left │ [Left] Column right │ [Right] End of buffer │ [Ctrl][PgDn] End of line │ [End] Line down │ [Down] Line up │ [Up] Next word │ [F8] Page down │ [PgDn] Page up │ [PgUp] Previous word │ [F7] ────────────────────────────┴──────────────── Text Editing Keystroke ────────────────────────────┬──────────────── │ Delete character at cursor │ [Del] Delete character left │ [Backsp] Insert new line │ [Enter] Insert scrap │ [Ins] Play recorded keystrokes │ [F4] Toggle keystroke recording │ [Shift][F3] Toggle insert mode │ [F5] Undo last edit │ [Shift][F1] Redo last Undo │ [Shift][F2] ────────────────────────────┴──────────────── Block Operations Keystroke ────────────────────────────┬──────────────── │ Begin extended selection │ [F6] Begin column selection │ [Shift][F6] Insert block from scrap │ [Ins] Delete block to scrap │ [Del] Merge from file │ [Esc],[T],[M] Write block to file │ [Esc],[P],[F] ────────────────────────────┴──────────────── Buffer Commands Keystroke ────────────────────────────┬──────────────── │ Buffers menu │ [F3] Delete current buffer │ [Ctrl][F9] Load new buffer │ [Ctrl][F7] Next buffer │ [Ctrl][F2] Previous buffer │ [Ctrl][F3] Print buffer │ [Ctrl][F8] Save and continue │ [Ctrl][F10] Save with new name │ [Esc],[T],[S] ────────────────────────────┴──────────────── Word Processing Keystroke ────────────────────────────┬──────────────── │ Indent line or block │ [Tab] Outdent line or block │ [Shift][TAB] Toggle word wrap │ [Shift][F7] ────────────────────────────┴──────────────── Searching Keystroke ────────────────────────────┬──────────────── │ Find │ [Esc],[S] Find again │ [Shift][F4] Find and replace │ [Esc],[R] Replace again │ [Shift][F5] ────────────────────────────┴──────────────── Window Commands Keystroke ────────────────────────────┬──────────────── │ Split window │ [Esc],[W],[S] Resize window │ [Esc],[W],[M] Delete window │ [Ctrl][F6] Next window │ [F1] Previous window │ [F2] Zoom window │ [Ctrl][F1] ────────────────────────────┴──────────────── Programming Keystroke ────────────────────────────┬──────────────── │ Compile current buffer │ [Shift][F8] Display compile errors │ [Shift][F9] Go to next error │ [Shift][F10] ────────────────────────────┴──────────────── Miscellaneous Keystroke ────────────────────────────┬──────────────── │ PolyAWK command │ [F10] Quit │ [Esc],[Q] Shell │ [Esc],[L],[R] Reverse case │ [Ctrl][F4] Toggle linedraw │ [Ctrl][F5] Set tabs │ [Alt][F1] Help │ [Alt][H] ────────────────────────────┴──────────────── emulate brief brief mode brief BRIEF KEYMAP ──────────── Cursor Movement Keystroke ────────────────────────────┬──────────────── │ Beginning of buffer │ Home,Home,Home │ Ctrl-PgUp Beginning of line │ Home Beginning of window │ Home,Home Bottom line of window │ Ctrl-End Column left │ Column right │ End of buffer │ End,End,End │ Ctrl-PgDn End of line │ End End of window │ End,End Go to bookmark │ Alt-J Go to line no. │ Alt-G Line down │ Line up │ Next word │ Ctrl Page down │ PgDn Page up │ PgUp Place numbered bookmark │ Alt-<n> n ε {0..9} Previous word │ Ctrl Scroll line down │ Ctrl-D Scroll line to bottom │ Ctrl-B Scroll line to center │ Ctrl-C Scroll line to top │ Ctrl-T Scroll line up │ Ctrl-U Top line of window │ Ctrl-Home Top of window │ Ctrl-Home ────────────────────────────┴──────────────── Text Editing Keystroke ────────────────────────────┬──────────────── │ Delete character at cursor │ Del Delete character left │ Backsp Delete line │ Alt-D Delete to end of line │ Alt-K Insert key literally │ Alt-Q Insert new line │ Enter Insert scrap │ Ins Open new line │ Ctrl-Enter Play recorded keystrokes │ F8 Redo last Undo │ Alt-Y Toggle insert mode │ Alt-I Toggle keystroke recording │ F7 Undo last edit │ Alt-U │ keypad * ────────────────────────────┴──────────────── Block Operations Keystroke ────────────────────────────┬──────────────── │ Begin block of lines │ Alt-L Begin column block │ Alt-C Begin exclusive block │ Alt-A Copy block to scrap │ keypad + Delete block │ Del Delete block to scrap │ keypad - Insert scrap │ Ins Read block from file │ Alt-R Write block to file │ Alt-W ────────────────────────────┴──────────────── Buffer Commands Keystroke ────────────────────────────┬──────────────── │ Buffer list │ Alt-B Change output filename │ Alt-O Delete current buffer │ Ctrl-Minus Load new buffer │ Alt-E Next buffer │ Alt-N Previous buffer │ Alt-Minus Print buffer │ Alt-P Write buffers and exit │ Ctrl-X ────────────────────────────┴──────────────── Word Processing Keystroke ────────────────────────────┬──────────────── │ Space indent line or block │ Space Space outdent line or block │ Alt-Space Tab indent line or block │ Tab Tab outdent line or block │ Shift-Tab ────────────────────────────┴──────────────── Searching Keystroke ────────────────────────────┬──────────────── │ Replace again │ Shift-F6 Replace backward │ Alt-F6 Replace forward │ F6 │ Alt-T Search again │ Shift-F5 Search backward │ Alt-F5 Search forward │ F5 │ Alt-S Toggle ignore case │ Ctrl-F5 Toggle regular expressions │ Ctrl-F6 ────────────────────────────┴──────────────── Window Commands Keystroke ────────────────────────────┬──────────────── │ Create window │ F3 Delete window │ F4 Enlarge window │ F2 Next window │ F1 Select adjacent window │ shift-keypad arrows Toggle window borders │ Alt-F1 ────────────────────────────┴──────────────── Programming Keystroke ────────────────────────────┬──────────────── │ Compile current buffer │ Alt-F10 Display compile errors │ Ctrl-P Go to next error position │ Ctrl-N ────────────────────────────┴──────────────── Miscellaneous Keystroke ────────────────────────────┬──────────────── │ Display output filename │ Alt-F Display SPE ver. no. │ Alt-V Execute a DOS command │ F9 Invoke Help system │ Alt-H PolyAWK command │ F10 Quit with verify save │ Alt-X Repeat key action │ Ctrl-R Shell out │ Alt-Z Toggle create backup file │ Ctrl-W Toggle pause between mesg. │ Ctrl-P ────────────────────────────┴──────────────── emulate epsilon EPSILON KEYMAP ────────────── SPE EPSILON/EMACS Key Bindings Insert Normal Keys ────────────────── Characters 32 - 128 insert into current buffer Normal keys that do extra things ──────────────────────────────── ] Insert ] and show matching } Insert } and show matching ) Insert ) and show matching Main keyboard special keys that do extra things ─────────────────────────────────────────────── Bksp Backspace Enter Insert newline alt-\ Delete whitespace backwards alt-, Goto top of buffer or window alt-. Goto bottom of buffer or window alt-/ Help Keyboard-5 Scroll_window_middle Ctrl-B Next_paragraph Ctrl-minus Help alt-BKSP Delete previous word to scrap Ctrl-up Previous sentence Ctrl-down Next sentence Alt-[ Previous paragraph Alt-] Next paragraph Ctrl-@ Set mark BKSP Previous paragraph alt keys (and ctrl-alt keys) ──────────────────────────── Alt-0 Show matching group Alt-1 Set accumulator argument to 1 Alt-2 Set accumulator argument to 2 or Set mark Alt-3 Set accumulator argument to 3 Alt-4 Set accumulator argument to 4 Alt-5 Set accumulator argument to 5 or Replace Alt-6 Set accumulator argument to 6 Alt-7 Set accumulator argument to 7 or Replace Alt-8 Set accumulator argument to 8 or Replace Alt-9 Set accumulator argument to 9 Alt-A Previous sentence Alt-B Goto end of word or Previous level Alt-C Convert words to upper case Alt-D Delete or append words to scrap Alt-E Next sentence Alt-F Goto end of word Alt-H Mark paragraph Alt-K Delete or append lines to scrap Alt-L Convert words to lower case Alt-M Goto beginning of previous non-blank line Alt-Q Wrap paragraph Alt-R Search regex backwards Alt-S Search regex forwards Alt-T Switch words Alt-U Convert words to upper case Alt-V Page up Alt-W Copy or append to scrap (using prev mark) Alt-X Invoke function Alt-Y Yank and pop scrap Alt-Z Scroll vertical up alt function keys ───────────────── Alt-F5 Toggle between 25-43 lines normal control keys ─────────────────── Ctrl-A Goto_bol Ctrl-B Goto_prev_char Ctrl-D Delete_chars Ctrl-E Goto_eol Ctrl-F Goto_next_char Ctrl-K Cut lines to scrap Ctrl-L Scroll_window_middle Ctrl-N Ddown Ctrl-O Insert newline Ctrl-P Up Ctrl-Q Insert quoted key Ctrl-R Backward incremental search Ctrl-S Forward incremental search Ctrl-T Reverse chars Ctrl-U Accumulator Ctrl-V Page down Ctrl-W Append or delete to scrap Ctrl-X Start of ctrl-X sequence keys Ctrl-Y Insert scrap Ctrl-Z Scroll vertical down Ctrl function keys ────────────────── Ctrl-F3 Write state Ctrl-F5 Toggle 25-43 lines Ctrl-F8 Display variable Ctrl cursor keys ──────────────── Ctrl-End Goto buffer bottom Ctrl-Home Goto buffer top Ctrl-Left Goto beg of word Ctrl-Right Goto end of word Ctrl prefix equivalents ─────────────────── Ctrl-^,a Goto_bol Ctrl-^,b Goto_prev_char Ctrl-^,d Delete_chars Ctrl-^,e Goto_eol Ctrl-^,f Goto_next_char Ctrl-^,k Cut lines to scrap Ctrl-^,l Scroll_window_middle Ctrl-^,n Ddown Ctrl-^,o Insert newline Ctrl-^,p Up Ctrl-^,q Insert quoted key Ctrl-^,r Backward incremental search Ctrl-^,s Forward incremental search Ctrl-^,t Reverse chars Ctrl-^,u Display accumulator Ctrl-^,v Page down Ctrl-^,w Append or delete to scrap Ctrl-^,x Start of ctrl-X sequence keys Ctrl-^,y Insert scrap Ctrl-^,z Scroll vertical down Ctrl-^,Alt-\ Indent_region Ctrl-^,Esc,\ Indent_region Ctrl-prefix function keys ───────────────────────── Ctrl-^,F3 Write state Ctrl-^,F5 Toggle 25-43 lines Ctrl-^,F8 Display variable Ctrl-prefix cursor keys ─────────────────────── Ctrl-^<End> Goto buffer bottom Ctrl-^<Home> Goto buffer_top Ctrl-^<Left> Goto beginning of word Ctrl-^<Right> Goto end of word Alt-prefix normal keys ────────────────────── Esc,% Set accumulator argument to 5 or Replace Esc,& Set accumulator argument to 7 or Replace Esc,) Show matching group Esc,* Set accumulator argument to 8 or Replace Esc,, Goto top of buffer or window Esc,. Goto bottom of buffer or window Esc,/ Help Esc,0 Set accumulator argument to 0 Esc,1 Set accumulator argument to 1 Esc,2 Set accumulator argument to 2 or Set mark Esc,3 Set accumulator argument to 3 Esc,4 Set accumulator argument to 4 Esc,5 Set accumulator argument to 5 or Replace Esc,6 Set accumulator argument to 6 Esc,7 Set accumulator argument to 7 or Replace Esc,8 Set accumulator argument to 8 or Replace Esc,9 Set accumulator argument to 9 Esc,> Goto bottom of buffer or window Esc,? Help Esc,@ Set accumulator argument to 2 or Set mark Esc,a Previous sentence Esc,b Goto end of word or Previous level Esc,c Convert words to upper case Esc,d Delete or append words to scrap Esc,e Next sentence Esc,f Goto end of word Esc,h Mark paragraph Esc,k Delete or append lines to scrap Esc,l Convert words to lower case Esc,m Goto beginning of previous non-blank line Esc,q Wrap paragraph Esc,s Search regex forwards Esc,t Switch words Esc,u Convert words to upper case Esc,v Page up Esc,w Copy or append to scrap (using prev mark) Esc,x Invoke function Esc,y Yank and pop scrap Esc,z Scroll vertical up Esc,[ Previous paragraph Esc,\ Delete whitespace backwards Esc,< Goto top of buffer or window Esc,] Next paragraph Esc,~ Toggle change status of buffer Alt-prefix function keys ──────────────────────── Esc,F5 Toggle 25-43 lines Alt-prefix command keys ───────────────────────── Esc,Bksp Delete Previous word Esc,Down Previous paragraph Esc,Up Previous paragraph Normal function keys ──────────────────── F1 help F2 Invoke function F4 bind_to_key F6 Display key binding F7 Change directory F8 Set macro variable F9 Undo F10 Redo Normal cursor keys ────────────────── Home goto_window_top End goto_window_bottom Left prev_char PgDn page_down PgUp page_up Right next_char Tab indent Up up Down down Ins toggle_insert_mode Del delete_char Mouse Motion ──────────── See "User's Manual", "Mouse Command Summary" for a description of mouse key commands. CTRL-X keys ─────────── Ctrl-B List of active buffers Ctrl-C Exit editor Ctrl-D Delete current window Ctrl-E Shell to DOS and invoke editor Ctrl-F Edit file - use tab for directory list Ctrl-I Indent columns with <num> spaces Ctrl-M Shell to DOS Ctrl-N Goto next compiler error Ctrl-O Delete blank lines Ctrl-S Save file Ctrl-T Transpose lines Ctrl-V Visit file Ctrl-W Save buffer to new filename Ctrl-X Exchange point and mark Ctrl-Z Exit editor Ctrl-^b List of active buffers Ctrl-^c Exit editor Ctrl-^d Delete current window Ctrl-^e Shell to DOS and invoke editor Ctrl-^f Edit file - use tab for directory list Ctrl-^i Indent columns with <num> spaces Ctrl-^m Shell to DOS Ctrl-^n Goto next compiler error Ctrl-^o Delete blank lines Ctrl-^s Save file Ctrl-^t Transpose lines Ctrl-^v Visit file Ctrl-^w Save buffer to new filename Ctrl-^x Exchange point and mark Ctrl-^z Exit editor ( Start recording keys ) Stop recording keys 1 Zoom current window 2 Split current window = Show buffer size and offset b Show buffer list e Playback last recording f Set wp left margin g Goto line i Read file into buffer k Delete current buffer l Display total and current lines m Invoke MAKE n Next window o Next window p Previous window r Redo u Undo w Write block to file Alt-b Display buffer list Alt-n Name macro Esc b Display buffer list Esc n Name Macro print bindings PRINT BINDINGS ───────────────────────────────────────────────────────────── Print the current keymap binding for the key specified. The editor will enter a input mode where, as keys are pressed, the function bound to the pressed key is displayed. When invoked, the message "Press keys to be looked up..." will appear. At this time, press the key in question. Example: Pressing 'a' produces: 0x1e61 #07777 (097) "a" is bound to insert_key │ │ │ │ │ │ │ │ │ ┌──────────────┘ │ │ │ │ │ │ │ │ │ └──> function bound to key │ │ │ └─────> ascii character │ │ └──────────> decimal value of ascii char │ └────────────────> decimal value of key └─────────────────────────> hex value of key To exit this mode, press ESC twice. insert quoted INSERT QUOTED ───────────────────────────────────────────────────────────── Insert a key into the current buffer bypassing the current keymap. Once invoked, the ascii value of the next key pressed will be entered into the current buffer. goto GOTO LINE ───────────────────────────────────────────────────────────── Goto a specified line in the current buffer. The prompt "Goto line:" will appear requesting the line number to become current. drop line anchor DROP LINE ANCHOR ───────────────────────────────────────────────────────────── Drop a line anchor at the current position in the current buffer. This anchor will mark the entire line as a selected block at which time all block functions will operate on this block. As the current buffer position is moved, this line will remain the base line of the selected block. To remove the anchor, drop another line anchor. drop column anchor DROP COLUMN ANCHOR ───────────────────────────────────────────────────────────── Drop a column anchor at the current position in the current buffer. This anchor will mark the current line and column position as a selected block at which time all block functions will operate on this block. As the current buffer position is moved, this line and column will remain the base position of the selected block. To remove the anchor, drop another column anchor. drop inclusive anchor DROP INCLUSIVE ANCHOR ───────────────────────────────────────────────────────────── Drop an inclusive anchor at the current position in the current buffer. This anchor will mark the current line and column position as a selected block at which time all block functions will operate on this block. The current character IS included in the selection. As the current buffer position is moved, this line and column will remain the base position of the selected block. To remove the anchor, drop another inclusive anchor. drop exclusive anchor DROP EXCLUSIVE ANCHOR ───────────────────────────────────────────────────────────── Drop an exclusive anchor at the current position in the current buffer. This anchor will mark the current line and column position as a selected block at which time all block functions will operate on this block. The current character IS NOT included in the selection. As the current buffer position is moved, this line and column will remain the base position of the selected block. To remove the anchor, drop another exclusive anchor. copy to scrap COPY TO SCRAP ───────────────────────────────────────────────────────────── Copy the currently marked block to the scrap buffer. Once the block has been copied, the anchor associated with the block is raised. cut to scrap CUT TO SCRAP ───────────────────────────────────────────────────────────── Copy the currently marked block to the scrap buffer then delete the marked block from the current buffer. paste from scrap PASTE FROM SCRAP ───────────────────────────────────────────────────────────── Insert the current scrap buffer contents into the current buffer. Depending on how the contents of the scrap buffer were placed there determines the mechanism for inserting its contents. Below are the for types of selections and a description of how there contents will be inserted into the current buffer. Selection type Placement of scrap contents ───────────────── ──────────────────────────────────────── LINE Before the current line with the cursor placed on the line after the inserted block (original column). COLUMN Before the current character with the cursor placed on the line after the inserted block (original column). Each line in the original column block will be placed in separate lines. INCLUSIVE Before the current character with the cursor placed on the column and line at the end of the inserted text. EXCLUSIVE Same as INCLUSIVE. indent spaces INDENT SPACES ───────────────────────────────────────────────────────────── Indent the current marked block or current line by one space. If no block is marked, the current line will be indented one space from column 1. If a COLUMN block is marked, all lines in the block will be indented one space from the leftmost column in the marked block. If any non-COLUMN block is marked, all lines in the block will be indented one space from column 1. indent tabs INDENT TABS ───────────────────────────────────────────────────────────── Indent the current marked block or current line by one tab. If no block is marked, the current line will be indented one tab from column 1. If a COLUMN block is marked, all lines in the block will be indented one tab from the leftmost column in the marked block. If any non-COLUMN block is marked, all lines in the block will be indented one tab from column 1. outdent spaces OUTDENT SPACES ───────────────────────────────────────────────────────────── Outdent the current marked block or current line by one space. If no block is marked, the current line will be outdented one space from column 1. If a COLUMN block is marked, all lines in the block will be outdented one space from the leftmost column in the marked block. If any non-COLUMN block is marked, all lines in the block will be indented one space from column 1. outdent tabs OUTDENT TABS ───────────────────────────────────────────────────────────── Outdent the current marked block or current line by one tab. If no block is marked, the current line will be outdented one tab from column 1. If a COLUMN block is marked, all lines in the block will be outdented one tab from the leftmost column in the marked block. If any non-COLUMN block is marked, all lines in the block will be outdented one tab from column 1. search SEARCH ───────────────────────────────────────────────────────────── Search the current buffer for a specified string. The search is performed using the current "search_flags" settings which may be toggled through use of the menus. When invoked, the prompt " Search for: " appears. Enter the string to be search for at this point. The arrow keys may be used to provide history of previous search patterns. replace REPLACE ───────────────────────────────────────────────────────────── Replace occurrences of a given string in the current buffer. The replace is performed using the current "search_flags" settings which may be toggled through use of the menus. When invoked, the prompt " Pattern: " appears. Enter the string to be replaced at this point. Once the replacement pattern is successfully entered, the prompt "Replacement:" appears. Enter the replacement string. The arrow keys may be used to provide history of previous search and replacement patterns at both prompts. toggle direction TOGGLE DIRECTION ───────────────────────────────────────────────────────────── Toggle the direction of the search: forwards or backwards. toggle pvcs TOGGLE PVCS ───────────────────────────────────────────────────────────── Enable or disable PVCS get and put calls when read-only buffers are edited. regular expression syntax Regular expressions are used for searches when using the search(), match(), sub() and gsub() functions. The special characters and their meanings are listed below. Regular Expression Symbols Special Characters Meaning ────────── ──────────────────────────── c match any normal character \i treat i as a normal character \c cursor position after search ^ match beginning of line $ match end of line < match beginning of word > match end of word . match any char (except \n) r* match zero or more of r .* match any string (except \n) r+ match one or more of r r? match zero or one of r a|b match a or b (a) treat r as a group {r} treat r as a match group [abc] match any characters abc [^abc] match any chars except abc a-b range within character class toggle regex searching TOGGLE REGEX SEARCHING ───────────────────────────────────────────────────────────── Enable or disable the use of regular expression characters in search and replacement patterns. If disabled, all characters will be treated as ascii values and will be search for and replaced without any special meaning. If enabled, certain characters in search and replacement strings will have special meanings. Those characters and their meanings are listed below. Regular Expression Symbols Special Characters Meaning ────────── ──────────────────────────── c match any normal character \i treat i as a normal character \c cursor position after search ^ match beginning of line $ match end of line < match beginning of word > match end of word . match any char (except \n) r* match zero or more of r .* match any string (except \n) r+ match one or more of r r? match zero or one of r a|b match a or b (a) treat r as a group {r} treat r as a match group [abc] match any characters abc [^abc] match any chars except abc a-b range within character class toggle case sensitivity TOGGLE CASE SENSITIVITY ───────────────────────────────────────────────────────────── Enable or disable the case sensitivity when searching for patterns. If enabled, all ascii characters in a search string must match exactly. If disabled, all ascii characters in a search string will be searched for without regard to case. toggle block searching TOGGLE BLOCK SEARCHING ───────────────────────────────────────────────────────────── Enable or disable the capability of confining search and replacements to a marked block. If enabled, all search and replacements will be restricted to a marked block, if any. If no block is marked, this setting is ignored and the entire buffer is searched. If disabled, this setting is ignored and the entire buffer is searched. 43/50-lines 43-LINES ───────────────────────────────────────────────────────────── Place the display adapter into 43-line mode by downloading an 8x8 font to the adapter. This will cause the adapter to display 43-lines (50 for VGA). This could cause unpredictable behavior if performed on a non-standard EGA or VGA card. 25-lines 25-LINES ───────────────────────────────────────────────────────────── Place the display adapter into 25-line mode by resetting the current mode of the display. dos shell DOS SHELL ───────────────────────────────────────────────────────────── Shell out to DOS (or whatever the current command shell is) preserving the current edit session. Any dos operation may be performed at this point without affecting the state of the edit session. To return to the editor, type "EXIT". WARNING: ──────── Before returning to the editor, all TSR's must be removed. If the memory configuration is not exactly the same as before shelling out, the edit session cannot be restored. It is recommended that all buffers be saved before this command is executed to avoid loss of data. dos buffer DOS BUFFER ───────────────────────────────────────────────────────────── Shell out to DOS (or whatever the current command shell is) preserving the current edit session. A window is created on the screen and the DOS session is performed within this window. To return to the editor, type "EXIT". The window will remain visible and up to 8K of data displayed while in the shell will be entered into the buffer which is attached the window. WARNING: ──────── Unexpected behavior will result if programs which write directly to display memory are executed. Before returning to the editor, all TSR's must be removed. If the memory configuration is not exactly the same as before shelling out, the edit session cannot be restored. It is recommended that all buffers be saved before this command is executed to avoid loss of data. dos function DOS FUNCTION ───────────────────────────────────────────────────────────── Execute a command from within the editor and display its contents in a window. A window is created on the screen and the command is performed within this window. WARNING: ──────── Unexpected behavior will result if programs which write directly to display memory are executed. The command executed must not execute any TSR's which remain resident. If the memory configuration is not exactly the same as before shelling out, the edit session cannot be restored. It is recommended that all buffers be saved before this command is executed to avoid loss of data. toggle help TOGGLE HELP ───────────────────────────────────────────────────────────── Toggle the display of the menu bar at the top of the screen. If enabled, the menu bar will remain resident and the mouse may be used to click on menu items. Even though the menu bar is resident it may be covered by some other window. To avoid this initially, create the first window on line 2 before the first display_update() is called so that the system won't create the default window. If disabled, the menu facility must be invoke in some other way to become visible (usually through <alt-h>). toggle clock TOGGLE CLOCK ───────────────────────────────────────────────────────────── Enable or disable the display of the system clock. If enabled, the clock will initially be displayed in the lower right corner of the screen. Changing video modes or screen sizes may affect where the clock is placed. Also, if a dialog window is created on the last line of the display, it may overlay the clock. Avoid this by creating a dialog window that doesn't overlap where the clock window is positioned. Use the create_window function in the following manner: dialog_window = create_window( 0, display_height-1, display_width - 16, 1) If disabled, no clock is displayed. reference manual reference library REFERENCE MANUAL ───────────────────────────────────────────────────────────── The reference manual contains all of the primitive functions described in the "LIBRARY REFERENCE MANUAL". The first time this command is invoked, the system will initialize all data structures. Because of the size of the reference manual, this may take a few seconds depending on the speed of the machine -- be patient. The initial display of the reference manual consists of two windows as shown. ╒══════════╕╒═════════════════════╕ │item 1 ││ │ │item 2 ││ This is the help │ │item 3 ││ │ │item 4 ││ text for item 6 │ │item 5 ││ │ ├──────────┤│ │ │item 6 ││ │ ├──────────┤│ │ │item 7 ││ │ │item 8 ││ │ │item 9 ││ │ ╘══════════╛╘═════════════════════╛ The leftmost window contains the function (or variable) name and the rightmost window contains the descriptive text for that function. KEY USAGE ───────── - display previous item - display next item - scroll descriptive text up - scroll descriptive text down <PGDN> - move down 1 page and display item <PGUP> - move up 1 page and display item <ESC> - close windows and return to previous window a-z,A-Z - incremental search for item name <BKSP> - backup to previous incremental search item if currently searching <ENTER> - copy marked block to scrap (if any) and return to previous window. Help window will remain. Left mouse button presses in the descriptive text window will drop inclusive anchors. Left mouse button presses on the top of the window and the lower right cause the window move and resize, respectively. Right mouse button presses in the descriptive text window will drop column anchors. toggle borders TOGGLE BORDERS ───────────────────────────────────────────────────────────── Toggle the display of borders for the current window. toggle linenumbers TOGGLE LINENUMBERS ───────────────────────────────────────────────────────────── Toggle the display of line numbers for the current window. Once enabled, line numbers will be displayed on the left side of the current window as shown. ╒══════════════════════════════╕ │ 1 This │ │ 2 window │ │ 3 has │ │ 4 the │ │ 5 display │ │ 6 of │ │ 7 line │ │ 8 numbers │ │ 9 enabled │ │ 10 │ │ 11 │ │ 12 │ │ 13 │ │ 14 │ ╘══════════════════════════════╛ The line numbers are only displayed on the screen as is the border of the window, they are not part of the buffer. toggle auto indent TOGGLE AUTO INDENT ───────────────────────────────────────────────────────────── Toggle auto indenting for the current buffer. When enabled, the current settings of <ENTER> and <CTRL-ENTER> are reassigned to functions which will perform the indenting. Pressing <ENTER> will automatically indent to match the leading whitespace on the previous non-blank line. Pressing Ctrl-<ENTER> causes auto-indent to occur after a line is "opened". The automatically-indented line is initially composed of virtual space. This means that consecutive lines that are indented but also left blank do not contain any superfluous characters. The previous settings for CR and NL are remembered and restored when auto-indent is disabled. toggle dialog window TOGGLE DIALOG WINDOW ───────────────────────────────────────────────────────────── Toggle the display of a resident dialog window, usually on the last line of the screen. If resident, all messages and prompting will appear in this window. If not resident, a pop-up window will appear on the screen for every message. Depending on the severity, some messages will not be seen. toggle line drawing TOGGLE DRAWING ───────────────────────────────────────────────────────────── Enable or disable the use of SHIFT arrow keys as line drawing keys. If enabled, pressing SHIFT will produce the appropriate piece of a line. Use of the SHIFT arrow keys is made simpler by pressing the NUM-LOCK key and using the keypad arrow keys without having to press SHIFT. Line drawing does more than just insert the appropriate line character into the current buffer, it also connects corners and sides. There are four possible line styles which can be used when drawing. 1 2 3 4 ┌───┬───┐ ╒═══╤═══╕ ╓───╥───╖ ╔═══╦═══╗ │ │ │ │ │ │ ║ ║ ║ ║ ║ ║ ├───┼───┤ ╞═══╪═══╡ ╟───╫───╢ ╠═══╬═══╣ │ │ │ │ │ │ ║ ║ ║ ║ ║ ║ └───┴───┘ ╘═══╧═══╛ ╙───╨───╜ ╚═══╩═══╝ By default, toggling draw mode uses a default line style of 1. To use the other styles, line drawing must be invoked through the use of F10. Press F10 (at which time a dialog window appears requesting a command) and type "toggle_drawing <style>", where style equals 1..4 (0 will disable line drawing). toggle electric TOGGLE ELECTRIC ───────────────────────────────────────────────────────────── Enable or disable the use of template insertion. The template entry facility works differently than some other products' in that templates are inserted only upon demand, and not automatically upon recognition of an abbreviation. Templates are auto-indented independently of the autoindent mode. Template insertion is activated manually by pressing ESC or whichever key is bound to the function "expand_template()". If no key is assigned to this function, you will need to do so using "assign_key()". Multiple-character abbreviation sequences are allowed. debug debugger DEBUGGER COMMAND AND KEY ASSIGNMENTS ───────────────────────────────────────────────────────────── BC [<id>|*] Breakpoint clear BD [<id>|*] Breakpoint disable BE [<id>|*] Breakpoint enable BP [<id>|*] Breakpoint set BL Breakpoint list . Display current location ?<expression>|<variable> Display/set data E Execute G [<function>] Go to function or end H Help O[R|C|F][+|-] Enable and disable options OR - regex searching OC - case sensitivity OF - window switching O - list all settings P [<count>] Step over once or count times EXIT Exit debugger @ Display redraw /[<string>] Search for string or search again K Stack trace #<string> Set tabs Q Exit debugger T [<count>] Trace into once or count times V <filename> View file Motion CTRL-PGUP Top of buffer CTRL-PGDN End of buffer CTRL-T Shrink current window CTRL-G Grow current window ENTER Execute current command F1 Help (Show this screen) F4 Toggle screen F5 Go F6 Change current window F8 Trace into F9 Breakpoint at line F10 Step over LEFT BUTTON Use for window size and movement help on help... help MENU AND HELP SYSTEM ───────────────────────────────────────────────────────────── The menu system provides access to rarely used functions with help information for each. If the menu line is visible on the top line of the screen, the mouse can be used to pulldown submenus. Place the mouse cursor over an item on the menu and press the left button. If no mouse is available or the menu is not visible, it can be invoked by typing F10, help. A key (usually alt-h) is usually assigned to the help() function to avoid such a round-about method. Below are the key assignments to be used once the menu system is active. ESC - backup one menu level. - move vertically through a submenu. - move horizontally through submenus. ENTER - execute the selected menu item. ALT-H - display help for selected menu item. LEFT BUTTON PRESS - movement through submenus. LEFT BUTTON RELEASE - execute the selected menu item. To receive help on a specific item, type F10, help <item name>. keys function bindings FUNCTION BINDINGS ───────────────────────────────────────────────────────────── The function binding macro allows keys to be assigned to functions interactively as well as displaying their current key assignments. Locally, all assignments are made to the current keymap. The macro display two windows as shown: ╒════════════════╕ ╒════════════════╕ │Ascii Table ├┐ │<Ctrl-A> ├┐ │Begin block of l││ │<Ctrl-B> ││ │Begin column blo││ │ ││ │Begin exclusive ││ │ ││ │Begin inclusive ││ │ ││ │ . ││ │ ││ │ . ││ │ ││ │ . ││ │ ││ │ ││ │ ││ │ ││ │ ││ │ ││ │ ││ │ ││ │ ││ │ ││ │ ││ ╘╤═══════════════╛│ ╘╤═══════════════╛│ └────────────────┘ └────────────────┘ Window 1 Window 2 Window 1 ──────── Contains a description of the function associated with the key sequence(s) displayed in window 2. Keys: - selected function in question <TAB> - select window 2 - select window 2 <INS> - add a new key sequence assignment to the current function <ESC> - exit Window 2 ──────── Contains the key assignments(s) used to invoke the function described by the highlighted text in window 1. - selected a new key sequence <TAB> - select window 2 - select window 2 <INS> - add a new key sequence assignment to the current function <DEL> - delete current key assignment <ESC> - exit If <INS> is pressed, a blank line will be display allowing space for a new key sequence to be entered. Use <CR> to accept the sequence or <ESC> to reject it. WARNING: ──────── Once all keys have been assigned, a prompt to save the changes to .../SAGEEDIT.CFG will appear. These changes will be written to the config file permanently. However, it is good practice to move any permanent changes to "startup.pel" or "local.pel". The keymap which is current at startup time will inherit the new assignments. toggle word processing WORD PROCESSING ───────────────────────────────────────────────────────────── Enable or disable word wrap for the current edit buffer. When enabled, word wrap will occur for the current line, previous line, and any following lines as long as some adjustment is being made to the length of the line. The width of each line will be maintained within "wp_left_margin" and "wp_right_margin". These margins can be set manually or by marking a block with a column selection and wrapping the block with "wrap_paragraph()". prompt XMACRO EXECUTE FUNCTION ───────────────────────────────────────────────────────────── Execute a function immediately. Enter a function or variable name to be executed. Functions must be specified with whitespace between parameters. Each parameter must be a literal string or integer; no function or variable name will be translated. Variables may be specified in any of the following ways: ?<variable_name> # Display the value ?<variable_name>=<value> # Assign a value to # a variable and display # its new value. <variable_name>=<value> # Assign a value to # a variable. The following keys are allowed from within the prompt response line: ┌──────────┬───────────────────────────────────┐ │ Key │ Description │ ├──────────┼───────────────────────────────────┤ │ │ Next or previous entered string │ │ <TAB> │ Symbol name completion │ │ <ENTER> │ Accept current input string │ │ <HOME> │ Goto beginning of prompt string │ │ <END> │ Goto end of prompt string │ │ <DEL> │ Delete current character │ │ <BKSP> │ Delete previous character │ │ <ESC> │ Cancel current prompt │ │ │ Right or left in prompt string │ │ others │ Insert into prompt response │ └──────────┴───────────────────────────────────┘ prompt REPLACE STRING REPLACE ───────────────────────────────────────────────────────────── Replace a found string within the current buffer. Replacements can be performed incrementally or globally. If regular expression searches are being performed, there are characters which have special meanings within the replacement string. Special Characters Meaning ────────── ──────────────────────────── & use matched pattern \1-9 use i-th group matched (group = {}) The following keys are allowed from within the prompt response line: ┌──────────┬───────────────────────────────────┐ │ Key │ Description │ ├──────────┼───────────────────────────────────┤ │ │ Next or previous entered string │ │ <ENTER> │ Accept current input string │ │ <HOME> │ Goto beginning of prompt string │ │ <END> │ Goto end of prompt string │ │ <DEL> │ Delete current character │ │ <BKSP> │ Delete previous character │ │ <ESC> │ Cancel current prompt │ │ │ Right or left in prompt string │ │ others │ Insert into prompt response │ └──────────┴───────────────────────────────────┘ prompt SEARCH STRING SEARCH ───────────────────────────────────────────────────────────── Search for a string within the current buffer. Many search setting may affect the behavior of the search to be performed. The settings in question are: ∙ regular expression searches ∙ regular expression maximal matching ∙ block searching ∙ forward or backward searches ∙ wrapping within buffer ∙ case sensitive ∙ global searches ∙ highlight found pattern ∙ advance before searching If regular expression searches are being performed, there are many characters which have special meanings within a search string. Special Characters Meaning ────────── ──────────────────────────── c match any normal character \i treat i as a normal character \c cursor position after search ^ match beginning of line $ match end of line < match beginning of word > match end of word . match any char (except \n) r* match zero or more of r .* match any string (except \n) r+ match one or more of r r? match zero or one of r a|b match a or b (a) treat r as a group {r} treat r as a match group [abc] match any characters abc [^abc] match any chars except abc a-b range within character class The following keys are allowed from within the prompt response line: ┌──────────┬───────────────────────────────────┐ │ Key │ Description │ ├──────────┼───────────────────────────────────┤ │ │ Next or previous entered string │ │ <ENTER> │ Accept current input string │ │ <HOME> │ Goto beginning of prompt string │ │ <END> │ Goto end of prompt string │ │ <DEL> │ Delete current character │ │ <BKSP> │ Delete previous character │ │ <ESC> │ Cancel current prompt │ │ │ Right or left in prompt string │ │ others │ Insert into prompt response │ └──────────┴───────────────────────────────────┘ prompt EDITFILE EDIT FILE ───────────────────────────────────────────────────────────── Edit a new file making it the current buffer in the current active window. Pressing TAB will produce a list of files which match the current pattern entered at the prompt line. If no pattern is present, all files in the current directory will be displayed. If only one file in the directory matches the pattern, the matched filename will become the default response to the prompt. The following keys are allowed from within the prompt response line: ┌──────────┬───────────────────────────────────┐ │ Key │ Description │ ├──────────┼───────────────────────────────────┤ │ │ Next or previous entered string │ │ <ENTER> │ Accept current input string │ │ <HOME> │ Goto beginning of prompt string │ │ <END> │ Goto end of prompt string │ │ <DEL> │ Delete current character │ │ <BKSP> │ Delete previous character │ │ <ESC> │ Cancel current prompt │ │ │ Right or left in prompt string │ │ others │ Insert into prompt response │ └──────────┴───────────────────────────────────┘ prompt TRANSFER TRANSFER FILE ───────────────────────────────────────────────────────────── Save the current buffer under a new file name. The name entered will become the buffer's new filename and its contents will be written to this file. The following keys are allowed from within the prompt response line: ┌──────────┬───────────────────────────────────┐ │ Key │ Description │ ├──────────┼───────────────────────────────────┤ │ │ Next or previous entered string │ │ <ENTER> │ Accept current input string │ │ <HOME> │ Goto beginning of prompt string │ │ <END> │ Goto end of prompt string │ │ <DEL> │ Delete current character │ │ <BKSP> │ Delete previous character │ │ <ESC> │ Cancel current prompt │ │ │ Right or left in prompt string │ │ others │ Insert into prompt response │ └──────────┴───────────────────────────────────┘ prompt SYSTEM SHELL COMMAND ───────────────────────────────────────────────────────────── Execute a SHELL command immediately. The string entered will be executed as a SHELL command. Any command can be entered as long as it deallocates all allocated memory (i.e. don't install any TSR routines). The following keys are allowed from within the prompt response line: ┌──────────┬───────────────────────────────────┐ │ Key │ Description │ ├──────────┼───────────────────────────────────┤ │ │ Next or previous entered string │ │ <ENTER> │ Accept current input string │ │ <HOME> │ Goto beginning of prompt string │ │ <END> │ Goto end of prompt string │ │ <DEL> │ Delete current character │ │ <BKSP> │ Delete previous character │ │ <ESC> │ Cancel current prompt │ │ <TAB> │ Display directory contents │ │ │ Right or left in prompt string │ │ others │ Insert into prompt response │ └──────────┴───────────────────────────────────┘ directory menu DIRECTORY LISTING ───────────────────────────────────────────────────────────── A display of the current directory listing will appear containing all files specified from the current prompt response. A window will appear similar to the one below. ╒═════════╕ │..\ ├┐ ∙ Files listed with a trailing '\' refer │BKUP\ ││ to a directory. Pressing <ENTER> on │file1.tmp││ such an item will display the directory │file2.tmp││ listing for the item. │file3.tmp││ │file4.tmp││ │ ││ ∙ Pressing <ENTER> on a non directory item │ ││ causes the selected file to be edited. │ ││ │ ││ │ ││ ∙ Pressing any legal filename character │ ││ will start an incremental search through │ ││ filename listing. │ ││ ╘╤════════╛│ ∙ Use and left mouse button to select └─────────┘ a menu item. setup SETUP ───────────────────────────────────────────────────────────── Setup allows modification of configurable settings interactively. Settings may be changed for window colors, keymap emulation mode, window/buffer options, or other system items. The setting may then be rejected, accepted temporarily, or saved permanently to a configuration file. Although permanent changes are written to a configuration file, they should be move to a compiled ".pel" file (i.e. startup.pel or local.pel) when convenient. This will enhance system startup time. pvcs Polytron Version Control System. ───────────────────────────────────────────────────────────── PVCS is a complete source code management system. It manages changes to any type of file, including source code, manuals, specifications, requirements, test procedures, bug reports, status reports and other documents, object files and executable files. Although PVCS is sold separately from the Sage Professional Editor, an interface between the two tools exists for the following function of PVCS: Get Vcompress Put Vdiff Ident Vdel Regen Vjournal Vname Vlog VCS Vlogin Vmrg prompt pvcsget get PVCS GET ───────────────────────────────────────────────────────────── Extract revisions from PVCS logfiles. Syntax: GET [<options>] <files> Options: -C[<file>] specify a configuration file -D<date/time> specify a revision by date/time -H display this text then exit -L[<rev>] lock the revision with intent to modify it -N force negative response to all queries -P[<rev>] pipe revision to stdout (obsolete) -Q[N|O] quiet mode; suppress messages and queries -R<rev> specify a particular revision -S<suffix> specify a suffix template -T[<rev>] touch the workfile (set to current time) -U[<date/time>] get only if newer than existing file or date -V<version> specify a particular version -W[<rev>] make file writable even if not locked -XO[<file>] write revision to file or stdout -Y force affirmative response to all queries @[<file>] specify a file containing more options/files prompt pvcsput put PVCS PUT ───────────────────────────────────────────────────────────── Deposit revisions in PVCS logfiles. Syntax: PUT [<options>] <files> Options: -A[<id list>] specify the access list a for new logfile -B ignore leading and trailing blanks when comparing -C[<file>] specify a configuration file -E[Y|N|C<str>] control keyword expansion and comment prefix -F[B] force PUT even if unchanged or force new branch -H display this text then exit -L after PUTting, do a GET with a lock -M[<text>] specify change description directly or from stdin -N force negative response to all queries -Q[N|O] quiet mode; suppress messages and queries -R<rev> specify a specific revision number -S<suffix> specify a suffix template -T[<desc>] specify workfile description directly or from stdin -U after PUTting, do a GET without a lock -V<version> assign version name to the revision -Y force affirmative response to all queries @[<file>] specify a file containing more options/files compile COMPILE ───────────────────────────────────────────────────────────── Compile the file associated with the current buffer. The buffer will be written to its original file before the compile occurs. The selection of compilers will be determined by the extension of the filename. If errors occur during the compile, use "goto_next_error" to display the error and the line on which it occurred. prompt pvcsvcs vcs PVCS VCS ───────────────────────────────────────────────────────────── Modify characteristics of PVCS logfiles. Syntax: VCS [<options>] <files> Options: -A[<id list>] delete or augment an access list -C[<file>] specify a configuration file -E[Y|N|C<str>] modify keyword expansion and/or comment prefix -H display this text then exit -I create and initialize a logfile -L[<rev>] lock a revision with intent to modify it -M[<desc>] specify a new revision description -N force negative response to all queries -O<owner id> change the owner of the logfile +P[E|K|L|T|W|D|C] add protection/attributes -P[E|K|L|T|W|D|C] remove protection/attributes -Q[N|O] quiet mode; suppress messages and queries -R[<rev>] specify the revision for -M -S<suffix> specify a suffix template -T[<desc>] specify workfile description directly or from stdin -U[<rev>] unlock a revision -V<vers>[:<rev>] assign a version name to a revision -V<vers>:delete delete a version name -V<nvers>::<vers> rename a version -W<workfile> modify the workfile name stored in the logfile -Y force affirmative response to all queries @[<file>] specify a file containing more options/files prompt pvcsvdiff vdiff PVCS VDIFF ───────────────────────────────────────────────────────────── Compare two files/revisions. Syntax: VDIFF [<options>] [<rev>] <reference file> [<rev>] <target file> Where: <rev> is -R[<revision>] or -V<version> Options: -A display all differences, particularly source of moves -B ignore leading and trailing whitespace on lines -C[<file>] specify a configuration file -D[<type>] generate a delta script to stdout -E[<number>] expand tabs to given number of characters per column -H display this text then exit -L[<number>] display the given number of context lines around changes -N omit line number information in display -Q quiet mode; suppress messages and queries -S<suffix> specify a suffix template -T test for difference only, do not display -XO<file> write output to file @[<file>] specify a file containing more options/files prompt pvcsvlog vlog PVCS VLOG ───────────────────────────────────────────────────────────── Display information about PVCS logfiles and revisions. Syntax: VLOG [<options>] <files> Options: -A<id list> display only for authors on the list -B display logfile information only -BL<id list> display only for revisions locked by names on list -BN[<branch>] display the newest revision number on the branch -BR[<rev>] display revision information only -BV[<version>] display only revisions corresponding to a version -C[<file>] specify a configuration file -D<date/time> display only for revisions in a date range -H display this text then exit -I suppress the normal indentation of branches -L[<id list>] display only for lockers on list or all locked revs -O<id list> display only for owners on list -Q[N|O] quiet mode; suppress messages and queries -R[<rev range>] display only for revisions in the range -S<suffix> specify a suffix template -V<version> display only for given version -W display revision tree width-first -XO<file> write output to file @[<file>] specify a file containing more options/files prompt pvcsindent indent PVCS IDENT ───────────────────────────────────────────────────────────── Display PVCS keyword strings from files. Syntax: IDENT [<options>] [<files>] Options: -H display this text then exit -XO<file> write output to file @[<file>] specify a file containing more options/files prompt pvcsregen regen PVCS REGEN ───────────────────────────────────────────────────────────── Regenerate a file from a reference file and a delta script. Syntax: REGEN [<options>] <reference file> <delta file> [> <target file>] Options: -H display this text then exit -XO<file> write output to file @[<file>] specify a file containing more options/files prompt pvcsvjournal vjournal PVCS VJOURNAL ───────────────────────────────────────────────────────────── Display portions of a PVCS journal file. Syntax: VJOURNAL [<options>] <journal files> Options: -D<date range> display only for entries within the date range -H display this text then exit -L<log list> display only for entries involving certain logfiles -O<op list> display only for entries involving certain operations -U<id list> display only for entries involving certain users -XO<file> write output to file @[<file>] specify a file containing more options/files prompt pvcsvcompress vcompress PVCS VCOMPRESS ───────────────────────────────────────────────────────────── Compress or decompress PVCS logfiles. Syntax: VCOMPRES [<options>] <logfiles> Options: -C[<file>] specify a configuration file -D compress/uncompress deltas only -H display this text then exit -Q[N|O] quiet mode; suppress messages and queries -U uncompress the logfiles -W compress/uncompress the work image only @[<file>] specify a file containing more options/files If no options are specified, compression is performed on both work image and delta records. prompt pvcsvdel vdel PVCS VDEL ───────────────────────────────────────────────────────────── Delete revisions from PVCS logfiles. Syntax: VDEL [<options>] <files> Options: -C[<file>] specify a configuration file -H display this text then exit -Q[O] quiet mode; suppress messages and queries -R[<rev range>] specify the range of revisions to delete -S<suffix> specify a suffix template -V<version> specify a revision to delete -Y force affirmative response to all queries @[<file>] specify a file containing more options/files prompt pvcsvmrg vmrg PVCS VMRG ───────────────────────────────────────────────────────────── Merge two sets of changes with respect to a common base. Syntax: VMRG [<options>] [<rev>] <basefile> [<rev>] <file1> [<rev>] <file2> Where: <rev> is -R[<revision>] or -V<version> Options: -A automatic merge mode -C[<file>] specify a configuration file -H display this text then exit -M multiple merge mode -N force negative response to all queries -O[<file>] specify merge output file -P pipe merge product to stdout -S<suffix> specify a suffix template -XO[<file>] write merge output to file or stdout -Y force affirmative response to all queries @[<file>] specify a file containing more options/files prompt pvcsvname vname PVCS VNAME ───────────────────────────────────────────────────────────── Generate PVCS logfile names. Syntax: VNAME [<options>] <workfiles> Options: -C[<file>] specify a configuration file -H display this text then exit -L report logfile name (default) -Q[N|O] quiet mode; suppress messages and queries -W report workfile name as stored in logfile @[<file>] specify a file containing more options/files calculator CALCULATOR KEY ASSIGNMENTS ───────────────────────────────────────────────────────────── Display Key Description Item ───────────────────────────────────────────────────────────── Left Press - Process item under mouse cursor 0-7 0-7 - Enter decimal, hex, octal value 8-9 8-9 - Enter decimal value A-F a-f,A-F - Enter hex value - - - Perform arithmetic calculation + + - Perform arithmetic calculation DIV / - Div operator MOD % - Modulus operator x *,x,X - Perform multiplication calculation & & - Logical AND operation | | - Logical OR operation <ENTER> - Display result = = - Display result SCP <INS> - Copy current value to scrap Shf <Ctrl-S> - Shift operation Dec <Ctrl-D> - Enter Decimal mode display Hex <Ctrl-H> - Enter Hex mode display Oct <Ctrl-O> - Enter Octal mode display 1sC <Ctrl-!> - Ones compliment of current value ± <Ctrl-minus> - Negate current value Rcl <Ctrl-R> - Recall previously saved value sTo <Ctrl-T> - Store current value Clr <Ctrl-C> - Clear current calculation oFF <Ctrl-F> - Exit calculator <ESC> - Exit calculator 
