Black Box 4

home *** CD-ROM | disk | FTP | other *** search

/ Black Box 4 / BlackBox.cdr / editors / qedcmds.arj / COMMANDS.QED

Wrap

Text File | 1991-09-10 | 57.0 KB | 1,526 lines

This file contains a description for each of the QEdit commands, up through the most recent version (2.15, 09-04-91). All commands documented in read.me files over the last several releases are included. Where appropriate, the default key assignments are provided. Additionally, <Esc> sequences are given for those commands which can be accessed through the "Pop-Down" menus. I have this file hooked to a key in QEdit so I can search for things forgotten as needed. My macro (in qconfig.dat) for this is: @q MacroBegin EditFile "c:\qedit\commands.qed" Return Find Pause Return "I" Return [all on one line] Offered by J. McKearney, Sept 11, 1991 ======================================================================== AddLine <F2> or <Esc><E><A> ------------------------------------------------------------------------- Adds a blank line after the cursor line, placing the cursor on the newly created line. The cursor column does not change. Align ------------------------------------------------------------------------- Aligns the text on the cursor line with the text on the line immediately before the cursor line and then positions the cursor on the next line. The cursor column does not change. If the cursor is on line one, or the previous line is blank, or the cursor line is blank, this command will only move the cursor to the next line. AltWordSet ------------------------------------------------------------------------- Instructs QEdit to recognize an alternate set of characters as "word" characters. By default, QEdit considers the following characters to be "word" characters: '0' thru '9', 'A' thru 'Z', 'a' thru 'z', and '_'. All other characters are considered word delimiters. QEdit also has an alternate word set that can be installed, using this command. AltWordSet adds the following characters to the default word set: \ ! # $ % & ' ( ) , - . / @ { } ~. (Currently, AltWordSet is used in the "edit filename at cursor" macro.) The default word set can be re-installed by executing the DefaultWordSet command. AppendScrbuff <Ctrl BA> ------------------------------------------------------------------------- Appends the currently marked Block to the end of the named Scratch Buffer. The existing contents of the named Scratch Buffer are not lost. If the named Scratch Buffer does not exist, a new Scratch Buffer will be created. [AsciiChart] ------------------------------------------------------------------------ Displays a scrollable ASCII chart on the screen. Backspace <Backspace> ------------------------------------------------------------------------- If Insert mode is ON: Deletes the character to the left of the cursor. The text to the right of, and including the cursor position, shifts left one position. If the cursor is in column one, the cursor line is appended to the end of the preceding line. If Insert mode is OFF: Deletes the character to the left of the cursor. The text to the right of the cursor does NOT close in or shift. If the cursor is in column one, however, the cursor line will still be appended to the end of the previous line. BegFile <Ctrl PgUp> ------------------------------------------------------------------------- Positions the cursor at column one on the first line of the current file. BegLine <Home> ------------------------------------------------------------------------- Positions the cursor at column one of the current cursor line. BegScreen <Ctrl Home> ------------------------------------------------------------------------- Positions the cursor at the top line of the current window. The cursor column does not change. [CenterLine] <^OT> ------------------------------------------------------------------------ If the cursor is inside a column block, the lines encompassed by the block are centered using the left and right columns of the block as the margins. If the cursor is inside a line block, the lines encompassed by the block are centered using column 1 and the right margin as the margins. Otherwise, the line the cursor is on is centered, using column 1 and the right margin as the margins. ChangeFilename <Alt O> or <Alt F><C> or <Esc><F><C> ------------------------------------------------------------------------- Changes the name of the current file. QEdit will prompt for the new name. If the file already exists, you will be required to confirm that you still want to rename the file. The current file is marked as being a changed file. (An asterisk will appear on the Status Line preceding the filename.) This command will have no effect on disk files, until the renamed file is saved. CloseWindow <Ctrl OC> or <Esc><W><C> ------------------------------------------------------------------------- Closes the current window, unless it is the only window which is open, in which case the command has no effect. Copy <grey +> ------------------------------------------------------------------------- Copies the marked Block into the Scrap Buffer. The Block is then unmarked. If no Block is marked, the cursor line is copied into the Scrap Buffer. The copying of the cursor line, when a Block is not marked, is configurable. Refer to the "Advanced Options" section of Chapter 2 for more information. CopyBlock <Alt C> or <Esc><C> ------------------------------------------------------------------------- Copies the marked Block to the cursor position. If the Block is a character Block (created using the DropAnchor, MarkCharacter, or MarkBlockBegin/End commands) or a column Block (created using the MarkColumn command), the Block is inserted into the text beginning at the current cursor position. If the Block is a line Block (created using the MarkLine command), it is inserted before or after the current cursor line, depending on the configuration setting (Refer to the "General Options" section of Chapter 2 for more information). The Block remains marked. Blocks may be copied from one file to another. CopyOverBlock <Alt Z> ------------------------------------------------------------------------- Copies the currently marked column Block and places it at the current cursor position by overlaying existing text and without shifting text to the right. This command only works with column Blocks. The Block remains marked. Blocks may be "copied over" from one file to another. CurrentFilename ------------------------------------------------------------------------- Returns the name of the currently edited file, as if it had been typed at the keyboard. This command is useful for manipulation of files from within macros. It may only be used in response to QEdit prompting for a filename. CursorDown <Cursor Down> ------------------------------------------------------------------------- Moves the cursor downward in the file to the next line. CursorLeft <Cursor Left> ------------------------------------------------------------------------- Moves the cursor one character to the left. When the cursor reaches the left edge of the screen, it stops, unless the text has been scrolled left, in which case the text scrolls right one position. CursorRight <Cursor Right> ------------------------------------------------------------------------- Moves the cursor one character to the right. When the cursor reaches the right end of the screen, the text starts scrolling left until the cursor reaches the maximum line length. CursorUp <Cursor Up> ------------------------------------------------------------------------- Moves the cursor upward in the file to the previous line. Cut <grey -> ------------------------------------------------------------------------- Copies the marked Block into the Scrap Buffer. The Block is then deleted from the file being edited. If no Block is marked, the cursor line is cut into the Scrap Buffer. The cutting of the cursor line, when a Block is not marked, is configurable. Refer to the "Advanced Options" section of Chapter 2 for more information. DefaultWordSet ------------------------------------------------------------------------ Re-installs the default editor word set. See the AltWordSet command for a description of editor "word" characters. DelCh <Del> ------------------------------------------------------------------------- Deletes the character at the current cursor position. The line to the right of the cursor shifts left one position. If the cursor position is past the last character on the line, the next line is appended to the cursor line. The "joining" of the next line when the cursor is past the last character on the line is configurable. Refer to the "General Options" section of Chapter 2 for more information. DeleteBlock <Alt G> or <Esc><D> ------------------------------------------------------------------------- Deletes the currently marked character or line Block. If there is not a Block marked in the current file, this command has no effect. Use the Cut command to delete a column Block. DelLine <Alt D> or <Esc><E><D> ------------------------------------------------------------------------- Deletes the cursor line. The line following the cursor line becomes the new cursor line. DelLtWord <Ctrl Backspace> ------------------------------------------------------------------------- Deletes the "word" to the left of the cursor. If the cursor is in column one, the cursor line is appended to the end of the preceding line. DelRtWord <Ctrl T> ------------------------------------------------------------------------- Deletes the "word" to the right of the cursor. If the cursor position is past the last character on the line, the next line is appended to the cursor line. DelToEol <F6> or <Esc><E><E> ------------------------------------------------------------------------- Deletes text on the cursor line, from the cursor position to the end of line. Dos <Alt F9> ------------------------------------------------------------------------- QEdit prompts for a command, which is passed to DOS for execution. After the command is executed by DOS, control is returned to QEdit. If you want to execute a series of commands in DOS, you should use the Shell command, described later in this chapter. +---------------------------------+ | QEdit Tip: | | You should NOT execute any | | TSR (terminate and stay | | resident) programs here. | | These include the DOS print | | and graph commands and | | memory-resident programs | | such as Sidekick and Superkey.| +---------------------------------+ DropAnchor <Alt A> ------------------------------------------------------------------------- This command is used to mark a character Block. Initially executing this command will mark one end of a Block at the cursor position. As the cursor is moved, the Block will "grow" with it. Executing this command again will mark the other end of the Block at the cursor position. If DropAnchor is executed in a file that already contains a character Block, the Block is extended to the current cursor position. DupLine <F4> ------------------------------------------------------------------------- Makes a copy of the current cursor line and inserts the copy immediately following the cursor line. The cursor is moved to the new line. EditFile <Alt E> or <Alt F><L> or <Esc><F><L> ------------------------------------------------------------------------- The editor prompts for the name(s) of the additional file(s) to be edited. Wildcard characters (* or ?) are permissible, as are multiple filenames. The editor will not load multiple copies of the same file. If you issue the EditFile command using the name of a file that has already been loaded, QEdit will simply make that file the current file. EndFile <Ctrl PgDn> ------------------------------------------------------------------------- Positions the cursor on the last line of the file immediately following the last non-blank character. If the last line of the file is blank, the cursor is positioned in column one. EndLine <End> ------------------------------------------------------------------------- Positions the cursor immediately following the last non-blank character on the cursor line. EndPara ------------------------------------------------------------------------ Positions the cursor just past the last character of the current paragraph. EndScreen <Ctrl End> ------------------------------------------------------------------------- The cursor is positioned on the last line of the current window. The cursor column does not change. Escape <Esc> ------------------------------------------------------------------------- If executed while editing, the "Pop-Down" menus are displayed. Otherwise, this command aborts any editor prompt. ExecuteScrap <Ctrl Enter> ------------------------------------------------------------------------- Plays back the latest macro that was created using the MacroRecord command. Exit <Ctrl KD> ------------------------------------------------------------------------- Conditionally discards the current file. If the file has not been modified, the file is discarded without prompting. If the file has been modified, the editor prompts with "Save Changes (Y/N)?". Pressing <Y> will save and then discard the file. Pressing <N> will discard the file without saving any changes. QEdit can be configured, when only a single file is being edited and the Exit command is issued, to either terminate or prompt for another file to edit. Refer to the "General Options" section of Chapter 2 for more information. File <Ctrl KX> or <Alt F><F> or <Esc><F><F> ------------------------------------------------------------------------- Saves and then discards the current file. QEdit can be configured, when only a single file is being edited and the File command is issued, to either terminate or prompt for another file to edit. Refer to the "General Options" section of Chapter 2 for more information. [FillBlock] <^KL> ----------------------------------------------------------------------- The user is prompted for a character with which to fill the block. With this command, you can now use the following macro to move a block, and blank fill the space used by the block, instead of the text closing in around the block. The macro assumes a block is already marked. The block will be [Cut] to the clipboard or system scrap buffer. You can then insert the block where you like by pressing the [Paste] key <Grey *>: f10 MacroBegin GotoBlockBeg Cut Paste FillBlock ' ' Return UnmarkBlock Choose a key (<f10> in the above example), and assign this macro to it in the QCONFIG.DAT file. Run QCONFIG, configure the keyboard, and you now have a "copy with wipe" command! Find <Ctrl QF> or <Esc><S><F> ------------------------------------------------------------------------- Searches for a specified string of characters within the current file. The User is prompted for a search string and search options. Available search options are: [I] Ignore the case of the search string. [W] Search for whole words only. [B] Search backwards from the current cursor position. FindReplace <Ctrl QA> or <Esc><S><R> ------------------------------------------------------------------------- Searches and replaces strings within the current file. The User is prompted for a search string, a replace string, and options. Available options are: [I] Ignore the case of the search string. [W] Search for whole words only. [B] Search backwards from the current cursor position. [N] Find and replace without prompting. At every occurrence of the search string in the file, the User is given the following replace options. [Y] Replace the search string with the replace string and continue on to the next occurrence of the search string. [N] Do not make any changes but continue on to the next occurrence of the search string. [O] Replace the search string with the replace string and then terminate the FindReplace process. [G] Replace the search string with the replace string for this and all occurrences throughout the file without any further prompting. [Q] Terminate the FindReplace process. [FirstNonWhite] -------------------------------------------------------------------------- Intended as a replacement and/or supplement to the [BegLine] command. Places the cursor at the first non-white character on the line, or column 1 if the line doesn't have any non-white characters. "White" characters are tabs or spaces. A useful macro would be: Home MacroBegin BegLine JTrue done: FirstNonWhite done: (Explanation: If already at the start of a line, go to the first non-white character on the line; otherwise, if not already at the start of a line, go to the start of the line. Flip <Alt 3> ----------------------------------------------------------------------- Changes the case of a character or Block of characters. If the cursor is in a marked Block, all characters in the Block are "reversed": lower case characters are changed to upper case, and upper case characters are changed to lower case. If the cursor is not in a marked Block, only the character at the current cursor location is reversed. GetPrev <Ctrl - (dash)> ------------------------------------------------------------------------- Duplicates the character immediately above the cursor at the cursor position. GetScrbuff <Ctrl BL> ------------------------------------------------------------------------- Inserts the contents of the named Scratch Buffer at the cursor position. Refer to the "Block Commands" section of Chapter 1 for more information. GExit <Alt X> or <Alt Q><X> or <Esc><Q><X> ------------------------------------------------------------------------- Issues the Exit command for all files that have been loaded. If no files have been modified, this command immediately terminates the editor and returns control to DOS. If any files have been modified you are prompted with "Save Changes (Y/N)?" for each modified file. For example, if you have ten files loaded and two of them have been modified, then you will be prompted to save changes twice, once for each modified file. GFile <Alt F><G> or <Esc><F><G> ------------------------------------------------------------------------- Instructs the editor to discard all files which have been loaded. Any files which have been modified will be saved. If no files have been changed, this command immediately terminates the editor and returns control to DOS. GotoBlockBeg <Ctrl QB> ------------------------------------------------------------------------- Positions the cursor at the beginning of the currently marked Block. If the Block is in a file other than the current file, the file containing the Block becomes the new current file. GotoBlockEnd <Ctrl QK> ------------------------------------------------------------------------- Positions the cursor at the end of the currently marked Block. If the Block is in a file other than the current file, the file containing the Block becomes the new current file. GotoColumn ------------------------------------------------------------------------- Prompts for a column number, and positions the cursor at that column on the current line. GotoLine <Ctrl J> ------------------------------------------------------------------------- Positions the cursor at the requested line. The editor will prompt for the desired line number. GPQuit <F3> or <Alt Q><Q> or <Esc><Q><Q> ------------------------------------------------------------------------- Issues the PQuit command for all files that have been loaded. GrowWindow <Ctrl OG> or <Esc><W><G> ------------------------------------------------------------------------- Increases the size of the current window if there are multiple windows on the screen. The editor will prompt for the direction in which to increase the size. The ShrinkWindow command can be executed from this prompt to decrease the window size. GSave <Alt Y> ------------------------------------------------------------------------- Issues the SaveFile command for all files that have been modified. HalfPgDn ------------------------------------------------------------------------- Scrolls the text toward the end of the file one-half page. HalfPgUp ------------------------------------------------------------------------- Scrolls the text toward the beginning of the file one-half page. HorizontalWindow <Ctrl OH> or <Esc><W><S> ------------------------------------------------------------------------- Splits the screen or current window horizontally, creating a new window. Up to eight windows may be displayed on the screen at one time. InsertDate ------------------------------------------------------------------------- Inserts the system date at the current cursor position. InsertLine <Alt F2> or <Esc><E> ------------------------------------------------------------------------- Inserts a blank line above the cursor line and positions the cursor on the newly created line. The cursor column does not change. InsertTime ------------------------------------------------------------------------- Inserts the system time at the current cursor position. [isBegLine] ------------------------------------------------------------------------- Returns TRUE if the cursor is at column 1; otherwise, FALSE is returned. [isEndLine] ------------------------------------------------------------------------- Returns TRUE if the cursor is past the last non-white character on the current line; otherwise, FALSE is returned, including the case when the cursor is on an empty line. [isEmptyLine] ------------------------------------------------------------------------- Returns TRUE if the current line is empty or contains only white space; otherwise, FALSE is returned. [isLastLine] ------------------------------------------------------------------------- Returns TRUE if the cursor is on the last line of the currently edited file; otherwise, FALSE is returned. [isFirstLine] ------------------------------------------------------------------------- Returns TRUE if the cursor is on the first line of the currently edited file; otherwise, FALSE is returned. [isCursorInBlock] ------------------------------------------------------------------------- Returns TRUE if the cursor is inside a marked block; otherwise, FALSE is returned. JoinLine <Alt J> or <Esc><E><J> ------------------------------------------------------------------------- Joins the line below the cursor line to the end of the cursor line. If the cursor is past the end of the line, then the line is joined at the cursor position. [JTrue], [JFalse] and [Jump] commands. ----------------------------------------------------------------------- These commands are intended for macro use. All QEdit commands set an internal QEdit result code of "True" if they executed successfully, or "False" if they did not. The [JTrue] and [JFalse] commands can be used to take advantage of that fact. [Jump] is just an unconditional jump. You can also define labels for branching, in the format "label:". The maximum label length is 15 characters. For Example: A command to delete from the cursor position to the beginning of the line, assigned to the f10 key: f10 MacroBegin begin: CursorLeft JFalse done: DelCh Jump begin: done: This MUST all occur on ONE LINE in your QCONFIG.DAT file. KillFile <Ctrl KZ> ------------------------------------------------------------------------- Erases the currently edited file from disk. The file remains loaded in the editor and is marked as being a changed file. (An asterisk will appear on the Status Line preceding the filename.) This command is very useful when available disk space is low. LineDown ------------------------------------------------------------------------- Scrolls the text one line at a time toward the end of the file. The cursor remains stationary on the screen. LineUp ------------------------------------------------------------------------- Scrolls the text one line at a time toward the beginning of the file. The cursor remains stationary on the screen. [ListFiles] ------------------------------------------------------------------------ Displays a list of the currently loaded files. To switch to another file, move the cursor to the appropriate file and press <Enter>. To keep editing the current file, press <Escape>. Literal <Ctrl P> ------------------------------------------------------------------------- Causes the editor to literally interpret the keystroke that is entered immediately following this command. It is used to insert control characters into the currently edited file. For example, to insert the ASCII form-feed character (ASCII 12), you would first press <Ctrl P> then <Ctrl L>. To insert a "null" character into the file, press <Ctrl P> and then <Ctrl 2>. (Note: The "2" must be the "2" key on the alphanumeric keyboard, NOT the key on the numeric keypad.) Refer to the "Adding Text" section of Chapter 1 for more information. Lower <Alt 2> ------------------------------------------------------------------------- Converts a character or Block of characters to lower case. If the cursor is in a marked Block, the entire Block is converted to lower case; otherwise, only the character at the current cursor location is converted. MacroRead <Esc> <M><R> ------------------------------------------------------------------------- Loads the named macro file, with all macros contained therein, from disk into the editor's internal macro buffer. The macros are assigned to the keys exactly as they were originally recorded and saved. The editor prompts the User for the name of the file. MacroRecord <Ctrl M> or <Esc><M><M> ------------------------------------------------------------------------- Toggles (ON and OFF) macro recording. If macro recording is OFF, this will turn macro recording ON and prompt for a key to which to assign the macro. After pressing the desired key (see Appendix B for a list of available keys), all following keystrokes are recorded until the MacroRecord key is pressed again. After the macro has been recorded, it can be played back by pressing the key to which the macro was assigned. Instead of assigning a macro to a specific key, it can be assigned to a "scrap" or temporary area by simple pressing <Enter> at the prompt. A macro assigned to the scrap area may be played back by entering the ExecuteScrap <Ctrl Enter> command. The scrap area will be updated each time the MacroRecord command is executed. MacroWrite <Esc> <M><W> ------------------------------------------------------------------------- Saves all currently defined macros to a binary disk file. The editor prompts for the name of the file. MainMenu <Esc> ------------------------------------------------------------------------- Activates the "Pop-Down" style menu system. Many of the editor's commands can be executed via the menus. MakeBotofScreen ------------------------------------------------------------------------- Scrolls the text in the window so that the cursor line becomes the bottom line of the window. MakeCtrofScreen <Shift F5> ------------------------------------------------------------------------- Scrolls the text in the window so that the cursor line becomes the center line of the window. MakeTopofScreen <F5> ------------------------------------------------------------------------- Scrolls the text in the window so that the cursor line becomes the top line of the window. MarkBlockBegin <Ctrl KB> or <Esc> ------------------------------------------------------------------------- Marks the beginning of a character Block. The Block is not shown until the MarkBlockEnd command is executed at some position beyond the beginning position of the Block. For an alternate method of marking character Blocks, refer to the DropAnchor and MarkCharacter commands. MarkBlockEnd <Ctrl KK> or <Esc><E> ------------------------------------------------------------------------- Marks the end of a character Block. The Block is not shown until the MarkBlockBegin command is also executed at some position before the end of the Block. For an alternate method of marking character Blocks, refer to the DropAnchor and MarkCharacter commands. MarkCharacter ------------------------------------------------------------------------- This command is used to mark a character Block. It is similar to the DropAnchor command except the cursor position is NOT included as part of the Block. This command is provided as a replacement for the DropAnchor command. If you want the cursor position included in character Blocks, then continue to use DropAnchor; otherwise, replace the DropAnchor command with this command. MarkColumn <Alt K> ------------------------------------------------------------------------- This command is used to mark a column Block. Initially executing this command will mark the current cursor position. As the cursor is moved, the Block will "grow". Executing this command again will mark the other end of the Block at the current cursor position. If MarkColumn is executed in a file that already contains a Block, the Block is extended to the current cursor position. MarkLine <Alt L> or <Esc><L> ------------------------------------------------------------------------- This command is used to mark a line Block. Initially executing this command will mark the current cursor line. As the cursor is moved, the Block will "grow" with it line by line. Executing this command again will mark the other end of the Block at the current cursor line. If MarkLine is executed in a file that already contains a Block, the Block is extended to the current cursor line. MarkWord <Ctrl KT> ------------------------------------------------------------------------ Marks, as a Block, the word at the current cursor location. If the cursor is not located within a word, no Block is marked. Match <Alt F3> ------------------------------------------------------------------------- Will find the corresponding "(", ")", "{", "}", "[", "]" character. This command is primarily intended for programming languages in which complicated expressions are grouped with one or more of these characters. This command is very useful for finding unmatched parentheses. MoveBlock <Alt M> or <Esc><M> ------------------------------------------------------------------------- Moves (copies and deletes) the currently marked Block to the cursor position. If the Block is a character Block (created using the DropAnchor, MarkCharacter, or MarkBlockBegin/End commands) or a column Block (created using the MarkColumn command), the Block is inserted into the text beginning at the current cursor position. If the Block is a line Block (created using the MarkLine command), it is inserted before or after the current cursor line, depending on the configuration setting (Refer to the "General Options" section of Chapter 2 for more information). The Block remains marked. Blocks may be moved from one file to another. NewFile ------------------------------------------------------------------------- Issues the Exit and EditFile commands for the current file. NextFile <Alt N> or <Alt F><N> or <Esc><F><N> ------------------------------------------------------------------------- Makes the next file in the ring the new current file when multiple files are loaded. NextPara ------------------------------------------------------------------------ Positions the cursor at the beginning of the next paragraph. NextWindow <Ctrl ON> or <Esc><W><N> ------------------------------------------------------------------------- Makes the window below the current window the new current window. If the current window is at the bottom of the screen, the top window on the screen will become the current window. OneWindow <Ctrl OO> or <Esc><W><O> ------------------------------------------------------------------------- Closes all windows except the current window and expands it to occupy the entire screen. PageDown <PgDn> ------------------------------------------------------------------------- Scrolls the text toward the end of the file, one page-full less one line, at a time. PageUp <PgUp> ------------------------------------------------------------------------- Scrolls the text toward the top of the file, one page-full less one line, at a time. Paste <grey *> ------------------------------------------------------------------------- Inserts the contents of the Scrap Buffer at the cursor position. The Scrap Buffer is loaded using the Cut or Copy commands. If the Scrap Buffer contains a character or column Block, it is inserted at the cursor position. If the Scrap Buffer contains a line Block, it is inserted before or after the cursor line depending on the configuration setting. Refer to the "General Options" section of Chapter 2 for more information. PasteOver <Ctrl PrtSc> ------------------------------------------------------------------------- This is a Paste command for column Blocks. It takes a column Block which has been loaded into the Scrap Buffer using the Cut or Copy commands and places it at the current cursor position by overlaying existing text and without shifting text to the right. Pause ------------------------------------------------------------------------ Temporarily halts macro execution, until either Return or Escape is pressed. If Return is pressed, the macro resumes where it left off. If Escape is pressed, the macro is terminated. This command is provided to allow for input to macros. In previous versions of QEdit, there was not a way to allow a macro to stop and wait for input from the user. This command now makes user input possible. The new Pause command makes certain types of macros now possible. For example, suppose you wanted to create a "find" command that always searched forward, ignored case, and didn't prompt you for options. In the QCONFIG.DAT file, assign to whatever key you like (<f7> in this example): f7 MacroBegin Find Pause Return 'i' Return If you wanted to get really fancy, you could let <f7> be your find-forward, and <shift f7> be your find-backward: #f7 MacroBegin Find Pause Return 'ib' Return Note that the Pause command "eats" the Return or Escape that terminates the pause mode. PQuit <Ctrl KQ> or <Alt F><Q> or <Esc><F><Q> ------------------------------------------------------------------------- This command initiates a protected quit. If the current file has not been modified, it is discarded. If the current file has been modified, the User is warned that changes will be lost. If multiple files are being edited, this command will make the previous file in the ring the new current file. QEdit can be configured, when only a single file is being edited and the PQuit command is issued, to either terminate or prompt for another file to edit. Refer to the "General Options" section of Chapter 2 for more information. PrevFile <Ctrl KP> or <Alt F> or <Esc><F> ------------------------------------------------------------------------- Makes the previous file in the ring the new current file when multiple files are loaded. PrevPara ----------------------------------------------------------------------- Positions the cursor at the beginning of the previous paragraph. PrevPosition <Ctrl QP> ------------------------------------------------------------------------- Positions the cursor at the previous cursor position. Very helpful when used with the GotoLine command. The GotoLine line can be used to go directly to a certain area of the file. The PrevPosition can then be used to return you to the original cursor position. PrevWindow <Ctrl OP> or <Esc><W> ------------------------------------------------------------------------- Makes the window above the current window the new current window. If the current window is at the top of the screen, the bottom window on the screen will become the current window. PrintAll <Alt P><A> or <Esc><A> ------------------------------------------------------------------------- Prints the entire contents of the current file. PrintBlock <Alt P> or <Esc> ------------------------------------------------------------------------- Prints the entire contents of the marked Block. The marked Block must be in the current file. PrintEject <Alt P><F> or <Esc><F> ------------------------------------------------------------------------- Sends a formfeed character (ASCII 12) to the printer. QuickHelp <F1> or <Alt H> ------------------------------------------------------------------------- Displays the Help Screen. A Help Screen is provided with QEdit; however, you may wish to design your own Help Screen. For more information, refer to the "The Help Screen" section of Chapter 2. Quit ------------------------------------------------------------------------- Unconditional quit. The current file is discarded regardless of any changes made to it. This command is for those who do not like software that "nags" you. USE WITH CAUTION! ReadBlock <Alt R> or <Alt F><R> or <Esc><F><R> ------------------------------------------------------------------------- Inserts the named disk file at the current cursor position. [RepeatCmd] <^QQ> ------------------------------------------------------------------------ Repeats the last executed command and/or macro "n" times. You are prompted for "n". You can stop the repeating at any time by pressing the <^Break> key. If the result code from the command is FALSE, or if a result code from any of the commands in the macro is FALSE, repetition halts. RepeatFind <Ctrl L> or <Esc><S><A> ------------------------------------------------------------------------- Repeats the previous Find or FindReplace command. Return <Enter> ------------------------------------------------------------------------- The Return command behaves differently depending on Insert mode and AutoIndent mode. If Insert mode is OFF, the cursor is positioned at the first column of the next line. If Insert mode is ON, the current cursor line is split at the cursor position and any text to the right of and including the cursor position is placed on a new line following the current line. If the cursor is past the last character on the line, then a blank line is added following the current line. The cursor is then moved to the first column of the new line. If AutoIndent is ON, spaces are inserted ahead of the cursor position to align it with the text on the previous line. If AutoIndent is OFF, the text is moved to the beginning of the next line. The Return command can be configured to split or not to split lines when Insert mode is ON. Refer to the "Advanced Options" section of Chapter 2 for more information. SaveFile <Ctrl KS> or <Alt F><S> or <Esc><F><S> ------------------------------------------------------------------------- Saves to disk the file currently being edited. The file remains loaded, ready for further editing. [SaveSettings] ------------------------------------------------------------------------- Saves the current settings of: Insert, AutoIndent, WordWrap, Sound, and Screen Updating. [RestoreSettings] ------------------------------------------------------------------------- Restores the saved settings, listed above. ScreenLeft <Alt F5> ------------------------------------------------------------------------- Shifts the screen to the left, the number of columns specified in the configuration program. Refer to the "Colors/Screen Options" section of Chapter 2 for more information. ScreenRight <Alt F6> ------------------------------------------------------------------------- Shifts the screen to the Right, the number of columns specified in the configuration program. Refer to the "Colors/Screen Options" section of Chapter 2 for more information. ScrollDown <Ctrl Z> ------------------------------------------------------------------------- Scrolls the text one line at a time toward the end of the file. The cursor remains on the same line of text until it reaches the top of the screen. ScrollUp <Ctrl W> ------------------------------------------------------------------------- Scrolls the text one line at a time toward the beginning of the file. The cursor remains on the same line of text until it reaches the bottom of the screen. SetCtabwidth <Esc><O><C> ------------------------------------------------------------------------- Sets the cursor tab width. This is the width that is used when the TabRt or TabLt commands are executed. SetEGA25 ------------------------------------------------------------------------- Switches a monitor with an EGA or VGA card to 25-line mode. This command has no effect if the video card is not an EGA or VGA type. SetEGA43 ------------------------------------------------------------------------- Switches a monitor with an EGA or VGA card to 43-line mode or 50-line mode, respectively. This command has no effect if the video card is not an EGA or VGA type. SetPrintLeftMargin <Alt P><L> or <Esc><L> ------------------------------------------------------------------------- Sets the number of spaces to be printed as a left margin at the beginning of each line. The default is zero. [SetPrintTopMargin] <ESC><T> [SetPrintBotMargin] <ESC><O> ------------------------------------------------------------------------- Set the top and bottom margins used when printing. If QEdit's print page size is set to 0, these commands have no effect. SetPrintPageSize <Alt P> or <Esc> ------------------------------------------------------------------------- Sets the number of lines to be printed per page before sending a formfeed. A value of zero will allow continuous printing (no formfeeds sent). SetPtabwidth <Esc><O> ------------------------------------------------------------------------- Sets the Physical Tab Width. This determines the width to which physical tab characters found in files are expanded if Physical Tab Expansion is set ON. It also determines the number of spaces to be used for Tabs Out mode. Refer to the ToggleTabsExpand and ToggleTabsOut commands in this chapter for more information. SetRmargin <Ctrl OR> or <Esc><O><R> ------------------------------------------------------------------------- Sets the right margin for word-wrap and paragraph reformatting. WordWrap mode is automatically switched ON whenever the right margin is set using this command. [SetInsMode] ---------------------------------------------------------------------- Sets Insert mode on. To set Insert mode off (that is, set overwrite mode on), do the following: SetInsMode ToggleInsert [SetAutoIndentMode] --------------------------------------------------------------------- Sets AutoIndent mode on. To set AutoIndent mode off, do the following: SetAutoIndentMode ToggleIndent [SetWordWrapMode] ---------------------------------------------------------------------- Sets WordWrap mode on. To set WordWrap mode off, do the following: SetWordWrapMode ToggleWordWrap [SetSoundOn] ---------------------------------------------------------------------- Sets sound on. [SetSoundOff] ----------------------------------------------------------------------- Sets sound off. [SetScreenOn] ------------------------------------------------------------------------ Turns screen updating on. Most macros execute dozens of QEdit commands, possibly hundreds of times. This can cause the screen to flash rapidly as the macro runs. Not only is this somewhat disconcerting to watch, it actully slows down the speed of some macros. The following commands allow you to temporarily suspend or resume screen updating, while a macro is running. [SetScreenOff] ---------------------------------------------------------------------- Turns screen updating off. You must turn screen updating back on before your macro prompts for input, or if there is some output from the macro that you want displayed on the screen. NOTE: QEdit will AUTOMATICALLY turn screen updating back on when the macro is finished executing. Thus, it is not necessary to issue the SetScreenOff command at the end of the macro. Shell <F9> or <Alt F><O> or <Esc><F><O> ------------------------------------------------------------------------- Invokes a DOS shell. While in the shell, you can execute DOS and other commands. When you are ready to leave the shell, type "exit <Enter>". You will be back in QEdit, exactly where you left off. +---------------------------------+ | QEdit Tip: | | You should NOT execute any | | TSR (terminate and stay | | resident) programs here. | | These include the DOS print | | and graph commands and | | memory-resident programs | | such as Sidekick and Superkey.| +---------------------------------+ ShiftLeft <Shift F7> ------------------------------------------------------------------------- Shifts the contents of the currently marked Block (or the cursor line, if the cursor does not reside in a marked Block) one position to the left. If you issue this command when the leftmost character(s) of the line(s) being shifted is in column 1, that character(s) will be deleted to allow the remainder of the line to shift left one position. ShiftRight <Shift F8> ------------------------------------------------------------------------- Shifts the contents of the currently marked Block (or the cursor line, if the cursor does not reside in a marked Block) one position to the right. If you issue this command when the rightmost character(s) of the line(s) being shifted is in column 512, that character(s) will be deleted to allow the remainder of the line to shift right one position. ShowEntryScreen <Alt F10> ------------------------------------------------------------------------- Displays the original DOS screen as it appeared upon initial execution of the editor. Pressing any key will return you to the edit screen. ShrinkWindow <Ctrl OS> or <Esc><W><R> ------------------------------------------------------------------------- Decreases the size of the current window, if there are multiple windows on the screen. The editor will prompt for the direction in which to decrease the size. The GrowWindow command can be executed from this prompt to increase the window size. Sort <Shift F3> ------------------------------------------------------------------------ Sorts a group of lines using the currently marked column Block as the key and the range of lines to be sorted. This command is operational only when there is just one window on the screen, and that window is not zoomed. SplitLine <Alt S> or <Esc><E><S> ------------------------------------------------------------------------- Splits the current cursor line at the cursor position. Any text to the right of and including the cursor position is placed on a new line following the current line. If the cursor is past the last character on the line, then a blank line is added following the current line. The cursor position does not change. StoreScrbuff <Ctrl BS> ------------------------------------------------------------------------- Copies the currently marked Block to the named Scratch Buffer. The editor will prompt for the name of the Scratch Buffer. The contents of all Scratch Buffers are lost when the editor is terminated. TabLt <Shift Tab> ------------------------------------------------------------------------- Positions the cursor at the previous tab position, as defined by the tab width. If in Insert mode, the text to the right of, and including the cursor position, also shifts left. TabRt <Tab> ------------------------------------------------------------------------- Positions the cursor at the next tab position, as defined by the cursor tab width. If in Insert mode, the text to the right of, and including the cursor position, also shifts right. ToggleBakups <Esc><O> ------------------------------------------------------------------------- Toggles file backups ON and OFF. If ON, QEdit will create a backup file using the ".bak" file extension whenever a modified file is saved. ToggleBoxDraw <Shift F1> ------------------------------------------------------------------------- Toggles Box Drawing mode ON and OFF. If ON, the cursor movement keys (up, down, right, left) will "draw" lines in the text, both up/down and right/left. Very useful for creating charts and tables. The letter "B" will appear on the Status Line when this mode is ON. ToggleBoxType <Alt F1> ------------------------------------------------------------------------ Allows changing of the box characters used in box drawing. ToggleEGA43 <Ctrl F1> ------------------------------------------------------------------------- Toggles an EGA monitor between 25-line and 43-line mode or a VGA monitor between 25-line and 50-line mode. This command has no effect if the video card is not an EGA or VGA type. ToggleEnterMatching <Esc><O><E> ------------------------------------------------------------------------- Toggles EnterMatching mode ON and OFF. If ON, the double quote, parenthesis, and square bracket keys all automatically enter the matching character when the left character is entered. For example, typing the '[' key automatically enters a ']' immediately following. ToggleIndent <Ctrl QI> or <Esc><O><A> ------------------------------------------------------------------------- Toggles AutoIndent mode ON and OFF. If ON, the cursor is positioned at the current left margin whenever the <Enter> key is pressed. The current left margin is determined by the first non-blank character on the immediately preceding line. Paragraph reformatting and word-wrapping will also use the current left margin when AutoIndent mode is ON. The letter "A" will appear on the Status Line when this mode is ON. ToggleInsert <Ins> or <Esc><O> ------------------------------------------------------------------------- Toggles Insert mode ON and OFF. If ON, text to the right of the cursor on the cursor line is shifted whenever characters, spaces, the Backspace command, the TabLt command, or the TabRt command is entered. Also, entering the Return command will cause a line split at the current cursor position. The letter "I" will appear on the Status Line when this mode is ON. ToggleSmartTabs <Ctrl QT> ------------------------------------------------------------------------- Toggles Smart Tabs ON and OFF. If ON, the TabRt and TabLt commands will place the cursor beneath the beginning of the next (or previous) word on the line immediately above the current cursor line. If the line immediately above the cursor line is blank, then the cursor will not move. Smart Tabs mode should NOT be set ON while C mode is ON. [ToggleSwap] <ESC><O><S> ------------------------------------------------------------------------ Toggles Expanded memory/Disk swapping for the [Dos] and [Shell] commands. This option can also be set via QCONFIG. ToggleTabsExpand <Alt V> ------------------------------------------------------------------------ Toggles Physical Tab Expansion ON and OFF. If ON, physical tab characters (ASCII 9's) found in a file will be expanded into spaces according to the Physical Tab Width set in the configuration program. If OFF, physical tabs will be displayed on the screen and a physical tab character will be placed in the text each time the TabRt command is entered. ToggleTabsOut <Alt I> ------------------------------------------------------------------------- Toggles Tabs Out mode ON and OFF. If ON, continuous spaces in a line of text will be replaced with physical tabs (ASCII 9's) according to the Physical Tab Width set in the configuration program. Only spaces in edited lines are replaced with physical tabs. Spaces falling between single or double quotes will not be replaced. ToggleWordwrap <Ctrl OW> or <Esc><O><W> ------------------------------------------------------------------------- Toggles WordWrap mode ON and OFF. If ON, the cursor, along with the word currently being typed, will automatically advance to the next line whenever a character is typed beyond the right margin. The right margin can be permanently set using the configuration program (refer to the "General Options" section of Chapter 2 for more information) or temporarily changed using the SetRmargin command. The letter "W" will appear on the Status Line when this mode is ON. UndoCursorline <Ctrl QL> ------------------------------------------------------------------------- Reverses any changes made to the current cursor line (except changes made with the FindReplace command). If the cursor has been moved from the changed line or a file or window command is executed, the changes cannot be undone. UnKill <Ctrl U> or <Esc><E> ------------------------------------------------------------------------- Recovers the last deleted entry from the current file's Kill Buffer. Deleted blocks and lines will be inserted immediately before the current cursor line and deleted words will be inserted immediately before the current cursor position. The number of lines saved in the Kill Buffer may be set with the configuration program. Refer to the "General Options" section of Chapter 2 for more information. UnmarkBlock <Alt U> or <Esc> ------------------------------------------------------------------------- Unmarks the currently marked Block. Upper <Alt 1> ------------------------------------------------------------------------ Converts a character or Block of characters to upper case. If the cursor is in a marked Block, the entire Block is converted to upper case; otherwise, only the character at the current cursor location is converted. WordLeft <Ctrl Cursor Left> ------------------------------------------------------------------------- Positions the cursor at the first character of the previous word. WordRight <Ctrl Cursor Right> ------------------------------------------------------------------------- Positions the cursor at the first character of the following word. WrapPara <Alt B> ------------------------------------------------------------------------- Reformats text from the current cursor position until a blank line or end of file is encountered. If AutoIndent is ON, the line below the cursor line is used for the left margin. Otherwise, a left margin of zero is used. The right margin is determined by the configuration program or the SetRmargin command. WriteBlock <Alt W> or <Alt F><W> or <Esc><F><W> ------------------------------------------------------------------------- Writes the currently marked Block to the named file. The editor will prompt for the name of the file. ZoomWindow <Ctrl OZ> or <Esc><W><Z> ------------------------------------------------------------------------- Toggles Zoom mode ON and OFF. If there are multiple windows on the screen, entering the ZoomWindow command will cause the current window to fill the entire screen. Pressing ZoomWindow again restores the other windows to the screen.