Tsejr
Tsejr
(formerly QEdit(R))
Version 4
R E F E R E N C E M A N U A L
Please note that this is the shareware version of the documentation, and
has been abridged from the original document that accompanies the
registered version of the software. The licensed commercial version
includes the complete indexed, bound manual.
The SemWare(R) Editor Junior (TSE Jr.) software products were formerly
called QEdit(R) (QEdit Advanced, QEdit TSR, and QEdit for OS/2).
�������������������������������������������������������Ŀ
� �
� SALES AND SUPPORT �
� �
� SemWare Corporation �
� Suite C3A �
� 4343 Shallowford Road �
� Marietta, GA 30062-5022 �
� U.S.A. �
� �
� �
� Orders ONLY: (800) 467-3692 Inside USA, 9am-5pm ET �
� �
� Other Voice Calls: (770) 641-9002 9am - 5pm ET �
� �
� InterNet: [email protected] �
� or [email protected] �
� CompuServe: GO SEMWARE (select Section 6) �
� or 75300,2710 �
� �
� FAX: (770) 640-6213 24 hours �
� BBS: (770) 641-8968 24 hours �
� �
���������������������������������������������������������
_______
____|__ | (R)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
This version of The SemWare Editor Junior (the "Software") is NOT public
domain or free software, but is being distributed as "shareware" for
EVALUATION PURPOSES ONLY. Your use of this Software indicates your
agreement to the terms and conditions of this License.
USAGE RESTRICTIONS
������������������
SemWare grants a limited license to individuals to use this shareware
Software for a 30-day evaluation period on a private, non-commercial
basis, for the express purpose of determining whether TSE Jr. is suitable
for their needs. At the end of this 30-day evaluation period, the
individual must either purchase a license from SemWare for continued use
of the Software, or discontinue using TSE Jr.
What does this mean? If you use this Software on a continued basis, you
must purchase a license for its use. TSE Jr. is NOT free, and we are not
giving away free copies. We are giving you the opportunity to try it
before paying for a license for continued use. It is that simple. Try it
for 30 days. Then either pay for it, or quit using it.
Paying for a license to continue using the Software product is not only
required, but also allows SemWare to provide support and updates, and
stay in business. Licensed users receive printed documentation; a
built-in spelling checker; a macro compiler/decompiler (QMAC);
additional utilities and configuration files; and a version of the
program that does NOT show the opening and closing shareware reminder
screens. Registration of the licensed copy entitles the registered user
to receive technical support (by phone, fax, our own support BBS, mail,
or various electronic services such as CompuServe or InterNet), and
makes them eligible for discounts on future versions.
Purchasing a license for The SemWare Editor Junior entitles you to use
the Software on any and all computers available to you, provided you do
not operate the Software on more than one computer or terminal at a time
and you do not operate the Software on a network or a multi-user system.
If you would like a network or multi-user license, please contact
SemWare for details.
DISTRIBUTION, COPYING RESTRICTIONS
����������������������������������
Individuals are granted a limited license to copy the SHAREWARE version
of TSE Jr. only for the trial use of other individuals in accordance
with the limitations identified in this License, and subject to the
following restrictions:
1. You MAY NOT distribute the Software in connection with any other
product or service.
2. You MAY NOT make general use of the Software within a company,
institution, or agency.
3. You MAY NOT copy or distribute the Software for any consideration or
"disk fee".
4. You MAY NOT copy or distribute the Software in modified form. (Any
distribution must include ALL FILES supplied by SemWare with the
shareware version of The SemWare Editor Junior, WITHOUT ALTERATION.)
WARRANTY DISCLAIMER
�������������������
SEMWARE PROVIDES THE SHAREWARE VERSION OF THE SEMWARE EDITOR JUNIOR "AS
IS" AND WITHOUT ANY WARRANTY. TO THE EXTENT PERMITTED UNDER APPLICABLE
LAW, SEMWARE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO, ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE. SPECIFICALLY, SEMWARE MAKES NO REPRESENTATION OR
WARRANTY THAT THE SOFTWARE IS FIT FOR ANY PARTICULAR PURPOSE.
SEMWARE SHALL NOT BE LIABLE FOR ANY DAMAGES RESULTING FROM THE USE OF
THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO, LOSS OF PROFIT, DATA OR USE
OF THE SOFTWARE, OR INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
DAMAGES OR OTHER SIMILAR CLAIMS, EVEN IF SEMWARE HAS BEEN SPECIFICALLY
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE
EXCLUSION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE FOREGOING
LIMITATION MAY NOT APPLY TO YOU.
U. S. GOVERNMENT LICENSEES
��������������������������
If you are acquiring the Software on behalf of any unit or agency of the
United States Government, the following provisions apply:
Purchasing a license for TSE Jr. allows you to use the product on a
regular and/or continuing basis. Registration of your licensed copy of
TSE Jr. entitles you to technical support from SemWare, discounts on
updates, and access to the Registered User area of our support BBS
(770/641-8968, <N81>, 1200/2400/9600 baud, 24 hours a day).
With your purchase, you will receive: a licensed copy of TSE Jr. V4.0
with a 90-day limited warranty; a bound, indexed manual; a built-in
spelling checker; a macro compiler/decompiler (QMAC); and additional
utilities for use with TSE Jr.
PHONE (Orders ONLY): (800) 467-3692 OTHER VOICE CALLS: (770) 641-9002
Inside USA, 9am-5pm ET 9am-5pm ET
==========================================================================
____ TSE Jr. V4.0 with printed manual ........... @ $59.00 ea $ ______
SUBTOTAL $ ______
--------------------------------------------------------------------------
Name: _____________________________________________________________
Address: __________________________________________________________
: __________________________________________________________
: __________________________________________________________
INTRODUCTION
FEATURES
SYSTEM REQUIREMENTS
INSTALLATION
Tasks to Perform Following Installation
Setting Up the Editor on a Laptop System
1. USER'S GUIDE
QUICK START
Getting Started
In the Editor
Getting Out
MENUS
THE STATUSLINE
PROMPTS
USING A MOUSE
Mouse Equipment
General Use of the Mouse
Using the Pull-Down Menus
Positioning the Cursor and Scrolling Text
Marking a Block
Using the Pop-Up Mouse Menu
Working with Windows
Summary of Mouse Operations
FILES
Creating New Files
Loading Existing Files
Locating a File on Disk
Changing the Current Directory from within the Editor
Invoking the Editor at a Specific Line Number
Multiple Files: The Ring
Saving Files and Exiting
Read-Only Files
VIEWING AND GETTING AROUND IN THE TEXT
Cursor Movement
Moving Through a File
Moving Around on the Screen
Moving By Lines and Characters
Using Windows
Creating Windows
Switching Windows
Changing Window Size
Closing Windows
Synchronized Scrolling in Windows
FINDING AND REPLACING TEXT
Finding Text
Replacing Text
COPYING, MOVING, CHANGING, AND DELETING TEXT
Block Commands
Marking and Unmarking a Block
CUA-Style Block Marking
Manipulating Blocks Directly
Manipulating Blocks Using Scrap Buffers
Manipulating Blocks Using Scratch Buffers
Accessing the Microsoft Windows Clipboard
Examples of Block Commands
Non-Block Commands
Adding Text
Copying Text
Moving Text
Deleting And Undeleting Text
Changing Case
Sorting
The Kill Buffer - A Safety Net
MACROS
PRINTING
Print Formatting
Formfeeds
THE SHELL AND DOS COMMANDS
Swapping, [JR] Shell Indicator
WORD-PROCESSING COMMANDS
MODES
3. COMMAND REFERENCE
INTRODUCTION
����������������������������������������������������������������������
This manual describes the use and operation of TSE Jr., and includes a
user's guide, a chapter on customizing the editor, and a reference
section for editor commands. A separate file, MACRO.DOC, contains
information about keyboard macros and the editor's macro language.
* FAST OPERATION - More than anything else, the editor was designed to
operate quickly, especially in these areas:
* COMPACT PROGRAM SIZE - Every effort has been made to keep the program
size as compact as possible. Even though memory is getting cheaper
all the time, we do not want the editor to require any more memory
than absolutely necessary.
TSE Jr. is available in three versions: the standard DOS version, the
memory-resident DOS version (TSE Jr./Mem-Res), and the OS/2 version (TSE
Jr./2). All three versions offer the same rich set of features and
behave in much the same manner. This shareware version is based on the
standard DOS version of TSE Jr.
FEATURES
����������������������������������������������������������������������
The editor offers a number of powerful features for editing text, both
easily and quickly. To put that power at your fingertips, the editor:
* Is very fast!
* Is compact. Even with all these features, the editor requires less
than 70K of disk space.
* Allows you to temporarily exit to DOS (or a DOS shell) and use DOS
commands from within the editor. Optionally, the editor can swap to
disk or expanded memory to allow even the largest programs (such as
compilers) to run without exiting the editor.
* Allows you to copy or paste text directly between the current file
and the Microsoft Windows Clipboard (or the OS/2 Clipboard, in the
OS/2 version of the editor).
* Will load multiple files from the DOS command line, with or without
wildcard characters.
* Allows you to specify up to six default file extensions for use when
loading files and determining tab settings.
* Supports EGA 43-line mode, and VGA 28-line and 50-line modes.
* Provides the ability to shift entire Blocks using the tab left and
right commands (TabLt and TabRt).
* Provides a pop-up ASCII chart that allows you to directly insert the
selected character into your text.
* Includes the ability to load and/or execute macros from the DOS
command line, as well as an option to execute an automatic startup
macro.
Please review the contents of the READ.ME file included with the
software. This file contains important information (usage information,
new features, changes, etc.) that became available after this manual was
created.
The READ.ME file also contains a complete list of the files included
with the software. A partial list is included here:
Note: After you have tried TSE Jr., you may wish to permanently
customize some of the options. The editor comes with a
configuration program, QCONFIG, that makes customizing the editor
easy. See Chapter 2, "Customizing the Editor," for instructions.
If you have a laptop computer (one with an LCD or plasma display), you
should set your screen parameters before using the editor. For the best
operation, enter MODE BW80 at the DOS command line before running the
editor.
��������������������������������������������������������������Ŀ
� Tip: �
� Please note that one of the MAJOR features of the editor �
� is configurability. You can customize the colors, the �
� keys, the on-screen appearance of the editor, and many �
� other functions. �
� �
� By spending just a small amount of time reviewing Chapter �
� 2 on configuration, you can benefit greatly through �
� customizing the editor to your personal preferences. �
����������������������������������������������������������������
CHAPTER 1. USER'S GUIDE
����������������������������������������������������������������������
QUICK START
����������������������������������������������������������������������
In the editor, you can edit any text file with a few simple commands.
The next three sections briefly describe the quickest way possible to
load, edit, and save a file.
Getting Started
���������������
To initiate the editor, type "Q <Enter>". The editor will respond with
a prompt for the name of the file to be edited.
��������������������������������������������������������������Ŀ
� File(s) to edit: �
� �
����������������������������������������������������������������
Enter the filename. The filename may include the full path designation.
��������������������������������������������������������������Ŀ
� Tip: �
� At any "File(s) to edit:" prompt, you may use wildcard �
� characters (* or ?) to obtain a list of matching files in �
� the directory. �
����������������������������������������������������������������
You may optionally include the filename on the DOS command line in order
to bypass this prompt. For example, from the DOS command line, type:
In the Editor
�������������
Once you are in the editor, the cursor movement keys (Left, Right, Up,
Down, Home, End, ...) allow you to move around in the text.
To obtain a Help Screen, simply press <F1>. Pressing <F1> again (or any
other key) returns you to the text.
To obtain a menu of editing commands, press <Esc>. You may then use the
cursor movement keys to position the cursor bar over the desired
command. Press <Enter> to execute the command.
��������������������������������������������������������������Ŀ
� Tip: �
� Within a prompt for a command, press <Esc> to cancel the �
� command (and the prompt). �
����������������������������������������������������������������
Getting Out
�����������
The easiest way to get out of the editor and save all the work you have
done is to enter <Alt F> <G>.
MENUS
����������������������������������������������������������������������
1. Press <Esc>. The main menu is displayed at the top of the screen.
The main menu consists of a list of sub-menu items.
�����������������������������������������������������������������Ŀ
�File Window �Block� Search Print Macro Editing Other Quit �
��������������������������������Ŀ���������������������������������
� Mark Line �
� Mark Character �
� Mark Column �
� Mark Begin �
� Mark End �
� UnMark �
�������������������Ĵ
��Copy Block���������
� Move Block �
� Delete Block �
� Copy Over �
� Fill... �
�������������������Ĵ
� Sort �
� Ignore Case [Off] �
� Descending [Off] �
���������������������
THE STATUSLINE
����������������������������������������������������������������������
�������������������������������������������������������������������Ŀ
�L 15 C 15 IAWRBS 411K *c:\semware\status.doc 20h,32�
���������������������������������������������������������������������
� � ������ � � � �����������������������
� � ������ � � � �
� � ������ � � � �
� � ������ � � � ���� The hex and decimal
� � ������ � � � value for the character
� � ������ � � � at the cursor position,
� � ������ � � � if this option is ON.
� � ������ � � �
� � ������ � � ���� The path and name of the
� � ������ � � file you are editing
� � ������ � �
� � ������ � ���� *) Indicates file has been changed
� � ������ �
� � ������ ������ Amount of available memory
� � ������ (DOS versions only)
� � ������
� � ��������� S) Indicates Synchronized Scrolling mode is ON
� � �����
� � �������� B) Indicates Box Drawing mode is ON
� � ����
� � ������� R) Indicates Macro Recording is ON
� � ���
� � ������ W) Indicates WordWrap mode is ON
� � ��
� � ����� A) Indicates AutoIndent mode is ON
� � �
� � ���� I) Indicates Insert mode is ON
� �
� ����� The current cursor column number
�
����� The current cursor line number
PROMPTS
����������������������������������������������������������������������
When the editor needs information from the user (such as the name of a
file to edit, a search string, etc.), a prompt is issued. The prompt
consists of a message, telling what information is requested, and an
area for the user to enter a response. The following commands are
available in prompts (if assigned to a key):
Note: Execute DelLine (<Ctrl Y> or <Alt D>) to clear the response area
of any prompt.
USING A MOUSE
����������������������������������������������������������������������
You can optionally use the mouse to perform a wide range of functions
within the editor, including selecting items from a menu or a pick list,
positioning the cursor on the screen, scrolling text, marking and
manipulating Blocks, and creating and moving between windows.
Mouse Equipment
���������������
To use a mouse in the editor, the mouse must be enabled. This is done
by setting the configuration option "Enable mouse processing" to <Y>.
(This is the default setting for this option. Refer to the "Advanced
Options" section of Chapter 2.)
To fully use the mouse capabilities, the editor must also be configured
to display a full border around each window on the screen. This is
because the mouse uses the border area to scroll text and perform many
window operations. To display a border around each window, set the
configuration option "Do you want the display boxed" to <Y>. (Refer to
the "Colors/Screen Options" section of Chapter 2.)
When the editor detects that a mouse is present and enabled, the
following special mouse-sensitive areas are included in the window
borders. (These areas, called mouse "hot spots", are used by the mouse
to perform particular operations, described later in this section.)
* The # symbol is located at the top of each vertical scrollbar, and the
# symbol is located at the bottom.
If desired, you can configure the editor for left-handed use of the
mouse (rather than right-handed). To do this, set the configuration
option "Left-handed mouse" to <Y>. (Refer to the "Advanced Options"
section of Chapter 2.)
To initiate an action with the mouse, position the mouse pointer at the
appropriate place on the screen, and then press one of the buttons on
the mouse (either the <LeftBtn> or <RightBtn>), as indicated by the
mouse command assignments described later in this section. Depending on
the desired action, you either "click," "press and hold," or "drag" the
mouse, as follows:
For certain commands, you execute the command one time only by
clicking the mouse button. For some commands, you must click the
indicated mouse button two or three times, as instructed for that
command. For multiple clicks, the mouse pointer must remain at the
same location while the button is repeatedly clicked the specified
number of times.
* To press and hold a mouse button, press and hold the button for a
period of time before releasing it. The amount of time that the
button must be held is determined by the configuration option
"Mouse hold time". (Refer to the "Advanced Options" section of
Chapter 2.)
* To drag the mouse, press the indicated mouse button, and continue to
hold down the button as you drag the mouse pointer to another location
on the screen. Do not release the button until the mouse pointer is
positioned at the desired location.
* Within menus, prompts, and pick lists, clicking the <LeftBtn> is the
same as pressing <Enter>, and clicking the <RightBtn> is the same a
pressing <Esc>.
For entries in menus and pick lists, the position of the mouse pointer
determines the entry that is selected when you click the <LeftBtn>.
To execute a command or set an option from the pull-down menus using the
mouse, you can follow these steps:
* Display the main pull-down menu by placing the mouse pointer on the
StatusLine and clicking the <LeftBtn>.
* Select a sub-menu item from the menu by placing the mouse pointer on
the item and clicking the <LeftBtn>.
To exit from the pull-down menus, click the <RightBtn> until the main
menu is removed from the screen, or move the mouse pointer outside the
menu area and click the <LeftBtn>.
You can use the mouse to position the cursor or scroll text on the
screen, as described by the following. Note that the special symbols, #
# # #, and the horizontal and vertical elevators along the scrollbars
are used for scrolling.
Place the mouse pointer in the text of the current window where you
want the cursor to be positioned, and click the <LeftBtn>.
Place the mouse pointer on the # symbol. To scroll down one line,
click the <LeftBtn>. To repeat scrolling, press and hold the
<LeftBtn>; scrolling continues until the button is released, or the
end of the file is reached.
Place the mouse pointer on the # symbol. To scroll up one line, click
the <LeftBtn>. To repeat scrolling, press and hold the <LeftBtn>;
scrolling continues until the button is released, or the beginning of
the file is reached.
Place the mouse pointer on the # symbol. To scroll left one column,
click the <LeftBtn>. To repeat scrolling, press and hold the
<LeftBtn>; scrolling continues until the button is released, or column
1 is reached.
Place the mouse pointer on the # symbol. To scroll right one column,
click the <LeftBtn>. To repeat scrolling, press and hold the
<LeftBtn>; scrolling continues until the button is released, or the
maximum line length is reached.
Place the mouse pointer on the scrollbar below the vertical elevator
(�), within the vertical elevator shaft. To scroll down one page,
click the <LeftBtn>. To repeat scrolling, press and hold the
<LeftBtn>, keeping the mouse pointer below the elevator; scrolling
continues until the button is released, or the elevator joins the
mouse pointer, or the end of the file is reached.
Place the mouse pointer on the scrollbar above the vertical elevator
(�), within the vertical elevator shaft. To scroll up one page, click
the <LeftBtn>. To repeat scrolling, press and hold the <LeftBtn>,
keeping the mouse pointer above the elevator; scrolling continues
until the button is released, or the elevator joins the mouse pointer,
or the beginning of the file is reached.
Place the mouse pointer on the scrollbar to the left of the horizontal
elevator (�), within the horizontal elevator shaft. To scroll left by
one TabWidth, click the <LeftBtn>. To repeat scrolling, press and
hold the <LeftBtn>, keeping the mouse pointer to the left of the
elevator; scrolling continues until the button is released, or the
elevator joins the mouse pointer, or column 1 is reached.
Marking a Block
���������������
The following describes how to use the mouse to mark a Block of text.
Place the mouse pointer on the line to be marked. Click the <LeftBtn>
three times (without moving the mouse pointer).
Place the mouse pointer on the beginning line to be marked. Press and
hold <Alt> (on the keyboard) and the <LeftBtn>. Then drag the mouse
to the desired ending line, and release <Alt> and the <LeftBtn>.
* To mark a column:
Place the mouse pointer on the beginning character to be marked.
Press and hold <Ctrl> (on the keyboard) and the <LeftBtn>. Then drag
the mouse to the desired ending position, and release <Ctrl> and the
<LeftBtn>.
* To mark a word:
When the ending position for a Block is not displayed on the screen, you
can scroll the text in the necessary direction by dragging the mouse
pointer outside the current window on the appropriate side. Then drag
the mouse pointer back inside the current window to stop scrolling and
continue marking.
��������������������������������������������������������������Ŀ
� Tip: �
� To unmark a Block using the mouse, place the mouse pointer �
� on a blank character on the screen and click the <LeftBtn> �
� twice. The editor attempts to mark a word at that �
� location. Because the blank character is not a word, the �
� editor fails to mark a Block, though it succeeds in first �
� unmarking the existing Block. �
����������������������������������������������������������������
A special Mouse Menu allows you to use the mouse to easily display a
menu of Block-related commands. To pop-up the Mouse Menu with the mouse
while in editing mode, click the <RightBtn> (with no menus, prompts, or
pick lists active). You can then select one of the displayed
Block-related commands by placing the mouse pointer on the desired item
and clicking the <LeftBtn>.
To remove the Mouse Menu, click the <RightBtn> until the Mouse Menu is
removed from the screen, or move the mouse pointer off the Mouse Menu
and click the <LeftBtn>.
This section describes how to use the mouse to create, switch, resize,
and close windows.
Place the mouse pointer on the left border of the window to be split
and click the <LeftBtn> twice.
Place the mouse pointer in the desired window, and click the
<LeftBtn>. To switch to another window and also position the editing
cursor at the mouse position in that window, press and momentarily
hold the <LeftBtn>.
* To resize a window:
* To zoom a window:
Place the mouse pointer on the [#] symbol in the StatusLine of the
window to be zoomed, and click the <LeftBtn>. While the window is
zoomed, the [#] symbol is replaced by the [#] symbol.
* To "unzoom" a window:
Place the mouse pointer on the [#] symbol and click the <LeftBtn).
The previous windows are restored to the screen, along with the [#]
symbol.
* To close a window:
Place the mouse pointer on the [�] symbol in the StatusLine of the
window to be closed, and click the <LeftBtn>.
Summary of Mouse Operations
���������������������������
�����������������������������������������������������������������
Mouse Pointer
Block Marking Mouse Button Location
�������������� ����������������������� ������������������
�����������������������������������������������������������������
Cursor Movement
and Scrolling Mouse Button Mouse Pointer Location
����������������� ��������������� ���������������������������
Scroll down:
1 line Click <LeftBtn> # symbol
multi lines Hold <LeftBtn> # symbol
1 page Click <LeftBtn> Scrollbar below vertical �
multi pages Hold <LeftBtn> Scrollbar below vertical �
Scroll up:
1 line Click <LeftBtn> # symbol
multi lines Hold <LeftBtn> # symbol
1 page Click <LeftBtn> Scrollbar above vertical �
multi pages Hold <LeftBtn> Scrollbar above vertical �
Scroll left:
1 column Click <LeftBtn> # symbol
multi columns Hold <LeftBtn> # symbol
1 TabWidth Click <LeftBtn> Scrollbar left of horiz. �
multi TabWidths Hold <LeftBtn> Scrollbar left of horiz. �
Scroll right:
1 column Click <LeftBtn> # symbol
multi columns Hold <LeftBtn> # symbol
1 TabWidth Click <LeftBtn> Scrollbar right of horiz. �
multi TabWidths Hold <LeftBtn> Scrollbar right of horiz. �
�����������������������������������������������������������������
Menus, Prompts Mouse Pointer
and Pick Lists Mouse Button Location
�������������������� ���������������� ���������������������
�����������������������������������������������������������������
Mouse Pointer
Windows Mouse Button Location
����������������� ������������������������ ������������������
There are three different ways to create new files, ready for editing.
1. From the DOS command line, enter <Q> followed by one or more new
filenames. Each filename must be separated by a space. For example,
typing:
��������������������������������������������������������������Ŀ
� Tip: �
� When specifying filenames, you may use full path �
� designations if desired. �
����������������������������������������������������������������
2. From the DOS command line, type "Q <Enter>". The editor responds
with the prompt:
�����������������������������������������������������������Ŀ
� File(s) to edit: �
� �
�������������������������������������������������������������
3. From within the editor, execute the EditFile <Alt E> command. The
above prompt will appear. Again, you may enter one or more new
filenames, each separated by a space.
Loading existing files works exactly like creating new files (in the
previous section) with two exceptions:
2. To show all the matching filenames in a "pick" listing. You can then
use the cursor keys to find the file you want and press <Enter> to
load it into the editor.
You can also configure the editor to use default file extensions, such
as "doc" and "pas" when entering filenames. For more information on
configuring these options, refer to the "General Options" section of
Chapter 2.
#include "d:\tsejr\src\local.h"
you could position the cursor anywhere within the specified path and
filename, and press <Ctrl ]>. The editor would then load that file and
make it the current file.
The LocateFile command in the editor allows you to easily locate a file
when you do not remember the directory in which that file resides, or
you do not recall the exact name of the file.
* LocateFile <Esc><F><A>
This command searches an entire drive for a specified filename. A
list of all matching filenames is displayed, allowing you to select an
appropriate file to edit.
When you execute this command, it prompts you for the filename for
which to search. A complete name or an ambiguous name (with DOS
wildcard characters) can be specified. By default, the current drive
is searched. However, a different drive can be searched by prefacing
the filename with the drive name (such as, d:foo). The default or
specified drive is then searched, and all matching filenames are
displayed in a pick list. To select the desired file to edit,
position the cursor bar on that filename in the pick list, and press
<Enter>. To remove the pick list (and terminate the command), press
<Esc>.
If you assign LocateFile to a key, you can execute this command within
any "File(s) to edit:" prompt (such as displayed by the EditFile <Alt E>
command).
The editor's DirTree command provides a very helpful visual means for
changing your current directory from within the editor.
* DirTree <Esc><F><I>
This command displays a pick list of all the drives on your system,
along with a directory tree for the current drive. The current drive
or directory can be changed from this pick list.
Assuming your current drive is the D: drive, and you also have A:, B:,
C:, and E: drives available on your system, following is an example of
what the directory tree pick list might look like when you execute
this command:
For example, to load file1 at line number 125, from the DOS command line
you would enter:
q file1 -n125
q -n125 file1
The editor allows as many files as will fit into memory to be loaded at
the same time. All of these files can then be edited by simply
switching back and forth between them without having to save and load
each file individually. Switching between files is accomplished very
quickly and easily.
A simple explanation of how the editor handles multiple files will help
you in manipulating and editing multiple files.
All files that are loaded into the editor are maintained in a "ring".
As we describe each of the commands used to manipulate the files in the
ring, refer to the illustration below.
��������������������������������������������������������������Ŀ
� ����Ŀ ����Ŀ �
� � � ������ �
� ������> � A � <���<Ctrl K P>��B���<Alt N> �
� � � � ������ � �
� � ������ ������ � �
� v ^ <Alt E> v �
� ����Ŀ � � ����Ŀ �
� � � � � � � �
� � F � <�������������������������������> � C � �
� � � � � � � �
� ������ � � ������ �
� ^ v v ^ �
� � ����Ŀ ����Ŀ � �
� � � � � � � �
� ������> � E � <���������� > � D � <����� �
� � � � � �
� ������ ������ �
� �
� The "Ring" �
����������������������������������������������������������������
In the ring we see that six files have been loaded into the editor. You
can, of course, load many more files - as many as your computer's memory
will allow.
Assume the file currently being edited is file "B". You may then move
from one file to another in any of the following ways:
* Enter the NextFile <Alt N> command. You will now be editing the next
file in the ring, file "C".
* Enter the PrevFile <Ctrl K P> command. You will now be editing the
previous file in the ring, file "A".
* Enter the EditFile <Alt E> command. The editor will prompt for a
filename. You may enter the name of any file in the ring. The editor
will make the entered file the current one for editing.
You may, at any time, add files to the ring or discard files from the
ring. If you add a new file to the ring using the EditFile command, it
will become the current file and the old current file will become the
previous file. If you delete a file from the ring the previous file
will become the current file.
��������������������������������������������������������������Ŀ
� Tip: �
� When loading files, be aware that the editor will not load �
� two copies of the same file. If you issue the EditFile �
� command for a file already loaded, that file will become �
� the new current file. �
����������������������������������������������������������������
The editor provides several different ways to save files, discard files,
and exit the editor. A set of five basic commands provides assorted
combinations of saving, discarding, and exiting in order to suit
individual preferences.
We recommend selecting one or two methods with which you feel most
comfortable and using them consistently.
�������������������������������������������������������������������Ŀ
�Command for Single � Command for Multiple � � � � � �
�File or Current File � Files � 1 � 2 � 3 � 4 � 5 �
�������������������������������������������������������������������Ĵ
�Exit <Ctrl K D> � GExit <Alt X> � � X � � X � X(a) �
� � � � � � � �
�File <Ctrl K X> � GFile <Alt F><G> � X � � � X � X(a) �
� � � � � � � �
�PQuit <Ctrl K Q> � GPQuit <Alt Q><Q> � � � X � X � X(a) �
� � � � � � � �
�Quit (b) � � � � � X � X �
� � � � � � � �
�SaveFile <Ctrl K S> � GSave <Alt Y> � X � � � � �
���������������������������������������������������������������������
(a) The Exit, File, and PQuit commands can be configured to terminate
or not terminate the editor. Refer to the "General Options"
section of Chapter 2 for more information.
��������������������������������������������
�Cannot save READONLY files - Press <Esc> �
��������������������������������������������
As you will see, there are quite a few commands available for moving
around in your text. If you are not already familiar with these types
of commands, try them out. You will probably find some new commands
that will be useful when editing.
Cursor Movement
���������������
��������������������������������������������������������������Ŀ
� Tip: �
� All editor commands, including those without default key �
� assignments, can be assigned as the user desires, to �
� almost any key. Refer to the "Keyboard Configuration" �
� section of Chapter 2 for more information. �
����������������������������������������������������������������
The ScrollUp command causes the cursor to remain on the same line of
text until it reaches the bottom of the screen, while the LineUp
command causes the cursor to remain stationary on the screen.
The ScrollDown command causes the cursor to remain on the same line of
text until it reaches the top of the screen, while the LineDown
command causes the cursor to remain stationary on the screen.
��������������������������Ŀ
�Go to line: �
� �
����������������������������
Type a line number and press <Enter>. The cursor then "jumps" to the
specified line number. An easy way to move about quickly in your text
is to keep track of critical positions by noting their line number,
which is displayed on the StatusLine, and then using this command to
"jump" to those positions.
For example, perhaps you are in the middle of a file and want to check
something at the very beginning of the file. To go to the beginning,
you would simply enter BegFile <Ctrl PageUp>. After you look at the
beginning, you want to go back to where you were previously. You
could use PageDown, but that could be tedious, especially if your file
is large. The easiest way would be to enter PrevPosition, and with a
single keystroke, you are immediately back where you started.
* NextEqualIndent, PrevEqualIndent
These commands move the cursor to the next or previous line (as
appropriate) whose text starts in the same column as the current line.
If the current line is blank, the cursor moves to the next or previous
blank line.
These commands affect the cursor position within the current screen of
displayed text.
* FirstNonWhite
This command is intended as a replacement for the BegLine command. It
positions the cursor on the first non-white (space) character on the
current line, or column 1 if the line is blank. An interesting
variation is a command that toggles between the beginning of the line
and the first non-white character on that line:
The MakeTopofScreen command scrolls the text upward until the cursor
line is the top line of the screen.
The MakeBotofScreen command scrolls the text downward until the cursor
line is the last line of the screen.
These commands enable you to move in short increments through the text.
When you use CursorLeft, the cursor stops when it reaches the left
edge of the screen, unless the text has been scrolled to the left. In
that case it scrolls the text to the right one column at a time until
it reaches column one.
When you use CursorRight and the cursor reaches the right edge of the
screen, it begins to scroll the text to the left. It stops scrolling
when it reaches the maximum line length.
If you prefer that cursor left/right would wrap at the beginning and
end of lines, you can assign the following macros in your QCONFIG.DAT
file in lieu of cursor left/right, respectively:
cursorleft
CursorLeft * try to go left
MacroQuitTrue * succeed! then we are done
CursorUp * else try to go to prev line
MacroQuitFalse * if fail, then at top of file. done.
EndLine * jump to end of previous line.
cursorright
isEndLine * are we at end of line?
JTrue down: * if so, go to down
CursorRight * else right one
MacroQuit * Quit macro
down:
CursorDown * try to go to next line
MacroQuitFalse * if not, go to end
BegLine * else go to beginning of line
* GotoColumn <Esc><S><G>
Upon entering the GotoColumn command, the editor prompts with:
��������������������������Ŀ
�Go to column: �
� �
����������������������������
Type a column number and press <Enter>. The cursor then moves to the
specified column number.
Using Windows
�������������
The editor provides the ability to view different areas of files (either
multiple files or the same file) at the same time, through the use of
windows. A window is a portion of the screen that allows you to view
text. You can divide your screen into as many as eight horizontal
windows. You can then view as many as eight different files through
these windows or have multiple views of a single file. This capability
can be quite helpful for comparing text, copying text, and moving text.
Creating Windows
If only one file is being edited, the newly created window will simply
be an additional view of the same file. The editor will not load more
than one copy of the same file.
If multiple files are being edited, the newly created window will be a
view of the next file in the ring. (Refer to the "Multiple Files"
section in this chapter.) If desired, you can configure the editor to
prompt for the name of the file to be viewed in the new window instead
of the editor automatically selecting the next file in the ring. Refer
to the "General Options" section of Chapter 2 for more information.
Once the screen has been split into windows, entering the
HorizontalWindow command again will affect the current window. All
other windows will remain unchanged.
Switching Windows
When multiple windows are opened, editing will take place only in the
current window (the window containing the cursor). For editing text in
other windows, two commands are provided to switch from one window to
another.
You can change the size of any window on the screen with the commands
below.
Closing Windows
Note that closing a window does not discard files from the editor.
Finding Text
������������
* Find <Ctrl Q F>
This command searches for a specific string of characters in the file.
Upon entering the Find command, the editor prompts for the string of
characters for which to search.
������������������������������������������������������������Ŀ
�Search for: �
� �
��������������������������������������������������������������
�������������������������������������������������������������Ŀ
�Options [BGLIW] (Back Global Local Ignore-case Whole-words): �
� �
���������������������������������������������������������������
Enter the letter(s) corresponding to the option(s) you want and press
<Enter>. The available options are:
[B] = Search backward from the current cursor position. When you
choose "B", the editor searches backward from the cursor
position toward the beginning of the file. Otherwise, it
searches from the cursor position toward the end of the file.
[W] = Search for whole words only. For example, when this option is
chosen, the word "sent" matches only the actual word "sent".
Otherwise, any other words that contain the string (such as
"sentence" or "absent") would also match.
[^] = Anchor the search string to the beginning of the line (or
Block). The search operation attempts to locate a matching
string that begins in column 1 of a line; or, if the [L]
option is also selected, it attempts to locate a matching
string that begins in the first column of the Block.
[$] = Anchor the search string to the end of the line (or Block).
The search operation attempts to locate a matching string that
ends on the last character of a line; or, if the [L] option is
also selected, it attempts to locate a matching string that
ends on the last character in the Block (or that ends on the
last character of a line, if the line ends in the Block).
Once the Find command is executed, the cursor is placed at the first
occurrence of the search string found in the text. To locate
subsequent occurrences of the search string, simply enter the
RepeatFind command (described below).
If you want to search for a string and replace it with another string,
refer to the "Replacing Text" section in this chapter.
��������������������������������������������������������������Ŀ
� Tip: �
� The placement of the found text is configurable. It can �
� either be placed on the same relative row on which the �
� cursor line initially started, or centered. Refer to the �
� ToggleCenterFinds command in Chapter 3, and to the option �
� "Should Find and RepeatFind center the found text" in the �
� "General Options" section of Chapter 2. On the menus, �
� press <Esc><S><C>. �
����������������������������������������������������������������
Within the IncrementalSearch prompt, you can use the following keys to
perform the operations indicated:
<Ctrl B> Searches forward from the beginning of the file for
the first occurrence of the current IncrementalSearch
string.
Replacing Text
��������������
Upon entering the FindReplace command, the editor prompts for the
string of characters for which to search.
������������������������������������������������������������Ŀ
�Search for: �
� �
��������������������������������������������������������������
The editor then prompts for a new string of characters (to replace the
old string).
������������������������������������������������������������Ŀ
�Replace with: �
� �
��������������������������������������������������������������
The editor then prompts for the search options you wish to use.
������������������������������������������������������������Ŀ
�Options [BGLIWN] (Back Global Local Ignore-case Whole-words �
�No-prompting): �
� �
��������������������������������������������������������������
Enter the letter(s) corresponding to the option(s) you want and press
<Enter>. The available search options are the same as those described
in the previous section ("Finding Text") for the Find command, as well
as the following additional replace options:
[N] = Find and replace with NO prompting. If you choose "N", the
editor finds and replaces every occurrence of the search
string, without asking you if you want to replace each
individual occurrence.
If you select the [N] or [#] option, the editor finds and replaces
every occurrence of the search string with no further user
intervention. If you DO NOT select the [N] or [#] option, the editor
prompts at every occurrence of the search string with:
Replace (Yes/No/Only/Rest/Quit):
<Y>es - Replace the search string with the new string and
continue to the next occurrence.
<N>o - Do not replace the search string, but continue to the
next occurrence.
<O>nly - Replace the search string with the new string and
quit.
<R>est - Replace the search string with the new string and
replace the rest of the occurrences with no further
prompts.
<Q>uit - Cancel the FindReplace process.
Block Commands
��������������
In this section, we will see how to mark and manipulate Blocks. A Block
is some portion of the text file which has been specifically delineated
using the Block-marking commands. We will see how to manipulate Blocks
both directly and through the use of intermediate storage areas known as
buffers.
The editor contains a rich set of Block commands. There are commands to
mark Blocks by lines, columns, and characters. There are commands to
copy, move, shift, and delete Blocks. These commands are very useful
for transferring text from one file to another. There are also
cut-and-paste commands, as well as commands to move Blocks to and from
named Scratch Buffers.
Before you can manipulate a Block, you must first "mark" the Block,
either by characters, lines, or columns. The type of Block that you
mark will depend on the editing situation and what you find most
comfortable.
* MarkCharacter
This command works just like DropAnchor except that while marking the
Block, the cursor is not included within the Block.
��������������������������������������������������������������Ŀ
� Tip: �
� When using the MarkLine, MarkCharacter, MarkColumn, and �
� DropAnchor commands, it is not necessary to mark the end �
� of the Block. The editor assumes the end of the Block to �
� be the current cursor position for MarkCharacter, �
� MarkColumn, and DropAnchor, and to be the current cursor �
� line for MarkLine. Marking the end of the Block is only �
� necessary when moving or copying text within the same �
� file. �
����������������������������������������������������������������
The editor allows you to mark one Block at a time. If you mark a Block
and then go elsewhere in the file and attempt to mark another Block, the
editor will simply extend the first Block by including all the text
between the original Block and the current cursor position. If you mark
a Block in one file and then go to another file and mark a Block, the
Block in the first file will automatically be unmarked.
The editor allows you to use the following CUA-style shifted cursor keys
for marking character Blocks. These pre-defined keys use the
MarkCharacter command to create Blocks that do not include the cursor
within the Block.
<Shift Cursor Left> Mark/extend Block and move left one character
<Shift Cursor Right> Mark/extend Block and move right one character
<Shift Cursor Up> Mark/extend Block and move up one line
<Shift Cursor Down> Mark/extend Block and move down one line
<Shift Home> Mark/extend Block and move to beginning of line
<Shift End> Mark/extend Block and move to end of line
<Shift PgUp> Mark/extend Block and move up one page
<Shift PgDn> Mark/extend Block and move down one page
To select the CUA-style Block-marking keys, you must set CUA-Style Block
Marking mode ON. (You can do this by setting the configuration option
"Use CUA-style (shift cursor) block marking" to <Y>. Refer to the
"Advanced Options" section of Chapter 2. You can also switch this mode
ON and OFF using the ToggleCUAMarking command.) These CUA-style keys
will then override any command assignments made to the same keys in
QCONFIG.DAT.
CUA-style
Key Block Command / Operation
����������� ���������������������������������������������������������
If you press any key that is not a CUA-style marking keys (or that is
not one of the related CUA-style Block command keys, as described
above), the current Block will be unmarked. You can override this
"unmarking" behavior by setting the configuration option "Should blocks
remain marked after CUA marking" to <Y>. Then a marked Block will
remain marked until you unmark it, or until you execute a command, such
as Cut, that unmarks the Block after its operation. (Refer to the
"Advanced Options" section of Chapter 2 for information on setting this
option.)
Once a "persistent" Block is marked, you can extend the Block by placing
the cursor at either the beginning or ending position of the Block, and
then pressing one of the CUA-style Block-marking keys. If you press one
of the CUA-style marking keys with the cursor at any other position in
the file, the current Block will be unmarked, and a new Block will be
started at the cursor position.
��������������������������������������������������������������Ŀ
� Tip: �
� When Copying or Moving Blocks: �
� �
� Blocks marked using the DropAnchor, MarkCharacter, �
� MarkColumn, and MarkBlockBegin/End commands will always be �
� inserted beginning at the current cursor position. �
� �
� Blocks marked using the MarkLine command will be inserted �
� at either the line before or the line after the current �
� cursor line. Refer to the "General Options" section of �
� Chapter 2 for more information. �
����������������������������������������������������������������
To use this command, first mark the Block as described above. Next,
move the cursor to the position in the file where you wish to insert
the marked text. (Or, if you have multiple files loaded and wish to
copy text from one file to another, use the NextFile, PrevFile or
EditFile commands to get a new current file and likewise position the
cursor.) Now enter the CopyBlock <Alt C> command. The Block will be
inserted at the new position. You may notice, after you use
CopyBlock, that the newly inserted Block of text is now marked and the
original Block is unmarked. To unmark the copied Block, enter the
UnmarkBlock command.
For an easy method to copy the same Block repeatedly, refer to the
Copy and Paste commands in the following section.
As with the CopyBlock command, you can move a Block to another part of
the same file or from one file to another.
For an easy method to delete a Block from its original position and
inserting it repeatedly at other positions, refer to the Cut and Paste
commands in the following section.
The Scrap Buffer is a temporary holding area for marked Blocks of text.
The commands Cut, Copy, Paste, and PasteOver are used solely for placing
text into the Scrap Buffer and copying text from the Scrap Buffer.
You can repeatedly use the Paste and PasteOver commands as many times as
needed to insert a copy of the Block held in the Scrap Buffer at
multiple positions in your file or files. The Paste and PasteOver
commands do not purge the contents of the Scrap Buffer.
* Copy <Grey +> and Paste <Grey *> / PasteOver <Ctrl PrtSc>
To copy a section of text from its present position and insert it
somewhere else:
2. Enter Copy <Grey +>. This places a copy of the marked text into
the Scrap Buffer.
3. If you want to insert the text somewhere else within the same file,
use the cursor movement commands to place the cursor where you wish
to insert the text.
4. If you want to insert the text in another file, switch to that file
using the NextFile, PrevFile, or EditFile command to access that
file. Then place the cursor at the desired position.
5. Enter Paste <Grey *> to insert the text. If you have copied a
column Block into the Scrap Buffer and wish to insert it by
overlaying existing text then use PasteOver <Ctrl PrtSc> instead of
Paste.
Since Paste and PasteOver leave the contents of the Scrap Buffer
intact, you can make multiple insertions in the same or different
files. Simply move the cursor to the file and position where you wish
to make additional insertions and enter Paste <Grey *> or PasteOver
<Ctrl PrtSc>. Please note that the next time you issue a Cut or Copy
command, the previous contents of the Scrap Buffer will be discarded.
* Cut <Grey -> and Paste <Grey *> / PasteOver <Ctrl PrtSc>
Cut and Paste/PasteOver work exactly like Copy and Paste/PasteOver
except that Cut will delete the marked Block from the file. You can
still make multiple insertions of the text using the Paste or
PasteOver Commands.
��������������������������������������������������������������Ŀ
� Tip: �
� The editor can be configured to have the Cut and Copy �
� commands act on the current cursor line if no Block is �
� marked. Refer to the "Advanced Options" section of �
� Chapter 2 for more information. �
����������������������������������������������������������������
The contents of all Scratch Buffers are discarded when the editor is
terminated.
���������������������������������������������������������Ŀ
�Store (Append) to buffer: �
� �
�����������������������������������������������������������
The Block is now stored in a Scratch Buffer under the assigned name.
1. Position the cursor where you wish the contents of the named
Scratch Buffer to be inserted.
2. Enter GetScrBuff <Ctrl B L>. The editor prompts for the name of
the Scratch Buffer to be retrieved.
�������������������������������������������������������Ŀ
�Get from buffer: �
� �
���������������������������������������������������������
4. Repeat the above steps whenever you want to insert the contents
of a Scratch Buffer into your text.
The following handy commands allow you to copy or paste text between the
current file and the Microsoft Windows Clipboard.
* WinClipCopy
This command makes a copy of the marked Block and inserts it directly
into the Microsoft Windows Clipboard.
* WinClipPaste
This command inserts a copy of the contents of the Microsoft Windows
Clipboard directly into the current file at the cursor position.
Note that the OS/2 version of the editor allows you to access the OS/2
Clipboard.
5. Move the cursor to the location where you want to insert the marked
Block.
5. Move the cursor to the location in the file where you want to
insert the marked Block.
4. If you want to leave the Block in its original position and insert
copies of it at other locations, then enter Copy <Grey +>.
If you want to delete the Block from its original position and
insert copies of it at other locations, then enter Cut <Grey ->.
5. Move the cursor to the location in the file where you want to
insert the Block.
The Block is now inserted. Repeat steps 5 and 6 for each additional
insertion.
4. If you want to leave the Block in its original position and insert
copies of it at other locations, then enter Copy <Grey +>.
If you want to delete the Block from its original position and
insert copies of it at other locations, then enter Cut <Grey ->.
6. Move the cursor to the location in the file where you want to
insert the Block.
The Block is now inserted. Repeat steps 5-7 for each additional
insertion.
5. The editor will prompt for the name of the buffer. Enter a name.
(It is best to use a name which reflects the contents of the
buffer and is easily remembered).
7. Move the cursor to the location in the file where you want to
insert a Block.
8. Enter GetScrBuff <Ctrl B L>. The editor will prompt for the name
of the Scratch Buffer. Enter the name of the desired Scratch
Buffer for insertion.
Non-Block Commands
������������������
In addition to the editor's array of Block commands, there are also many
commands for manipulating your text which do not depend on marked
Blocks. This section explains non-Block commands.
Adding Text
* AddLine <F2>
As its name implies, this command inserts a blank line in the text.
The line is added immediately below the current cursor line. The
cursor is moved to the new line. The cursor column does not change.
��������������������������������������������������������������Ŀ
� Tip: �
� An alternate and perhaps easier method of entering control �
� characters or any ASCII character into your text is to �
� hold down the <Alt> key and enter the decimal equivalent �
� of the ASCII character using the numeric keypad. For �
� example, to insert a formfeed character (ASCII 12) in the �
� text, just enter <Alt 12> using the numeric keypad. �
� �
� If a linefeed character (ASCII 10) is entered, the editor �
� will split the line at this position the next time the �
� file is edited. �
� �
� Another method for entering ASCII characters into the text �
� is to use the AsciiChart command, described below. �
����������������������������������������������������������������
* AsciiChart <Esc><O><T>
Displays a scrollable ASCII chart on the screen. When the ASCII chart
is displayed, the cursor bar is located on the entry that corresponds
to the character at the cursor position in the text. If the cursor is
positioned in the text beyond the end of the line, the cursor bar is
located on the first item in the ASCII chart (the null character).
To place a display character from the ASCII chart into the text, scroll
the cursor bar to the desired entry and press <Enter>. The ASCII
chart is removed from the screen, and the selected character is placed
in the text at the cursor position.
To remove the ASCII chart from the screen without placing a character
into the text, press <Esc>.
* ToggleEnterMatching <Esc><O><E>
This is also a specialized command which is really a mode of operation
that can be switched ON or OFF. If switched ON, the editor will
automatically insert into the text a corresponding ), ], }, or "
character each time a (, [, {, or " character, respectively, is
entered. To switch EnterMatching mode ON, enter <Esc><O><E>. To
switch OFF, enter <Esc><O><E> again.
Copying Text
* DupLine <F4>
This command simply makes a copy of the current cursor line and
inserts this copy on the line immediately below the cursor line. The
cursor is placed on the new line.
Moving Text
* Align
This command lines up the left-most character of the cursor line with
the left-most character of the line above it. This allows you to
align portions of text which require a common left margin. This
command also moves the cursor down one line; thus, large portions of
text can be aligned very quickly by entering this command and holding
the command key down.
If the line below the cursor line is blank, the blank line will be
deleted.
* Return <Enter>
Before reading the explanation of the Return command, it may be
helpful to review the discussion of Insert mode in the "Modes" section
in this chapter.
If the editor is not in Insert mode, this command will simply place
the cursor at the beginning of the line below the cursor line. No
text will be affected.
��������������������������������������������������������������Ŀ
� Tip: �
� The editor can be configured so the Return command does �
� not split lines in Insert mode. Refer to the "Advanced �
� Options" section of Chapter 2 for more information. �
����������������������������������������������������������������
* SwapWords
This command will swap the word in which the cursor is positioned with
the previous word on the current line. Any "non-word" characters
between the affected words are preserved.
If Insert mode is OFF, the Backspace command works the same as above
except the text to the right of the cursor is not pulled behind the
cursor as it moves left.
* DelToEol <F6>
This command deletes the character at the cursor position and all text
to the right of the cursor on the current cursor line. The cursor
position does not change.
Changing Case
Sorting
The editor allows you to sort a range of lines, using a column Block as
the key upon which the sort is based. In order to use the Sort feature,
mark a column Block indicating the key on which to sort, and then press
<Shift F3>.
* ToggleSortDescending <Esc><B><N>
Toggles the sort order between ascending and descending. Set this
option OFF to sort in ascending order; set this option ON to sort in
descending order.
The editor maintains a temporary storage area for deleted text. This
provides the User a safeguard against incorrectly or inadvertently
deleting text. This recovery mechanism is automatically in effect when
the editor is running. No action is required from the User until there
is a need to recover deleted text.
The temporary storage area is called the Kill Buffer. Text that has
been deleted by the following commands will be placed into the Kill
Buffer:
To understand how the Kill Buffer works and how text is recovered from
the Kill Buffer, refer to the following illustration:
Entry Command
Number Entered Buffer Contents
�����������������������������������������������������Ŀ top
� 4 � DelToEol � part of this line was deleted. �
�����������������������������������������������������Ĵ
� 3 � DelRtWord � word (1 word deleted) �
�����������������������������������������������������Ĵ
� 2 � DelLine � This entire line was deleted. �
�����������������������������������������������������Ĵ
� 1 � DelLine � This entire line was deleted. �
�����������������������������������������������������Ĵ
� empty � � �
�����������������������������������������������������Ĵ
� empty � � �
������������������������������������������������������� bottom
Each time one of the text deletion commands is used, a new entry is made
in the Kill Buffer. In the above example, four deletion commands have
been issued. The text from these four commands has been stored in the
Kill Buffer from top to bottom. In other words, when the DelToEol
command was issued (entry #4), the first three entries were pushed
toward the bottom of the Kill Buffer and the newly deleted text was
entered at the top.
In the example, the Kill Buffer has enough room for six entries. When a
seventh entry is made, the oldest entry, or entry number one, will be
discarded from the Kill Buffer. Once discarded from the Kill Buffer,
that text can no longer be recovered.
To recover deleted text, the UnKill <Ctrl U> command is used. Each time
the UnKill command is issued the most recent entry (the "top" entry of
the Kill Buffer) is retrieved and restored to the file. This entry is
then deleted from the Kill Buffer, and all remaining entries move toward
the top of the buffer by one position. In the example, the first time
the UnKill command is issued, entry #4 will be recovered. Next, entry
#3 will be recovered, and so on. Thus, recovering deleted text follows
the rule of LIFO (last in, first out). The last entry of deleted text
will be the first one recovered and the first entry of deleted text will
be the last one recovered.
Here are some additional items of which to be aware regarding the Kill
Buffer and its uses.
* A separate Kill Buffer is maintained for each file loaded into the
editor. The Kill Buffer for each file exists only as long as the file
is loaded.
* The text deleted using the DelLine, DelRtWord, and DelToEol commands
will take up one entry in the Kill Buffer each time the commands are
executed. The text deleted using the DeleteBlock command will take up
as many entries as there are lines in the Block.
* When issuing the UnKill command to recover deleted text, deleted lines
will be inserted immediately before the current cursor line, and
deleted words will be inserted immediately before the current cursor
position.
MACROS
����������������������������������������������������������������������
The editor provides a helpful facility for creating macros, allowing you
to simplify and automate editing tasks and to more fully customize the
editor. Macros can be created as simple Keyboard Macros, by having the
editor record a series of keystrokes as they are entered from the
keyboard. More versatile macros can be created by assigning a series of
editing and macro commands to specific keys within the editor's Keyboard
Definition file (QCONFIG.DAT). To create even more complex macros, QMac
(the external macro facility) can be used. (QMac is included in the
registered version.)
For more information about creating and using macros, refer to the file
MACRO.DOC.
PRINTING
����������������������������������������������������������������������
The editor allows you to print either your entire current file or a
portion of the current file.
To print the entire current file, enter the PrintAll <Alt P><A> command.
The entire current file is printed.
To print a portion of the current file, first mark the portion of the
file to be printed using the Block-marking commands. (Refer to the
"Block Commands" section in this chapter.) Next, enter the PrintBlock
<Alt P><B> command. Only the marked Block portion of the file is
printed.
Print Formatting
����������������
The editor contains various commands to make printing easier and more
useful. There are commands to set the left margin, the top margin, and
the bottom margin; to specify the number of lines per page; to indicate
the output destination; to select single-, double-, or triple-spacing;
and to indicate whether you want to print line numbers.
To have the editor pause after each page is sent to the printer, set
this option ON. (For this option to operate effectively, the print
page size must be set to an appropriate value greater than 0. Refer
to SetPrintPageSize in this section.) The editor then requires a
keypress after every page is printed before continuing. This allows
you to manually feed paper to the printer, one sheet at a time.
Set this option OFF for the editor to automatically send each
subsequent page to the printer without pausing.
Formfeeds
���������
To have the editor send a final formfeed character to the printer, set
this option ON. Set this option OFF to prevent the editor from
automatically sending a final formfeed character.
Two very helpful commands allow you to interact with DOS from within the
editor. The commands, Shell and Dos, allow you to perform most
functions that you would normally execute from the DOS command line,
then return you to your original position in the editor.
The editor also has an option which frees up memory when executing the
Shell and Dos commands. For details, see "Swapping, [JR] Shell
Indicator" later in this section.
* Shell <F9>
This command should be used when executing multiple DOS commands. Upon
executing the Shell command, control is passed to DOS. The DOS prompt
appears on the screen, just as if no other programs were running. You
may now enter most DOS commands. (Some exceptions are noted below.)
Once you have entered all the desired DOS commands, simply type "exit"
and press <Enter>, and control passes back to the editor. You are
then positioned in the file exactly where you were when the Shell
command was executed.
������������������������������������������������������������Ŀ
�Execute what: �
� �
��������������������������������������������������������������
You may now enter almost any DOS command. (Some exceptions are noted
below.) Once the DOS command has completed, pressing any key causes
control to pass back to the editor.
You should not execute any TSR programs (programs that terminate but
remain resident in your computer) from the Shell or Dos commands. For
example, the DOS PRINT and GRAPHICS commands are TSR programs.
If you mistakenly execute a TSR program from the Shell or Dos command,
the computer's memory allocation scheme will probably become fragmented,
and as a result, the editor's available memory may become severely
limited. You should save your files, terminate the editor, and then
reboot the computer.
While in a shell with swapping ON, the editor will maintain a file with
a ".SWP" file extension in your root directory. It is very important
that you do not delete this file while in the shell.
Once in the shell, the editor will optionally append "[JR]" to the DOS
prompt string, provided that:
3. You have set the "Change DOS PROMPT during a Shell" option to <Y> via
the configuration program. (For more information, refer to the
"Advanced Options" section of Chapter 2.)
If you have NOT defined the prompt environment variable, then we suggest
you do so. It is helpful with DOS command-line operations in general.
A suggested prompt is (this should go in your AUTOEXEC.BAT file):
set prompt=$p $t $g
If you do have a prompt string defined, but you do not get the "[JR]"
prompt in the editor's shell, add the following to your AUTOEXEC.BAT:
set x=x
WORD-PROCESSING COMMANDS
����������������������������������������������������������������������
The editor has all the features you need to do basic word processing.
In addition to the commands which enable you to view and edit your text
(discussed in previous sections), the editor provides word-wrapping,
paragraph-reformatting capabilities, and a line-centering command.
The editor also contains commands for changing case and for filling a
Block. Refer to the sections in this chapter on "Changing Case" and
"Manipulating Blocks Directly," respectively, for more information on
these two functions.
* The Right Margin
To benefit from the word-wrap and paragraph-reformatting features of
the editor, an appropriate right margin must first be set. The
default setting is column 72. This may be changed using the
configuration program. (Refer to the "General Options" section of
Chapter 2 for instructions on how to change the right margin setting.)
The value of the right margin is used each time the editor is
initiated.
The editor provides the ability to change the right margin setting
temporarily while the editor is running without affecting the
permanent setting. To change the right margin setting temporarily,
execute the SetRmargin <Ctrl O R> command. The editor prompts with:
������������������������������������Ŀ
�Right margin [1..2032]: �
� �
��������������������������������������
Enter the desired column number for the right margin. The new setting
is in effect until the SetRmargin command is executed again or the
next time the editor is initiated. WordWrap mode (see below) is
automatically switched ON whenever the right margin is set using this
command.
* WordWrap
WordWrap is an editing mode which can be switched ON and OFF using the
ToggleWordwrap <Ctrl O W> command. When switched ON, this mode causes
the cursor to advance automatically to the next line as text is
entered.
The cursor advances to the next line based on the right margin, which
is set using the SetRmargin <Ctrl O R> command (see above). Once the
cursor reaches the right margin and a non-blank character is typed,
the cursor, along with the word (that is, any continuous string of
non-blank characters) currently being typed, will be advanced to the
next line.
The cursor does not advance to the next line if the current line does
not contain at least one space.
* Paragraph Reformatting
The WrapPara <Alt B> command reformats text from the current cursor
position to the next blank line or the end of the file.
With the cursor inside of a line Block, you can execute this command
to center several lines at once. With the cursor inside of a column
Block, you can center lines based on the left and right Block
boundaries.
MODES
����������������������������������������������������������������������
* Insert mode
Insert mode can be switched ON and OFF by pressing the <Ins> key. When
Insert mode is ON, an "I" appears on the StatusLine. The following
table describes the commands and keystrokes which are affected by
Insert mode.
Command/
Keystroke Insert ON Insert OFF
����������� ���������������������� ����������������������
Characters, Shifts text to right Overwrites existing
Space of cursor, one column text.
to the right.
This mode enables CUA-style Block marking, using the shifted cursor
keys. CUA-Style Block Marking mode can be switched ON and OFF using
the ToggleCUAMarking command. You can also set this mode as the
default mode by setting the configuration option "Use CUA-style (shift
cursor) block marking" to <Y>. (Refer to the "Advanced Options"
section of Chapter 2.)
When switched ON, this mode forces the shifted cursor keys to mark
non-inclusive character Blocks. The "CUA-Style Block Marking" section
of this chapter provides additional information about this mode.
* AutoIndent mode
AutoIndent mode is switched ON and OFF using the ToggleIndent
<Ctrl Q I> command. This mode, when ON, positions the cursor at the
current left margin (This is not the same as the print 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. When AutoIndent mode is ON, an "A" appears on the
StatusLine. The following table describes the commands and keystrokes
which are affected by AutoIndent mode.
Command/
Keystroke AutoIndent ON AutoIndent OFF
��������� �������������������������� ������������������������
* C mode
This mode is specifically for "C" language programming. It is
switched ON and OFF using the configuration program. (Refer to the
"General Options" section of Chapter 2 for information on switching C
mode ON and OFF.) C mode is only in effect when AutoIndent mode is
also ON.
C mode, when switched ON, affects files with a ".c", ".cpp", ".cxx",
".h", ".hpp", or ".hxx", file extension. When the current cursor line
contains a "{" and the <Enter> key is pressed, the editor issues a
normal Return followed by a TabRt command. Additionally, when a "}"
character is entered, the editor first issues a TabLt command and then
enters the "}" character.
* WordWrap mode
WordWrap mode is switched ON and OFF using the ToggleWordwrap
<Ctrl O W> command. When switched ON, this mode causes the cursor to
advance to the next line automatically as text is entered.
The cursor advances to the next line based on the right margin, which
is set using the SetRmargin <Ctrl O R> command. Once the cursor
reaches the right margin and a non-blank character is typed, the
cursor, along with the word (i.e., any continuous string of non-blank
characters) currently being typed, is advanced to the next line.
The cursor does not advance to the next line if the current line does
not contain at least one space. When WordWrap mode is ON, a "W"
appears on the StatusLine.
* BackUp mode
BackUp mode is switched ON and OFF using the ToggleBakups <Esc><O><B>
command. When BackUp Mode is switched ON, the editor creates a backup
copy (using the .bak file extension) for any file that is edited and
saved. The backup copy of the file is an image of the file before it
was last edited and saved. When BackUp mode is OFF, no backup files
are created.
* MacroRecord mode
MacroRecord mode is switched ON and OFF using the MacroRecord <Ctrl M>
command. This mode, when ON, records and assigns a series of commands
and keystrokes to a designated key (or scrap area). This creates a
Keyboard Macro. For a complete explanation of macros and their use,
refer to the file MACRO.DOC. When MacroRecord mode is ON, an "R"
appears on the StatusLine.
* EnterMatching mode
EnterMatching mode is switched ON and OFF using the ToggleEnterMatching
<Esc><O><E> command. If switched ON, the editor automatically inserts
into the text a corresponding ), ], }, or " character each time a (, [,
{, or " character, respectively, is entered.
Note that all of the supported tab modes may be set via the Tab type
menu (<Esc><O><Y>).
��������������������������������������������������������������Ŀ
� Tip: �
� In general, Physical Tab Expansion mode should always be �
� set ON. You would only want to set it OFF if you are �
� editing binary or data files that contain or require �
� physical tabs. �
����������������������������������������������������������������
Simply press <Enter>, unless you have previously renamed the editor, or
if the editor is located in another directory.
If you have renamed the editor, enter the appropriate filename and press
<Enter>. If it is located in another directory, enter the full pathname
and press <Enter>.
If the version numbers of the editor and the configuration program are
not the same, the error message "Configuration area not found" is
displayed. Try reloading the editor software from the distribution disk
(in particular, Q.EXE and QCONFIG.EXE).
��������������������������������������������������������������Ŀ
� Configuration choices. �
� Choose One of the Following by pressing the indicated Key: �
� �
� Advanced options �
� Colors/screen �
� General options �
� Help install �
� Keys �
� Printer options �
� Quit �
� Save changes and quit �
� Tab settings �
����������������������������������������������������������������
* Advanced options
Contains a variety of configurable options, including those related
to video display, DOS memory, editor menus, and the mouse.
* Colors/screen
Allows you to change colors of various display items and to specify
numerous other editing display options.
* General options
A miscellaneous category of options.
* Help install
Allows you to install your own Help Screen.
* Keys
Allows you to reassign editor commands to different keys.
* Printer options
Allows you to set options for printing text, such as page size.
* Quit
Terminates the program. You are first prompted to save or not save
changes.
* Tab settings
Allows you to set various tab-related options, including the
physical and cursor tab widths.
To make a selection from the menu, type the first letter of the desired
menu item. You are prompted for a response to each option within the
category. Each configuration option is displayed along with its current
value. (The Keys and Help install categories, however, work a little
differently and simply request a filename.)
For each option displayed, you may enter a new value. If you do not
wish to change the current value, simply press <Enter>. After you have
reviewed all options in a category, you are returned to the main
configuration menu where you can select another category.
Once you have completed customizing, you may save all the changes you
have made either by simply typing "S" at the main menu prompt; or by
typing "Q" at the main menu prompt, and then typing "Y" at the prompt,
"Save Changes (Y/N)?". Your changes are made permanent (that is,
effective the next time you execute the editor) by writing them to the
editor program itself (Q.EXE or QMR.EXE). The configuration program
then terminates.
If you decide that you do not want to save your changes, type "Q" at the
main menu prompt, then type "N" at the prompt, "Save Changes (Y/N)?". No
changes are saved, and the configuration program terminates.
ADVANCED OPTIONS
����������������������������������������������������������������������
��������������������������������������������������������������Ŀ
� Tip: �
� Many TSRs, including mouse drivers, do not properly �
� recognize the enhanced keyboard. If you are using a TSR �
� and it is not working with the editor, try setting this �
� option to <N>. �
����������������������������������������������������������������
* Swap to Expanded memory or DISK on the Dos and Shell commands (Y/N)? [Y] :
Select <Y> if you want the editor to swap itself out of DOS memory
and to expanded memory or disk whenever the Dos or Shell commands
are executed. This will leave a small 2K editor kernel in DOS
memory, freeing up the rest of DOS memory for running other
applications, such as compilers or spreadsheets, out of the Dos or
Shell commands.
* Get num rows on screen from BIOS data area (100% IBM PC only)(Y/N)? [N] :
FOR NON EGA/VGA SYSTEMS ONLY. Set this option to <Y> if you want
the editor to automatically detect the number of rows on your
screen.
You should set this option to 25 unless you have a special card and
monitor (such as a Genius Video System) that allow you to display
more than 25 rows.
* Do you want the Return command to split lines in Insert mode (Y/N)? [Y] :
Normally, the Return command splits the current line at the cursor
when executed with Insert mode ON. This means that the portion of
the line following the cursor is inserted on a new line. If Insert
mode is OFF, the Return command simply places the cursor at the
beginning of the next line.
If you select <N> for this option, the Return command always acts as
if Insert mode is OFF. Return moves the cursor to the beginning of
the next line with no effect on the text.
* Should Cut and Copy use current line if no block marked (Y/N)? [N] :
If you enter <Y> for this option, the current cursor line is used
when you execute the Cut or Copy command and no Block is marked in
the current file.
* Do you want the Escape command to invoke the menus (Y/N)? [Y] :
By default, the Escape command displays the pull-down menu, when
executed outside of the menu or any editor prompts. If you do NOT
want the Escape command to do this, select <N> for this option.
* Should the editor restore the starting drive/dir on program exit (Y/N)? [Y] :
Set this option to <Y> if you want to return to the original DOS
drive and directory on program exit regardless of which drives and
directories you have accessed with the editor's directory picker or
the Dos or Shell commands.
* Should the editor change the DOS PROMPT during a shell (Y/N)? [N] :
Set this option to <Y> if you want the following to be appended to
the DOS prompt during an editor Shell: [JR].
If you are using DOS 3 or above and you store all supplemental files
in the same directory as the editor, you do not need to set this
option.
To select the amount of time that you must hold down the mouse
button before the editor begins repeating a mouse-executed command,
set this option to the desired value, from 1 through 36. The time
is measured in terms of machine timer ticks, in 1/18-second
increments.
To control the amount of time that the editor delays between each
repetition of a mouse-executed command, set this option to an
appropriate value, from 0 through 32767. This option is hardware
dependent, and is relative to the speed of your particular machine.
To slow down repetition, increase the value of this option; to speed
up repetition, decrease the value.
<Shift Cursor Left> Mark/extend Block and move left one character
<Shift Cursor Right> Mark/extend Block and move right one character
<Shift Cursor Up> Mark/extend Block and move up one line
<Shift Cursor Down> Mark/extend Block and move down one line
<Shift Home> Mark/extend Block and move to beginning of line
<Shift End> Mark/extend Block and move to end of line
<Shift PgUp> Mark/extend Block and move up one page
<Shift PgDn> Mark/extend Block and move down one page
Set this option to <N> to have the shifted cursor keys operate
according to their assignments in QCONFIG.DAT.
This section contains a list of the Screen and Screen Color Options
which can be customized using the configuration program. The
configuration program prompt message, the default value, and a
description are given for each option.
�������������������������������������������������������������Ŀ
�L 15-- C 15---IAW-BS--411K-----*c:\semware\editor.doc--------�
���������������������������������������������������������������
* Do you want the original screen restored upon termination (Y/N)? [Y] :
Determines whether the editor is to restore the original screen upon
exiting the program. Be aware that setting this option to <Y>
causes the editor to require an additional 4K of memory; however,
this can be very handy after long editing sessions to see what you
were doing before you started.
If this option is set to <Y>, and the editor determines that your
system has a Color/Graphics Adapter card (CGA), the editor does not
write to the screen at full speed, in order to avoid "snow". If you
have a CGA card that does not create snow effects, set this option
to <N> so that the editor updates the screen as quickly as possible.
If you have a VGA, EGA, COMPAQ, ZENITH, or other color adapter that
allows full speed screen updating without "snow", then set this
option to <N>.
If you select <Y> for either of the previous two options, the following
color chart and screen display options are presented:
��������������������������������������������������������������������������������Ŀ
�Attribute chart/guide. [0..127] �
� �
�[ 0][ 1][ 2][ 3][ 4][ 5][ 6][ 7][ 8][ 9][ 10][ 11][ 12][ 13][ 14][ 15]�
�[ 16][ 17][ 18][ 19][ 20][ 21][ 22][ 23][ 24][ 25][ 26][ 27][ 28][ 29][ 30][ 31]�
�[ 32][ 33][ 34][ 35][ 36][ 37][ 38][ 39][ 40][ 41][ 42][ 43][ 44][ 45][ 46][ 47]�
�[ 48][ 49][ 50][ 51][ 52][ 53][ 54][ 55][ 56][ 57][ 58][ 59][ 60][ 61][ 62][ 63]�
�[ 64][ 65][ 66][ 67][ 68][ 69][ 70][ 71][ 72][ 73][ 74][ 75][ 76][ 77][ 78][ 79]�
�[ 80][ 81][ 82][ 83][ 84][ 85][ 86][ 87][ 88][ 89][ 90][ 91][ 92][ 93][ 94][ 95]�
�[ 96][ 97][ 98][ 99][100][101][102][103][104][105][106][107][108][109][110][111]�
�[112][113][114][115][116][117][118][119][120][121][122][123][124][125][126][127]�
� �
�Select attributes from the chart above. �
����������������������������������������������������������������������������������
The chart above is for use with the following Screen Color Options.
Enter a number, in response to each option, based on the color in which
the number appears on the chart.
If you have a monochrome screen, many of the values in the chart will
appear to be the same color. However, you still have the options of
normal, highlighted, underlined, and reverse video. If you have a color
monitor, you can take advantage of a wider array of options. (The
default monochrome setting is shown in the text of each prompt message
below. The default color setting is shown to the right of the prompt
message.)
* Attribute for Blocked Text [112]: Default Color Setting: [120]
The color used for marked Blocks.
* Attribute for Display Box Border [15]: Default Color Setting: [31]
The color used for the border around the editor, if the editing
screen is boxed.
* Attribute for Selected Menu items [112]: Default Color Setting: [32]
The color used for selected items within the pull-down menus.
* Attribute for Menu Quick Letter [15]: Default Color Setting: [116]
The color used for the highlighted quick-key letter for each item
listed on the pull-down menus.
GENERAL OPTIONS
����������������������������������������������������������������������
* Do you want the DelCh command to join lines if at EOL (Y/N)? [Y] :
Affects the behavior of the DelCh command. Set this option to <N>
if you want the DelCh command to be restricted so that it only works
on the current line. Set this option to <Y> if you want the DelCh
command to work across line breaks. This means that if you issue
DelCh at the end of the line, the following line is joined to the
end of the cursor line (just as if you had issued a JoinLine
command).
* Do you want PQuit, Exit, and File to return to EditFile prompt (Y/N)? [Y] :
If only 1 file is being edited, the editor can either terminate or
ask for another file to edit whenever the PQuit, Exit, or File
commands are executed. To have the editor terminate, select <N>.
* Use CMODE for .c, .cpp, .cxx, .h, .hpp, and .hxx files (Y/N)? [Y] :
Set this option to <Y> if you want C mode to be ON each time the
editor is started; otherwise, set it to <N>. Refer to the "Modes"
section of Chapter 1 for more information on C mode.
* Do you want a beep on warning messages and missed searches (Y/N)? [Y]:
Determines whether the editor sounds the bell on any warning message
and when there is no match resulting from a Find or FindReplace
operation. If you want the bell to sound, select <Y>; otherwise,
select <N>.
Note that even when these options are not selected as defaults, they
can still be selected from within the editor when the Find command
is executed. For more information on the Find command and the
available Find options, refer to the "Finding Text" section of
Chapter 1.
Note that even when these options are not selected as defaults, they
can still be selected from within the editor when the FindReplace
command is executed. For more information on the FindReplace
command and the available FindReplace options, refer to the
"Replacing Text" section of Chapter 1.
* Should Find and RepeatFind center the found text (Y/N)? [Y]
Affects the editor's behavior when the Find, RepeatFind, or
IncrementalSearch commands are executed. Set this option to <Y> to
have the line containing the found text centered vertically within
the current window. Set this option to <N> to have line containing
the found text positioned on the same row as the current line.
If the filename entered does not end with a period (and does not
include the DOS wildcard characters) and that file does NOT exist as
named, the editor appends the first default file extension to the
name and tries to load that file. If that file exists, then the
editor loads it for editing. If it does not exist, the editor
repeats the process with the other default file extensions. If no
matching file is found, then the editor creates a new file as
originally named.
For each of the six previous options, enter the desired file
extension.
The editor allows you to create a customized one-page Help Screen, which
may be displayed at any time from within the editor by executing the
QuickHelp <F1> command. This section contains instructions for
installing your own Help Screen using the configuration program.
Of course, you may prefer to use the default Help Screen which is
already loaded into the editor. In that case no action is required.
However, if you want to design and use your own Help Screen, simply
follow these steps:
1. Create an 80 x 25 (80 columns by 25 lines) text file (you can use the
editor to create this file) and list all of the information that
should appear on the screen when the QuickHelp command is executed.
We suggest that you list less frequently used commands in this file,
while leaving out more familiar commands such as cursor movement and
paging.
2. Run QCONFIG and select option <H> from the configuration menu.
3. At the prompt, enter the name of the Help file just created.
That is all there is to it! Now when you execute QuickHelp from within
the editor, your customized Help Screen is displayed.
KEYBOARD CONFIGURATION
����������������������������������������������������������������������
By taking a few minutes to review this section, your future text editing
may become significantly more comfortable as a result of customizing
your keyboard to suit your individual preferences.
The editor uses the Keyboard Definition file to customize the keyboard.
This file contains a list of all the keys to which commands may be
assigned. Supplied with the editor is a Keyboard Definition file called
QCONFIG.DAT which contains the default settings for the keyboard. Other
files are supplied which emulate certain common word processors and
editors. The READ.ME file contains a list of these other emulations.
@c or @C specifies Alt C
@PgUp specifies Alt PgUp
f1 QuickHelp
#f5 MakeCtrofScreen
@f2 InsertLine
cursorup CursorUp
^cursorleft WordLeft
@a DropAnchor
^a WordLeft
��������������������������������������������������������������Ŀ
� Tip: �
� The configuration program ignores the case of the key �
� name, and ignores the case of the commands and of any �
� underscores that may be embedded in the commands. This �
� means that PGUP, PgUp, and pgup all refer to the same key, �
� and InsertLine, insert_line, and Insert_Line all refer to �
� the same command. �
� �
� Also, the order of the keys does not matter. The �
� configurable keys may be put in any order desired. �
����������������������������������������������������������������
^f1_f2 Exit
(Note that if you assign a command or macro to a single key, and then
use that same key as the initial key of a two-key sequence, you lose the
two-key assignment. For example, if you assign a command to <Ctrl B>,
you would not be able to use a two-key assignment such as <Ctrl B A>.)
To allow you to further customize the editor, multiple commands and/or
text can be assigned to any configurable key (or two-key). This is
accomplished through the use of macros. For more information on
creating macros and assigning them to keys, refer to "Creating Macro
Programs" in the file MACRO.DOC.
The following outlines steps to create and install your own Keyboard
Definition file. (To customize the keyboard using one of the supplied
word-processor or editor emulation Keyboard Definition files, skip to
step number 6.)
1. Load the file QCONFIG.DAT into the editor. (From the DOS command
line, type "q qconfig.dat" and press <Enter>).
3. Browse through the file using the Cursor Up and Down keys. Notice
that the left side of the file contains a list of all configurable
keys. To the right of each key is the command or macro currently
assigned to the key. Some keys have no commands assigned.
5. Save the file and exit the editor by pressing <Alt X>.
7. You will be prompted for the name of the Keyboard Definition file.
Enter the name of the Keyboard Definition file you wish to load. If
you are creating your own file, enter the new name chosen in step 2.
8. Your key assignments are then incorporated into the editor program,
Q.EXE, and the configuration menu reappears.
10. Run the editor to insure that your key assignments function as
desired.
PRINTER OPTIONS
����������������������������������������������������������������������
TAB SETTINGS
����������������������������������������������������������������������
This section contains a list of all Tab Setting Options which can be
customized using the configuration program. The configuration program
prompt message, the default value, and a description are given for each
option.
* Do you want the editor to start in Physical Tab Expansion mode (Y/N)? [Y] :
Determines whether Physical Tab Expansion mode is initially ON or
OFF each time the editor is executed. Set this option to <Y> if you
want Physical Tab Expansion mode to be ON each time the editor is
started; otherwise, set it to <N>. Refer to the "Modes" section of
Chapter 1 for more information on Physical Tab Expansion mode.
* Do you want the editor to start in Tabs Out mode (Y/N)? [N] :
Determines whether Tabs Out mode is initially ON or OFF each time
the editor is executed. Set this option to <Y> if you want Tabs Out
mode to be ON each time the editor is started; otherwise, set it to
<N>. Refer to the "Modes" section of Chapter 1 for more information
on Tabs Out mode.
The editor allows you to set default physical and cursor tab widths
for up to six different file extensions. When a file is loaded that
matches one of these extensions, the indicated defaults are used.
Otherwise, the defaults set in the previous two default tab options
are used.
For each of the six options, enter the desired file extension and
the appropriate physical and cursor tab width values.
If you press <Enter> without entering any tabs stops, you are
prompted with:
Select <Y> to remove all existing Variable Tab stops. Select <N> to
leave the tab stops unchanged.
CHAPTER 3. COMMAND REFERENCE
����������������������������������������������������������������������
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 simply
moves the cursor to the next line.
AltWordSet
��������������������������������������������������������������������
Instructs the editor to recognize an expanded set of characters as
"word" characters.
DelLtWord MarkWord
DelRtWord *RepeatFind
*Find SwapWords
*FindReplace WordLeft
isWord WordRight
AsciiChart <Esc><O><T>
��������������������������������������������������������������������
Displays a scrollable ASCII chart on the screen. Press <Enter> to have
the selected character inserted into the text at the current cursor
position. Press <Esc> to remove the ASCII chart from the screen without
placing a character into the text.
When the ASCII chart is initially displayed, the cursor bar is located
on the entry that corresponds to the character at the cursor position in
the text; or on the first item in the ASCII chart (the null character),
if the cursor is positioned beyond the end of the line.
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.
BegLine <Home>
��������������������������������������������������������������������
Positions the cursor at column one of the current cursor line.
With the cursor inside of a line Block, you can execute this command to
center several lines at once. With the cursor inside of a column Block,
you can center lines based on the left and right Block boundaries.
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.
CursorDown <Cursor Down>
��������������������������������������������������������������������
Moves the cursor downward in the file to the next line.
DefaultWordSet
��������������������������������������������������������������������
Re-installs the default word set. Refer to the AltWordSet command for
more information about word sets.
DelCh <Del>
��������������������������������������������������������������������
Deletes the character at the current cursor position. The text on 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.
DirTree <Esc><F><I>
��������������������������������������������������������������������
Displays a pick list of all the drives on your system, along with a
directory tree for the current drive. The current drive or directory
can be changed from this pick list.
��������������������������������������������������������������Ŀ
� Tip: �
� You should NOT execute any TSR (terminate and stay �
� resident) programs from the editor's Dos command. This �
� includes the DOS print and graph commands, and �
� memory-resident programs such as Sidekick and Superkey. �
����������������������������������������������������������������
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.
The option "Load wildcarded filespecs from inside the editor" has an
effect on the behavior of this command when wildcard characters are
included. (Refer to the "General Options" section of Chapter 2.)
EndLine <End>
��������������������������������������������������������������������
Positions the cursor immediately following the last non-blank character
on the cursor line.
EndPara
��������������������������������������������������������������������
Positions the cursor immediately following the last nonblank character
of the current paragraph.
Escape <Esc>
��������������������������������������������������������������������
If executed while editing, the pull-down menus are displayed.
Otherwise, this command terminates any editor prompt.
� Save Changes? Ŀ
��Yes�������������
� No �
� Cancel �
������������������
Press <Y> to save and then discard the file. Press <N> to discard the
file without saving any changes. Press <C> or <Esc> to halt the command
and return control back to the editor, without saving or quitting the
file.
The editor 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.
The editor 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.
At every occurrence of the search string in the file, the User is given
the following replace options (unless the [N] or [#] serach option is
specified):
[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.
[R] Replace the search string with the replace string for this and
the rest of the 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 does not have any non-white characters. "White"
characters are tabs or spaces. A useful macro would be:
� Save Changes? Ŀ
��Yes�������������
� No �
� Cancel �
������������������
Press <Y> to save and then discard the file. Press <N> to discard the
file without saving any changes. Press <C> or <Esc> to halt the command
and return control back to the editor, without saving or quitting the
file.
For example, if you have ten files loaded and two of them have been
modified, then you are prompted to save changes twice, once for each
modified file.
GotoColumn <Esc><S><G>
��������������������������������������������������������������������
Positions the cursor at the requested column. The editor prompts for
the desired column number.
GotoFirstLine
��������������������������������������������������������������������
Positions the cursor on the beginning line of the current file. The
column position is not changed.
GotoLastLine
��������������������������������������������������������������������
Positions the cursor on the last line of the current file. The column
position is not changed.
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.
<Ctrl B> Searches forward from the beginning of the file for
the first occurrence of the current
IncrementalSearch string.
InsertDate
��������������������������������������������������������������������
Inserts the system date at the current cursor position.
InsertTime
��������������������������������������������������������������������
Inserts the system time at the current cursor position.
isBegLine
��������������������������������������������������������������������
This command is intended for use only within macros.
isCurrChar
��������������������������������������������������������������������
This command is intended for use only within macros.
isCurrChar char
Examples:
isCurrChar 'a'
JTrue found:
isCurrChar #97
JTrue found:
isCursorInBlock
��������������������������������������������������������������������
This command is intended for use only within macros.
Returns TRUE if the current line is empty or contains only white space;
otherwise, FALSE is returned.
isEndLine
��������������������������������������������������������������������
This command is intended for use only within macros.
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.
isFirstLine
��������������������������������������������������������������������
This command is intended for use only within macros.
Returns TRUE if the cursor is on the first line of the currently edited
file; otherwise, FALSE is returned.
isLastLine
��������������������������������������������������������������������
This command is intended for use only within macros.
Returns TRUE if the cursor is on the last line of the currently edited
file; otherwise, FALSE is returned.
isWord
��������������������������������������������������������������������
This command is intended for use only within macros.
JFalse
��������������������������������������������������������������������
This command is intended for use only within macros.
JTrue
��������������������������������������������������������������������
This command is intended for use only within macros.
Jump
��������������������������������������������������������������������
This command is intended for use only within macros.
ListFiles <Esc><F><T>
��������������������������������������������������������������������
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 <Esc>.
LocateFile <Esc><F><A>
��������������������������������������������������������������������
Searches an entire drive for a specified filename. A list of all
matching filenames is displayed, allowing the user to select the
appropriate file to edit.
This command prompts for the filename for which to search. A complete
name or an ambiguous name (with DOS wildcard characters) can be
specified. By default, the current drive is searched. However, a
different drive can be searched by prefacing the filename with the drive
name (such as, d:foo). The default or specified drive is searched, and
all matching filenames are displayed in a pick list. To select the
desired file to edit, position the cursor bar on that filename in the
pick list, and press <Enter>. To remove the pick list, press <Esc>.
MacroQuit
��������������������������������������������������������������������
This command is intended for use only within macros.
MacroQuitFalse
��������������������������������������������������������������������
This command is intended for use only within macros.
MacroQuitTrue
��������������������������������������������������������������������
This command is intended for use only within macros.
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.
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 pull-down 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.
MakeTopofScreen <F5>
��������������������������������������������������������������������
Scrolls the text in the window so that the cursor line becomes the top
line of the window.
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.
Note that the editor uses the MarkCharacter command to provide a set of
CUA-style Block-marking keys (using the shifted cursor keys). Refer to
"CUA-Style Block Marking" in Chapter 1.
MouseMenu
��������������������������������������������������������������������
Pops up a menu of Block-related commands. This command provides access
to a list of Block-related commands for easy selection using a mouse.
When invoked, a menu similar to the following is displayed:
If the mouse is not used, this menu can still be accessed by assigning
this command to a key.
NewFile
��������������������������������������������������������������������
Executes the Exit <Ctrl K D> command followed by the EditFile <Alt E>
command. Refer to the Exit and EditFile commands in this chapter for
more information.
NextEqualIndent
��������������������������������������������������������������������
Moves the cursor to the next line whose text starts in the same column
as the current line. If the current line is blank, moves to the next
blank line.
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 on the first character of the next paragraph.
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.
� Lose Changes? Ŀ
��Yes�������������
� No �
� Cancel �
������������������
Press <Y> to quit the current file. Press <N>, <C>, or <Esc> to cancel
the command, without discarding the current file.
If multiple files are being edited, this command makes the previous file
in the ring the new current file.
The editor 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.
PrevEqualIndent
��������������������������������������������������������������������
Moves the cursor to the previous line whose text starts in the same
column as the current line. If the current line is blank, moves to the
previous blank line.
PrevPara
��������������������������������������������������������������������
Positions the cursor on the first character of the previous paragraph.
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!
RestoreSettings
��������������������������������������������������������������������
This command is intended for use only within macros.
Return <Enter>
��������������������������������������������������������������������
The Return command behaves differently depending on Insert mode and
AutoIndent mode.
The Return command can be configured to split or not split lines when
Insert mode is ON. Refer to the "Advanced Options" section of Chapter 2
for more information.
SaveSettings
��������������������������������������������������������������������
This command is intended for use only within macros.
Saves the current settings of: Insert, AutoIndent, WordWrap, Sound, and
Screen Updating. See RestoreSettings.
SetAutoIndentMode
��������������������������������������������������������������������
This command is intended for use only within macros.
Sets AutoIndent mode ON. To set AutoIndent mode OFF, do the following:
SetAutoIndentMode ToggleIndent
SetBakups
��������������������������������������������������������������������
This command is intended for use only within macros.
Enables the automatic creation of file backups, which causes the editor
to create a backup file using the ".bak" file extension whenever a
modified file is saved. (Refer to ToggleBakups for more information.)
SetBoxDraw
��������������������������������������������������������������������
This command is intended for use only within macros.
Enables Box Drawing mode. The letter "B" appears on the StatusLine when
this mode is ON. (Refer to ToggleBoxDraw for more information.)
SetCenterFinds
��������������������������������������������������������������������
This command is intended for use only within macros.
Enables Find centering, which causes the Find and FindReplace commands
to center the found text vertically in the window. (Refer to
ToggleCenterFinds for more information.)
SetCtabwidth <Esc><O><C>
��������������������������������������������������������������������
Sets the cursor tab width. This is the width that is used when the
TabRt or TabLt commands are executed and Fixed Tabs mode is in effect.
SetCUAMarking
��������������������������������������������������������������������
This command is intended for use only within macros.
Enables CUA-Style Block Marking mode, which defines shifted cursor keys
to be used to mark Blocks. (Refer to ToggleCUAMarking for more
information.)
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 card to 43-line mode, or a monitor with a
VGA card to 50-line mode. This command has no effect if the video card
is not an EGA or VGA type.
SetEnterMatching
��������������������������������������������������������������������
This command is intended for use only within macros.
SetInsMode
��������������������������������������������������������������������
This command is intended for use only within macros.
Sets Insert mode ON. To set Insert mode OFF (that is, set overwrite
mode ON), do the following:
SetInsMode ToggleInsert
SetPrintAddFF
��������������������������������������������������������������������
This command is intended for use only within macros.
� Print Device Ŀ
��PRN������������
� LPT1 �
� LPT2 �
� LPT3 �
� Disk File... �
�����������������
����������������������������������������������������������Ŀ
� Printer line spacing [1=single, 2=double, etc.]: �
� �
������������������������������������������������������������
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.
SetScreenOff
��������������������������������������������������������������������
This command is intended for use only within macros.
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: The editor AUTOMATICALLY turns screen updating back ON when the
macro is finished executing. Thus, it is not necessary to issue
the SetScreenOn command at the end of the macro.
SetScreenOn
��������������������������������������������������������������������
This command is intended for use only within macros.
SetSortCaseInsensitive
��������������������������������������������������������������������
This command is intended for use only within macros.
SetSortDescending
��������������������������������������������������������������������
This command is intended for use only within macros.
SetSoundOff
��������������������������������������������������������������������
This command is intended for use only within macros.
SetSoundOn
��������������������������������������������������������������������
This command is intended for use only within macros.
SetSwap
��������������������������������������������������������������������
This command is intended for use only within macros.
Enables swapping to expanded memory or disk when the Shell and Dos
commands are executed. (Refer to ToggleSwap for more information.)
SetSyncScroll
��������������������������������������������������������������������
This command is intended for use only within macros.
SetTabsExpand
��������������������������������������������������������������������
This command is intended for use only within macros.
SetTabsOut
��������������������������������������������������������������������
This command is intended for use only within macros.
Sets Tabs Out mode ON. (Refer to ToggleTabsOut for more information.)
SetTabType <Esc><O><Y>
��������������������������������������������������������������������
Determines the behavior of the tab key based on the tab type selected.
Choices are Fixed, Smart, and Variable. (Refer to the "Modes" section
of Chapter 1.) When executed, the following menu is displayed:
SetVarTabStops <Esc><O><V>
��������������������������������������������������������������������
Allows the setting of the tab stops used when Variable tab type is
selected.
SetVGA28
��������������������������������������������������������������������
Switches a monitor with a VGA card to 28-line mode. This command has no
effect if the video card is not a VGA type.
SetWordWrapMode
��������������������������������������������������������������������
This command is intended for use only within macros.
Sets WordWrap mode ON. To set WordWrap mode OFF, do the following:
SetWordWrapMode ToggleWordWrap
��������������������������������������������������������������Ŀ
� Tip: �
� You should NOT execute any TSR (terminate and stay �
� resident) programs from the editor's Shell command. This �
� includes the DOS print and graph commands, and �
� memory-resident programs such as Sidekick and Superkey. �
����������������������������������������������������������������
To use this command, the option "Do you want the original screen
restored upon termination (Y/N)?" must be set to "Y" (the default
setting). This option is set via the QCONFIG program, under
"Colors/screen."
Note: The Sort command can only be used with a single, nonzoomed window
on the screen.
SpacesToTabs <Esc><O><M>
��������������������������������������������������������������������
Compresses occurrences of multiple spaces to tabs, where appropriate.
Spaces within quotes (single and double) are not compressed. If the
cursor is within a marked Block when this command is executed, only
spaces within the Block are compressed; otherwise, this common operates
on the entire file.
SwapChars
��������������������������������������������������������������������
Swaps the character at the cursor position with the character preceding
the cursor. The cursor column position does not change. If, when this
command is executed, the cursor is in column 1, or is positioned beyond
the last non-blank character of the line, then no action occurs.
SwapWords
��������������������������������������������������������������������
Swaps the word in which the cursor is positioned with the previous word
on the current line. Any "non-word" characters between the affected
words are preserved. If, when this command is executed, the cursor is
not positioned on a character within a word, or if there is no previous
word on the current line, then no action occurs.
The editor can be configured so that if Insert mode is ON, AND the
cursor is inside a marked Block, the entire Block shifts left by the
current cursor tab width. For more information on this option, refer to
the "Advanced Options" section of Chapter 2.
TabRt <Tab>
��������������������������������������������������������������������
Positions the cursor at the next tab position, as defined by the cursor
tab width. If Insert mode is ON, the text to the right, including the
character at the cursor position, shifts right.
The editor can be configured so that if Insert mode is ON, AND the
cursor is inside a marked Block, the entire Block shifts right by the
current cursor tab width. For more information on this option, refer to
the "Advanced Options" section of Chapter 2.
TabsToSpaces <Esc><O><X>
��������������������������������������������������������������������
Expands tab characters to the appropriate number of spaces. Tabs within
quotes (single and double) are not expanded. If the cursor is within a
marked Block when this command is executed, only tabs within the Block
are expanded; otherwise, this command operates on the entire file.
ToggleBakups <Esc><O><B>
��������������������������������������������������������������������
Toggles (ON and OFF) file backups. If ON, the editor creates a backup
file using the ".bak" file extension whenever a modified file is saved.
The letter "B" appears on the StatusLine when this mode is ON.
ToggleCenterFinds <Esc><S><C>
��������������������������������������������������������������������
Toggles (ON and OFF) Find centering. If ON, this causes the Find,
FindReplace, and IncrementalSearch commands to center the found text
vertically on the screen. If OFF, the initial row the cursor was on when
the command was initiated does not change.
ToggleCUAMarking
��������������������������������������������������������������������
Toggles (ON and OFF) CUA-Style Block Marking mode. If ON, the shifted
cursor keys can be used to mark non-inclusive character Blocks. (Refer
to "CUA-Style Block Marking" in Chapter 1.)
ToggleEnterMatching <Esc><O><E>
��������������������������������������������������������������������
Toggles (ON and OFF) EnterMatching mode. If ON, the double quote,
parenthesis, square bracket, and curly brace keys all automatically
enter the matching right-hand character when the left-hand character is
entered. For example, typing the "[" key automatically enters a "]"
immediately following.
The letter "A" appears on the StatusLine when this mode is ON.
The letter "I" appears on the StatusLine when this mode is ON.
TogglePrintAddFF <Esc><P><R>
��������������������������������������������������������������������
Toggles (ON and OFF) the automatic sending of a formfeed character to
the printer when printing is complete. If ON, the editor automatically
sends a final formfeed character when printing is complete (after the
last printed page).
ToggleShowCurrChar <Esc><O><H>
��������������������������������������������������������������������
Toggles (ON and OFF) the display of the ASCII and Hexadecimal values of
the current character on the StatusLine. When ON, the ASCII and Hex
values of the current character are displayed in the far right portion
of the StatusLine. If the cursor is past the end of the text on the
line, <EOL> is displayed.
ToggleSortCaseInsensitive <Esc><B><I>
��������������������������������������������������������������������
Toggles (ON and OFF) case-insensitive sorting. When ON, upper and lower
case letters are sorted as if they are of the same case. When OFF,
upper and lower case letters are sorted strictly by their ASCII value,
which places all upper case letters before the lower case letters.
ToggleSortDescending <Esc><B><N>
��������������������������������������������������������������������
Toggles (ON and OFF) descending sorting. When ON, sorting is performed
from highest value to lowest value (descending). When OFF, sorting is
performed from lowest value to highest value (ascending).
ToggleSwap <Esc><O><S>
��������������������������������������������������������������������
Toggles (ON and OFF) swapping to expanded memory or disk when the Shell
<F9> and Dos <Alt F9> commands are executed. (You can specify a default
for swapping, using the configuration program. Refer to the "Advanced
Options" section of Chapter 2 for more information.)
If ON, the editor swaps itself out of DOS memory and to expanded memory
or disk when a shell command is executed. This leaves a small 2K editor
kernel in DOS memory, freeing up the rest of DOS memory for running
other applications out of the shell such as compilers or spreadsheets.
While you are in a shell, the editor maintains a file with a ".SWP" file
extension in your root directory. It is very important that you do not
delete this file while in the shell.
The letter "S" appears on the StatusLine when this mode is ON.
ToggleVarTabs
��������������������������������������������������������������������
Toggles (ON and OFF) Variable Tabs mode. When ON, tab stops are set to
those specified by the SetVarTabStop command, or by the default set by
the configuration program. When OFF, tab stops are set to a fixed tab
width, as specified by the SetCTabWidth command.
ToggleVGA28
��������������������������������������������������������������������
Toggles a VGA monitor between 25-line and 28-line mode. This command
has no effect if the video card is not a VGA type.
The letter "W" appears on the StatusLine when this mode is ON.
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.
WinClipCopy
��������������������������������������������������������������������
Copies the marked Block into the Microsoft Windows Clipboard. The Block
is then unmarked.
��������������������������������������������������������������Ŀ
�File to write: �
� �
����������������������������������������������������������������
Enter the new filename. If the filename you specify already exists,
the editor prompts with: