BILL'S EDITOR

Copyright 1986 by

Mueller's PC Consulting - William H. Mueller
6050 W. 82nd Drive Arvada, CO. 80003
Phone Number: (303) 424-3696
CompuServe Number - 75166.2557

Shareware fee - $20.00

---- Copyright on this software and manual is possessed by:
William H. Mueller (dba Mueller's PC Consulting)
and is protected by United States Copyright Law.
---- License Statement
You are licensed to use this product on a trial basis. If
you decide to make this program a part of your software library
then please send a fee of $20.00 to the author to encourage
further development and other products (& keep me in business).
Whether you decide to keep this product or not, please pass
this program and documentation along for others to look at.

---- Warranty
This product is warranted to perform as outlined in this
manual and within the limitations of being used in an
environment as stated in the System specifications. With the
various hardware and software environments into which this
program may be put, no warranty of fitness for a particular
purpose is offered. Any liability of the seller will be limited
exclusively to product replacement. This software and manual are
distributed without warranties as to performance of purpose or
any other warranties whether expressed or implied.

---- Welcome to Bill's Editor.
I think you will find this Editor to be very easy to use.
The Editor is designed to allow you to perform simple text
editing chores without any memorizing of awkward special
commands or unneeded features getting in your way.
Any tool has its intended purpose and job that it is suitable
for. A hammer versus a sledgehammer. A car versus a truck. The
same is true with my Editor. For truly complex jobs requiring
headers, footnotes, hyphenation, or any of the other complexities
of Word Processing, you should indeed use a full featured Word
Processing software package. But using a full featured Word
Processing package to modify a DOS batch file or to type up a
short note/letter borders on the absurd.
Everyone should have on hand a simple, easy to use editor to
take care of these simple chores. An editor like this should have
come with your computer's operating system.
Once you are familiar with the basic word processing concepts
and have grown accustomed to this Editor, I think it will become
like any other tool you have. You will be able to not use this
Editor for a while and, when the need arises, use it again without
having to reintroduce yourself to the program.
In this spirit, I ask you to use my Editor and see for yourself
its ease of use. Any comments or suggestions concerning my Editor
will be welcome. Future revisions will be based on this user input.
Please enjoy.



Table of Contents

GENERAL
Installation ........................... 1
Usage and Screen ....................... 2
System requirements/technical notes .. 2
Usage from DOS ....................... 2
Screen ............................... 3
Command Line Area .................. 4
Print Status Line .................. 4
Editor Status Lines ................ 5

USE OF KEYBOARD
Cursor Movement Keys ................... 6
Deletion Keys .......................... 7
Other Keys ............................. 7

FUNCTION KEY COMMANDS
FUNCTION KEY MENU ...................... 9
-Help Screen ....................... 9
-Directory ......................... 10
-File & Exit ....................... 10
xit w/ file save .................. 10
uit - NO save of file ............. 11
ave file & continue edit .......... 11
ew file ........................... 11
o ............................... 11
es & Save current ............... 11
-Yes - but don't save current ... 11
-Block ............................. 12
-block begin & -block end ...... 12
opy block ......................... 13
ove block ......................... 13
elete block ....................... 13
emove block markers ............... 13
-Screen Format ..................... 14
ord Wrap .......................... 14
ab width .......................... 14
eft Margin ........................ 14
ight Margin ....................... 15
ormat paragraph ................... 15
uto Indent ........................ 15
-Print ............................. 16
ines per page ..................... 16

rint left margin .................. 17
umber pages ....................... 17
itle on page ...................... 17
ile print ......................... 17
lock print ........................ 17
-Search ............................ 18
ind text .......................... 18
eplace text ....................... 19
o to line ......................... 20
-Repeat search .................... 20


This documentation was originally written to be distributed via
normal marketing methods. Since it is now being distributed via
shareware marketing, the documentation doesn't always read true
in regards to installation but the intended sense is still there.

---- Installation
The first step to take on any installation is to make a backup
copy of your master program disk. To do this, insert Bill's Editor
master disk into drive A and a blank formatted disk into drive B.
On a single floppy system, have a blank formatted disk handy; DOS
will prompt you to swap the disks as necessary. At the DOS prompt,
type:
COPY A:BEDIT.COM B:

--- Floppy based system:
On a floppy based system, repeat the above procedure to obtain
a work disk. If you wish to boot your computer from this disk,
the blank formatted disk should have had your DOS system put on it
at the time it was formatted. You would end up with three disks:
1. Master disk - your original Editor disk. Store this disk
in a safe place. This should be some place that is not readily
accessible to the computer operator. This disk should be used
again only if all the other copies of the program are bad. Do NOT
use this disk in daily operations!
2. Backup disk - again, store this copy in a safe place. If
your Editor work disk should ever get damaged or wear out, this is
the disk to use to make a new working copy.
3. Work disk - this is the disk you would use in your daily
operation of the computer.

--- Hard disk based system:
On a hard disk system, you would still want to make the Backup
disk for safety's sake. Of course, for a working copy to use, you
would want to install a copy of the Editor onto your hard disk.
Hard disk configurations and their use can vary quite a bit
depending on the customer. I will describe a typical hard disk
setup.
If you have a hard disk, you should unquestionably also be
using sub-directories. No more programs than are absolutely
necessary (CONFIG.SYS, AUTOEXEC.BAT & COMMAND.COM for DOS 2.x)
should be loaded into your root directory. All other programs
should be put into their own sub-directory along with associated
files.
Besides serving the purpose of logically setting up your hard
disk for efficient use, a structure as described here would even
allow the recovery of a lot or most of your data on the hard disk
in the case of an accidental reformatting of the disk. Something
to consider. If you have questions concerning hard disks and
sub-directories, please consult your DOS manual. As a hard disk
owner, you may also wish to issue the appropriate PATH command to
call the Editor from anywhere in your system.

-- Example Hard disk installation:
Make a sub-directory on your hard disk. For the sake of this
example, I am assuming that your hard disk is your C drive and the
name you wish to give your sub-directory is WORD. Substitute as
necessary:
MD C:\WORD
COPY A:BEDIT.COM C:\WORD
(Page. 1)




---- Usage and Screen
--- System requirements and misc. technical notes:
Bill's Editor has these system requirements:
1. Computer - IBM PC, XT, AT or true compatible.
2. DOS - Version 2.0 or later.
3. 80 column x 25 row monitor.
4. Memory - minimum 128k, more memory will allow the
editing of larger files. The Editor itself needs to
have about 86k available for it when invoked. This
allows space for the Editor and about 5.5k of
workspace for your text file.
The Editor is a RAM based editor. This means that any file to
be edited must fit in available memory space. The editor will
reject for editing any file which is larger than available memory.
If, during editing, all available memory is consumed, the Editor
will inform you of that fact. At that point, you may either save
the file or delete some text to increase available memory.
The actual disk file you are editing is not modified in any
way by the Editor until you save the file to disk. You can
actually lose power to the computer while editing and all you will
have to reconstruct is the changes you have just made. During an
editing session, you may save the latest changes to disk whenever
you wish and continue editing. This will minimize any possible
loss of editing changes in the event of a power interruption or
computer lockup. (Sorry to have to talk about such things, but
they do happen occasionally.)
The Editor does not create any backup files that you have to
be constantly deleting from your disk. The Editor will overwrite
the original file when you save the file. If you wish to edit a
file and still have the original file available for some other
use, you will want to use the DOS COPY command to make a copy of
your original file under a different name prior to editing.
If you specify a filename that does not presently exist, the
Editor will ask you to confirm that you wish to create a new file.
This simple confirmation will save you a bit of trouble if you
have mis-typed the name of an existing file.

---- Usage from DOS:
Bill's Editor conforms to the normal DOS calling conventions.
This means that you may invoke the Editor (program name is BEDIT)
in any fashion that is supported by your version of DOS.
The Editor may be invoked with or without an initial
filename to be edited. If no filename ia given on the DOS
command line, or the filename does not conform to DOS rules for
naming files, the Editor will default to a filename of
"TEXT.DFT". I recommend that you use your own filenames when
invoking the Editor. If you invoke the Editor without giving it
a filename, or if you give it a bad filename, and the default
filename of "TEXT.DFT" is being used, you will be automatically
asked for a new filename prior to the Editor saving your file to
disk.


(Page. 2)

--- DOS 2.x and above:
The Editor must be located either in the DOS default
drive/directory or be on a drive/directory that is in your DOS
PATH. Bill's Editor may then be invoked by typing:

BEDIT [filename]

The [filename] is optional (though recommended) and is the
name of the file you wish to edit. Do not type the [] symbols
around your filename. This filename may consist of any
acceptable DOS drive/directory/filename combination. If only a
filename is given, the Editor will look in the default DOS
drive/directory for the file.
The present default DOS drive/directory will also be the
default drive/directory for the Editor. This cannot be changed
from within the Editor.

--- DOS 3.x only:
Users of DOS 3.x may also invoke the Editor by typing the
drive/directory where BEDIT is located. To use the example
information from the hard disk installation section, you would
type:
C:\WORD\BEDIT [filename]

All other usage information is the same as DOS 2.x.


---- Screen:
Anytime a key on your keyboard is referenced in this or
future sections or the manual, that key will be bracketed by the
"<" and ">" symbols. This indicates a key that you may press to
perform an Editor function. An example of this would be:

indicating that you may press the carriage return (also
called "Enter") key on your keyboard. The Editor uses this same
notation in its screens for command entry.
The examples of the screens shown here and in the remainder
of the manual are actual images of the Editor's screens. They
are condensed here (side to side) in order to fit better on the
printed page with margins. The Editor uses all 80 columns of
your screen for better legibility.
The 25 rows of your screen are broken up into two major
parts, top and bottom, by the Editor. The bottom part (20 rows)
is where you will do all of the editing of your text file.
The purpose of this section is to explain the meaning of the
top part (5 rows) of your screen. After the sign-on logo you
will see this screen (shown with the Editor defaults):

*********** Sample Screen ***********

-Help screen -Files & Exit -Screen Format -Search
-Directory -Block -Print -Repeat search

File: F:\WORD\BEDITDOC\TEXT.DFT
Line:1 Col:1 LM:1 Tab:5 RM:70 WW=Off Insert AI=Off low cur

******** End of Sample Screen ********


(Page. 3)

The names/purposes of these 5 lines are:

Command Line 1 = -Help screen -Files & Exit
Command Line 2 = -Directory -Block
Print Status Line =
Editor Status \__ = File: F:\WORD\BEDITDOC\TEXT.DFT
Lines / = Line:1 Col:1 LM:1 Tab:5

--- Command Line Area:
The Command Lines 1 and 2 when put together form the Command
Line area. It is through this Command Line area that you will
issue commands for the Editor to execute.
When you press one of the available function keys, a new
menu will appear in the Command Line area. This new menu will
list the various operations available for that function key
menu. In general, the choices at this level will either serve
to toggle something from on to off (for example - Word Wrap) or
will allow you to enter a new value for something (for example -
setting a new right margin). A few specialized operations vary
from this, but most Editor functions are available with no more
than two keystrokes.
The usage of the Command Line area and the function key
menus is covered in detail in Section 3 of this manual.
The Command Line area is also used by the Editor any time it
needs to show to you an information or error message. These
messages will be accompanied by a beep to alert you to look
there for the message. This is the only time the Editor will
make any noises.
These messages are designed to be self-explanatory given
what you are trying to do, so no listing is provided. You are
most likely to see these messages when using the Command Line
area. If possible, the action on your part that caused the
message will remain on the screen so you can see what you
entered to cause the error message.

--- Print Status Line:
The Print Status Line is normally blank until you press the
function key. The use of this line is explained fully in
Section 3 of this manual under the -Print sub-section.


(Page. 4)


--- Editor Status Lines:
1.
---------------------------------------------------------------------
File: F:\WORD\BEDITDOC\TEXT.DFT
Line:1 Col:1 LM:1 Tab:5 RM:70 WW=Off Insert AI=Off low cur
---------------------------------------------------------------------
2. 3. 4. 5. 6. 7. 8. 9. 10.

The Editor Status Lines (with the Editor default settings)
are duplicated above with a cross-referencing number next to
each section to be described below.
1. File: - This line will show the full DOS path and filename of
the file you are editing.
2. Line: & Col: - This section will always give you the line
number and column number where the cursor is located.
3. LM: - This is your Left Margin setting. Further information
is located on page 14, -Screen Format/eft Margin.
4. Tab: - This is your Tab setting. Further information is
located both on page 8 under Tab and on page 14 under
-Screen Format / ab width.
5. RM: - This is your Right Margin setting. Further information
is located on page 15 under -Screen Format / ight
Margin and on page 14, -Screen Format / ord Wrap.
6. WW= - This is the Word Wrap on/off status. Further
information is located on page 14 under -Screen Format
/ ord Wrap.
7. Insert - This is the Insert/Replace status. Further
information is mainly located on page 7 under Ins. It
should be noted that Insert/Replace effects how other
functions of the Editor behave and is commented about in
various sections of the manual.
8. AI= - This is the Auto Indent on/off status. Further
information is located on page 15 under
-Screen Format / uto Indent.
9. low - This is the lowercase/uppercase status indicator.
It is controlled by the key on the keyboard.
When lowercase is active, the indicator will read `low'.
If uppercase is active, the indicator will read `CAP'.
10. cur - This is the cursor/numeric status indicator for the
cursor keypad. It is controlled by the key on
the keyboard. When this indicator reads `cur'then the
arrow keys, Home, End, PgUp, PgDn, Ins and Del are the
active keys. When this indicator reads `NUM' then the
keypad 0 through 9 and the period are the active keys.

Of course, anytime your actions change any of the
information in the Editor Status Lines, the display will be
updated to reflect those changes.







(Page. 5)


---- USE OF KEYBOARD
The Editor uses the keyboard keys in a logical and
consistent manner that requires NO awkward memorization of
unique key strokes.
Any special keys needed to perform an action will be listed
in the command section of the screen (first 2 lines).
Most cursor pad keys also can be used in conjunction with
the Control key to obtain an amplified effect or other
variation. When using the Control key combinations, one must
first press and hold the Control key and then tap the other
indicated key as many times as is desired.
No other special keys (or combinations) on the keyboard are
used by the Editor so, if pressed, they will not be recognized.
Each key and its effect is described below.

--- CURSOR MOVEMENT KEYS:

Home : Position the cursor to Column 1 of present line.

End : Position the cursor to immediately after last character
of present line.

PgUp : move up in text one screen at a time.
Control-PgUp : move to beginning of text.

PgDn : move down in text one screen at a time.
Control-PgDn : move to end of text.

Left Arrow : will move the cursor one position to the left.
If you are in Column 1, the cursor will move to the
end of the previous line.
Control-Left Arrow : will move the cursor left one word. If
you are Column 1, the cursor will move to the end of
the previous line.

Right Arrow : will move the cursor right one position. When
you are at the end of the line, the cursor will just
keep going to the right.
Control-Right Arrow : will move the cursor right one word. If
you are positioned on the last word of a line, the
cursor will move to the end of the line. When
- is pressed again, the cursor
will go to Column 1 of the next line.

Up Arrow : will move the cursor up one line.

Down Arrow : will move the cursor down one line.










(Page. 6)

--- DELETION KEYS:

Del : Delete key. Pressing this key will delete the
character under the cursor.
Special circumstance : when the cursor is located to the
right of the text on a line (or on a blank line) then
pressing the key will move the line below it up
to the cursor line and any text will be positioned
starting at the cursor location.
CAUTION : DO NOT HOLD DOWN THE KEY. Correct technique
is to tap the key as many times as you desire. For
deleting a line or more of text, I recommend either
using the - (below) keystroke or the
-Block elete function (described in Section 3).
The Editor gives priority to receiving input from
the keyboard, not to updating the screen. If you hold
down the key, you will quickly lose track of
what is being deleted.

Control-Del : deletes text starting from the cursor location
and all text to the right of it on the same line.
Hint : to quickly delete an entire line from the text and
move the next line up, perform the following:
a. Make sure cursor is on the line you wish to delete.
b. Press key. (positions cursor to column 1)
c. Press -. (deletes all text on line)
d. Press . (deletes blank line)

Backspace : deletes text to the left of the cursor. The
cursor, and any text to its right, will move to the
left.
Special circumstance : if the cursor is located in column 1
when you press the key, the cursor, along
with any text on that line, will move up to the line
above and be positioned after any text on the above
line.


--- OTHER KEYS:

Ins : toggles Insert On/Off. The Editor Status Lines (screen
lines 4 & 5) will indicate current mode by alternating
between the words 'Insert' and 'Replace'. When in
Insert mode, anything you type will be inserted into
the text at the cursor location. When in Replace
mode, anything you type will replace the existing
text. The editor defaults to the Insert mode when
first invoked.

Control-Ins : inserts a blank line above the current cursor
location and moves the cursor to the screen column
indicated by your Left Margin in the new blank line.





(Page. 7)



Tab : will move the cursor right to the next Tab stop. Tab
stops are set through the -Screen Format function.
The effect of this depends on whether the Insert state
is toggled on or off.
Insert On : all text from the cursor position on will be
shifted over to the next Tab stop.
Insert Off : (replace mode) cursor will move over to the
next Tab stop but has no effect on the text.

Esc : Escape key. This key is operable only when you are
inside one of the Function Key commands. When
pressed, it will stop all command processing and
return you to normal editing mode after displaying a
'Command aborted' message.

Return : (Enter Key) the effect of this key will depend on
whether you are in Insert or Replace mode.
Insert - when is pressed, a new line is made.
Any text that had been at or to the right of the
cursor will be moved down to the new line and
positioned starting at your defined Left Margin
setting or Auto Indent level.
Replace - when is pressed, the cursor will be
moved to the next line and positioned in the screen
column indicated by your Left Margin setting or Auto
Indent level. No movement of the text will occur.

Function Keys ( through ) : some of the keyboard
function keys are used to perform various actions.
These actions are explained in detail in Section 3 of
this manual.

Num & Cap Lock : these keys will perform their usual toggling
of numeric/cursor and capital/lowercase. Which mode
you are in for each will be displayed in the Editor
Status Lines area (screen lines 4 & 5).




















(Page. 8)

---- FUNCTION KEY COMMANDS
* Note - screen representations are shown condensed.

--- FUNCTION KEY MENU:

-Help screen -Files & Exit -Screen Format -Search
-Directory -Block -Print -Repeat search

The above Function Key menu is displayed in the Command Line
area (Lines 1 and 2 of the screen). This display is active at
all times; that is, you can press a function key at any time
within an editing session, except when you are actually within
one of the function key commands. At that time, the menu
choices available for that function key purpose will be shown in
the Command Line area. Also, the cursor will be re-positioned
into the Command Line area. Normal editing is not available
until you leave the menu you had selected and the cursor is
re-positioned back into the body of the text.
Before going into the workings of each function key, let's
cover some information that is common to the behavior of all
function key commands.
The menu choices available on a individual menu will always
be bracketed by left and right arrows ("<" and ">") as shown
above in the Function Key menu (i.e. -Block). Within one of
the Function Key menus this will usually be the first letter of
the action desired (i.e. elete Block).
If, when presented with the menu selections available for a
specific function key, you accidentally press some key other
than one of the menu choices, you will receive the following
information message on the Command Line 2:

Invalid MENU selection - Press

After pressing the return key, you will be presented with the
menu that you were in.
At any level within a function key command, you may press the
key to exit that command. The following information message
is displayed on Command Line 2:

Command aborted - Press

After pressing the return key, you will be returned to the
MAIN Function Key menu and the cursor will be located within the
text at the row and column where it was when you initially
pressed the function key. You may resume normal editing at that
time.
Now, let's cover what each function key command can do for you.

--- -Help Screen:

After pressing the key you will see a screen of helpful
summary information that explains what actions can be performed
with which function keys. It also lists the editing action that
will take place when certain keypad keys are used in conjunction
with the key.
This screen of information will cover up your text area, but
please do not be concerned, the Editor knows what text is
underneath the Help Screen and will restore your original text
when you have finished reading the Help Screen and press the
key.
(Page. 9)

--- -Directory:

The function key will give you access to directory
information consisting of filenames and the size of the files
for any Drive/Directory in your system. Directories will be
identified by a "

" symbol in the column where the file size
information would normally be.
Pressing will put the following prompt on Command Line 1:

Enter dir\filespec desired:

You may enter any valid DOS Drive/Directory/Filespec
including the "*" and "?" wildcard operators.
Just pressing the key will give you a directory
listing of your current DOS default Drive/Directory. This will
be the drive and directory that you were in at the time you
invoked the Editor.
The directory display will appear as a window in the middle
of your text area and, as with the Help Screen, the text is
still there and will be restored when the directory information
is complete.
The phrase, "Press to continue:" will be at the
bottom of the directory window.
Depending on how long your directory listing is, when you
press , you will either see the next segment of your
directory listing or be returned to the normal editing mode if
your directory listing has been completed.
The main purpose of this feature is to enable you to see
filenames that you may wish to edit. This will avoid the hassle
of exiting the Editor and doing a DOS DIR command and then
re-entering the Editor to edit a file with a name you don't
quite remember.


--- -File & Exit:

The key is your `Gateway' to exiting the Editor, going
on to a new file to edit or saving your file to disk during an
editing session to prevent possible loss of the changes you've
made. If you had been editing with the default filename of
"TEXT.DFT", you will be prompted for a new filename anytime you
do an operation which writes to the disk.
The menu you are shown in the Command Line area after
pressing the key is:

ave file & continue edit ew file ENTER OF
uit - NO save of file xit w/ file save CHOICE OR :

The usage of each menu choice will be covered in detail below:

-- xit w/ file save:
This operation is really straight forward. Pressing
will cause your computer to write the file, with any changes you
have made during the editing session, back to the drive and
directory from whence it came. After saving your file, the
operation of the Editor will cease and you will be returned to
the DOS command level.

(Page. 10)

-- uit - NO save of file:
Pressing will also cause you to exit the Editor.
If you have made no changes to the file, you will exit
directly to DOS very quickly. If you have made any type of
change to your file, you will first be asked to confirm that you
wish to leave the Editor with the following message in the
Command Line area:
Exit WITHOUT saving current File (Y/N):
If you press any key except the key, you will be returned
to editing your file. Pressing the key will exit you to DOS.
This option is available to exit from the Editor if, for some
reason, you decide that you don't wish to have any of the changes
you made to your file written out to the disk.
This feature may also come in handy if you would like to use
the Editor just to quickly look at the contents of a file and
then exit.

-- ave file & continue edit:
If you are in a fairly lengthy editing session, it is a good
idea to use this option occasionally to save the current state
of your file to disk. This way, if something nasty were to
happen (such as losing power), you would have saved your work up
until the last time you had pressed the - combination.
It takes but a few seconds.

-- ew file:
Pressing will display the following menu:
EDIT NEW FILE?: o es & Save current ENTER OF
-Yes - but don't save current CHOICE OR :

- o: Entering will have the same effect as pressing the
key. That is, you will abort the command and return to
editing your current file.

- es & Save current: Entering will first save the
current file, clear the screen and then show the following prompt:
Enter New File Name:
At this time, you may enter the name of the new file you
wish to edit. If the file is found, it will be read into memory
and you may begin editing.
If the file is not found, you will see the following prompt
along with the filename you entered:
Enter New File Name: testtext.doc
File does not exist. Create? (Y/N):
Answering will put you into the editing mode with your
new file. A answer will give you the opportunity to enter
another new file name.

- -Yes - but don't save current: Entering will act very
much like answering except that the current file is not written
to disk. If you have made any editing changes to the current file,
you will see the following confirmation prompt before being allowed
to enter a new file name:
New File WITHOUT saving current File (Y/N):
Any answer but will return you to editing your current file.



(Page. 11)

--- -Block:
The first question that a computer user who is new to word
processing concepts is liable to ask is: What's a block?
Simply put - a block is a section of your text that you wish
to mark off, treat as a whole unit and do some operation on. The
operations commonly performed are:
Copy, Move, Delete and Print.
A block operation becomes a very handy way to modify entire
sections of text without a lot of repetitive typing. Some hints
about how to effectively use these functions will be included as
each operation is explained.
On a Monochrome monitor, the block that you define will be
shown in low intensity and will also be underlined. On a Color
monitor, the block will be displayed in a green shading.

Blocks in the Editor can be defined only in terms of a
complete line of text so, regardless of where the cursor is
located within a line, when you request a block begin or a block
end, the full line will be included in the block. This
restriction can be overcome by temporarily breaking the line
into two different lines using the normal editing keys. (While
in Insert mode, position the cursor where you wish to break the
line and then press the key.)
The block will expand and/or contract as necessary with any
editing that you do within the block, such as adding or deleting
lines of text.
Pressing will present you with this menu:

-block begin opy block ove block ENTER OF
-block end elete block emove block markers CHOICE OR :

After pressing the letter of your choice, you will be
automatically returned to normal editing. This will allow you
to re-position the cursor before your next block operation. This
is not meant to imply that all block operations must be
performed together. You may actually perform one block type
operation and then go on to do any other editing or Function Key
command you desire before returning to the next block operation
you wish to perform.
It should be mentioned at this point that the printing of a
block of text to your printer is accomplished through the
-Print function key which will be covered under the
-Print section of this manual.

-- -block begin & -block end: These two menu choices
allow you to define the block you wish to operate on.
The keys may be pressed in either order (i.e. Block end may
be the first pressed) as long as the beginning of your block is
physically located prior to the block end within your text. The
line the cursor is on is the line of text that will be acted
upon.
In actuality, pressing only one of these keys will define a
block that is only one text line in depth. That text line is a
block in and of itself and may be treated as such when using the
Block Copy, Move, Delete and the -Print a block options.
You may continue to press either block begin and/or block
end and the Editor will re-adjust the block boundaries as
necessary. Of course, the Editor keeps track of which you have
pressed and where. It allows a certain amount of latitude
during all of this and will only step in if you define a block

(Page. 12)

end prior to a block beginning. When it senses that you are
trying to do that particular operation, it will then reset all
block markers and start afresh with a new marker at the current
cursor position.

-- opy block: This command will generate a copy of
your defined block and place it in your text starting at the
line below the cursor location. The original block is not
effected and is still marked as your defined block.
This feature comes in very handy and can save a lot of
needless typing, if one or more sections of your text will be
identical or reasonably close to a previous section. Just mark
off the previous section of text and copy it as many times as
needed where you desire the copies to be and then make whatever
changes are necessary.

-- ove block: This command will take the section of text
that you defined as a block and move it to a new area of your
text starting on the line below the cursor location.
After you have moved the block of text, it will still be
defined as a block.
This feature allows you to very easily change the order in
which paragraphs appear in a letter or to move lines in a DOS
batch file for a different sequence of operation.

-- elete block: This command will take a section of your
text defined as a block and delete it from your text. The lines
immediately before and after the deleted block will then be next
to each other.
No block markers will then be defined in your text.

-- emove block markers: This command will remove all
previously defined block markers from your text. Just the
markers are removed - NOT the text itself.

-- A note on block markers: If you save a file to disk that
has block markers in it, the markers are NOT saved with the
file. This is because the markers are not tangible marks but
something the Editor keeps track of in the computer's memory.
The disk files generated by the Editor are, at all times, pure
ASCII files - that is, they will have no special control codes
in them.

-- General operating note:
Since both the block copy and the block move operate by
putting the block of text into the text starting at the line
below the cursor position, you will have to perform an extra
step if you wish to copy or move the block to line 1 of your
text.
This extra step is to insert a blank line into your text at
line 1. Either position the cursor in line 1 and press the
- key combination or, with the cursor on line 1 in
column 1 and insert toggled on, press the key.
With the cursor in the new blank line 1, perform your block
move or copy and then delete the blank line 1 by positioning the
cursor in the blank line in column 1 and pressing the key.



(Page. 13)

--- -Screen Format:
The -Screen Format function key allows you to set certain
parameters and to format your text. The menu for is:

ord Wrap eft Margin ormat paragraph ENTER OF
ab width ight Margin uto Indent CHOICE OR :

You will remain in this menu until you select ormat
paragraph or press the key. This allows you to set the
different parameters to your liking without excessive
keystrokes.
The effect of each option is:

-- ord Wrap: Pressing will toggle the `WW=Off' on the
Editor Status Line to `WW=On' and vice-versa. WW stands for
Word Wrap and monitors where you are on any text line. When you
are past the Right Margin, it automatically moves the cursor to
the beginning of the next line after you finish the word you
were typing. The beginning of the next line is determined by
the Left Margin or by Auto Indent, if it is turned on. Any word
that is more than one space past the Right Margin will also be
brought down to the new line.
The default for the Editor is to have Word Wrap off.

-- ab width: Pressing will allow you to set the number
of spaces between each Tab Stop. Tab Stops are calculated by
addition starting with column 1. With the Editor default of 5,
for example, the Tab Stops will be at columns 6, 11, 16, etc.
The normal effect of the Tab key is covered on page 9 of
this manual. (Use of Keyboard)
Note - if you are only one space away from a Tab Stop when
you press the Tab key, the Editor assumes you would have used
the Space Bar or the Right Arrow cursor key to go that one
space, so it moves you to the next higher Tab Stop.
After pressing , this prompt will appear in Command Line 1
to allow you to change Tab width:
Set Tab width to:
Pressing will retain the old Tab width setting.
After entering a new width, the Editor Status Line display for
`Tab:' will be updated.

-- eft Margin: Pressing will allow you to set the
left margin for your text. The prompt you will see in Command
Line 1 is:
Set left margin to:
Pressing will retain the present value. After
entering a new value for Left Margin, the Editor Status Line
display for `LM:' will be updated.
Any text entered after changing the Left Margin will be
within the new margin boundary. Old text will stay where it was
unless you choose to ormat paragraph.
The default for the Editor is a Left Margin at column 1.






(Page. 14)

-- ight Margin: Pressing will allow you to set the
right margin for your text. The prompt you will see in Command
Line 1 is:
Set right margin to:
Pressing will retain the present value. After
entering a new value for Right Margin, the Editor Status Line
display for `RM:' will be updated.
The default Right Margin for the Editor is column 70.
The setting of the Right Margin is used only under two
circumstances:
1. When using -ormat paragraph.
2. When Word Wrap is set on (-ord Wrap toggle).

-- ormat paragraph: Pressing will format the text
between your Left and Right Margins. This formatting will start
on the line where the cursor is located and continue down the
text and stop when the Editor sees a blank line.
CAUTION : It is important to remember to put a blank line
after the text you wish to have formatted. The Editor will keep
formatting the text until it sees a blank line or it reaches the
end of the text. (Even the key will NOT get you out of
that one.) This conforms to the common practice of putting a
blank line between each paragraph. If your writing style
differs from this, you will need to temporarily insert blank
lines into your text and remove them later.

-- uto Indent: Pressing the key will toggle the Auto
Indent mode and the Editor Status Line will change from `AI=Off'
to `AI=On' and vice-versa.
Auto Indent is a very handy feature that deserves a little
explanation for those of you that are not familiar with the
concept.
With Auto Indent on, when you press the key to end
input on a particular line and go to a new line, the cursor will
be positioned under the first non-blank character of the line
above. This means that the cursor will be positioned under the
first visible character on the text line above. Auto Indent will
also work when you have Word Wrap toggled On.

Some examples of how Auto Indent can be used:

1. In regular word processing, use it to indent a whole
paragraph so that it will stand out from the rest of
your letter. (Like this section is.)
2. A second use in word processing would be to type in
a column of information (i.e. - a column of figures)
that you wished to have indented from the rest of
your text.
3. Programmers use it to indent portions of code for
readability.


Remember that Auto Indenting does its trick by looking at
the previous line, so the first line must be manually set to
where you wish to have it.

Used properly, Auto Indenting can save a lot of time and
bother from having to Tab or space over from your left margin.


(Page. 15)

--- -Print:
The printing out of all your text, or the portion that has
been marked off as a Block is accessed by pressing the key.
The following menu will appear in the Command Line area:

ile print ines per page umber pages ENTER OF
lock print

rint left margin itle on page CHOICE OR :

Line 3 of the screen, which will be blank whenever you are
not in the -Print function, will then display the Print
Status Line (default shown):

PRINT INFO - LM:5 Lines/Pg:60 NumPg=Off Title =

The meaning of each of these print setup options corresponds to
the available menu selections in the Command Line area:

LM:5 -

rint left margin (default is 5 columns).
Lines/Pg:60 - ines per page (default 60 lines).
NumPg=Off - umber pages (default is Off).
Title = - itle on page (default is no title).

The effect of setting these will be explained with each menu
selection. ile print and lock print will be covered after
the print setup options.

-- ines per page: When you select menu option you will
be asked this question in Command Line 1:
Set number of lines per printed page to:
The default is 60 lines. This assumes that you will be
using 11 inch paper and that your Top of Form (this term is
explained at the beginning of the next page) is set reasonably
close to the physical top of your sheet of paper.
This is based upon the "norm" for most printers. The word
norm is in quotes because what is normal for printers can vary
quite a bit depending on the model of printer. Different
printers can vary, and if your printing results are not to your
satisfaction, you may have to consult your printer's manual to
see how to adjust these settings to your printer.
The norm for most printers is to have a 1/6 (one-sixth) inch
spacing between each printed line. This provides 66 lines on a
11 inch piece of paper and 84 lines on a 14 inch piece of paper.
The other factor to take into consideration is your `top of
form (TOF)'. The TOF is set by most printers to the location of
the print head at the time the printer is turned on. If your
print head is positioned on the first line of a piece of paper,
you have 66 lines available on an 11 inch piece of paper. If,
however, the print head is located below this point, the number
of lines available is reduced by the number of lines the print
head is below the first physical line.
The setting you use for the number of lines per printed page
will be affected by these factors. Also, if you have page
numbering turned on, you must have at least three lines
available for printing below your normal text on each page. The
page numbering feature will skip 2 lines below your last line of
text and then print a line with the page number.


(Page. 16)

--

rint left margin: When you select menu option

you
will be asked this question in Command Line 1:
Set left margin on printed page to:
The default is column 5.
This means, when you print out your text, all lines of your
text will begin printing on column 5 on the paper.
This is an easy way to get a border on your printed text.
If you tie the Editor's defaults for margins together (Left
margin = 1, Right margin = 70, and the Printer Left margin = 5),
the text will be centered on a normal 80 column printer with a 5
column border on each side.
These margin settings can be used together to give your
printed text almost any appearance you wish.

-- umber pages: Pressing will toggle the NumPg (Number
Pages) from Off to On and vice-versa.
Having page numbering turned on causes each page of the text
to have a page number printed on the line that is 3 lines below
the Lines per page is set. This will cause an automatic form
feed at the end of your print. Without page numbering, no
automatic form feed will occur when your text has finished
printing. This allows you to print multiple Blocks of text on
one page.

-- itle on page: Pressing from the -Print menu
will allow you to print a title on the first line of each page.
The prompt used to enter this title is:
Set Title on Print page (Max 25 characters) to:
The title left blank means that you do not wish to have a
title printed, and the printing of text will begin on the first
line. (This is the default setting for the Editor.)
Entering a title will automatically turn this feature on.
Setting the title back to blank will turn this feature off.
With this feature active, the Editor will print a title for
the text on the first print line of each page, skip 2 lines and
then begin printing the text. These 3 lines are included in the
ines per page count. Remember, the lines associated with
page numbering are not included in this count.

-- ile print: Pressing will automatically start the
printing of your file according to the Print Option settings.

-- lock print: Pressing will automatically start the
printing of a defined block according to the Print Option
settings. If no Block is defined, an error message will be
generated to that effect.

-- General:
If at any time during the printing process an error occurs,
an error message will be generated and printing will cease.
This can happen for various reasons, such as:
1. Printer is turned off or is off-line.
2. Paper has jammed or you are out of paper.
3. Loose or disconnected power/printer cable.
Please correct the problem prior to trying to print again.
No special printer codes are supported by the Editor. Only
the normal character set can be sent to the printer. If you wish
to have your text printed in a special mode, set up your printer
for that mode prior to invoking the Editor.

(Page. 17)

--- -Search:
The menu that you will see in the Command Line area upon
pressing the key is:
ind text o to line ENTER OF
eplace text CHOICE OR :

The search function allows you to quickly and reliably find
a word, phrase or combination of letters and optionally replace
them with another word, phrase or combination of letters. The
search function also allows you to specify a line number to go
to.
Let's go through each option.

-- ind text:
Pressing the key to initialize the Find function will
clear the Command Line area and present you will this prompt on
Command Line 1:
FIND->
At that point you enter the text string that you desire to
find and press when you are through. In this example,
I have entered `Tom' as the string to find. After pressing
you will be presented with an options list:
FIND-> Tom
OPTIONS - earchback ase holeWord:
If you press on the OPTIONS line, the Editor defaults
will cause a search which:
1. Starts on the line the cursor is on.
2. Searches forward through your text. (i.e. - goes
toward the end of your text.)
3. Is case insensitive. It will find the first
occurrence of `Tom' even if it is capitalized
differently, for example: `TOM', `tom', or `tOm'.
4. Will look for the combination of the three letters
`Tom' even if they are located within another word,
for example: `tomato', or `photomap'.
The OPTIONS line allows you to modify this search default.
You may select 1, 2 or 3 of the options in any combination and
order by pressing the corresponding key. If you do not select a
particular option, the Editor default for that option will be
used.
The effect of each of the options is:
earchback - instead of searching forward through your
text, pressing will cause the search to go
backwards through your text starting at the line
prior to the line the cursor line is on.
ase - pressing will cause your search to be case
sensitive. In the previous example where we
requested that `Tom' be searched for, the Editor
would locate only those instances of `Tom' where the
first letter (`T') is uppercase and the second and
third letters (`om') are in lowercase. Examples of
text which would NOT be found are, `TOM' or `tom'.
holeword - pressing will cause your search to
look only for those instances where the requested
word is a whole word by itself in the text. In the
example of `Tom', the letter combination of `tom'
that appears in the words `tomato', or `photomap'
would NOT be found by the search function.


(Page. 18)

The Find function will locate the first occurrence of your
requested search pattern. To locate the next occurrence of the
same pattern, press the key from the main Function Key
Menu. The use of the key is described in more detail
later.
If the Find text is not found or if you have already found
the last occurrence, the Editor will give you the following
message in Command Line 2:
Search string not found - Press

-- eplace text:
The Replace function is very similar to the Find function
described above. In this section, only the differences will be
discussed.
Upon pressing the key, you will receive this prompt:
REPLACE->
At that point, you enter the text string that you desire to
replace and press when you are through. In this
example, I have again entered `Tom' as the string to find. After
pressing you will receive an additional prompt asking
what to put in its place:
REPLACE-> Tom WITH->
I will type in `Bill' at this point and press :
REPLACE-> Tom WITH-> Bill
You will then be presented with this option list on Command
Line 2:
OPTIONS - lobal,earchback,ase,holeWord,uto replace:
The Editor defaults are the same for the Replace function as
they were for the Find function with one addition; the Editor
will pause to ask you if you wish to replace each occurrence of
your requested Replace text (unless uto replace is selected)
with the following message in Command Line 2:
Replace ? (Y/N):
The options for earchback, ase and holeword work the
same way in Replace as they did in the Find function. The
additional options and their effect are:
lobal - with this option selected, the whole file
will be searched for your replace text. By default,
the global search will start at the beginning of
your text file. If you also selected earchback
as one of your options, global will start at the end
of your text file and go backwards through your text.
uto replace - if you press for the Auto replace
function, all text equal to your Replace text and
conforming with your selected options will
automatically be replaced by the text you entered
after the `WITH->' prompt. The Editor will not stop
after each occurrence to ask you if you wish to
replace.
NOTE: - use uto replace function with due caution.
Be sure that your requested Replace text with
Options does not occur in any place in your text
that you would not wish it to be replaced !!
The key may also be used to repeat the last Replace
operation.
Another difference between the Replace function and the Find
function is that the Replace function will continue through your
text as defined by your selected options until you reach the end
of the text or you press .

(Page. 19)


-- o to line: Pressing will allow you to enter a number
that the Editor will use to count the lines of text and position
the cursor on the line that corresponds to the number you
requested. After pressing you get this prompt:
Go to line number:
Enter the desired line number and press .
If you enter a number larger then the number of lines in
your text, the Editor will position the cursor on the last line
of your text.
Although the Editor does not number lines as such, this
feature can be a handy way to return to a section of text. It
does require that you make a mental note of the line number so
that you can enter it later.


--- -Repeat search:
When is pressed, the Editor will automatically use the
same text and options you used on your last text type of
search. Only line number searches are not repeated. The last
search could have been either a Find operation or a Replace
operation.
After doing either a Find or a Replace operation, you may
perform any other editing function you wish before using the
key. The function will remember which type of
search function was last performed (Find or Replace) and perform
the identical search with the same options.
An important point to note is that pressing the key
will start this continuation of the search from the line where
the cursor is currently positioned, not from where the cursor
was located after the last search operation.
If you have not yet performed a text search or, when you
last used the -Search function, you used the key to
abort defining a text search (which leaves the search text &/or
the options undefined), pressing the key will return a
message in Command Line 2 that informs you of that.




















(Page. 20)