home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Share Gallery 1
/
share_gal_1.zip
/
share_gal_1
/
WP
/
WP080.ZIP
/
PEDITDOC.EXE
/
PEDIT.DOC
Wrap
Text File
|
1991-12-09
|
136KB
|
4,147 lines
╔══════════════════════════════════════╗
║ ║
║ pEDIT PLUS ║
║ ─────────────────── ║
║ the personal EDITor ║
║ ║
║ ║
║ Version 1.0 ║
║ ║
║ ║
║ December 1, 1991 ║
║ ║
╚══════════════════════════════════════╝
pEDIT COPYRIGHT 1989, 1990, 1991
_______
____|__ | (R)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
T. G. Muench
P.O. Box 11536
Prescott, AZ 86304-1536
(602) 445-2479
CIS 71171,2424
_______
____|__ | (R)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
This program is produced by a member of the Association of
Shareware Professionals (ASP). ASP wants to make sure that
the shareware principle works for you. If you are unable to
resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help.
The ASP Ombudsman can help you resolve a dispute or problem
with an ASP member, but does not provide technical support
for members' products. Please write to the ASP Ombudsman at
545 Grover Road, Muskegon MI 49442 or send a CompuServe
message via CompuServe Mail to ASP Ombudsman [70007,3536].
The OMB may also be contacted by FAX, by sending to the ASP
FAX number: (617) 788-2765. In communicating with the OMB,
please include a telephone number and/or FAX if available.
DISCLAIMER OF WARRANTY
THIS SOFTWARE IS SUPPLIED AS IS. THE AUTHOR DISCLAIMS ALL
WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS
FOR ANY PURPOSE. THE AUTHOR ASSUMES NO LIABILITY FOR
DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE
USE OF THIS SOFTWARE.
THIS IS A FULLY FUNCTIONING PROGRAM. IT IS NOT A DEMO NOR IS
IT CRIPPLED IN ANY WAY. ALL FEATURES ARE DOCUMENTED IN THE
ON-DISK MANUAL. IF YOU HAVE TROUBLE USING THE PROGRAM OR
FEEL YOU DID NOT RECEIVE ALL THE FILES, CONTACT THE AUTHOR
FOR ASSISTANCE.
A C K N O W L E D G E M E N T S
The author wishes to thank the following people for
their help.
Jim Hass of MicroFox Company, the author of the superb
DOS shell/menu/security program HDM-IV. Jim has had the
foresight to see the potential of pEDIT by building support
for it into HDM. He has also helped with beta testing and
has made many suggestions to make pEDIT the best it can be.
Thomas G. Hanlin III, author of many assembly language
libraries for BASIC. The graphical pEDIT would not have been
possible without his GrafWiz routines which provide super-
fast text display in graphics modes. These routines are now
included in his BasWiz library.
C O N V E N T I O N S
The following conventions are used throughout this
documentation and in the tutorial.
pEDIT commands are shown in upper case; examples are
RULER and TRIM BUFFER. Commands are sometimes enclosed in
double quotes. Command parameters are shown in lower case
with a vertical bar (|) separating options; an example is
"SET VIDEO text|graphics".
Keyboard key, ButtonBar button and mouse button names
are enclosed in angle brackets. For labelled keys, the key
name corresponds to what is stamped on the key; examples are
<Home> and <PgDn>. The arrow keys have the names <Left>,
<Right>, <Up> and <Down>.
Control keys and Alternate keys are prefixed by Ctrl-
and Alt-, respectively; examples are <Ctrl-C> and <Alt-B>.
The Functions keys are named <F01> through <F12>. Some older
keyboards do not have the <F11> and <F12> keys. Control keys
are sometimes represented as ^X for <Ctrl-X>.
ButtonBar buttons are referenced by their 3-character
text mode abbreviations, for example <CMD>, <FND> and <CUT>.
The mouse button names are <MLB> and <MRB> for the left
and right buttons, respectively. pEDIT PLUS fully supports a
Microsoft compatible 2-button mouse; the middle button of a
3-button mouse is not recognized.
T A B L E O F C O N T E N T S
Introduction . . . . . . . . . . . . . . . . . . . . . 1
Installing pEDIT PLUS
1. General Information . . . . . . . . . . . . . . 3
2. Floppy Disk Installation . . . . . . . . . . . 6
3. Hard Disk Installation . . . . . . . . . . . . 6
Quick Starting pEDIT PLUS
1. Overview . . . . . . . . . . . . . . . . . . . 8
2. Command Mode . . . . . . . . . . . . . . . . . 12
3. Prompting Mode . . . . . . . . . . . . . . . . 12
4. The ButtonBar . . . . . . . . . . . . . . . . . 13
5. Using a Mouse . . . . . . . . . . . . . . . . . 15
pEDIT PLUS Commands
1. Cursor Movement . . . . . . . . . . . . . . . . 17
2. Text Manipulation . . . . . . . . . . . . . . . 19
3. Text Deletion . . . . . . . . . . . . . . . . . 22
4. Searching . . . . . . . . . . . . . . . . . . . 23
5. Files . . . . . . . . . . . . . . . . . . . . . 25
6. Buffers . . . . . . . . . . . . . . . . . . . . 27
7. Windows . . . . . . . . . . . . . . . . . . . . 29
8. Cut and Paste . . . . . . . . . . . . . . . . . 31
9. Key Macros . . . . . . . . . . . . . . . . . . 32
10. Miscellaneous . . . . . . . . . . . . . . . . . 34
Macro Facility
1. Macro Types . . . . . . . . . . . . . . . . . . 39
2. Macro Execution . . . . . . . . . . . . . . . . 39
3. Sample Macros . . . . . . . . . . . . . . . . . 39
Extended DOS Shell . . . . . . . . . . . . . . . . . . 41
Printing From pEDIT PLUS . . . . . . . . . . . . . . . 42
Compiling From pEDIT PLUS
1. Manual Invocation . . . . . . . . . . . . . . . 43
2. Batch File . . . . . . . . . . . . . . . . . . 43
3. Disk Macros . . . . . . . . . . . . . . . . . . 44
T A B L E O F C O N T E N T S
Error Handling
1. Insufficient Internal Storage . . . . . . . . . 45
2. Insufficient Disk Space . . . . . . . . . . . . 45
3. No Initialization File . . . . . . . . . . . . 45
Miscellaneous/Legalities
1. Copyright Notice . . . . . . . . . . . . . . . 46
2. Registration . . . . . . . . . . . . . . . . . 46
Appendices
A. Key Bindings
1. Labelled Keys . . . . . . . . . . . . . . . 48
2. Standard . . . . . . . . . . . . . . . . . . 49
3. WordStar . . . . . . . . . . . . . . . . . . 51
4. EMACS . . . . . . . . . . . . . . . . . . . 53
5. Microsoft Quick . . . . . . . . . . . . . . 55
B. The DOS Environment . . . . . . . . . . . . . . 57
C. Supported Video Displays . . . . . . . . . . . 58
D. Initialization File . . . . . . . . . . . . . . 60
E. Help Files . . . . . . . . . . . . . . . . . . 61
F. Color Codes . . . . . . . . . . . . . . . . . . 62
G. Troubleshooting . . . . . . . . . . . . . . . . 63
I N T R O D U C T I O N
pEDIT PLUS is a DOS-based text editor with a graphical
user interface for the IBM Personal Computer family. The
program is referred to interchangably as pEDIT PLUS, pEDIT+,
and pEDIT. The program has has been tested with MDA (mono-
chrome text), HGA (Hercules monochrome in text mode), CGA,
EGA and VGA displays. pEDIT PLUS requires PC/MS-DOS 2.1 or
higher, 384k of memory and 720k of floppy drive capacity;
512k memory is recommended as is a hard disk.
This all-new pEDIT adds full mouse support and a unique
graphical ButtonBar interface. The ButtonBar is made up of
18 buttons that give you quick access to the most common
editing functions. The philosophy behind the ButtonBar is
simple: it's easier to press a button than pull down a menu.
pEDIT will handle any ASCII text file with lines up to
32000 characters in length terminated by a carriage-return
line-feed pair. pEDIT is not a binary editor although it can
be used to view binary files. pEDIT PLUS is also not a word
processor or desktop publisher and does not import graphics
or support multiple fonts. pEDIT does, however, have several
features normally associated with word processors: settable
margins, automatic word wrap, paragraph indent and line
centering. Paragraphs can be 'filled' or reformatted to fit
within the existing margins. Words (or parts of words) can
be Capitalized, lower-cased or UPPER-CASED.
pEDIT+ has other capabilities which make it competitive
with ANY shareware editor available: split screen editing;
edit up to 16 files at one time; compile without leaving
the editor; file pick lists; and global search and replace.
The editor configures itself by loading an 'initiali-
zation' file at start up. This file contains environment
settings and key bindings that are used to customize the
editor. You can make pEDIT PLUS work the way you want it
to work... even mimic another editor such as WordStar, the
Microsoft Quick Editor or EMACS. pEDIT+ is completely con-
figurable; if you don't like the supplied configurations,
modify them or create your own.
pEDIT is unique among shareware editors in that every-
thing is treated as text in a buffer. Any previous command
can be recalled from a Command buffer, edited and reissued.
And, the output from shelled DOS commands is available in a
special DOS buffer.
- 1 -
The command line interface is there for those who want
to use it. It is intended for those commands that are used
infrequently. The more efficient method is to use the key-
board and, of course, the ButtonBar.
Every effort has been made to make pEDIT PLUS perform as
efficiently as possible. The speed is quite good on an AT
(or higher) class machine with a hard drive. All text is
stored entirely in memory, which makes accessing any part of
the file very fast. The user can move from the top to the
bottom of any buffer instantaneously.
Displaying text in graphics mode is normally painfully
slow. For this reason, pEDIT+ uses special assembly language
routines that bypass the BIOS and write directly to the
hardware. These routines achieve about 95% of the speed of
text mode. However, scrolling - which uses the BIOS - is
still slow when compared to text mode. If you prefer speed
to the graphical interface, a text mode is available on all
display systems.
- 2 -
I N S T A L L I N G p E D I T P L U S
1. General Information
The distribution diskette contains the following files.
An asterisk indicates the file is included with the regis-
tered version only.
READ.ME
Text file containing information about the INSTALL
program and how to get started with pEDIT
WHATS.NEW
New features of pEDIT 2.0, 2.10 and pEDIT PLUS 1.0
PEDIT.EXE
The pEDIT PLUS executable program
PEDIT.HLP
Topic Help File for every pEDIT PLUS command
PEDIT.BTN
Button Help file
PEDIT.SHR
File required for internal operation of pEDIT PLUS
PEDITDOC.EXE
Self-extracting file which will, when executed,
create PEDIT.DOC, the complete pEDIT documentation
PEDITCGA.BAR
PEDITMGA.BAR
PEDITEGA.BAR
ButtonBar images for CGA, mono EGA/VGA and color
EGA/VGA displays
TUTORIAL.BAT
TUTORIAL.DOC
PRACTICE.TXT
These files are used by the tutorial
- 3 -
PEDITEMC.INI
PEDITQUI.INI
PEDITSTD.INI
PEDITWST.INI
Sample initialization files for EMACS, Microsoft
Quick Editor, Standard and WordStar configurations
PEDITEMC.KEY
PEDITQUI.KEY
PEDITSTD.KEY
PEDITWST.KEY
Keyboard help files to match the above initializa-
tion files
EMCLETTR.PMC
EMCOTHUP.PMC
EMCOTHDN.PMC
EMCWREV.PMC
Sample EMACS disk macros
QUILETTR.PMC
QUIOTHUP.PMC
QUIOTHDN.PMC
QUIWREV.PMC
Sample MS Quick Editor disk macros
STDLETTR.PMC
STDOTHUP.PMC
STDOTHDN.PMC
STDWREV.PMC
Sample Standard disk macros
WSTLETTR.PMC
WSTOTHUP.PMC
WSTOTHDN.PMC
WSTWREV.PMC
Sample WordStar disk macros
REGISTER.DOC
How to register for pEDIT - you can register through
Public (software) Library or directly from the author;
please support the shareware concept by registering
- 4 -
VENDOR.DOC
Information for shareware vendors regarding require-
ments for distributing pEDIT
INSTALL.EXE
Program to install pEDIT PLUS on your system
(*)REGISTER.HDM
Explains the benefits of registering the evaluation
copy of HDM IV (Hard Disk Menu) you will receive
when you register pEDIT
(*)KEYRATE.COM
Program to set the keyboard repeat rate on AT and
later computers
(*)STAYDOWN.COM
Memory-resident utility from PC Magazine to allow
Ctrl-, Alt- and Shift- commands to be entered as 2
separate keystrokes.
The following installation procedures assume you have a
basic knowledge of PC operation and can format a diskette.
Refer to your DOS manual as needed. There are some things to
check and decisions to make BEFORE starting the installation:
1. If you are installing pEDIT for the first time, make sure
the target device has at least 270k of free disk space;
allow another 135k for the expanded manual
If you are installing over an existing pEDIT, be sure and
save any customized INI and KEY files by renaming them to
other than PEDIT.INI and PEDIT.KEY
2. Choose one of the supplied configurations (EMACS, Quick,
Standard or WordStar); see the Appendix for descriptions
3. Decide, if you have a hard drive system, if you will let
INSTALL modify your AUTOEXEC.BAT file to setup the DOS
PATH and PEDIT environment variable.
4. Decide if you want to install the optional KEYRATE and
STAYDOWN utilities (Registered version only).
5. Decide if you want to print the tutorial documentation
and run the tutorial
- 5 -
2. Floppy Disk Installation
This procedure assumes you have 2 floppy drives of at
least 360k each, or a single 720k (or 1.44MB) drive. In a
dual (360k) system, Drive A: will hold the program disk with
the pEDIT executable, initialization and help files. Drive
B: will hold a work disk with your documents, source pro-
grams or other text. In a single (720k or 1.44MB) floppy
system, everything will be on the one floppy.
The following example is for those with two 360k drives;
if you have the 3.5" 720k floppy, format just one disk and
put everything on it.
1. Format two diskettes; make one (the program disk) a system
disk if you want to be able to boot from it; label the
floppies 'pEDIT PLUS Program' and 'pEDIT Work'
2. Insert the distribution diskette in Drive A:
3. Set default to the A: drive and run the INSTALL program
A>INSTALL<Enter>
4. Remove the distribution disk from Drive A; move the pEDIT
Program Disk to Drive A and insert a pEDIT Work Disk in B:
5. If you want KEYRATE to be run automatically when you boot,
copy KEYRATE.COM to your system disk and add the following
line to your AUTOEXEC.BAT file:
KEYRATE FAST
6. If you want STAYDOWN to be installed when you boot, copy
STAYDOWN.COM to the system (boot) diskette and add this
line to AUTOEXEC.BAT:
STAYDOWN
7. Proceed to "Quick Starting pEDIT PLUS"
3. Hard Disk Installation
This procedure assumes you have one floppy drive and a
hard disk of any size. You will most certainly want to in-
stall pEDIT on the hard drive for improved speed.
If you have a hard drive system, two things MUST be set
up in your AUTOEXEC.BAT file in order for pEDIT to operate
- 6 -
properly: (1) the directory containing the pEDIT files must
be in your DOS PATH, and (2) the environment variable PEDIT
must be defined. If you choose not to have the installation
program do this for you, you must manually edit AUTOEXEC.BAT
and make the required changes. In either case, you must re-
boot your system for the changes to take effect.
╓────────────────────────────────╖
║ pEDIT PLUS tip: ║
║ ║
║ If things don't work right ║
║ after rebooting, check your ║
║ AUTOEXEC.BAT file to make sure ║
║ the PATH and SET PEDIT state- ║
║ ments are being executed. ║
║ ║
╙────────────────────────────────╜
You will need to decide if you want to install pEDIT in
the root (\) directory, in its own directory (\PEDIT), or in,
for example, a \TOOLS or \UTIL directory. The example assumes
pEDIT will be installed from Drive A into its own directory
on Drive C.
1. Insert the distribution diskette in Drive A:
2. Set default to the A: drive and run the installation program
A>INSTALL<Enter>
3. Remove the distribution disk from Drive A:
4. Edit your AUTOEXEC.BAT file if you did not let INSTALL
do it for you. It must contain the following statements:
PATH=...;C:\PEDIT
SET PEDIT=C:\PEDIT
5. If you want KEYRATE to be invoked automatically when you
boot, copy KEYRATE.COM to the root directory of your hard
disk and add the following line to AUTOEXEC.BAT:
C:\KEYRATE FAST
6. If you want STAYDOWN to be installed when you boot, copy
STAYDOWN.COM to the root directory and add this line to
AUTOEXEC.BAT:
C:\STAYDOWN
7. Proceed to "Quick Starting pEDIT PLUS"
- 7 -
Q U I C K S T A R T I N G p E D I T P L U S
1. Overview
This section will give you the information you need to
get up and running with pEDIT PLUS as quickly as possible.
The program file (PEDIT.EXE) must in a directory contained
in your DOS PATH, or be in the current directory. The init-
ialization (PEDIT.INI) and help (PEDIT.HLP, PEDIT.BTN and
PEDIT.KEY) files must be accessible via the DOS environment
or, again, be in the current directory.
Hard drive users must define a DOS environment variable
'PEDIT' so the editor can find the files it needs. The
location of the pEDIT files will henceforth be referred to
as the PEDIT PATH; don't confuse this with the DOS PATH.
╓────────────────────────────────────╖
║ pEDIT PLUS tip: ║
║ ║
║ See the Appendix for a full ║
║ discussion of the DOS environment. ║
║ ║
╙────────────────────────────────────╜
If you have a floppy-only system, make sure you have a
copy of COMMAND.COM (or your alternate command processor)
present. This file must be available to use the DOS command.
As the following examples show, pEDIT can be invoked
with a default or alternate configuration. If @XXX is not
specified on the command line, pEDIT will use the default
PEDIT.INI and PEDIT.KEY files. If @XXX is specifed, the
editor will use the files PEDITXXX.INI and PEDITXXX.KEY.
Here, XXX represents the alternate configuration to be used:
STD (Standard), WST (WordStar), EMC (EMACS), QUI (MS Quick),
- or one of your own.
pEDIT can be started in one of two ways: with or without
a file specification. If you don't want to start out editing
an existing file, at the DOS prompt enter:
C>PEDIT [@XXX]
The normal way of starting pEDIT would be to specify the
name of a file to be edited using either a specific or wildcard
file specification:
C>PEDIT [@XXX] D:\PATH\FILENAME.TYP
C>PEDIT [@XXX] D:\PATH\*.DOC
- 8 -
┌──────────────────────────────────────────────────────────┐
││ ButtonBar ││
│├────────────────────────────────────────────────────────┤│
││
││ ││
││ ││
││ ││
││ ││
││ ││
││ ││
││ ││
││ ││
│├────────────────────────────────────────────────────────┤│
││ BufferName Global Mode Direction LLLL:CCCC
│├────────────────────────────────────────────────────────┤│
││ ││
││ ││
││ ││
││ ││
││ ││
││ ││
││ ││
││ ││
││
│└────────────────────────────────────────────────────────┘│
│ BufferName Global Mode Direction LLLL:CCCC │
└──────────────────────────────────────────────────────────┘
Command:
<Message> Working . . .
Figure 1
-----------------
pEDIT PLUS Screen
- 9 -
If you used a wildcard specification, you will be pre-
sented with a FILES window containing a 'pick list' of all
matching filenames (unless there are "No matching files" or
"Too many files").
╓────────────────────────────────╖
║ pEDIT PLUS tip: ║
║ ║
║ "Too many files" means that ║
║ there were too many files to ║
║ list in the FILES window. You ║
║ should narrow the search by ║
║ changing '*.*' to '*.txt', for ║
║ example. ║
║ ║
╙────────────────────────────────╜
Once a file has been selected, the pEDIT screen will be
displayed. Next, the message line will show that the initial-
ization file is being read - provided, of course, that pEDIT
can find one. Finally, if a matching file was found, pEDIT
will load the file into memory and display the first screen-
full of text. The cursor will be positioned at the top of
the buffer.
pEDIT uses all 25 screen rows for text, status, commands
and messages. In text mode, some monitors can display more
than the standard 25 lines of text; 43 lines on EGA and VGA,
and 50 lines on VGA. The pEDIT screen can contain 1 or 2
windows. In 25-line mode, a single window holds 19 lines of
text; if the screen is split, each window contains 9 lines.
Figure 1 shows a representation of the pEDIT+ screen with
two windows displayed. It is important to realize that you
can view two different files or two portions of the same file
when the screen is split.
Each window has a status line at the bottom. For a text
window, the status line shows the buffer name, the current
scope (blank=Local/Global), mode (Insert/Overstrike) and
direction (Forward/Reverse). For an informational window, it
indicates the type of information being displayed - HELP,
FILES, SHOW, LIST, ERROR, etc.
A window can be thought of as a viewport into a portion
of the text. Figure 2 shows a text buffer (represented by
the large box) and a window into the text. A window can't
show more than 78 columns of text. pEDIT uses horizontal
scrolling so the window can be into any portion of the text,
not just the leftmost 78 columns.
- 10 -
┌────────────────────────────────────────────────────────┐
│ │
│ ┌────────────────┐ │
│ Now is │the time for all│ good persons to come to the │
│ aid of │their country. │ │
│ │ │ │
│ │<─── Window ───>│ │
│ │ │ │
│ └────────────────┘ │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│<─────────────────────── Buffer ───────────────────────>│
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
└────────────────────────────────────────────────────────┘
Figure 2
---------------
Buffers/Windows
- 11 -
The command line displayed at row 24 is actually a one
line window into the COMMAND buffer. The 'Command: ' prompt
is displayed whenever the editor is in command mode.
The message line at row 25 is used to display inform-
ational text, errors, etc. Also shown at the right margin is
the 'Working . . .' message that flashes whenever pEDIT is
busy loading a file, searching, etc.
Commands are entered either by typing them in at the
command line, by pressing a defined key, or by 'pressing' a
button. Obviously, the latter two methods are the most
efficient for functions you use all the time.
There are some commands you need to know about in this
initial learning phase. The first is HELP, which is bound to
<F01> in all configurations. The second is ALTHELP (for
alternate or button and keyboard help), which is always <Alt-
H>. Finally, LIST KEYS displays a list of all defined keys.
2. Command Mode
You enter Command Mode by pressing the DO COMMAND key.
The key bound to DO COMMAND depends on the configuration
you are using but is normally the <Esc> key. The prompt
"Command: " is displayed on the command line and the cursor
will be positioned after the colon. At this point you can
issue any valid pEDIT command, for example WRITE FILE or SET
MARGINS 10 70. If you enter Command Mode without meaning to,
simply press <Enter> after the prompt to return to editing.
╓──────────────────────────────────────╖
║ pEDIT PLUS tip: ║
║ ║
║ The Command line is a window into ║
║ the COMMAND buffer. All defined keys ║
║ work the same as they do in any text ║
║ buffer. The mouse cannot be used on ║
║ the command line. ║
║ ║
╙──────────────────────────────────────╜
3. Prompting Mode
Prompting Mode is active whenever pEDIT is asking for
input and the "Command: " prompt is not displayed. In this
mode you will not have access to all of pEDIT's commands and
key definitions. All Control characters are represented by
- 12 -
the Ascii character 22 (). Only Insert mode is supported;
limited line editing is available using a subset of your de-
fined keys:
MOVE UP Recall the last command entered
ERASE PREV Erase the previous character
ERASE CHAR Erase current character
MOVE LEFT Move cursor left one character
MOVE RIGHT Move right one character
MOVE HOME Position to start of line
MOVE END Position cursor to end of line
4. The ButtonBar
The first thing you will notice about pEDIT+ is the
unique ButtonBar. The next thing you will notice is that
there are no menus. As explained in the Introduction, the
philosophy behind the ButtonBar is this: it is easier to
press a button than pull down a menu - which can lead to
several levels of submenus.
The ButtonBar provides, at the press of a button, 18 of
the most commonly used editing functions. In graphics mode
the buttons will be displayed in 2 (CGA), 3 (monochrome EGA-
/VGA) or 16 (color EGA/VGA) colors. The button will appear
to depress when clicked on with the mouse. You must click
close to the middle of a button as pEDIT uses row and column
instead of graphics mouse coordinates.
Accessing the ButtonBar without a mouse is clumsy at
best. When the special key <Ctrl-F10> is pressed, the text
cursor will disappear and the first (leftmost) button will
be "selected". The current button is shown in reverse video
(text mode) or by depressing the button (graphics mode). Use
the <Left> and <Right> keys to select a button; then, press
<Enter> to accept the selection or ABORT to cancel.
In text mode, the buttons are represented by 3-character
abbreviations. Figure 3 shows a picture of the ButtonBar in
text mode and lists the function of each button.
- 13 -
┌┬───┬───┬───┬───┬───┬───┬───┬───┬───┬
││ < │HLP│CMD│BUF│INF│GET│WRT│ONE│TWO│ /\/
└┴───┴───┴───┴───┴───┴───┴───┴───┴───┴
┬───┬───┬───┬───┬───┬───┬───┬───┬───┬┐
\/\ │FND│NXT│RPL│FMT│CUT│PST│DOS│QUI│ > ││
┴───┴───┴───┴───┴───┴───┴───┴───┴───┴┘
< SHIFT LEFT Shift the window left
HLP HELP Bring up indexed help system
CMD DO COMMAND Enter command mode
BUF BUFFER Switch to another buffer
INF SHOW BUFFER Info about the current buffer
GET GET FILE Load a file for editing
WRT WRITE FILE Save modified buffer to disk
ONE ONE WINDOW Unsplit the screen
TWO TWO WINDOWS Split the screen
FND FIND Search for text
NXT FINDNEXT Repeat the last search
RPL REPLACE Replace text
FMT FILL PARAGRAPH Reformat paragraph
CUT REMOVE TEXT Cut (to clipboard)
PST INSERT HERE Paste (from clipboard)
DOS DOS Shell to DOS
QUI QUIT Abort the editing session
> SHIFT RIGHT Shift the window right
Figure 3
-------------
The ButtonBar
- 14 -
5. Using a Mouse
pEDIT PLUS supports a Microsoft compatible 2-button
mouse. The middle button of a 3-button mouse is ignored.
Most mice support Microsoft as well as other proprietary
mode(s); be sure and set your rodent up in Microsoft mode.
Table 1 summarizes how the mouse is used by pEDIT.
The use of a mouse is optional. pEDIT PLUS will detect a
mouse if one is installed and display a mouse pointer which
will move across the screen as the mouse is moved across the
desktop. The pointer appears as a block in text mode and an
arrow in graphics modes.
╓─────────────────────────────────────╖
║ pEDIT PLUS tip: ║
║ ║
║ The text cursor and mouse pointer ║
║ are not the same! The text cursor ║
║ appears as an underline and shows ║
║ where text will be inserted. ║
║ ║
╙─────────────────────────────────────╜
Some mouse terminology should be explained. To "click
on" an object means to move the mouse pointer to the object
and press and release the specified button. To "click and
drag" means to hold down the left mouse button while drag-
ging (moving) the mouse up, down, left or right.
You can use "click and drag" to select text. Click the
right button to turn the highlighting on; then, hold the
left button down as you "drag" the mouse horizontally or
vertically. Note that text selection starts where the text
cursor - not the mouse pointer - is.
╓────────────────────────────────────╖
║ pEDIT PLUS tip: ║
║ ║
║ Hold down the left mouse button ║
║ for more than 1/2 second to repeat ║
║ the mouse action. ║
║ ║
╙────────────────────────────────────╜
The Disk Operating System (DOS) stores keystrokes in a
typeahead buffer and passes them to the application on re-
quest. Unfortunately, mouse button presses are not 'queued'
so you cannot 'click ahead'. Do not attempt to use the mouse
when the program is busy and the mouse pointer is turned off.
- 15 -
┌───────────────┬─────────────────────┬────────────────────┐
│ Location of │ Function of Left │ Function of Right │
│ Mouse Pointer │ Button <MLB> │ Button <MRB> │
╞═══════════════╪═════════════════════╪════════════════════╡
│ │ │ │
│ In current │ Move text cursor │ Toggle Select │
│ text window │ to mouse location │ on and off │
│ │ │ │
├───────────────┼─────────────────────┼────────────────────┤
│ │ │ │
│ In other │ Move text cursor │ │
│ text window │ to other window │ │
│ │ │ │
├───────────────┼─────────────────────┼────────────────────┤
│ │ │ │
│ HELP, FILES │ Highlight option │ Select option; │
│ or BUFFER │ under the mouse │ same as <Enter> │
│ window │ pointer │ │
│ │ │ │
├───────────────┼─────────────────────┼────────────────────┤
│ │ │ │
│ On UpArrow │ Scroll up 1 line │ │
│ of ScrollBar │ │ │
│ │ │ │
├───────────────┼─────────────────────┼────────────────────┤
│ │ │ │
│ On DownArrow │ Scroll down 1 │ │
│ of ScrollBar │ line │ │
│ │ │ │
├───────────────┼─────────────────────┼────────────────────┤
│ │ │ │
│ Between Up- │ Page up to the │ │
│ Arrow and the │ Previous Screen │ │
│ DoubleArrow │ │ │
│ │ │ │
├───────────────┼─────────────────────┼────────────────────┤
│ │ │ │
│ Between the │ Page down to │ │
│ DoubleArrow │ the Next Screen │ │
│ and DownArrow │ │ │
│ │ │ │
└───────────────┴─────────────────────┴────────────────────┘
Table 1
-------------
Mouse Actions
- 16 -
p E D I T P L U S C O M M A N D S
This section lists all pEDIT commands. Each command is shown
in uppercase and has a description following. (B) signifies
the command is a button on the ButtonBar, while (M) means it
is accessible with a mouse.
1. Cursor Movement
Moving the cursor around in the text is among the most basic
of all editing functions. The following commands are non-
destructive; that is, the existing text is not modified.
MOVE ABSOLUTE (M)
This function is accessible only with a mouse. When you
click the <MLB> in the current text window, the text cursor
will be moved to the location of the mouse pointer.
MOVE TOP
Positions the cursor to the first line of the buffer, scrol-
ling or repainting the screen as necessary. pEDIT keeps all
text in memory, making it very fast to move to the top of
the buffer from any point in the buffer.
MOVE BOTTOM
Moves the cursor to the dummy last line at the end of the
buffer. The screen will scroll or repaint as required.
MOVE HOME
The action of MOVE HOME depends on the position of the cursor
within the current line. If the cursor is not at the begin-
ning of a line, it will move there. If it is at the start of
a line, it will wrap to the start of the previous line. This
command is normally bound to the <Home> key.
MOVE END
The action of MOVE END depends on the position of the cursor
within the current line. If the cursor is not at the end of
the line, it will move there. If it is at the end of a line,
it will wrap to the end of the next line. Normally bound to
the <End> key.
MOVE UP
Moves the cursor up one line in the current buffer. There can
- 17 -
be no action if the cursor is already on the first line of
the buffer. pEDIT keeps the cursor as close as possible to
the same column. This command is normally bound to the <Up>
key.
MOVE DOWN
Moves the cursor down one line in the current buffer. The
cursor cannot move if it is already on the dummy last line
of the buffer. pEDIT keeps the cursor as close as possible
to the same column. This command is normally bound to the
<Down> key.
MOVE LEFT
Moves the cursor left one character position. If the cursor
is at the beginning of a line, it will wrap to the end of the
previous line. Normally bound to the <Left> key.
MOVE RIGHT
Moves the cursor right one character position. If the cursor
is at the end of a line, it will wrap to the beginning of the
next line. This command is normally bound to the <Right> key.
MOVE WORD
Moves the cursor to the beginning of the next word in the
current direction. If the direction is Forward, it will move
toward the end of the buffer; if Reverse, toward the begin-
ning of the buffer.
The screen will scroll or repaint depending on the state of
Select. If Select is active, the screen will be redisplayed.
If Select is not active, scrolling will take place to keep
the cursor on the fourth line from the top or bottom of the
window.
- 18 -
p E D I T P L U S C O M M A N D S
2. Text Manipulation
These commands are used to manipulate text - insert new text
and change the form of existing text.
INSERT CHAR
This is the default when one of the typing keys is pressed.
In Insert mode, the character will be inserted into the
buffer at the current cursor position; text to the right is
"shoved over" to make room. In Overstrike mode, the character
is simply overwritten.
pEDIT uses automatic word wrap to keep text between the
defined margins as you type. If a word will not fit inside
the current right margin, it will be moved to the start of
the next line. The first line of a paragraph will be auto-
matically indented if the PIndent parameter is set.
When the Tab key is pressed, the cursor will move to the next
tab stop. Only standard tab stops at every eighth column are
supported. Control characters are displayed as a caret (^)
followed by the displayable character; for example, Control-
A appears on-screen as "^A".
OPEN LINE
Opens up a new (empty) line for text insertion. The end
result is the same as pressing <Enter> followed by <Left>
except that no indenting will take place.
FILL PARAGRAPH (B)
Reformats a paragraph or portion of a paragraph to fit within
the defined margins. Paragraph indenting, if any, is honored
for the first line. Use this command after you have inserted
or deleted text or changed margins.
The SET MARGINS and SET PINDENT commands are used to set the
margins and paragraph indent, respectively. Reformatting
begins at the current line and stops at the end of the para-
graph. A paragraph is defined as contiguous text bounded by
empty lines both above and below.
INDENT
This function is very useful in programming when you want to
indent a section of code in or out without having to manually
- 19 -
edit each line. Indenting is by levels where one level is 4
character positions or one-half a tab stop. INDENT uses tabs
and spaces to indent the line to the desired offset.
To use INDENT (1) position the cursor to the start of the
first line, (2) toggle Select on, (3) highlight the entire
range of lines to be indented and (4) issue the "INDENT" or
"INDENT n" command. Specify the number of levels (n) as a
positive or negative integer - positive moves toward the
right, negative toward the left.
AUTO INDENT
This function is very useful in programming. It is used to
automatically indent a new line the same as the current
line. pEDIT uses the same leading whitespace (spaces and
tabs) as the current line. AUTO INDENT is normally used at
the end of a line but the command can be issued anywhere.
Normally bound to <Ctrl-Enter>.
CENTER LINE
Centers the current line - the line the cursor is on -
between the defined margins. Only spaces are used to move
the line to the appropriate offset.
CAPITAL WORD
Capitalizes the current word starting at the current position
of the cursor within the word. The capitalization does not
start at the beginning of the word; this is to allow, for
example, 'Compuserve' to be changed to 'CompuServe'.
LOWER WORD
Converts the current word to lowercase starting at the
current position within the word. All characters from the
cursor to the end of the word will be changed to lowercase.
UPPER WORD
Converts the current word to uppercase. All characters from
the cursor to the end of the word will be changed to upper-
case.
QUOTE CHAR
This function is used to enter special characters into the
text. pEDIT prompts with "Press key to be added: "; at this
point press one of the special keys. For example, to insert
- 20 -
a form feed (Ctrl-L) press the QUOTE CHAR key followed by
<Ctrl-L>. The character will show as '^L' on the screen.
The feature can also be used with Find and Replace. To find
a line feed (Ctrl-J), if the QUOTE CHAR key is <Ctrl-V>,
press the DO COMMAND key and enter "FIND <Ctrl-V><Ctrl-J>".
Extended keys such as the PC keypad and function keys cannot
be quoted. The graphics characters - those above Ascii 127 -
are inserted in a special way. Hold down the Alt key and
enter the decimal value of the character using the numeric
keypad only; release the Alt key when done.
TRANS CHAR
Transposes (swaps) two characters of text within a line. The
cursor must be on the second character when you issue the
command. The cursor cannot be positioned past the end of the
line.
- 21 -
p E D I T P L U S C O M M A N D S
3. Text Deletion
These commands are used to erase existing text and to restore
deleted text. Deletion can be by character, word or line.
ERASE CHAR
Deletes the current character - the character the cursor is
on. The action is dependent on the current mode. In Insert
mode, the character is deleted and text to the right of the
cursor is shifted left to "fill in the hole". In Overstrike
mode, the character is replaced by a space.
ERASE PREV
Deletes the previous character - the character to the left of
the cursor. In Insert mode, the character is deleted and text
to the right of the cursor is again shifted toward the left.
In Overstrike mode, the character is replaced by a space. The
command is permanently bound to the <BackSpace> key.
ERASE WORD
Deletes text from the current position in a word to the end
of the word. The current mode and direction have no effect
on the action taken by ERASE WORD; deletion is always toward
the end of the word.
ERASE LINE
Erases a line or portion of a line. If the cursor is at the
beginning of a line, the entire line - including the end of
line marker - is erased and stored in the text buffer. If
the cursor is not at the beginning of a line, deletion is
from the current position to the end of the line.
RESTORE TEXT
Restores the text last deleted by ERASE WORD or ERASE LINE.
This text is stored in a special text buffer for later
restoration. This text buffer is rebuilt after every action
so only the last erasure can be restored.
This command along with REMOVE TEXT provide an "undo" cap-
ability. It is very unlikely that anyone would ever need to
"undo" hundreds of editing operations. A better approach is
to "Save early, save often" so you can fall back to the
point of the last save.
- 22 -
p E D I T P L U S C O M M A N D S
4. Searching
These commands are used to search for text and to replace
one text string by another. A limited wild card facility
permits matching the beginning and end of line. The SET SCOPE
command determines if the searching is to be local (current
buffer) or global (all buffers).
FIND (B)
FIND is used to search for a text string. To initiate this
function, press the FIND key and respond to "String to
find", or press DO COMMAND and enter "FIND <text>". The
direction of the search will be in the current direction.
You can cancel a FIND operation by pressing the ABORT key.
If the target string is all lowercase, the operation will be
case-insensitive; that is 'pedit' will match 'pedit', 'pEDIT'
and 'PEDIT'. If, however, the target contains any uppercase
characters, the match will be exact, i.e. 'pEDIT' matches
only 'pEDIT'.
Special symbols are used to match beginning of line (bol) and
end of line (eol). Use '\\<' for bol and '\\>' for eol. For
example, '.\\>' matches a period only if it is at the end of
a line.
FINDNEXT (B)
Searches for the next occurrence of the last search string
you specified. It is advisable to have FINDNEXT bound to a
key so only a single key press is required to repeat the
last search operation.
REPLACE (B)
pEDIT has a very powerful search and replace function. To
initiate it, either press the REPLACE key and reply to the
"Old string:" and "New string:" prompts, or press DO COMMAND
and enter "REPLACE <old> <new>".
pEDIT will search for each occurrence of 'old' and prompt you
with "Replace (Y)es (N)o (A)ll (L)ast (Q)uit: "
Y, Enter - replace this occurrence
N - skip this replacement
A - replace all occurrences from this point
- 23 -
L - make this the last replacement and quit
Q - quit.
Matching the old string will follow the rules listed for the
FIND command. The same wild cards that are useable in FIND
may be specified for the 'old' string only.
- 24 -
p E D I T P L U S C O M M A N D S
5. Files
These commands pertain to the reading and writing of disk
files. You can load in a file, save a buffer to disk and
change the file name associated with a buffer.
Up to 16 files can be loaded at one time. Note that a buffer
cannot be "released" because pEDIT cannot currently free up
memory once it has been allocated.
GET FILE (B)
Loads in a file from disk for editing. pEDIT supports wild-
card file specifications of the type '*.*' and '*.BAS'. If
more than one file matches the specification, you will be
presented with a list of all matching file names in alpha
order. To select a file, use the arrow keys or click on it
with the left mouse button; press <Enter> or click the right
mouse button to load the highlighted file. Press the ABORT
key to cancel.
If no matching file exists, pEDIT will display "Creating
file". If the file does exist, it will be loaded into
memory. It is important to realize that the file itself is
still on disk and will remain untouched unless you save a
modified buffer using WRITE FILE.
INCLUDE FILE
Reads in the specified file from disk and inserts it into the
buffer starting at the current cursor location. The result is
the same as if the user typed in the text contained in the
file.
INCLUDE FILE should be used only for relatively small files.
The function uses the normal INSERT CHAR routine, not the
much faster GET FILE which loads text directly into memory.
WRITE FILE (B)
Saves the contents of the current buffer to disk without
terminating the editing session. If no associated file name
has been specified, pEDIT will ask for one.
pEDIT verifies that there is sufficient disk space for the
file BEFORE starting the save operation. The Error Handling
Section has a full description of what to do if you get an
error while saving a file.
- 25 -
You can change the name of the associated file at any time by
using the RENAME FILE command.
RENAME FILE
Changes the name of the disk file associated with the cur-
rent buffer. The new name will be used at the time of the
next WRITE FILE operation.
Use RENAME FILE when you want to save a file under a name
other than the one the it was called up under.
- 26 -
p E D I T P L U S C O M M A N D S
6. Buffers
These commands affect how text is viewed. You can pick which
buffer to view, set the mode and direction for a buffer, and
so on.
SHOW BUFFER (B)
Displays detailed information about the current buffer: the
buffer name, associated file name, current mode/direction,
number of lines and characters of text, etc. The status line
also shows the pEDIT version number.
BUFFER (B)
Use the BUFFER command to switch between buffers. You will
be presented with a BUFFER window containing the names of
all buffers except the COMMAND buffer. The first User buffer
will be highlighted. To select a buffer, use the up and down
arrow keys or click on the buffer name with the left mouse
button. Press <Enter> or click the right mouse button to move
selected buffer. Press ABORT to cancel.
TRIM BUFFER
This function 'trims' the current buffer by removing trailing
blanks from all lines of text.
TRIM BUFFER is useful in any document where a left margin
has been defined. pEDIT automatically indents every line to
the specified left margin, which can result in "empty" lines
between paragraphs. These empty lines can take up a lot of
space in a large document.
CHANGE MODE
Used to toggle between Insert and Overstrike modes. If the
mode is Insert when the command is given, it will change to
Overstrike and vice versa.
CHANGE DIR
Use this command to toggle between the Forward and Reverse
directions. Note that only FIND, FINDNEXT, REPLACE and MOVE
WORD use the buffer direction.
MARK
- 27 -
Used to mark a particular place in a buffer so you can re-
turn to it at some later time. Sometimes called a bookmark;
there can be only one marker in each buffer. pEDIT tries to
stay as close as possible to the original mark as text is
inserted and deleted.
GOTO MARK
This command moves to the position (line and offset) defined
by the last MARK command.
LINE
The LINE command is used to "goto" a particular line in the
buffer. Enter "LINE nn" to move to line number nn; if you
enter LINE by itself, pEDIT will ask for the line number.
- 28 -
p E D I T P L U S C O M M A N D S
7. Windows
The window functions control the number of windows on screen
and let you select the current window. A window can be moved
up/down/left/right to view any portion of a buffer.
ONE WINDOW (B)
This function 'unsplits' the screen. If there are 2 windows
on screen, the current window - the one the cursor is in -
becomes the only window. The current window will occupy the
full screen. The line the cursor was on when the command was
issued becomes the top line of the window.
TWO WINDOWS (B)
This command 'splits' the screen if there is only one window
visible. Both windows will initially show the same number of
lines of the current buffer. The cursor will move to the
other window anticipating that you want to load in another
file.
OTHER WINDOW (M)
If the screen is split, this command will move the cursor to
the other window. The cursor will move to the row and column
stored the last time the cursor was in the window.
If you have a mouse, click anywhere in the other window to
move to that window.
PREV LINE (M)
Scrolls the current window up one line. This command is
normally accessed only with a mouse, by clicking on the
UpArrow symbol at the top of the Scroll Bar.
PREV SCREEN (M)
Moves the text window back one screen towards the beginning
of the buffer. This command should be bound to the <PgUp>
key as it means "Page Up". The screen is repainted rather
than scrolled.
NEXT LINE (M)
Scrolls the current window down one line. This command is
normally accessed only with a mouse, by clicking on the
- 29 -
DownArrow symbol at the bottom of the Scroll Bar.
NEXT SCREEN (M)
Moves the text window forward one screen towards the end of
the buffer. This command should remain bound to the <PgDn>
key as it means "Page Down". Again, the screen is repainted
rather than scrolled.
SHIFT LEFT (B)
Moves the window horizontally to the left (toward the left
margin) the specified number of columns. If no parameter is
specified, the shift amount will be 40 columns.
SHIFT RIGHT (B)
Shifts the screen horizontally to the right - toward the end
of the line - by the number of columns you specify. This is
to permit viewing text past column 78. If no argument is
specified, the screen will be shifted 40 columns. The shift
value is limited only by the maximum line length of 32767
characters.
- 30 -
p E D I T P L U S C O M M A N D S
8. Cut and Paste
pEDIT provides another "undo" capability. A block of text
can be "cut" and stored in a "paste" buffer (also called the
"clipboard") for later restoration. Other functions can make
a copy of selected text without removing it, and delete text
without storing it.
The maximum size of a block that can be stored on the clip-
board via the REMOVE TEXT and STORE TEXT commands is limited
by available memory.
SELECT TEXT (M)
This is a toggle that turns the select state on/off. If the
state is off, it will be turned on and vice versa. Selected
text is highlighted in reverse video as the cursor is moved.
Select is automatically turned off after REMOVE TEXT, STORE
TEXT and WIPE TEXT commands. To cancel the selection, i.e.
turn the highlighting off, simply issue the command again.
REMOVE TEXT (B)
Removes (cuts) the selected text and stores it to the clip-
board (paste buffer). The clipboard is rebuilt every time
REMOVE TEXT is invoked; therefore, only the most recently
deleted text can be reclaimed.
STORE TEXT
Copies the selected text to the clipboard without removing
from the buffer. Use this command whenever you want to make
a copy of some text without deleting it.
WIPE TEXT
Deletes the highlighted block without copying it to the clip-
board. WIPE TEXT is much faster than REMOVE TEXT because the
paste buffer is not rebuilt. This command is especially use-
ful for deleting large amounts of text; use it when you have
no need to get the text back. There is no limit on the size
of the block that can be erased.
INSERT HERE (B)
Inserts text from the clipboard into the current buffer
starting at the current cursor position. Note that INSERT
HERE can be invoked more than once to make multiple copies
of the stored text.
- 31 -
p E D I T P L U S C O M M A N D S
9. Key Macros
pEDIT's key macro facility lets you automate repetitive
tasks. With the following commands you can start a "learn"
sequence and pEDIT will "remember" all the keystrokes that
re entered. You can then "play back" the macro on demand
to replay the keystrokes.
Key macros can be saved to disk, making it possible to have
several pre-defined macros available for use.
LEARN
The LEARN command is used to start recording keystrokes. The
recording will continue until the REMEMBER command is given.
pEDIT will store all typing keys, function keys and special
keys such as control keys. Note that mouse button presses
are not stored.
Any key can be stored in a pEDIT macro. The only restriction
is that a macro containing a REPEAT command cannot itself be
repeated.
REMEMBER
Used to end the keystroke recording started by LEARN. pEDIT
will ask for a key to bind to; press any of the definable
keys on the keyboard. You cannot bind to the Tab, Enter or
BackSpace keys.
A macro must also not be bound to a key that is contained
within the macro. If this happens, the macro routine will go
into a loop and probably crash the system.
SAVE MACRO
Saves the currently defined key macro to disk. Enter only a
file name; pEDIT automatically adds the extension .PMC. The
editor will write the macro file in the directory pointed to
by the PEDIT PATH.
If a macro file of the same name already exists, you will be
given the chance to overwrite it or cancel.
EXECUTE
Executes the macro defined by LEARN and REMEMBER. When this
command is issued, the keystrokes are 'replayed' as if you
- 32 -
entered them. There are two forms of this command: one for a
key macro, one for a disk macro. See the 'Macro Facility'
section for more information.
EXECUTE by itself is used for the single key macro. A com-
mand of the form "EXECUTE filename" invokes a disk macro.
Here, "filename" is a valid DOS file name up to 8 characters
in length without an extension. pEDIT automatically adds the
file type .PMC to all disk macro file names.
- 33 -
p E D I T P L U S C O M M A N D S
10. Miscellaneous
DO COMMAND (B)
When the "DO" key is pressed the editor will respond with the
'Command: ' prompt. At this point you can enter any valid
pEDIT command. Commands can be upper- or lower-case or mixed.
Note that commands must be entered in full with spaces in
between words. You can exit Command Mode without doing any-
thing by pressing <Enter> after the prompt.
The Command line is really a one-line window into the COMMAND
buffer. All defined keys can be used on the command line for
editing the current line or recalling previous commands. Use
MOVE UP and MOVE DOWN to scroll through the stored commands.
RECALL
Used to recall the last command given via DO COMMAND. The
end result is the same as pressing the DO COMMAND key
followed by the MOVE UP with one important difference; the
previous command is copied to the current command line. The
command can of course be edited before pressing <Enter> to
begin execution.
DO BUTTON
Permits keyboard access to the ButtonBar for those without a
mouse. This function is permanently bound to <Ctrl-F10> and
should not be issued from the command line. When this key is
pressed, the first button will be selected and pEDIT will
wait for your input. Use the <Left> and <Right> keys to move
from button-to-button, and press <Enter> to accept or ABORT
to cancel.
ABORT
pEDIT has a user-definable ABORT key which must be defined
in the initialization file. The actual key used depends on
the configuration; ABORT is not 'hard-wired' to <Ctrl-C>
because WordStar uses <Ctrl-C> as a command key.
ABORT can be used to abort out of any REPEAT, FIND, FINDNEXT
or REPLACE loop. You can also use it to cancel out of the DO
BUTTON function, or any BUFFER, FILES or HELP screen.
REFRESH SCREEN
This command is used to clear and repaint the screen. Use
- 34 -
RefreshScreen if, for any reason, the screen should be over-
written or otherwise obliterated.
DEFINE SHIFT
Defines a shift or "lead-in" key for multi-key commands. It
signals pEDIT to wait for a second keystroke. A shift key
cannot be a command key by itself.
The shift keys must be defined in your initialization file
before other other key definitions. A maximum of 4 shift
keys can be defined.
DEFINE KEY
Used to 'bind' a pEDIT command to the key of your choice.
Pressing the key is equivalent to pressing DO COMMAND and
typing in the associated command. Here, 'command' refers to
any valid pEDIT command entered in full (no abbreviations)
with or without parameters.
Keys can be defined dynamically during an editing session
or, more commonly, specified in your init file. When DEFINE
KEY is issued from within the editor, pEDIT will ask for a
procedure name and a key press.
SHOW KEY
Displays the command bound to a key. pEDIT will prompt for a
key press and display the full command string, if there is
one, bound to that key.
LIST KEYS
Lists all defined keys and the commands bound to them. pEDIT
will pause in between screens; press any key to continue to
the next screen.
LIST ASCII
Displays the complete ASCII character set used by the IBM
PC. Includes the decimal value (1-255), the hexadecimal or
"HEX" value (01H to FFH) and the character. Very handy for
programmers. The editor will pause in between screens; press
any key to continue to the next screen.
DOS (B)
This function 'shells' you to DOS or passes a command to DOS
for execution. All text memory is swapped out to disk, and a
- 35 -
second copy of the command processor is loaded into memory
to process commands. Do not attempt to run any TSR programs
when shelled; see the section 'Extended DOS Shell' for more
information.
If "DOS" is given without parameters, you will be shelled to
DOS and will see the DOS prompt. You may then enter DOS com-
mands and do anything you can do at the operating system
level. Type 'EXIT' to return to the editor exactly as you
left it.
If a parameter is specified, the command will be passed to
DOS for execution and the output will be shown in the DOS
buffer.
REPEAT
Lets you repeat any key press up to 32767 times. Only the
next single key press - typing, function, Ctrl, Alt - is
repeated.
The repeat count is shown by 'Repeat: ' on the message line.
Use <BackSpace> to correct the count; set the count to zero
if you wish to cancel.
You can end a REPEAT loop by pressing the ABORT key.
SET AUTOSAVE
The autosave feature can be used to automatically save your
work to disk. If autosave is active, a WRITE FILE will be
performed periodically to the current buffer if changes have
been made. The buffer will also be saved when a new file is
loaded or you switch buffers.
The usage is "SET AUTOSAVE value". A value of zero turns the
autosave feature off; a value in the range 1-30 defines a
save interval of 1 to 30 minutes.
SET COLOR
Lets you choose foreground and background colors for your
editing session. For monochrome and CGA displays, the only
legal combinations are Black-on-White and White-on-Black.
Black and White refer to the mono colors whatever they may
be - black and white, black and green, etc.
Only the basic 16 colors are supported on EGA/VGA color
displays. The usage is "SET COLOR fground bground". See the
Appendix for a list of valid color code names.
- 36 -
SET LINES
Lets you choose the number of lines of text that are shown
on-screen in text mode. All displays support 25 lines; 43
line mode requires EGA or VGA, while 50 line mode requires
VGA. Screen writing and scrolling are generally much slower
in 43-and 50-line modes. This command cannot be used when
the editor is in graphics mode or the screen is split. The
usage is "SET LINES 25|43|50".
SET MARGINS
Lets you set left and right text margins; the right margin
controls where text wraps. The default margins are 1 and 80.
The left margin must be greater than zero and the right
margin has to be greater than the left. The usage is "SET
MARGINS left right".
SET PINDENT
Used to set the paragraph indent, i.e. the number of columns
by which to indent the first line of a paragraph. The usage
is "SET PINDNT nn" where nn is zero or a positive integer.
SET SCOPE
Specifies the "scope" for all FIND and REPLACE operations.
If the scope is Local, only the current buffer will be
searched. If the scope is Global, all user buffers will be
searched and 'Global' will show on the status line. The
format of this command is "SET SCOPE local|global".
Things can get out of hand if some buffers are searched in a
forward direction while others are searched in reverse. For
this reason, the direction for all buffers is temporarily set
to Forward during a global search.
SET VIDEO
Lets you switch between text and graphics mode if you have a
graphics display. pEDIT PLUS will start up in graphics mode
if it detects a CGA/EGA/VGA display; you can override this
if you prefer the speed of text mode to the graphical inter-
face. The usage is "SET VIDEO text|graphics".
HELP (B)
Provides full on-line help for every pEDIT PLUS command. The
editor looks for a help file named PEDIT.HLP in the direct-
ory defined by the PEDIT PATH.
- 37 -
You will be presented with a HELP window containing an alpha-
betical list of all pEDIT commands. Use the arrow keys or
click the left mouse button to highlight the topic you want
help with; press <Enter> or click the right mouse button to
select that topic. The function can be cancelled by pressing
ABORT.
ALTHELP
Displays the contents of the files PEDIT.BTN and PEDIT.KEY
in BUTTON and KEYBOARD windows, respectively. The editor
looks for these two files in the directory specified by the
PEDIT PATH. Provides help for the ButtonBar and the keyboard
(usually a keyboard diagram and/or a list of the keys you
have defined).
RULER
Toggles an on-screen ruler on and off. The ruler temporarily
overwrites the status line at the bottom of the window.
QUIT (B)
Use the QUIT command to abort an editing session. Abort MEANS
abort - any changes you have made will be lost. If any User
buffers have been modified, pEDIT gives you the option of not
quitting by displaying "Buffer(s) modified - quit (Y/N)? ".
Enter Y to abort, N to cancel and resume editing.
EXIT
Terminates the editing session and returns you to DOS. The
current buffer is automatically written to disk if it has
been modified. If any of the other user buffers have been
altered, pEDIT asks you one at a time if you want to write
them. Answer Y to save the buffer, N to skip it.
- 38 -
M A C R O F A C I L I T Y
1. Macro Types
pEDIT supports two different kinds of macros. The first
is a key macro. The primary use of this type of macro (of
which there can be only one) is to automate one-time tasks.
If you find you are using the same stored keystrokes over and
over, the macro should be given a name and saved to disk.
The second type of macro is a disk macro. Start by set-
ting up a key macro as above; experiment until you get it
working the way you want. Then, issue the SAVE MACRO command
and pick a file name. The name must be a standard DOS file-
name of up to 8 characters. Do not include a file type;
pEDIT automatically adds the extension PMC. If the macro
file already exists, you will be given a chance to overwrite
the file or abort.
Disk macros are used to automate things you do all of the
time. Let's say you do medical transcription and constantly
have to type in the phrase 'blood pressure'. Easy - define a
disk macro 'BP' to automatically enter the text for you.
Another use for disk macros is to extend the editor - to
give it a capability it doesn't have. Two of the sample
macros provide something not built-in to pEDIT: the ability
to scroll the OTHER window up/down when the screen is split.
2. Macro Execution
A key macro is invoked by issuing the command EXECUTE
without any parameters.
Disk macros are executed via "EXECUTE filename" where
filename is the name the macro was saved under. Again, do not
specify a file type. pEDIT looks for the macro files in the
directory pointed to by the PEDIT PATH.
3. Sample Macros
pEDIT is supplied with four sample macros which will be
installed under the following names. Again, XXX refers to
the configuration type (EMC, QUI, STD or WST):
XXXLETTR.PMC Sets the left margin to 10, the right
margin to 70 and the paragraph indent
to 4 for a letter with 1" margins
- 39 -
XXXOTHUP.PMC Scrolls the other window up
XXXOTHDN.PMC Scrolls the other window down
XXXWREV.PMC Moves one word in the reverse direction;
temporarily changes the buffer direction
to Reverse - so you must start Forward
- 40 -
E X T E N D E D D O S S H E L L
pEDIT has an intelligent DOS shell which provides up to
350k of free memory on a 640k machine when shelled to DOS.
This provides sufficient free memory to complile from within
pEDIT and to run large programs.
All text is temporarily 'swapped' out to disk and the
memory is released before calling DOS. When the user types
'EXIT' to return to the parent program, the text storage is
reallocated and reloaded from these swap files.
pEDIT checks to make sure there is sufficient disk space
to hold the swap files. If not, the function will be cancel-
led. It is very important that you not delete the temporary
swap files, which are stored in the PEDIT PATH with names of
PEDMEM?.TMP where ? = 0-4. pEDIT automatically deletes these
files after they have been reloaded into memory.
DO NOT run any TSR (Terminate and Stay Resident) pro-
grams when shelled to DOS. This is a sure way to lock up
your computer. Examples of TSRs are the DOS PRINT utility
and mouse drivers such as MOUSE.COM.
- 41 -
P R I N T I N G F R O M
p E D I T P L U S
pEDIT does not directly support printing. Programs that
do - such as word processors - must provide printer drivers
for hundreds of printers. This would add immeasurably to the
size and complexity of pEDIT. It is the belief of the author
that functions such as printing are best left to utilities
and the Operating System. A print spooler is provided with
DOS Versions 3 and higher. There are many excellent share-
ware spoolers and print utilities.
You can, however, print from pEDIT using the DOS shell.
To print the contents of the current buffer, first save the
buffer to disk using WRITE FILE; then, issue the command:
DOS COPY filespec LPT1:
to copy the specified file to the parallel printer port. If
you have a parallel printer attached to another port or a
serial printer, replace LPT1: by the appropriate device
name. Note that if you are redirecting a serial printer via
the DOS MODE command, you can use LPT1: as the device.
As mentioned in the previous section, never try and
print by shelling a DOS PRINT command. This is guaranteed to
lock up your system.
If you would like to print from pEDIT using the above
method and have a printer setup routine you need to invoke,
put an auto-executing macro in your initialization file to
do the setup for you. If, for example, you have a program
named NLQ in your DOS PATH to set a dot matrix printer to
nlq (near letter quality) mode, you can define a macro NLQ
as follows that contains the following command:
DOS NLQ
You can also print a portion of the current buffer by
(1) copying the text to the clipboard, (2) opening a dummy
file such as DUMMY.TMP, (3) pasting the text from the clip-
board and (4) shelling a DOS command as above.
- 42 -
C O M P I L I N G F R O M
p E D I T P L U S
Programs can be compiled from within pEDIT using the DOS
function. There are several ways to accomplish this; in all
cases, the output will be placed in the DOS buffer so you
can see any errors.
1. Manual Invocation
The simplest method is to manually issue the command(s)
from within the editor. Unfortunately, a different command
line must be typed in for every source buffer so this can't
be easily automated. pEDIT now supports simple command sub-
stitution to translate
DOS \QBASIC\BC % /S /O ;
to, for example,
DOS \QBASIC\BC C:\BASIC\TEST /S /O ;
pEDIT will substitute the file name associated with the cur-
rent buffer less the file type. The file type (extension) is
not included because compilers and linkers typically use the
same file name but a different file type.
2. Batch File
Another method is to use a batch (BAT) file to perform
the compilation. This method requires some finagling because
the output from a BAT file cannot be redirected. Recall that
pEDIT uses a temporary PEDIT.TMP file to capture the output
from a shelled DOS command.
Following is a sample batch file to compile and link a
QuickBASIC program from pEDIT. Refer to the DOS manuals for
more information on batch commands and command substitution
using the parameters %1...%9. Note the use of the redirection
symbol >> which tells DOS to append the command output to the
specified file. This file MUST be named PEDIT.TMP.
ECHO OFF
IF EXIST %1.BAS GOTO Continue
ECHO No source file >>PEDIT.TMP
GOTO Exit
:Continue
IF EXIST %1.EXE DEL %1.EXE
- 43 -
BC %1.BAS /O ; >>PEDIT.TMP
LINK /EX /NOE %1.OBJ+QB.LIB,,,BCOM45.LIB ; >>PEDIT.TMP
DEL %1.OBJ
DEL %1.MAP
:Exit
3. Disk Macros
The most elegant way to compile is with pEDIT's disk
macros. The macros can even be set up to automatically step
through the compile errors and position to every bad line in
the source file! This is quite impressive considering that
no macro language is used.
Only the general method, which requires two macros, can
be outlined here. The first does the actual compilation and
positions the DOS buffer to the start of the latest compile
statement. The second steps through the errors by moving to
the DOS window, finding an error string and storing it on
the clipboard, and returning to the source window and using
FIND to position to the offending line.
The most difficult part of the second macro is locating
the errors! Compilers use different error indicators. A caret
(^) on one line is fairly common to point to the offending
part of a statement on the line above. Another problem is
that a single source line can generate several errors.
- 44 -
E R R O R H A N D L I N G
If an error occurs, pEDIT will bring up an ERROR window
and alert you to one of the following problems.
1. Insufficient Internal Storage
At startup, pEDIT checks to see how much free memory is
available. This determines the maximum number of lines and
characters of text it can handle. pEDIT informs you whenever
99% of either of these values is reached and advises you to
"Save your work and exit". If youcontinue to work, you will
get the warning *every* time text is added. If you ignore
the warnings and exceed the allocated space, the program
will abort.
There is no recovery from this other than to exit (be
sure and save your work) and start over. pEDIT presently
cannot free up memory once it has been allocated.
2. Insufficient Disk Space
pEDIT checks for sufficient disk space BEFORE starting a
file save operation. If this does happen, you will be advised
to "Increase available space on current drive or change file
specification via RENAME FILE".
The text is still in memory and has not been lost; how-
ever, it has not yet been saved to disk. If possible, Spawn
out to DOS and delete some files to free up space. Or, switch
to a different diskette that has more room. Or, use RENAME
FILE to change to another drive; for example, if the current
file is A:MYFILE.TXT, save the file as B:MYFILE.TXT.
3. No Initialization File
pEDIT requires an initilization file for proper oper-
ation. The default init file is named PEDIT.INI. If this
file cannot be found, it means that pEDIT has not been
properly installed using the INSTALL program.
If an initialization file cannot be found, pEDIT will
invoke a minimal configuration so you can communicate with
the editor. The colors are set to white on blue, and the
labelled keys such as the cursor keys, <Ins>, <Del>, <PgUp>
and <PgDn> are bound to their expected functions. Finally,
the <Esc> key is defined as DO COMMAND.
- 45 -
M I S C E L L A N E O U S
L E G A L I T I E S
1. Copyright Notice
This document, other accompanying written and disk-based
specifications, and all referenced and related program files
are copyrighted by T. G. Muench.
PC-DOS is a registered trademark of International
Business Machines Corporation. MS-DOS and QuickBASIC are
trademarks of Microsoft Corporation. WordStar is a regis-
tered trademark of MicroPro International. Other brand and
product names are trademarks or registered trademarks of
their respective holders.
2. Registration
pEDIT PLUS is a "shareware program" and is provided at
no charge to the user for evaluation. Feel free to share it
with your friends, but please do not give it away altered or
as part of another system. The essence of "user-supported"
software is to provide personal computer users with quality
software without high prices, and yet to provide incentive
for programmers to continue to develop new products. If you
find this program useful and find that you are using pEDIT
PLUS and continue to use pEDIT PLUS after a reasonable trial
period, you must make a registration payment to T. G. Muench.
Commercial users of pEDIT PLUS must register and pay for
their copies of pEDIT PLUS within 30 days of first use or
their license is withdrawn. Site-License arrangements may be
made by contacting T. G. Muench.
Anyone distributing pEDIT+ for any kind of remuneration
must first contact T. G. Muench at the address below for
authorization. This authorization will be automatically
granted to distributors recognized by the (ASP) as adhering
to its guidelines for shareware distributors, and such
distributors may begin offering pEDIT PLUS immediately.
However T. G. Muench must still be advised so that the
distributor can be kept up-to-date with the latest version
of pEDIT PLUS.
You are encouraged to pass a copy of pEDIT PLUS along to
your friends for evaluation. Please encourage them to reg-
ister their copy if they find it useful.
- 46 -
A registration payment of $30 entitles you to license
your currently used copy of pEDIT PLUS and receive the
latest version of pEDIT PLUS without shareware screens, FREE
utilities, and special rates on subscriptions to PsL News
and Shareware Magazine. A payment of $40 grants you full
registration - all of the above plus a printed manual and
one FREE upgrade. All registerered users are entitled to
technical support.
REGISTER *NOW* and receive an evaluation copy of Micro-
Fox's HDM IV (Hard Disk Menu), the top rated DOS shell/menu
system. Your copy of HDM will come preconfigured to start up
pEDIT. HDM IV has received rave reviews in PC Source, PC
Computing, PC Resource and Dr. File Finder's Guide to Share-
ware. With HDM IV you will never again have to face the
infamous 'C>' prompt!
Your comments and suggestions are welcomed by writing to
the author at the address below or by leaving E-Mail at CIS
[71171,2424]. Be sure and reference the version number of
your copy of pEDIT (use the SHOW BUFFER command). Priority
will be given to registered users; others will be helped on
an "as can" basis.
You can order pEDIT in one of two ways: direct from Pub-
lic (software) Library by calling 1-800-2424-PsL and asking
for pEDIT - Item# 10369. If you wish, you can charge to your
VISA/MC/AMEX or Discovery card. Call TODAY and receive a PsL
free-disk coupon.
Or, fill out the order form at the end of this document,
and send a check or money order to:
T. G. Muench
P.O. Box 11536
Prescott, AZ 86304-1536
(602) 445-2479
Purchasers outside the US must provide a check in US
funds *DRAWN ON A US BANK*. Additionally, they can obtain a
Postal Money Order at their National Post Office made out in
US funds. Purchase discounts are available in the form of
corporate site licenses. Write to the author for more infor-
mation.
- 47 -
A P P E N D I C E S
A. Key Bindings
1. Labelled Keys
Many of the labeled keys on the PC keyboard are bound to
functions common to all configurations. The function bound
to these keys corresponds to the key name. Keys marked with
(*) cannot be redefined.
(*)BackSpace ERASE PREV
(*)Tab INSERT CHAR
(*)Enter INSERT CHAR
Home MOVE HOME
End MOVE END
PgUp PREV SCREEN
PgDn NEXT SCREEN
Up MOVE UP
Down MOVE DOWN
Left MOVE LEFT
Right MOVE RIGHT
Ctrl-Enter AUTO INDENT
Ctrl-H =<BackSpace>
Ctrl-I =<Tab>
Ctrl-J =<Ctrl-Enter>
Ctrl-M =<Enter>
- 48 -
A P P E N D I C E S
A. Key Bindings
2. Standard
Esc DO COMMAND
F01 HELP
F02 BUFFER
F03 FINDNEXT
F04 OTHER WINDOW
F05 RESTORE TEXT
F06 CHANGE DIR
F07 LEARN
F08 REPEAT
F09 QUIT
F10 WRITE FILE
F11 STORE TEXT
F12
Ins CHANGE MODE
Del ERASE CHAR
Ctrl-Home MOVE TOP
Ctrl-End MOVE END
Ctrl-Left EXECUTE STDWREV
Ctrl-Right MOVE WORD
Ctrl-PgUp EXECUTE STDOTHUP
Ctrl-PgDn EXECUTE STDOTHDN
Alt-A LIST ASCII
Alt-C CAPITAL WORD
Alt-D REMOVE TEXT
Alt-F FILL PARAGRAPH
Alt-G GET FILE
Alt-H ALTHELP
Alt-I INCLUDE FILE
Alt-K DEFINE KEY
Alt-L LOWER WORD
Alt-M SET MARGINS
Alt-N RENAME FILE
Alt-P INSERT HERE (paste)
Alt-Q QUIT
Alt-R REPLACE
Alt-S SELECT TEXT
Alt-T TRANS CHAR
Alt-U UPPER WORD
Alt-V SET VIDEO
Alt-W WIPE TEXT
- 49 -
Alt-1 ONE WINDOW
Alt-2 TWO WINDOWS
Ctrl-B RECALL
Ctrl-C ABORT
Ctrl-D ERASE WORD
Ctrl-F FIND
Ctrl-G SET SCOPE GLOBAL
Ctrl-K ERASE LINE
Ctrl-L SET SCOPE LOCAL
Ctrl-O OPEN LINE
Ctrl-P SET PINDENT
Ctrl-R REMEMBER
Ctrl-V QUOTE CHAR
Ctrl-W REFRESH SCREEN
Ctrl-Z EXIT
- 50 -
A P P E N D I C E S
A. Key Bindings
3. WordStar
Esc DO COMMAND
F01 HELP
F02
F03 FINDNEXT
F04
F05 CHANGE MODE
F06 CHANGE DIR
F07 LEARN
F08 REPEAT
F09
F10
F11 STORE TEXT
F12
Ins CHANGE MODE
Del ERASE CHAR
Ctrl-Home MOVE TOP
Ctrl-End MOVE END
Ctrl-Left SHIFT LEFT
Ctrl-Right SHIFT RIGHT
Ctrl-PgUp EXECUTE WSTOTHUP
Ctrl-PgDn EXECUTE WSTOTHDN
Alt-A LIST ASCII
Alt-B BUFFER
Alt-C CAPITAL WORD
Alt-D DOS
Alt-H ALTHELP
Alt-K DEFINE KEY
Alt-L LOWER WORD
Alt-O OTHER WINDOW
Alt-P SET PINDENT
Alt-Q QUIT
Alt-R REMEMBER
Alt-S SET SCOPE
Alt-T TRANS CHAR
Alt-U UPPER WORD
Alt-V SET VIDEO
Alt-X ABORT
Alt-1 ONE WINDOW
Alt-2 TWO WINDOWS
- 51 -
Ctrl-A EXECUTE WSTWREV
Ctrl-B FILL PARAGRAPH
Ctrl-C NEXT SCREEN
Ctrl-D MOVE RIGHT
Ctrl-E MOVE UP
Ctrl-F MOVE WORD
Ctrl-G ERASE CHAR
Ctrl-J AUTO INDENT
Ctrl-L FINDNEXT
Ctrl-N OPEN LINE
Ctrl-P QUOTE CHAR
Ctrl-R PREV SCREEN
Ctrl-S MOVE LEFT
Ctrl-T ERASE WORD
Ctrl-U RESTORE TEXT
Ctrl-V CHANGE MODE
Ctrl-W PREV LINE
Ctrl-X MOVE DOWN
Ctrl-Y ERASE LINE
Ctrl-Z NEXT LINE
Ctrl-K+B SELECT TEXT
Ctrl-K+C INSERT HERE
Ctrl-K+D GET FILE
Ctrl-K+F RENAME FILE
Ctrl-K+Q QUIT
Ctrl-K+R INCLUDE FILE
Ctrl-K+S WRITE FILE
Ctrl-K+U SELECT TEXT
Ctrl-K+Y REMOVE TEXT
Ctrl-K+X EXIT
Ctrl-Q+A REPLACE
Ctrl-Q+C MOVE BOTTOM
Ctrl-Q+D MOVE END
Ctrl-Q+F FIND
Ctrl-Q+I LINE
Ctrl-Q+P GOTO MARK
Ctrl-Q+R MOVE TOP
Ctrl-Q+S MOVE HOME
Ctrl-Q+Y ERASE LINE
Ctrl-O+C CENTER LINE
Ctrl-O+L SET MARGINS
Ctrl-O+R SET MARGINS
- 52 -
A P P E N D I C E S
A. Key Bindings
4. EMACS
Esc+Esc DO COMMAND
F01 HELP
F02
F03 FINDNEXT
F04
F05 CHANGE MODE
F06 CHANGE DIR
F07
F08
F09 RESTORE TEXT
F10
F11 STORE TEXT
F12
Ins CHANGE MODE
Del ERASE CHAR
Ctrl-Home MOVE TOP
Ctrl-End MOVE END
Ctrl-Left SHIFT LEFT
Ctrl-Right SHIFT RIGHT
Ctrl-PgUp EXECUTE EMCOTHUP
Ctrl-PgDn EXECUTE EMCOTHDN
Alt-A LIST ASCII
Alt-F FILL PARAGRAPH
Alt-H ALTHELP
Alt-K DEFINE KEY
Alt-M SET MARGINS
Alt-P SET PINDENT
Alt-Q QUIT
Alt-R REPLACE
Alt-S SET SCOPE
Alt-V SET VIDEO
Ctrl-A MOVE HOME
Ctrl-B MOVE LEFT (backward)
Ctrl-C SPAWN
Ctrl-D ERASE CHAR
Ctrl-E MOVE END
Ctrl-F MOVE RIGHT (forward)
Ctrl-G ABORT
Ctrl-J AUTO INDENT
- 53 -
Ctrl-K ERASE LINE (kill line)
Ctrl-L REFRESH SCREEN
Ctrl-N MOVE DOWN (next line)
Ctrl-P MOVE UP (prev line)
Ctrl-S FIND (search)
Ctrl-T TRANS CHAR
Ctrl-U REPEAT (universal)
Ctrl-V NEXT SCREEN
Ctrl-W REMOVE TEXT (wipe)
Ctrl-Y INSERT HERE (yankback)
Ctrl-Z EXIT
Esc+. SELECT TEXT
Esc+< MOVE TOP
Esc+> MOVE BOTTOM
Esc+B EXECUTE EMCWREV (word back)
Esc+C CAPITAL WORD
Esc+D ERASE WORD
Esc+F MOVE WORD (word forward)
Esc+L LOWER WORD
Esc+U UPPER WORD
Esc+V PREV SCREEN
Ctrl-X+( LEARN (start macro)
Ctrl-X+) REMEMBER (end macro)
Ctrl-X+1 ONE WINDOW
Ctrl-X+2 TWO WINDOWS
Ctrl-X+B BUFFER
Ctrl-X+E EXECUTE (macro)
Ctrl-X+N OTHER WINDOW (next window)
Ctrl-X+P OTHER WINDOW (prev window)
Ctrl-X+Ctrl-C QUIT
Ctrl-X+Ctrl-F RENAME FILE
Ctrl-X+Ctrl-R INCLUDE FILE (read file)
Ctrl-X+Ctrl-S WRITE FILE (save file)
Ctrl-X+Ctrl-V GET FILE (visit file)
- 54 -
A P P E N D I C E S
A. Key Bindings
5. Microsoft Quick
Esc DO COMMAND
F01 HELP
F02 BUFFER
F03 FINDNEXT
F04
f05 CHANGE MODE
F06 CHANGE DIR
F07 LEARN
F08 REPEAT
F09
F10
F11
F12
Ins CHANGE MODE
Del ERASE CHAR
Home MOVE HOME
End MOVE END
Up MOVE UP
Down MOVE DOWN
Left MOVE LEFT
Right MOVE RIGHT
PgUp PREV SCREEN
PgDn NEXT SCREEN
Ctrl-Left EXECUTE QUIWREV
Ctrl-Right MOVE WORD
Ctrl-Home MOVE TOP
Ctrl-End MOVE BOTTOM
Ctrl-PgUp EXECUTE QUIOTHUP
Ctrl-PgDn EXECUTE QUIOTHDN
Alt-A LIST ASCII
Alt-C CAPITAL WORD
Alt-H ALTHELP
Alt-K DEFINE KEY
Alt-L LOWER WORD
Alt-M SET MARGINS
Alt-O OTHER WINDOW
Alt-P SET PINDENT
Alt-Q QUIT
Alt-T TRANS CHAR
Alt-U UPPER WORD
- 55 -
Alt-V SET VIDEO
Alt-X EXECUTE
Alt-1 ONE WINDOW
Alt-2 TWO WINDOWS
Ctrl-B RECALL
Ctrl-C ABORT
Ctrl-L FINDNEXT
Ctrl-F FILL PARAGRAPH
Ctrl-J AUTO INDENT
Ctrl-O OPEN LINE
Ctrl-P QUOTE CHAR
Ctrl-R REMEMBER
Ctrl-T ERASE WORD
Ctrl-U RESTORE TEXT
Ctrl-V CHANGE MODE
Ctrl-W PREV LINE
Ctrl-Y ERASE LINE
Ctrl-Z NEXT LINE
Alt-F+O GET FILE (Open)
Alt-F+M INCLUDE FILE (Merge)
Alt-F+S WRITE FILE (Save)
Alt-F+A RENAME FILE (save As)
Alt-F+D DOS
Alt-F+X EXIT (eXit)
Alt-E+S SELECT TEXT
Alt-E+T REMOVE TEXT (cuT)
Alt-E+C STORE TEXT (Copy)
Alt-E+P INSERT HERE (Paste)
Alt-E+E WIPE TEXT (clEar)
Alt-S+F FIND
Alt-S+R FINDNEXT (Repeat find)
Alt-S+C REPLACE (Change)
- 56 -
A P P E N D I C E S
B. The DOS Environment
Most PC users are familiar with the DOS PATH command. A
statement of the form
PATH=C:\;C:\DOS\;C:\PEDIT
in your AUTOEXEC file tells DOS where to look for programs
and batch files. Unfortunately, the DOS environment is a
mystery to most.
Environment variables are defined using the SET command at
the DOS prompt. The command "SET" by itself displays a list
of all defined variables while "SET NAME=VALUE" defines a
variable. Programs can read these environment variables and
get access to the equivalence value. Adding a line such as:
SET PEDIT=C:\PEDIT
to your AUTOEXEC.BAT file lets pEDIT find its initialization
and help files no matter what device/directory you are in.
Note that only a device and directory are specified.
Following is a sample AUTOEXEC.BAT file showing the DOS PATH
and the PEDIT environment variable. Note that these items
*must* be defined before entering a DOS shell such as HDM;
if they were after "HDM" in this case, the statements would
never be executed.
PATH=C:\;C:\DOS;C:\WINDOWS;C:\PEDIT
SET PEDIT=C:\PEDIT
CD \HDM
HDM
DOS allocates only a relatively small amount of memory for
the environment and it is possible to exceed this. The error
is 'Out of environment space' while booting. If this happens
and you have DOS 3.1 or higher, add the following line to
your CONFIG.SYS file to reserve more space:
SHELL=C:\DOS\COMMAND.COM C:\DOS /E:nnn /P
Substitute your device and path in place of C:\DOS. For DOS
3.1, use /E:16 to reserve 16 paragraphs or 256 bytes. For
DOS 3.2 or higher, specify /E:256.
In DOS Version 2, unfortunately, there is no way to increase
the environment space. You have no alternative here but to
shorten the DOS PATH.
- 57 -
A P P E N D I C E S
C. Supported Video Displays
1. MDA
The Monochrome Display Adapter is the original text-only
display. It supports only two 'colors' such as black and
white or black and green. pEDIT+ can only run in text mode
on this type of display.
2. HGA
The Hercules Graphics Adapter provides monochrome graphics
on a monochrome display. Unfortunately, the fast text
display routines used by pEDIT do not support the standard
80x25 mode, so users with Hercules displays can run in text
mode only.
3. CGA
The Color Graphics Adapter was the first color display that
supported graphics. The resolution is horrible and colors
are limited to two palettes of 4 colors each in low-res (40
column) mode, and only 2 colors in high-res mode. pEDIT runs
in hi-res 640x200 mode on a CGA monitor; the text resolution
(8x8 cell) is horrible also. The extended characters above
Ascii 127 are not available in CGA graphics mode.
4. EGA
The Enhanced Graphics Adapter provides MUCH better graphics
and text resolution than the CGA. Graphics mode displays
640x350 dots, and text uses a 8x14 cell. Sixteen colors are
available on color displays.
An EGA display can also be attached to an IBM monochrome
adapter. pEDIT PLUS supports this configuration, but with
only 2 text colors possible.
5. VGA
The Video Graphics Array offers a slightly better resolution
(640x480) than EGA. pEDIT PLUS runs a VGA display in EGA
mode to be compatible with the standard 80x25 text mode.
Again, sixteen colors are available on color displays.
- 58 -
A VGA display can also be attached to an IBM monochrome
adapter. pEDIT supports this configuration as above.
6. MCGA
The MultiColor Graphics Array was supplied with some low-end
PS/2 models. It provides CGA modes plus the VGA 640x480 2-
color mode. pEDIT can run the MCGA only in CGA 2 color mode;
unfortunately, MCGA users will be stuck with the low text
resolution of this mode.
7. Other
You should be able to run pEDIT PLUS in graphics mode on
any display that supports a VGA-compatible mode. You may
have to force your system into VGA mode before starting up
pEDIT; refer to the manuals that came with your display
and/or adapter card for more information.
- 59 -
A P P E N D I C E S
D. Initialization File
pEDIT requires an initialization file at startup. This file
must be available to pEDIT either through translation of the
DOS environment variable PEDIT or be located in the current
directory. The default init file is named PEDIT.INI; pEDIT
looks for this file unless you specify an alternate by in-
cluding @XXX on the command line, where XXX = WST, EMC, STD
or QUI.
Four sample initialization files are included:
STD Standard; pEDIT's own; attempts to conform to
the so-called PC standard; <F01> = Help, etc.
WST WordStar; the first PC word processor; many
users know the WordStar keys and LOTS of soft-
ware uses these key definitions
EMC EMACS; the famous UNIX programmer's editor;
uses mnemonics, i.e. <Esc+F> = word forward,
<Esc+B> = word back
QUI Quick; Microsoft's Quick Editor, used by the
Quick Compilers and the DOS 5 Editor; an ex-
ample is <Alt-F+O> = Open file
An initialization file is a text file containing any of the
following commands: DEFINE_SHIFT(), DEFINE_KEY(), SET() and
EXECUTE(). Note the underscore between words and the paren-
theses. The commands can be uppercase, lowercase or mixed.
The editor ignores blank lines and treats anything after an
exclamation point as a comment.
Unlike other editors, pEDIT uses English key names. You
don't have to try and remember what '@' and '#' stand for.
pEDIT uses the prefixes shown on the keys: Alt and Ctrl.
DEFINE_SHIFT is used to define a shift or 'lead-in' key and
tells pEDIT that the key will be the first key of a multi-
key command. DEFINE_SHIFT(Ctrl-Q) sets up Control-Q as one
of WordStar's lead-in keys. The shift keys must be defined
at the top of the init file before any key definitions that
use that shift key.
DEFINE_KEY defines a key. Obviously, no one would want to
have to define each key every time they wanted to edit some-
thing, so these bindings should be in the INI file. The
- 60 -
statement DEFINE_KEY (Get_File, Alt-G) binds the key Alt-G
to the procedure GET FILE. A plus (+) sign between two key
names indicates a two key command. For example, the state-
ment DEFINE_KEY(Find, Ctrl-Q+F) defines WordStar's FIND key.
SET is used to define the editing environment. If you wanted
pEDIT to always come up in color using blue on a white back-
ground, you would include SET (COLOR, BLU, WHT) in the init
file. This would be the same as entering the command "SET
COLOR blu wht" from within pEDIT.
EXECUTE is used to auto-execute a macro at startup time. If
you wanted to execute a macro named LETTER every time you
started pEDIT, for example, you would add EXECUTE (letter)
to your INI file.
Again, you don't have to use any of the initialization files
supplied with the editor. You can set up any keyboard map-
ping you want.
E. Help Files
The Help File PEDIT.HLP is required if you want to use the
HELP function. This file contains fixed 78-byte records. The
editor uses random file access to read the help file so it
must be made up of fixed-length records.
You can customize the Help File as long as you keep the length
of each record at exactly 78 bytes by 'padding' with spaces.
You will need to limit each command's text to 19 lines (one
screenful) of text. If you look at the file, you will see
the first record for a command starts with two carets plus
the command name in caps - for example "^^MOVE UP".
The editor uses the optional files PEDIT.BTN and PEDIT.KEY
for the ALTHELP command. When this command is invoked, pEDIT
displays the contents of the above two files in BUTTON and
KEYBOARD windows, respectively. pEDIT PLUS comes with four
sample Keyboard Help Files corresponding to the 4 Initial-
ization Files listed above. You can customize the Keyboard
Help File any way you want; the lines can be of any length.
- 61 -
A P P E N D I C E S
F. Color Codes
BLK Black
BLU Blue
GRN Green
CYN Cyan
RED Red
MAG Magenta
BRN Brown
WHT White
GRY Grey
LBL Light Blue
LGR Light Green
LCY Light Cyan
LRD Light Red (Pink)
LMG Light Magenta
YEL Yellow
BWH Bright White
The light colors are also called bright or intense. Only
certain combinations are legal for VGA/EGA color displays.
The foreground color can be any of the 16 listed above; the
background, however, is limited to the normal (non-intense)
colors.
- 62 -
A P P E N D I C E S
G. Troubleshooting
1. pEDIT can't find the files it needs
If you get an error message "Initialization file not found"
when starting pEDIT, there is a serious problem. pEDIT
*MUST* be installed on your system to function properly. If
pEDIT has been installed, check your AUTOEXEC.BAT file to
make sure the "SET PEDIT=" statement is being executed. The
section titled 'The DOS Environment' has more information.
2. No mouse pointer at startup
pEDIT could not detect a Microsoft compatible mouse driver.
The mouse driver must be installed either at system startup
by placing the statement "DEVICE=d:\path\MOUSE.SYS" in the
file CONFIG.SYS, or from the DOS command line by executing
the MOUSE program.
3. Mouse pointer disappears
If this should happen, press any key or click the left mouse
button to restore the pointer.
4. ButtonBar not graphical
There are several possibilities: (1) you have a text-only
display; (2) you are using a Hercules monochrome graphics
adapter or (3) the program cannot find the ButtonBar image
file "PEDIT.BAR".
5. ButtonBar trashed
The most likely cause for this is having the wrong ButtonBar
image file installed. pEDIT expects you to have one and only
one display in use. If the image file is somehow lost, you
can get it back from the distribution disk; see the list of
file names listed in 'Installing pEDIT PLUS'.
6. Invalid drive or drive unavailable
You have referenced a drive that doesn't exist or a floppy
drive is not available, i.e. no diskette is loaded or the
latch is open.
- 63 -
7. Garbage in printed documentation
PEDIT.DOC uses the special characters above Ascii 127 for
box drawing. A printer that supports the IBM Extended Char-
acter Set is required to print this document. Many printers
including the HP LaserJet can print these characters but
must be configured to do so; refer to your printer manual.
If your printer cannot handle these special characters, use
pEDIT PLUS to convert them to standard characters such as
dashes (-) and plus signs (+).
8. Can't use DOS command
pEDIT "swaps" all text to disk before shelling to DOS. If
there is not enough free disk space to hold the swap files,
the function will be cancelled.
9. System hangs after using DOS command
A good guess is that you executed a TSR (Terminate and Stay
Resident) program when shelled to DOS. A prime example of
such a program is the PRINT utility that comes with DOS
version 3 and higher. You cannot use PRINT from within the
editor; see 'Printing from pEDIT' for an alternate method.
10. Screen garbled after shelling DOS command
For some unknown reason, error messages such as "File not
found" are NOT redirected to PEDIT.TMP and can overwrite the
pEDIT screen. Use the REFRESH SCREEN command to restore the
screen.
- 64 -
I N D E X
A
ASCII 1, 13, 21, 35, 58, 64
ASP 46
AUTOEXEC 5, 6, 7, 57, 63
B
BIOS 2
Batch File 43, 57
Binary 1
Boot 6, 7, 57
Buffers 11, 27, 36, 37, 38
Button Help File 3
ButtonBar 1, 2, 3, 9, 13, 14, 17, 34, 38, 63
C
CGA 1, 3, 13, 36, 37, 58, 59
COMMAND Buffer 1, 12, 27
COMMAND.COM 8, 57
Click 13, 15, 17, 25, 27, 29, 38, 63
Color 13, 36, 58, 59, 61, 62
Command Mode 12, 14, 34
Commands
ABORT 13, 23, 25, 27, 34, 36, 38
ALTHELP 12, 38
AUTO INDENT 20
BUFFER 14, 27
CAPITAL WORD 20
CENTER LINE 20
CHANGE DIR 27
CHANGE MODE 27
DEFINE KEY 35
DEFINE SHIFT 35
DO BUTTON 34
DO COMMAND 12, 14, 21, 23, 34, 35, 45
DOS 14, 35, 36, 41, 42, 43
ERASE CHAR 13, 22
ERASE LINE 22
ERASE PREV 13, 22
ERASE WORD 22
EXECUTE 32, 33, 39
EXIT 38
FILL PARAGRAPH 14, 19
FIND 14, 21, 23, 24, 27, 34, 37, 44
FINDNEXT 14, 23, 27, 34
GET FILE 14, 25
GOTO MARK 28
HELP 12, 14, 37, 38
INCLUDE FILE 25
INDENT 19, 20
INSERT CHAR 19, 25
INSERT HERE 14, 31
LEARN 32
LINE 28
LIST ASCII 35
LIST KEYS 35
LOWER WORD 20
MARK 27, 28
MOVE ABSOLUTE 17
MOVE BOTTOM 17
MOVE DOWN 18, 34
MOVE END 13, 17
MOVE HOME 13, 17
MOVE LEFT 13, 18
MOVE RIGHT 13, 18
MOVE TOP 17
MOVE UP 13, 17, 34
MOVE WORD 18
NEXT LINE 29
NEXT SCREEN 30
ONE WINDOW 14, 29
OPEN LINE 19
OTHER WINDOW 29
PREV LINE 29
PREV SCREEN 29
QUIT 14, 38
QUOTE CHAR 20, 21
RECALL 34
REFRESH SCREEN 34
REMEMBER 32
REMOVE TEXT 14, 22, 31
RENAME FILE 26, 45
REPEAT 32, 34, 36
REPLACE 14, 23, 27, 34, 37
RESTORE TEXT 22
RULER 38
SAVE MACRO 32, 39
SELECT TEXT 31
SET AUTOSAVE 36
SET COLOR 36
SET LINES 37
SET MARGINS 19, 37
SET PINDENT 19, 37
SET SCOPE 23, 37
SET VIDEO 37
SHIFT LEFT 14, 30
SHIFT RIGHT 14, 30
SHOW BUFFER 14, 27, 47
SHOW KEY 35
STORE TEXT 22, 31
TRANS CHAR 21
TRIM BUFFER 27
TWO WINDOWS 14, 29
UPPER WORD 20
WIPE TEXT 31
WRITE FILE 12, 14, 25, 26, 36, 42
Configuration 5, 8, 12, 34, 39, 45, 48, 58, 59
Copyright 46
Cursor Movement 17
Cut and Paste 31
D
DOS Buffer 1, 43, 44
DOS PATH 7, 8, 42, 57
Disk Macro 4, 33, 39, 44
Diskette 3, 5, 6, 7, 45, 63
Distribution 3, 6, 7, 63
Drag 15
E
EGA 1, 3, 5, 10, 13, 20, 36, 37, 44, 58, 62
EMACS 1, 4, 5, 8, 53, 60
EMC 4, 8, 39, 60
Environment 1, 5, 7, 8, 57, 60, 61, 63
F
Files 25, 41, 42, 45
Floppy 1, 6, 8, 63
G
Global 1, 9, 10, 23, 37, 50
H
HDM 5, 47, 57
Hard Disk/Drive 1, 2, 5, 6, 8, 47
Help File 3, 4, 6, 37, 57, 61
Hercules 1, 58, 63
I
INSTALL 3, 5, 6, 7, 45
Initialization file 4, 34, 35, 42, 45, 60, 61, 63
K
KEYRATE 5, 6, 7
Key Macro 32, 33, 39
Key Macros 32
Keyboard Help File 4, 61
L
Local 10, 23, 37, 50
M
MCGA 59
Macro 4, 32, 33, 39, 42, 44, 54, 61
Memory 1, 2, 5, 10, 17, 25, 31, 35, 36, 41, 45, 57
Microsoft 1, 4, 15, 46, 55, 60, 63
Miscellaneous 34
Mouse 1, 12, 13, 15, 16, 17, 25, 27, 29, 32, 34, 38, 41, 63
Mouse Button 15, 25, 27, 32, 38
MS Quick 4, 8
P
PATH 5, 7, 8, 32, 37, 38, 39, 41, 42, 57
PEDIT PATH 8, 32, 37, 38, 39, 41
PEDIT.BAR 63
PEDIT.BTN 3, 8, 38, 61
PEDIT.DOC 3, 64
PEDIT.EXE 3, 8
PEDIT.HLP 3, 8, 37, 61
PEDIT.INI 5, 8, 45, 60
PEDIT.KEY 5, 8, 38, 61
PEDIT.SHR 3
PEDIT.TMP 43, 44
PSL 47
Pointer 15, 16, 17, 63
Printing 42, 64
Prompting Mode 12
Q
QUI 4, 39, 60
R
Registration 46, 47
S
STAYDOWN 5, 6, 7
STD 4, 8, 39, 60
Scope 10, 23, 37, 50, 51, 53
Scroll 2, 10, 16, 17, 18, 29, 30, 34, 37, 39, 40
Searching 12, 23
Shareware 1, 4, 5, 42, 46, 47
Shell 1, 14, 35, 36, 41, 42, 43, 47, 57, 64
Standard 4, 5, 8, 39, 49, 60
T
TSR 36, 41, 64
Text Deletion 22
Text Manipulation 19
Troubleshooting 63
Tutorial 3, 5
U
Undo 22, 31
V
VGA 1, 3, 10, 13, 36, 37, 58, 59, 62
Video Display 58
W
WST 4, 8, 39, 60
Windows 11, 14, 29
Wordstar 1, 4, 5, 8, 34, 46, 51, 60, 61