home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Black Box 4
/
BlackBox.cdr
/
editors
/
qedcmds.arj
/
COMMANDS.QED
Wrap
Text File
|
1991-09-10
|
58KB
|
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><B><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><B><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><I>
-------------------------------------------------------------------------
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><B><B>
-------------------------------------------------------------------------
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><B><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><B><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><B><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><P> or <Esc><F><P>
-------------------------------------------------------------------------
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><P>
-------------------------------------------------------------------------
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><P><A>
-------------------------------------------------------------------------
Prints the entire contents of the current file.
PrintBlock <Alt P><B> or <Esc><P><B>
-------------------------------------------------------------------------
Prints the entire contents of the marked Block. The marked Block
must be in the current file.
PrintEject <Alt P><F> or <Esc><P><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><P><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><P><T>
[SetPrintBotMargin] <ESC><P><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><P> or <Esc><P><P>
-------------------------------------------------------------------------
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><P>
-------------------------------------------------------------------------
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><B>
-------------------------------------------------------------------------
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><I>
-------------------------------------------------------------------------
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><U>
-------------------------------------------------------------------------
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><B><U>
-------------------------------------------------------------------------
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.