Category : Word Perfect
Archive   : MPE4WP22.ZIP
Filename : MANUAL.MPE

 
Output of file : MANUAL.MPE contained in archive : MPE4WP22.ZIP
ÿWPC‰
ûÿ2BÿÿVSÿÿW©ÿÿ#|x10 PitchÿÿzNxxx
ôÇ¿ôx Œ
@ɇÏÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿþÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿStandard$ PrinterSTAND$$$.PRSÛx Œ
@ɇÏ>˜|Š‚ûÿ2¡4E WGžCourier 10 PitchŠ‚Standard$ PrinterSTAND$$$.PRSÛx Œ
@ɇÏ>˜|"ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿßxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxûÿ2¬Óÿÿÿÿ J‡ÿÿzNxxx
ôÇ¿ôx Œ
@ɇÏÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿzNxxx
ôÇ¿ôx Œ
PɇÏÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ#|xÐ °°XX Ð
Ð °°° ÐÓ Èh Ó
MPE4WP
ÃÃMacro Programming Environment for WordPerfectÄÄ
ÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀ
USER REFERENCE GUIDE


Ó ˆ) ÓCopyright ÀÀ 1991, 1992 by Michael H. Shacter
10309 Parkwood Drive
Kensington, Maryland 20895©4041Á`.(#BÁVersion 2ƒ
Ô )Ô Ð XXX° ÐÐ °°° ÐÓÓÕM ªMPE4WPÁ`(#7ÁUser Reference Guideƒ
Á`
(#DÁPage ƒ

MÕÐ=ÐÓ X ÓÁà
ì'Áà ÃMPE4WPƒ
Áà
ì ÁUSER REFERENCE GUIDEÄ Äƒ
Áà
ì&Áà ÃVersion 2Ä Äƒ

Áà
ìÁÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀƒ


ÐÌX°` ¸ hÀpÈ xÐ (#€%Ø'0*ˆ,à.813è5@8˜:ð  Ð0`Àð !ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÌÐÁ
àÁMPE4WP is the Macro Programming Environment for WordPerfect.
MPE4WP is a replacement for the WordPerfect Macro Editor that
lets you create and edit WordPerfect macros on the full
WordPerfect editing screen using all the advanced editing
features offered by WordPerfect. MPE4WP brings virtually
seamless integration with WordPerfect. In short, it is the macro
editor that you wish had been included with WordPerfect.

Á
àÁUntil now, editing WordPerfect macros was not easy. The
built-in WordPerfect Macro Editor lacks all but the most
primitive editing functions. Even the simplest edits are
difficult. To move a line of code in the Macro Editor, the line
must be deleted, one character at a time, then re-typed at its
new location. There are no search and replace capabilities, no
utility for line drawing, no capacity to splice in routines from
other macros.

Á
àÁSome of these shortcomings are remedied by the ED program,
available from WordPerfect Corporation for an additional fee.
Unfortunately, you cannot access WordPerfect's menus, when using
ED. Therefore, you must know in advance the keystrokes that are
necessary for your macro. This can be difficult because
WordPerfect has at least three sets of menus, each with its own
keystrokes. One set is for routine editing. Another set comes
into play when you à ÃSearchÄ Ä for a code. And still a third set
becomes active when à ÃBlockÄ Ä is on. Among ED's other limitations
are the absence of line drawing capabilities and the inability to
view WordPerfect special characters.

Á
àÁThe optimal macro editor should support all of WordPerfect's
editing features and should allow instant access to and recording
of all keystrokes required to use WordPerfect's menus. MPE4WP
fulfills these requirements and does much more.

Á
àÁFor example, MPE4WP includes a ÃÃRecord ModeÄÄ that emulates
WordPerfect's macro recorder, but with the advantage that it may
be utilized while editing a macro. Thus you may switch at any
time between recording and editing a macro source file.

Á
àÁThese are a few of the additional features provided by
MPE4WP:
ÐÌX°à @ p
 Ð0`Àð !ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿX°¸ hÀpÈ xÐ (#€%Ø'0*ˆ,à.813è5@8˜:ð Á
ÁÀÀÂÏÂInsert Macro Commands, complete with tildes,
using no more than three keystrokesÆYÆ

Á
ÁÀÀÂÏÂConvert existing macros into WordPerfect or
ASCII files for further editing or printingÆYÆÔ À+=Ԍ
Á
ÁÀÀÂÏÂDraw boxed messages using WordPerfect's line
draw featureÆYÆ

Á
ÁÀÀÂÏÂBlock, copy and move Macro Commands and textÆYÆ

Á
ÁÀÀÂÏÂEasily cut and paste routines from other macrosÆYÆ

Á
ÁÀÀÂÏÂUse search and replace tools to debug and edit
macros quicklyÆYÆ

Á
ÁÀÀÂÏÂEffortlessly control the position of macro
messagesÆYÆ

Á
ÁÀÀÂÏÂUse numbers rather than control codes or ASCII
characters to position macro messagesÆYÆ

Á
ÁÀÀÂÏÂMenu selection of commands to control the
appearance of on©screen messagesÆYÆ

Á
ÁÀÀÂÏÂDraft, edit and spell check text of any length
for inclusion in macrosÆYÆ

Á
ÁÀÀÂÏÂCreate and edit macros that are too big for the
Macro EditorÆYÆ

Á
ÁÀÀÂÏÂUse DOS wild cards to process several files in
one operationÆYÆ

ÐÌX°¸ hÀpÈ xÐ (#€%Ø'0*ˆ,à.813è5@8˜:ð  Ð0`Àð !ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÌÐÁ
àÁBecause of MPE4WP's memory conservation techniques, you may
still create your macros without ever leaving WordPerfect, by
using the à ÃShell/DOS CommandÄ Ä feature. An MPE4WP macro automates
the entire process, converting the source file on the WordPerfect
editing screen into a macro. And MPE4WP's speed will
considerably shorten the time required to create and edit macros.

Á
àÁMPE4WP has been designed with both advanced and novice macro
programmers in mind. Beginning macro programmers will find all
the tools needed to learn how to create macros for streamlining
and customizing WordPerfect. If you have been deterred from
experimenting with macros by the aggravation attendant upon using
the WordPerfect Macro Editor, cast your frustrations aside and
start learning. Advanced macro programmers will have access to
superior programming tools without being impeded by safeguards
for beginners.

ÙÙ
à ÃWHAT IS MPE4WP?Ä Ä

Á
àÁMPE4WP consists of three types of tools to overcome the
inadequacies of the WordPerfect Macro Editor:
Ô Ø'ԌÒT I. A. 1. a.(1)(a) i) a)(1) A. 1. a.(1)(a) i) a)TÒÁ
àÁØ€(1)Ø MC.COM, the Macro Compiler, compiles (converts) source
files into WordPerfect macros. (A source file is nothing more
than a textual representation of a macro as it would appear in
the Macro Editor.) MC is blazingly fast and minimizes memory
usage, so it can be used without ever leaving WordPerfect, by
using the à ÃShell/DOS CommandÄ Ä feature. (An MPE4WP macro automates
the entire process.) MC supports advanced features not available
through the WordPerfect Macro Editor to simplify writing
WordPerfect macros. Source files may be WordPerfect documents or
ASCII files.

Á
àÁØ€(2)Ø M2T.COM, the Macro Decompiler, performs the opposite
task: it converts WordPerfect macros into WordPerfect files or
simple ASCII text. Use M2T to examine, modify, or print macros
created by yourself or others, outside the confines of the Macro
Editor.

Á
àÁØ€(3)Ø The Macro Programming Environment, which emulates and
improves upon the desirable features of the Macro Editor. The
Macro Programming Environment includes the MPE4WP keyboard and a
series of macros to facilitate the creation of macros at the
WordPerfect editing screen. Macro Commands are no more than
three keystrokes away and are inserted in your macros complete
with tildes and the cursor correctly positioned to take the next
argument. Key Commands can be added by pressing the key
represented by the command. You may record keystrokes and access
menus in the same manner as you would with the macro recorder,
without leaving the editing screen. Attractive presentations can
be created and positioned on the screen with the same ease that
WordPerfect supports for the printed page. Incorrect Macro and
Key Commands can be deleted by striking one key.

Á
àÁMPE4WP is fully compatible with all releases of
WordPerfect 5.1. Of course, if you are still using
WordPerfect 5.0, you must restrict yourself to the Macro and Key
Commands available in version 5.0. For a list of commands
available in both versions 5.1 and 5.0, please see the file
COMMAND.LST. Regrettably, the MPE4WP macros will not work in
WordPerfect 5.0. Even without the MPE4WP macros, you will find
yourself more productive at the normal WordPerfect editing screen
or in your favorite editor than in the Macro Editor.

Á
àÁBecause you are probably eager to learn how to use MPE4WP, I
shall have only a few words to say about registration at the
beginning of this document. MPE4WP is user supported software.
It is not public domain. In brief, if you are using MPE4WP for
personal use and find the program is worth $20, I need you to pay
a $20 registration fee. If you feel the program is worth more
than $20 (bless you for your perspicacity), you will not be
penalized, you still pay only $20, but you get a much better
bargain than those who believe it is worth less. MPE4WP may not
be used in business without a license. More informationÔ Ø'Ô concerning registration and licensing may be found at the end of
this document in the section entitled "REGISTRATION/“LICENSE/”COPYRIGHT".

ÙÙ
à ÃROAD MAPÄ Ä

Á
àÁWhen I first began using computers, I was often bewildered
by software documentation that assumed I knew more than I did.
The fact that there were two ways of describing the same concept
(and the author of the documentation used both to avoid
repetitiousness) added to the confusion. I have attempted to
avoid these pitfalls. In the interest of completeness, however,
the documentation points out how the same objective may be
achieved in more than one way. Sometimes, the alternative
approach will not make sense, but the explanation is included for
the insight it adds into how the program is operating. Don't be
confused. If one approach works for you, that is sufficient.
Later, when you become more proficient, and if you are still
curious, you will understand how the other method works.
Sometimes it will seem like I am beating a subject to death.
This might be a valid criticism. Let the impatient mind cause
the impatient hand to flip forward to the next page. Perhaps
there will be something interesting there.

Á
àÁFrom time to time you will find a statement, command, or
instruction in quotation marks (""). The quotation marks are
merely intended to set off the statement, command, or instruction
from the rest of the text. You never type the quotes. All
keystroke sequences refer to WordPerfect 5.1; the commands for
5.0 should be similar. Where the steps are very important, each
one is described. In other cases, a shorthand approach is
employed that begins with the statement "Keystrokes:" and lists
the keystrokes, just as they would appear in a macro.

Á
àÁIn addition to this User Reference Guide, the file
README.MPE contains Quick Start information for macro experts.
The balance of this section describes the organization of the
User Reference Guide.

Á
àÁAs you have already observed, the User Reference Guide
begins with a series of objective statements heaping praise on
the features contained in MPE4WP and describing how they will
improve productivity. Congratulations on your perseverance, you
will arrive shortly at information about Installing MPE4WP.

Á
àÁMPE4WP macros are created from source files. A source file
is nothing more than a textual representation of a macro as it
would appear in the Macro Editor. The section about Creating
Source Files for MC explains how to create a source file and some
of the enhancements to the WordPerfect macro language supported
by MC.Ô Ø'Ԍ
Á
àÁThe next section contains information on the MPE4WP macros
and keyboard. MPE4WP supplies you with a special keyboard and
macros that eliminate the need to type out the names of Macro and
Key Commands. Many commands may be entered with a single
keystroke. No command requires more than 3 keystrokes. MPE4WP
also allows you to record keystrokes and play them back, just
like WordPerfect's macro recorder, except that you can access
menus while in the process of editing your macro. Once you have
created a macro source file, another macro will automate the
process of converting the source file on the screen into a macro.
This section is worth reading carefully.

Á
àÁThe two sections after installation describe how to use MC
and M2T, the macro compiler and decompiler. A great deal of
attention has been devoted to the user interface of both
programs. You could probably run either without a tutorial.
Nevertheless, the documentation also contains information about
usage, especially command line input, that would not ordinarily
be apparent without reading these two sections.

Á
àÁOne of the more powerful features of WordPerfect's main
editing screen is its impressive line drawing tools. Read the
next section for a tutorial on drawing attractive boxes for your
macros.

Á
àÁThe following section on Key Macros discusses the
appropriate place for these utilities and offers a word of
caution about using them in your macros.

Á
àÁMPE4WP supports all the Macro and Key Commands available in
the present version of WordPerfect 5.1. But times change, and
the next section on Anti©Obsolescence, explains how, when
WordPerfect is ready with a new command, MPE4WP will be ready
too.

Á
àÁIn the course of preparing the MPE4WP macros, I learned a
few things, which I try to share with you in the section on Macro
Programming Tips.

Á
àÁI hope the MPE4WP programs and macros show a level of
ingenuity and creativity by the author. They also rely in part
on the work of others. Read Program Notes for information on
sources.

Á
àÁWhat can I say about Standard Disclaimers except don't blame
me if you don't read it.

Á
àÁThe final section is one that is important to me and should
be important to you. It deals with Registration and the related
issues of License and Copyright. Please read it.
Ô Ø'ԌÁ
àÁIf you need help writing macros, you should not hesitate to
call WordPerfect's toll free number. The number for macros is
(800) 541-5129. Don't ask them questions about MPE4WP; those are
my responsibility. If you need assistance with MPE4WP, you may
write to me at the address listed in the section on Registration.
This is the same address emblazoned on your screen when you run
MC or M2T. You may also leave a message for me on CompuServe (ID
No. 76170,1627). The WordPerfect Manual contains lucid
explanations of many of the topics addressed in this User
Reference Guide. Unfortunately, the Manual can be fairly opaque
when explaining how to create and edit macros. You may therefore
wish to consider purchasing Gordon McComb's book ÃÃWordPerfect 5.1
Macros and TemplatesÄÄ, which appears to contain an excellent
discussion on a variety of macro©related subjects, for novice and
expert alike, and was a ÃÃPC MagazineÄÄ Editor's Choice.

ÙÙ
à ÃINSTALLING MPE4WPÄ Ä


Á
àÁThe MPE4WP package contains the following files:
ÐÌX°à @ p
 Ð0`Àð !ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿX0 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ ÌÐÒƂ°¨ (#ÆÒ
‡ÁJ
0 ÁREADME.MPEƒÔ 0Ô MPE4WP Quick StartÔ! 0ø0!Ô¯
ŐŇÁJ
0 ÁMANUAL.MPEƒÔ ÀÔ MPE4WP User Reference Guide (this document)
formatted as a WordPerfect documentŐÅÔ! ˆˆÀ!Ô¯
ŐŇÁJ
0 ÁMC.COMƒÔ Ô Macro Compiler, described in MANUAL.MPE and
README.MPEŐÅÔ! àà!Ô¯
ŐŇÁJ
0 ÁM2T.COMƒÔ pÔ Macro Decompiler, described in MANUAL.MPE and
README.MPEŐÅÔ! 88p!Ô¯
ÅèŇÁJ
0 ÁMPE4WP-I.WPKƒÔ ÈÔ Integrated MPE4WP keyboard, described in
MANUAL.MPE and README.MPE
Ô! XÈ!Ô¯‡ÁJ
0 ÁMPE4WP.WPKƒÔ Ô Alternative MPE4WP keyboard, described in
MANUAL.MPE and README.MPEÅèÅÔ! èè !Ô¯
ŘŇÁJ
0 Á{ATTRIB}.WPMƒ
ÁJ
0 ÁCMDS_A-L.WPMƒ
ÁJ
0 ÁCMDS_M-Z.WPMƒ
ÁJ
0 Á{CREATE}.WPMƒ
ÁJ
0 Á{EXPAND}.WPMƒ
ÁJ
0 Á{HELP}.WPMƒ
ÁJ
0 Á{INSERT}.WPMƒ
ÁJ
0 Á{KEY}.WPMƒ
ÁJ
0 Á{POS}.WPMƒ
ÁJ
0 Á{RECORD}.WPMƒ
ÁJ
0 Á{SPCIAL}.WPMƒÔ H&Ô MPE4WP macro files for use with MPE4WP.WPK
keyboard, described in MANUAL.MPE and
README.MPEŘÅ
(Do not install these macro files if you
elect to use the MPE4WPK-I.WPK keyboard)Ô! ˜!'
x!Ô¯Ô 'ԌÅXŇÁJ
0 Á{CREATE}.DOCƒÔ Ô Sample source file for creating a customized
{CREATE} macro, described in MANUAL.MPE and
README.MPEÅXÅ (formatted as a WordPerfect
document)
Ô! È!Ô¯‡ÁJ
0 ÁCOMMAND.LSTƒÔ èÔ List of Commands supported by MPE4WP,
described in MANUAL.MPE and README.MPEÔ! °°è!Ô¯
ÅÈŇÁJ
0 ÁCOMMAND.WPMƒÔ @Ô Diagnostic macro, described in COMMAND.LSTÅÈÅÔ! @@!Ô¯
‡ÁJ
0 ÁREGISTER.FRMƒÔ ÐÔ Convenient form for registering MPE4WPÔ! ИÐ!Ô¯
‡ÁJ
0 ÁWHATS.NEWƒÔ ` Ô Information on changes from Version 1Ô! ` (
` !Ô¯ÐÌX0 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ X°à @ p
 Ð0`Àð !ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÌÐ

Á
àÁMPE4WP is furnished with two alternative keyboard files:
MPE4WP.WPK and MPE4WP-I.WPK. The MPE4WP.WPK keyboard works in
tandem with an external set of macro files. In contrast,
MPE4WP-I.WPK is an integrated keyboard in which the macros have
been incorporated into the keyboard file, eliminating the need
for the external macro files. Each approach has its advantages
and disadvantages.

Á
àÁIn favor of the MPE4WP-I.WPK keyboard, fewer files are
required, and the macros should execute more quickly on slower
machines. The reduction in number of files comes at the expense
of a larger keyboard file and a concomitant increase in the
amount of memory required to load the keyboard file. When
WordPerfect loads a keyboard file, all the Key Macros associated
with the file are loaded into memory. If available memory
becomes tight, there may not be sufficient memory to run MC from
within WordPerfect. For most users memory economization will not
be an issue, so MPE4WP-I.WPK will be a good choice. (Please note
that, with the exception of the Create macro, the macros in the
MPE4WP-I keyboard have been compacted by deleting all formatting
tabs and hard returns, thereby saving about 5K of memory. If you
wish to modify or study the operation of the MPE4WP macros please
use the accompanying macro files.)

Á
àÁThe advantage of the MPE4WP.WPK keyboard is better memory
conservation, because the external macros are loaded and released
from memory one at a time, when the corresponding key is pressed.
In addition, it is easier to edit conventional file macros than
Key Macros.

Á
àÁCopy either MPE4WP.WPK or MPE4WP-I.WPK to the same directory
as your other macro and keyboard files. If you opt for
MPE4WP.WPK, the MPE4WP macro files should also be copied to your
macro directory. To verify the name of your macro directory,
check in à ÃSetupÄ Ä (Keystrokes: à Ã{Setup}Ä ÄL). Entry number 2 tells
where your macro files are located:
Ô Ø'Ԍ
Å°ÅÃ ÃÄ ÄÃ ÃSetup: Location of FilesÄ Ä

à Ã1Ä Ä - à ÃBÄ Äackup Files à ÃC:\WP51\BAKÄ Ä

-> à Ã2Ä Ä - à ÃKÄ Äeyboard/Macro Files à ÃC:\WP51\MACROÄ Ä
Å°Å
Á
àÁIf you do not have a special directory for your macro and
keyboard files, now might be a good time to create one.
Otherwise, place the keyboard file (and the MPE4WP macro files,
if you select the MPE4WP keyboard) in the same directory as
WP.EXE.

Á
àÁIdeally, MC and M2T will be placed in a directory on your
path. If the directory containing WP.EXE is on your path, this
would be a good place to locate MC and M2T. If you plan to run
MC from within WordPerfect, you may need to modify the ÃÃCreateÄÄ
macro supplied with MPE4WP. See the section entitled "Create"
for further details.

Á
àÁThe MPE4WP macros can also be renamed to operate with my
other program, MALT (More Alt-Keys for the Perfects). MALT is a
memory resident program (TSR) that adds 90 new Alt©like macro
keys for use with WordPerfect and other members of the Perfect
family. To avoid conflicts with other TSRs, MALT does not rely
on the traditional shift keys (Shift/Alt/Ctrl). Instead, MALT
uses CapsLock as an auxiliary shift key. Unlike Alt-keys,
MALT-keys are not restricted to the letters of the alphabet. An
additional 90 small macros can be maintained in a master library
macro. Any one of the library macros can be accessed by using
ScrollLock as an auxiliary shift key. MALT uses only 512 bytes
of RAM, can be unloaded from memory, and does not interfere with
the normal operation of CapsLock or ScrollLock. The
documentation accompanying MALT explains how to convert the
MPE4WP macro to MALT keys.

ÙÙ
à ÃCREATING SOURCE FILES FOR MCÄ Ä

Á
àÁThe first step in creating a macro with MPE4WP is to create
a ÃÃsourceÄÄ file. In its simplest form, a macro source file is a
text analogue of the macro; i.e. the text should correspond to
what would appear on the screen of the Macro Editor. Although
MPE4WP provides some powerful improvements to the macro language,
no special commands or directives are required to create a source
file. The source file may be a WordPerfect document or an ASCII
file. Using the macro tools included with MPE4WP, you will find
that you use fewer keystrokes to "type" a macro on the
WordPerfect screen than you would use in the Macro Editor. For
more information on the macro tools, see the section entitled
"The MPE4WP Macros and Keyboard".
Ô Ø' ԌÁ
àÁHere are few rules that must be observed when creating
source files.

ÙÙ
Áà
ì%ÁÃÃFile FormatÄă

Á
àÁBeginning with Version 2.0, source files may be WordPerfect
documents. It is no longer necessary to save source files in
ASCII format. When processing a source file, MC ignores all
WordPerfect document formatting commands except for tabs and
WordPerfect special characters. Feel free to include any
formatting commands, headers, footers, comments, footnotes, etc.,
that you feel make your source file more readable. Don't
hesitate to be creative when developing source files on the
WordPerfect editing screen. For instance, styles or outlines
might help to illuminate a difficult programming strategy. They
will not affect macro output. {CREATE}.DOC, which is included
with this package, is an example of a source file that
incorporates unusual formatting.

Á
àÁMPE4WP does not impose any artificial limitations on text
line length. You may enter, edit, and spell check text of any
length in your source file for inclusion in your macro, subject
only to memory limitations imposed by WordPerfect.

ÙÙ
Áà
ì'ÁÃÃSpacesÄă

Á
àÁUse ordinary spaces (or hard spaces), not the centered dots
(ASCII 250) utilized by the Macro Editor. For example, correctly
formatted text will look like this:

Á àÁà Ã{PROMPT}Ä ÄPress any key to continue~

ÅèÅnot like this:

Á
àÁà Ã{PROMPT}Ä ÄPressà ÃÀ ÀÄ Äanyà ÃÀ ÀÄ Äkeyà ÃÀ ÀÄ Ätoà ÃÀ ÀÄ Äcontinue~

ÙÙÅèÅ
Áà
ì&ÁÃÃSpellingÄă

Á
àÁCase is not important when entering Macro and Key Commands,
but spelling is. Thus, you may enter the prompt Macro Command as
à Ã{PROMPT}Ä Ä, {prompt}, or {PrompT}. Likewise, the spell Key Command
could be à Ã{Spell}Ä Ä, {SPELL}, {SpEll}, or any other variation of
upper- and lower-case letters. You will get an error message,
however, if you misspell a command, as for example in {PROMT} or
{Spill}. Spaces are also an important part of spelling.
à Ã{ON CANCEL}Ä Ä is spelled correctly. In contrast, {ONCANCEL} is
spelled incorrectly and will yield an error message. Hard
spaces, too, are acceptable. The MPE4WP macros and M2T use hard
spaces to prevent a macro command from "splitting" at the end ofÔ Ø'
Ô a line. Thus, if you turn on à ÃReveal CodesÄ Ä, you will see
{ONÃ Ã[ ]Ä ÄCANCEL}. Use the MPE4WP macros and you will never have to
worry about spelling errors. Otherwise, refer to the list of
current Macro and Key Commands in the COMMAND.LST file.

ÙÙ
Áà
ìÁÃÃCharacter Positioning CodesÄă

Á
àÁMPE4WP eliminates the need for the awkward character
positioning codes required by the Macro Editor. Instead of using
cryptic Key Commands or ASCII characters, you may use the
notation à Ã{n}Ä Ä (where "n" is any number between 0 and 254) to
represent column and/or row numbers. Thus, if you want to
position a prompt at column 3, row 65, you type à Ã{^P}{3}{65}Ä Ä,
rather than à Ã{^P}Ä ÄÀÀA. The à Ã{n}Ä Ä notation may be used to insert any
ASCII character into your macro and is recommended for control
characters (ASCII 1 to 31). (For those who know BASIC, Ã Ã{n}Ä Ä is
equivalent to CHR$(n), where "n" is any number between 0
and 254.) Incidentally, MC correctly interprets à Ã{0}Ä Ä as the
appropriate WordPerfect code (ASCII 254) to position the cursor
at column or row 0. The ÃÃPositionÄÄ macro offers effortless control
of message positioning. For more information on this capability,
see the section entitled "Making Boxes with MPE4WP".

Á
àÁNote: If you are using a text editor to create source files
in ASCII format, you must use the à Ã{n}Ä Ä notation in lieu of ASCII
characters 9, 10, and 13 (tab, line feed, and carriage return).

ÙÙ
Áà
ìÁÃÃThe WordPerfect Character SetÄă

Á
àÁMC recognizes all special characters in the WordPerfect
character set in source files that are formatted as WordPerfect
documents and will place them in a macro without further user
intervention. Thus this section is relevant only to those who
create source files in ASCII text format.

Á
àÁThe WordPerfect character sets contain 1500 characters,
including all the ASCII characters. The characters are divided
into 12 sets, numbered from 0 to 11. In addition a thirteenth
set, set 12, is a user-defined character set. A character is
identified by its set number followed by its character number
within that set. At the editing screen, a WordPerfect character
is inserted into a document by pressing CTRL-2 or CTRL-V then
typing the number of the character set, a comma, the number of
the character in the set, and pressing à ÃEnterÄ Ä.

Á
àÁSource files in ASCII format should use the notation {s,n}
to insert special characters in a macro, where "s" is the number
of the character set and "n" is the number of the character
within the set. For example, the copyright symbol©©the "C" in a
circle©©is character number 23 in character set 4. ToÔ Ø' Ô incorporate the copyright symbol in your macro, the format would
be à Ã{4,23}Ä Ä. You can also use à Ã{^V}Ä Ä followed by (1) the number of
the character set, (2) a comma, (3) the character number, and (4)
à Ã{Enter}Ä Ä, just as you would in the Macro Editor. Using this
format for the copyright symbol, the relevant part of your source
file would read "à Ã{^V}Ä Ä4,23à Ã{Enter}Ä Ä". Although the à Ã{Compose}Ä Ä Key
Command (CTRL-2) is recognized by the MPE4WP programs, it is not
recognized by WordPerfect. Thus the statement à Ã{Compose}Ä Ä4,23”à Ã{Enter}Ä Ä will not produce the intended result. Please note that
the {s,n} notation is not required for special characters, such
as control characters and line drawing characters, that are also
ASCII characters.

ÙÙ
Áà
ì$ÁÃÃDescriptionsÄă

Á
àÁA source file may contain an optional description for
inclusion in a macro. The description should be preceded by the
command à Ã{DESCRIPTION}Ä Ä (upper-case, lower-case or any combination
of the two is ok) and terminated by either a tilde or a hard
return. WordPerfect imposes a 39-character limitation on the
length of a macro description, so MC will truncate any
description that is longer than 39 characters. The description
may be on a line by itself or on a line with other commands. To
minimize complication, place the description at the top of the
macro source file. To accommodate those programmers who prefer
to begin a source file with a comment describing the operation of
the macro and the programming strategy, the description may
generally be placed anywhere within the first 1000 characters of
the source file. If possible, it is preferable to place the
description command before initial formatting commands such as
margins, headers and footers since these commands are composed of
multiple characters, all of which contribute to the 1000©
character limit. If you have a reason for using the command
à Ã{DESCRIPTION}Ä Ä as text, precede it with an extra open brace, like
this: {{DESCRIPTION}. The following sample descriptions are all
acceptable and equivalent:
ÙÙ
Á
àÁà Ã{Description}Ä ÄCreates header with date & page number~

or

Á
àÁà Ã{DESCRIPTION}Ä Äà ÃÄ ÄCreates header with date & page number

or

Á
àÁà Ã{:}Ä Äblah, blah, blah~à Ã{description}Ä ÄCreates header with date &
page number~

ÙÙÔ H& ԌÁà
ìÁÃÃFormatting Characters (Tabs and Hard Returns)Äă

Á
àÁYou may use tabs and hard carriage returns to format your
macros, just as you would in the Macro Editor. If you are not
creating your source file in WordPerfect, you should be sure that
your editor saves text with hard tabs (ASCII 9) and does not
convert tabs to spaces.

Á
àÁSince you will now be editing your macros at the normal
editing screen, rather than in the Macro Editor, you may lose
sight of the fact that you must use the Key Commands à Ã{Tab}Ä Ä and
à Ã{Enter}Ä Ä, if you want your new macro to insert a tab or a hard
return when it is run.

ÙÙ
Áà
ì'ÁÃÃBracesÄă

Á
àÁMC expects that any text beginning with an open brace ({) is
the beginning of a Macro Command, a Key Command, or one of the
following special keys: Ã Ã{ALT x}Ä Ä, where "x" is any "legal"
character, Ã Ã{KEY MACRO n}Ä Ä, where "n" is the number of a Key Macro,
or à Ã{VAR n}Ä Ä, where "n" is a number from 0 to 9. An error message
will be generated if the text between the braces is not a
recognized command or if an open or close brace is not found
within 16 characters (the length of the longest macro command) of
its counterpart. To treat the open brace as text, or to force a
command to appear as text when the macro is run, simply add an
extra open brace, so your source code would look like this: {{.
Failure to add an open brace before ordinary text will result in
a harmless error message; MC will still treat the open brace as
text. To treat a command as text (you usually won't), you must
add an extra open brace.

ÙÙ
Áà
ì#ÁÃÃSilent CommentsÄă

Á
àÁIn addition to the WordPerfect macro comment (à Ã{;}Ä Ä), which is
incorporated into the final macro, MPE4WP also supports silent
comments. Silent comments, as the name suggests, are ones that
are not included in your macro. The silent comment may be
helpful in reminding you why you adopted certain programming
strategies, but would not be informative to the end user of your
macro. Moreover, eliminating comments may speed up the operation
of your macro. The beginning of a silent comment is marked by a
colon in braces: "Ã Ã{:}Ä Ä" and, like the WordPerfect comment,
terminated by a tilde. For example, Ã Ã{:}Ä ÄThis is a silent
comment~. When you have completed your source file, you may wish
to use à ÃReplaceÄ Ä (ALT-F2) to change one or more of your WordPerfect
comments to silent comments by replacing the semi-colon with a
colon. If you are editing a source file in WordPerfect, you may
also use a document comment (Keystrokes: Ã Ã{Text In/Out}Ä Äcc) to
achieve the same effect of a silent comment.Ô Ø'
Ԍ
ÙÙ
à ÃTHE MPE4WP MACROS AND KEYBOARDÄ Ä

Á
àÁMPE4WP is supplied with a set of macros to simplify creating
and editing macros at the WordPerfect editing screen. Each macro
is assigned a key on one of the MPE4WP keyboards. The MPE4WP-I
keyboard uses Key Macros exclusively. The MPE4WP keyboard uses a
combination of Key Macros and file macros. The macros associated
with the two keyboards are identical. You will need WordPerfect
5.1 to use these macros.

Á
àÁAside from the MPE4WP macro key assignments, the MPE4WP/”MPE4WP-I keyboard is the original WordPerfect keyboard. If you
are accustomed to using your own remapped keyboard, you may wish
to make changes to the MPE4WP“/MPE4WP-I keyboard. Please see the
section entitled "Record Mode" for a discussion of how remapping
may affect the operation of some of the MPE4WP macros.

Á
àÁTo use the MPE4WP/MPE4WP-I keyboard, press à ÃSetupÄ Ä (Shift-F1).
Now, select Ã Ã5Ä Ä, Keyboard à ÃLÄ Äayout. Position the cursor on MPE4WP or
MPE4WP-I, as the case may be, and press à Ã1Ä Ä, à ÃSÄ Ä, or à ÃEnterÄ Ä to select
the keyboard.

Á
àÁThe following table lists each of the MPE4WP macros,
identifies the key to which it is assigned, and summarizes the
use of each key. The macro file associated with the key on the
MPE4WP keyboard is also listed. (Note: The macro file name is
irrelevant to the MPE4WP-I keyboard since all its macros are Key
Macros. Users of the MPE4WP-I keyboard will need to know the
macro file name, however, to examine or modify a macro, because,
as explained elsewhere, the MPE4WP-I Key Macros have been
compacted.) You will notice that the root names of many of the
MPE4WP macros are enclosed in braces. The purpose of the braces
is to avoid name conflicts with existing macros. You may already
have a macro named CREATE.WPM, but are unlikely to have one named
{CREATE}.WPM. Each of the macros is described in detail in the
pages following the table.


Áà
ì$ÁÃÃMPE4WP MACROSÄă


ÒƂ°¨ (#„°Œ
@  (#ÆÒÅèŇÃÃNameÄÄ
Ô `"Ô ÃÃKeyÄÄÔ ˜!Ô ÃÃFile nameÄÄÔ ˜!Ô ÃÃSummaryÄÄÔ- ˜!(#`"`"˜!-Ô¯‡HelpÔ (#Ô CTRLªH
Ô ¸$Ô {HELP}.WPM
Ô ð#Ô Just what its name suggests
ÅèÅÔ- ð#ð#€%¸$(#-ԯŠŇRecord ModeÔ €%Ô CTRLªRÔ H&Ô {RECORD}.WPM
Ô H&Ô Record keystrokes in
WordPerfect in an analogous
manner to macro recording
Å ÅÔ- Ø'H&''€%-Ô°Å ŇInsert ModeÔ Ô CTRLªIÔ ÈÔ {INSERT}.WPMÔ Ô Insert Key Commands in an
analogous manner to the Macro
Editor's Command Insert Mode
Å ÅÔ- XȐÈ-Ô¯ÅèŇKeyÔ Ô CTRLªKÔ èÔ {KEY}.WPM
Ô èÔ Insert a single Key Command
in an analogous manner to
pressing CTRL-V in the Macro
Editor
ÅèÅÔ- @è°° -Ô¯ÅXŇSpecial KeysÔ Ô CTRLªSÔ ÐÔ {SPCIAL}.WPM
Ô ÐÔ Insert the commands à Ã{ALT x}Ä Ä,
à Ã{KEY MACRO n}Ä Ä and à Ã{VAR n}Ä Ä
ÅXÅÔ- ˜Ð˜˜-Ô¯ÅèŇMacro
Commands
(A-L)Ô ð
Ô CTRLª{Ô (
Ô CMDS_A©L.WPMÔ ` Ô Help screen of Macro Commands
from A to L; insert a command
(with tildes) by typing
two-key mnemonic
ÅèÅÔ- € ¸ ð
(
` -Ô¯ÅèŇMacro
Commands
(M-Z)Ô ØÔ CTRLª}Ô Ô CMDS_M©Z.WPMÔ H
Ô Help screen of Macro Commands
from M to Z; insert a command
(with tildes) by typing
two-key mnemonic
ÅèÅÔ- h ØH
-Ô¯ÅxŇExpandÔ 0Ô CTRLªXÔ øÔ {EXPAND}.WPM
Ô øÔ Type two-key mnemonic then
press CTRL-X to expand to
Macro Command with tildes;
uses same mnemonics as CTRL-{
and CTRL-}, but without help
screens
ÅxÅÔ- àøÀÀ0-ԯŰŇDeleteÔ ¨Ô CTRLªDÔ pÔ Key MacroÔ ¨Ô Delete Macro or Key Command
on which cursor is located;
if cursor is not on a
command, delete first command
to left
Å°ÅÔ- p8p¨-Ô¯ÅXŇCreateÔ XÔ CTRLªCÔ Ô {CREATE}.WPMÔ XÔ Convert the source file on
the editing screen to a macro
ÅXÅÔ- è è X-ԯŐŇPositionÔ °Ô CTRLªPÔ xÔ {POS}.WPMÔ °Ô Position message on screenŐÅÔ- °x@x°-Ô¯
ŐŇAttributeÔ  Ô CTRLªAÔ Ð Ô {ATTRIB}.WPMÔ  Ô Add attributes to messagesŐÅÔ-  Ð ˜!Ð  -Ô¯
Å@ŇWriteÔ `"Ô CTRLªWÔ (#Ô Key MacroÔ `"Ô Save file in WordPerfect
format, no verification for
overwrite
Ô- ¸$(#ð#(#`"-Ô¯‡Clear PromptÔ €%Ô CTRLªPrint
Screen
Ô Ø'Ô Key MacroÔ €%Ô Clear status prompt from
screen in the event of
unanticipated errors Å@ÅÔ- 'H& (H&€%-Ô°ÅXŇPlaybackÔ Ô CTRLªInsertÔ ÈÔ Key MacroÔ Ô Play back recording in case
of unanticipated
interruptionsÅXÅÔ- ȐÈ-Ô¯

ÙÙÁà
ì(ÁÃÃHelpÄă

Á
àÁÃÃÄÄÃÃHelpÄÄ lists each of the MPE4WP macros with a reminder of the
key used to call the macro.

ÙÙ
Áà
ì%ÁÃÃRecord ModeÄă

Á àÁÃÃRecord ModeÄÄ is analogous to macro recording. It remembers
and plays back all the keys you press during a session. You
start recording by pressing CTRL-R. A flashing prompt appears on
the screen as a reminder that you are recording. ÃÃRecord ModeÄÄ
will remember each key you type. When you are ready to
incorporate the saved keystrokes in your source file, press
CTRL-Q. If you are not at the main editing screen, you will be
returned there. You will then be prompted to position the cursor
and press à ÃEnterÄ Ä to play back the text of all the keys you typed,
including all Key Commands.

Á
àÁÃÃRecord ModeÄÄ has been programmed to record the original key
assignments of all Key Commands. If you wish to use ÃÃRecord ModeÄÄ
with a keyboard in which the key assignments have been remapped,
you may modify the ÃÃRecord ModeÄÄ macro. The macro includes a
comment explaining how to make the change. You should be aware,
however, that if you have assigned a Key Macro (i.e. more than
one keystroke) to a key, ÃÃRecord ModeÄÄ will not recognize the keys
in the Key Macro, but will still record the original key
assignment. This is not a failing of ÃÃRecord ModeÄÄ. It occurs
because of the way WordPerfect handles the keyboard.
Regrettably, ÃÃRecord ModeÄÄ cannot recognize ALT©keys. To insert an
ALT©key, use the ÃÃSpecial KeysÄÄ macro.

Á
àÁThe maximum length of a ÃÃRecord ModeÄÄ recording is almost
1,000 characters, more than long enough for the deepest
WordPerfect menu. The only reasonable way to reach the maximum
is to forget you are recording. If you ever reach the limit,
ÃÃRecord ModeÄÄ will warn you that it is returning you to the main
screen for playback. The next keystroke will return you to the
main editing screen to play back the keystrokes you have
recorded.

Á
àÁIn addition to recording keystrokes, ÃÃRecord ModeÄÄ also
inserts any formatting codes created while recording. You may
delete the formatting codes, if you wish. They will be ignored
by MC when the source file is converted into a macro.
Ô 'ԌÁ
àÁÃÃRecord ModeÄÄ utilizes the Macro Command à Ã{STATUS PROMPT}Ä Ä to
remind you that you are recording. This creates an anomaly when
you access other editing screens, like the Header, Footer, and
Footnote editing screens. The normal prompt at the bottom of the
these editing screens©©which looks something like this: Ã ÃHeader A:
Press Exit when doneÄ Ä©©is hidden by the ÃÃRecord ModeÄÄ's prompt
à ÃRecording CTRL-Q to quitÄ Ä. It is possible to avoid this problem
in the editing screens by repeatedly calling a conventional
prompt, either with the à Ã{PROMPT}Ä Ä command or with à Ã{CHAR}Ä Ä. Using
one of these alternative prompts, however, causes the more
serious problem of trapping the cursor. The cursor does not
appear on the screen where you are typing, instead it is captured
by the prompt. Incidentally, the problem with the Status Prompt
cannot be solved by simply relocating the prompt with character
positioning codes. Regardless of the location of the status
prompt, it still overrides the WordPerfect prompt in the other
editing screens.

Á
àÁThere are two ways to tell you are at the appropriate
editing screen when using ÃÃRecord ModeÄÄ. One is faith: you
pressed the right keys so you must be in the header, footer, or
footnote editing screen. (The footnote screen is less
problematic, since there is usually a footnote symbol in the
upper left corner of the screen.) The more objective method is
to notice the abbreviated status line. The status line on the
main editing screen looks like this: "Ã ÃDoc 1 Pg 1 Ln 4 Pos 71Ä Ä".
The status line in the header editing screen looks like this:
"Ã ÃLn 1 Pos 10Ä Ä". Notice the omission of information regarding Doc
number and Pg. You will have to remember to press à ÃExitÄ Ä when you
are done at the editing screen.

Á
àÁWhen using ÃÃRecord ModeÄÄ or writing macros in general, I
recommend that you use mnemonics instead of numbers. In my view,
although admittedly without much research, mnemonics are more
likely than numbers to remain consistent from version to version
of WordPerfect. When a new feature is added to a menu, if it is
added anywhere but at the end, all the numbers will be increased,
and all your macros will have to be revised. It is likely,
however, that the mnemonic for the new feature will be chosen to
avoid conflicts with existing mnemonics. Even if one mnemonic
changes, the rest presumably will remain the same. In addition,
when editing a macro, the mnemonics give a hint as to what the
keystrokes represent.

Á
àÁIn the interest of completeness, the ÃÃRecord ModeÄÄ macro, as
well as the ÃÃInsert ModeÄÄ and ÃÃKeyÄÄ macros, provide for all Key
Commands. In my experience, however, some Key Commands, such as
à Ã{Compose}Ä Ä, à Ã{Keyboard}Ä Ä, and à Ã{Help-Help-Left}Ä Ä cannot be entered at
the keyboard.

ÙÙÔ 'ԌÁà
ìÁÃÃPlayback and Clear PromptÄă

Á
àÁÃÃPlaybackÄÄ (CTRL-Insert) and ÃÃClear PromptÄÄ (CTRL-Print Screen)
are precautionary measures that you may never require. Although
unlikely, ÃÃRecord ModeÄÄ may terminate prematurely. In this case,
by pressing CTRL-Insert, you may play back the keystrokes you
recorded prior to the failure. ÃÃPlaybackÄÄ is a failsafe mechanism
only and will not work if ÃÃRecord ModeÄÄ terminates normally.

Á
àÁIf one of the macros that uses the à Ã{STATUS PROMPT}Ä Ä command
terminates prematurely, the Status Prompt may remain on the
screen. Use ÃÃClear PromptÄÄ to clear the prompt from the screen.
(By the way, the WordPerfect keyboard edit screen erroneously
shows that ÃÃClear PromptÄÄ is assigned to "CTRL-Num *" (instead of
CTRL-Print Screen).

ÙÙ
Áà ì%ÁÃÃInsert ModeÄă

Á
àÁÃÃInsert ModeÄÄ (CTRL-I) is similar in operation to the Macro
Editor's Command Insert Mode, which is accessed in the Macro
Editor by pressing CTRL-F10. While in ÃÃInsert ModeÄÄ, pressing a
key to which a Key Command is assigned, will result in the
insertion of the textual representation of the Key Command in
your source file. You may also insert text by pressing any
letter, number, or punctuation key. Press CTRL-Q to quit ÃÃInsert
ModeÄÄ.

Á
àÁLike ÃÃRecord ModeÄÄ, ÃÃInsert ModeÄÄ uses original key assignments,
and may be modified by following the instructions in the comment
in the macro. See the discussion under ÃÃRecord ModeÄÄ for
considerations relating to remapped keys. In contrast to ÃÃRecord
ModeÄÄ, ÃÃInsert ModeÄÄ does not cause the insertion of formatting
codes into your source file.

ÙÙ
Áà
ì)ÁÃÃKeyÄă

Á
àÁÃÃKeyÄÄ (CTRL-K) is for inserting a single Key Command and is
similar in usage to CTRL-V in the Macro Editor. Press CTRL-K and
you will receive a prompt "Ã ÃKey Command =Ä Ä". Now press the key
associated with the Key Command to insert the text of the
command. Do not press à ÃCancelÄ Ä if you decide against inserting a
Key Command©©that would simply insert the command à Ã{Cancel}Ä Ä into
your source file. Instead, press any key that is not associated
with a Key Command, like the space bar or any alpha-numeric key.

ÙÙ
Áà
ì$ÁÃÃSpecial KeysÄă

Á
àÁÃÃSpecial KeysÄÄ (CTRL-S) are those keys that are not sensibly
assigned to one or more keys because they have so manyÔ Ø'Ô permutations. The special keys are à Ã{ALT x}Ä Ä, where "x" is any
legal character, Ã Ã{KEY MACRO n}Ä Ä, where "n" is the number of a Key
Macro, and à Ã{VAR n}Ä Ä, where "n" is a number from 0 to 9. (The ten
à Ã{VAR n}Ä Ä keys can also be accessed from the à ÃExpandÄ Ä macro by typing
"Vn", where "n" again is a number from 0 to 9, and pressing
CTRL-X.)

Á
àÁPressing CTRL-S will bring up a menu of the special keys.
Press a mnemonic or number for your selection. You will then be
prompted for a legal character or number, depending on your
selection. ÃÃSpecial KeysÄÄ will only allow you to enter numbers for
Key Macro and VAR. ÃÃSpecial KeysÄÄ does not verify that a legal
character has been entered for ALT.

ÙÙ
Áà
ì#ÁÃÃMacro CommandsÄă

Á
àÁÃÃMacro CommandsÄÄ is divided into two parts: A to L (CTRL-{)
and M to Z (CTRL-}). (The WordPerfect Keyboard Edit screen shows
CTRL-{ and CTRL-} as CTRL-[ and CTRL-], which is another valid
way of looking at things.) ÃÃMacro CommandsÄÄ displays help screens
giving the syntax for each of the Macro Commands supported by the
most recent version of WordPerfect. Each of the commands is also
identified by a two-letter mnemonic. Press the mnemonic keys
(upper- or lower-case is acceptable) and the Macro Command is
inserted into your source file, complete with tildes and cursor
correctly positioned for the first command argument, if one is
required. In the case of the à Ã{FOR}Ä Ä, à Ã{IF}Ä Ä, and à Ã{WHILE}Ä Ä commands,
the corresponding à Ã{END FOR}Ä Ä, à Ã{END IF}Ä Ä, or à Ã{END WHILE}Ä Ä command is
also inserted.

ÙÙ
Áà
ì'ÁÃÃExpandÄă

After you have learned the mnemonics for the ÃÃMacro CommandsÄÄ you
use most often, you will wish to use ÃÃExpandÄÄ (CTRL-X). ÃÃExpandÄÄ is
much faster than ÃÃMacro CommandsÄÄ because it does not require
WordPerfect to draw help screens. Simply type the two©letter
mnemonic (upper- or lower-case is acceptable) then press CTRL-X
and the command with tildes and correctly positioned cursor are
inserted in your text. For example, to insert the à Ã{ASSIGN}Ä Ä
command into your source file, type "as", then press CTRL-X. The
"as" will disappear and in its place will appear à Ã{ASSIGN}Ä Ä~~. The
cursor will be positioned on the first tilde. If you reflexively
add a space every time you type a word, don't worry. ÃÃExpandÄÄ will
compensate for this habit. If you accidentally type an erroneous
mnemonic, ÃÃExpandÄÄ will simply ignore the two letters. (The ten
à Ã{VAR n}Ä Ä keys can also be accessed from the Expand macro by typing
"Vn", where "n" is a number from 0 to 9, and pressing CTRL-X.)

Á
àÁYou may change the mnemonics used by ÃÃMacro CommandsÄÄ and
ÃÃExpandÄÄ by changing the two-letter labels associated with theÔ Ø'Ô command. Suppose for example that you wanted to change the
mnemonic for à Ã{LOOK}Ä Ä from LO to LK. You would change the line of
the macro that reads à Ã{LABEL}Ä ÄLO~ to read à Ã{LABEL}Ä ÄLK~. That's all
there is to it. Be careful not to assign the same mnemonic to
two different commands. If CH stands for à Ã{CHAR}Ä Ä, it cannot also
represent à Ã{CHAIN}Ä Ä. If you are very adventurous, you might try
changing the prompts on the ÃÃMacro CommandsÄÄ help screens, but
unless you are careful, you will distort the boxes. For
additional information on drawing help screens in macros, see the
section entitled "Making Boxes with MPE4WP".

ÙÙ
Áà
ì'ÁÃÃDeleteÄă

Á
àÁMPE4WP makes it easy for you to insert Macro and Key
Commands into your source file. It is even easier to delete
commands using ÃÃDeleteÄÄ (CTRL-D). Place the cursor anywhere on the
offending command and press CTRL-D. The command will be erased.
If the cursor is not on a command, ÃÃDeleteÄÄ will delete the first
command it finds to the left of the cursor.

ÙÙ
Áà
ì&ÁÃÃPositionÄă

Á
àÁWordPerfect allows you to position the display of macro
messages. In general, a line of a message may positioned
anywhere on the screen by using the code à Ã{^P}Ä Ä followed by two
characters indicating the column and row of the message. (As
discussed above, MPE4WP permits you to use numbers instead of
characters to indicate the row and column.) ÃÃPositionÄÄ automates
the procedure for determining the coordinates of a macro message.

Á
àÁA complete explanation of ÃÃPositionÄÄ in the context of
creating a boxed message is contained in the section entitled
"Drawing Boxes with MPE4WP". In brief, press CTRL-P, block the
top line of the message (usually the top of a box) to be
positioned and press à ÃEnterÄ Ä. You can then move the line anywhere
on the screen to visually determine the most satisfactory
placement. To center the message on the screen horizontally,
press à ÃCenterÄ Ä (Shift©F6). All keys for moving the message are
listed in a prompt at the bottom of the screen.

Á
àÁWhen the box is located on the screen to your satisfaction,
press à ÃEnterÄ Ä. ÃÃPositionÄÄ will pause to permit you to relocate the
cursor to the upper left corner of the box. Press à ÃEnterÄ Ä, and the
coordinates in the form {^P}{c}{r}, where "c" is a column number
and "r" is a row number, will be entered for you. When your
source file is converted to a macro, the column and row numbers
will be translated to the applicable ASCII characters.

Á
àÁOnce the top line of the message has been properly located,
ÃÃPositionÄÄ can be used to fill in the coordinates for subsequentÔ Ø'Ô rows. Place the cursor at the beginning of the next row, press
CTRL-P. Now press à ÃNÄ Ä and ÃÃPositionÄÄ will fill in the coordinates
for the next row.

Á
àÁUntil you block a new message, ÃÃPositionÄÄ will return to the
last calculated screen coordinates each time it is executed. To
move the most recently positioned line, press à ÃEnterÄ Ä without
blocking any new material.

Á
àÁUsage Notes: ÃÃPositionÄÄ is designed for use with a standard
25 row by 80 column screen and will not calculate screen
coordinates outside that range. ÃÃPositionÄÄ may not display
properly if you have configured WordPerfect to keep the Menu Bar
visible. (Does anyone keep the Menu Bar visible? Does anyone
even ÃÃuseÄÄ the Menu Bar?) ÃÃPositionÄÄ may not be used to position a
message that contains a tilde. (I do not think anyone will do
that, but there is no harm in saying so.)

ÙÙ
Áà
ì&ÁÃÃAttributeÄă

Á
àÁAttributes, such as bold, underline and mnemonic, determine
the appearance of on©screen messages. Each attribute has special
control codes to turn the attribute on and to turn it off. Since
there are 16 possible attributes, each of which has its own "On"
and "Off" commands, it used to be difficult to remember which is
which. ÃÃAttributeÄÄ streamlines the procedure of adding attribute
commands.

Á
àÁA complete explanation of ÃÃAttributeÄÄ in the context of
creating a boxed message is contained in the section entitled
"Drawing Boxes with MPE4WP". In brief, pressing CTRL-A brings up
a menu of all 16 attributes. The mnemonic for each attribute
command is highlighted in its own attribute. Each time an
attribute is selected ÃÃAttributeÄÄ cycles between Attribute On and
Attribute Off, or press à ÃTabÄ Ä to toggle between On and Off. The
word "Attribute" on the menu bar is highlighted in the most
recently selected attribute command. Simply press à ÃEnterÄ Ä to use
the counterpart (On or Off) of the same attribute last used.


ÙÙÁà
ì(ÁÃÃWriteÄă

Á
àÁÃÃWriteÄÄ is a short macro that bypasses WordPerfect's annoying
habit of asking whether you want to replace an existing copy of a
file. For me, the answer always is "Yes". If you prefer to be
asked, don't use ÃÃWriteÄÄ.

ÙÙÔ €%ԌÁà
ì'ÁÃÃCreateÄă

Á
àÁÃÃCreateÄÄ (CTRL-C) automates the process of converting a source
file on the WordPerfect editing screen into a macro. ÃÃCreateÄÄ
verifies that no changes have been made to your source file since
it was last saved. If ÃÃCreateÄÄ detects that there have been any
changes to the text in the current window, it will ask if you
want to save the file. Answer "Yes" and ÃÃCreateÄÄ will pause while
you save your text. ÃÃCreateÄÄ will then call MC to compile your
macro, i.e. to convert your source file into an operational
macro, after which you will be returned to the WordPerfect
editing screen.

ÒT(1) A. 1. a.(1)(a) i) a)(a) A. 1. a.(1)(a) i) a)TÒÁ
àÁÃÃCreateÄÄ uses WordPerfect's à ÃShell/DOS CommandÄ Ä function to run
MC to convert the source file on the active editing screen into a
macro. ÃÃCreateÄÄ is initially configured to expect that Ø€(a)Ø MC is
located in a directory on your path, ؀(b)ؠthe document on the
current screen is the source file for the macro to be created,
Ø€(c)Ø the new macro is to have the same root name as the source
file and to be placed in the same directory as the source file,
and ؀(d)ؠMC should pause before creating the macro to permit
verification that source and macro file names have been entered
correctly and that the new macro will not overwrite an existing
one.

Á
àÁTo make MPE4WP most useful, it should be tailored to match
your needs. For example, ÃÃCreateÄÄ may operate faster if it is
given the full path name for MC. Another useful modification is
to have new macros placed in your macro directory, rather than in
the same directory as the source file. (Note: Before reading
the instructions on modifying ÃÃCreateÄÄ, you may wish to glance
ahead to the instructions for running MC.)

Á
àÁÃÃCreateÄÄ uses two variables that can be modified to adapt
ÃÃCreateÄÄ to suit your preferences. One variable is "FullPN", which
is the full path name of MC. The other is "CmdLine", which
controls the optional commands that are used to control MC. The
assignments for both variables are located toward the beginning
of ÃÃCreateÄÄ and are easily modified. The following discussion
explains how to modify either or both of these variables. ÃÃÄÄAs
discussed below, the combined length of the two variables cannot
exceed 59 characters.

ÃÃÄÄÁ
àÁÃÃCreateÄÄ may be modified either with the Macro Editor or by
revising the source file and recompiling with MC. (Note: This
will probably be the last time you will ever need to use the
Macro Editor.) Before making any changes, it might be a good
idea to back up the file you are working on. The procedure for
accessing the Macro Editor will depend on which keyboard you are
using: MPE4WP or MPW4WP-I. If you are using MPE4WP-I:
ÒT(a) A. 1. a.(1)(a) i) a)(a) A. 1. a.(1)(a) i) a)TÒØ€(a)Ø press à ÃSetupÄ Ä (Shift F1), Ø€(b)Ø select Ã Ã5Ä Ä, Keyboard à ÃLÄ Äayout,
Ø€(c)Ø position the cursor on MPE4WP-I, and press à Ã7Ä Ä Ã ÃEÄ Ädit, to enterÔ Ø'Ô the à ÃKeyboard: EditÄ Ä menu. Position the cursor over CTRL-C
(Create) and press à Ã1Ä Ä, à ÃAÄ Ä, or à ÃEnterÄ Ä to enter the Macro Editor.

Á
àÁTo use the Macro Editor in connection with the MPE4WP
keyboard, press à ÃMacro DefineÄ Ä (CTRL-F10). If you have previously
selected the MPE4WP keyboard, simply hit CTRL-C (as you would to
edit an ALT key), otherwise type "{CREATE}" at the prompt. (Use
the full path name for {CREATE} if it is not in your macro
directory.) WordPerfect will then prompt you à Ã{CREATE}.WPM
Already ExistsÄ Ä: à Ã1Ä Ä Ã ÃRÄ Äeplace; à Ã2Ä Ä Ã ÃEÄ Ädit; à Ã3Ä Ä Ã ÃDÄ Äescription. Select à ÃEditÄ Ä.

Á
àÁFor your convenience a source file entitled {CREATE}.DOC is
also included. In addition to illustrating some of the special
features that can be incorporated in a source file, {CREATE}.DOC
also includes instructions for modifying the file and several
examples. As a precautionary measure the tildes that mark the
ends of the silent comments have been prominently marked. Be
sure not to delete them. After you have modified {CREATE}.DOC,
use MC to convert it to a macro. In order to function properly
with the MPE4WP keyboard, the new macro should be called
{CREATE}.WPM and placed in the same directory with your other
macros. If you are using the MPE4WP©I keyboard, the new
{CREATE}.WPM should be retrieved into the keyboard and assigned
to the key CTRL©C.

Á
àÁWhen you are ready to edit ÃÃÄÄÃÃCreateÄÄ, look for the line that
reads:

Á
àÁà Ã{ASSIGN}Ä ÄFullPN~MC~

A comment near the beginning of the macro will help you find the
appropriate line. This assignment establishes a variable called
"FullPN" which is later used to tell the à ÃShell/DOS CommandÄ Ä
function to run MC. If you have placed MC in the "C:\WP\"
directory, you would modify the line to read:

Á
àÁà Ã{ASSIGN}Ä ÄFullPN~“C:\WP\MC~

(The instructions in the macro use the special hard tilde à Ã{~}Ä Ä
command, because it is not possible to use a real tilde. Do not
be confused. When you modify the macro, leave the real tildes in
place.)

Á
àÁÃÃCreateÄÄ contains a second variable called CmdLine, which is
located below the FullPN assignment. Initially, the CmdLine
variable is assigned as follows:

Á
àÁà Ã{ASSIGN}Ä ÄCmdLine~/P à Ã{SYSTEM}Ä Ä15~à Ã{SYSTEM}Ä Ä12~~

Á
àÁThe "/P" option tells MC to pause before converting your
file to a macro. This permits you to verify the name of the
source file and the macro file. When ÃÃCreateÄÄ is executed, theÔ Ø'Ô commands à ÃÄ Äà Ã{SYSTEM}Ä Ä15~à Ã{SYSTEM}Ä Ä12~ expand to the full path and name
of the document in the current editing window, so MC will know
the name of the file to process. With the default configuration,
MC will place the output macro in the same directory as the
source file. The "/P" option permits you to specify a different
output directory and/or filename from within MC. To have the new
macros placed in a different directory, add a space after
à ÃÄ Äà Ã{SYSTEM}Ä Ä12~ and write the path name of the destination directory.
(Do not add a file name to the destination directory. MC will
automatically complete the file name using the root name of the
source file and the extension ".WPM".) Assuming that you wish to
place the new macros in C:\WP\MACROS the whole thing would read
like this:

Á
àÁà Ã{ASSIGN}Ä ÄCmdLine~/P à Ã{SYSTEM}Ä Ä15~à Ã{SYSTEM}Ä Ä12~ C:\WP\MACRO~

Á
àÁNote the space between /P and the commands
à Ã{SYSTEM}Ä Ä15~à Ã{SYSTEM}Ä Ä12~ as well as the space between
à Ã{SYSTEM}Ä Ä15~à Ã{SYSTEM}Ä Ä12~ and "C:\WP\MACRO". Please note further
the ÃÃabsenceÄÄ of a space in à ÃÄ Äà Ã{SYSTEM}Ä Ä15~à Ã{SYSTEM}Ä Ä12~.

Á
àÁIf you are not concerned about overwriting existing macros,
and you always want your macros to be placed in the specified
output directory, you may eliminate the "/P" option from the
CmdLine variable. Alternatively, you may add any of the other
options discussed in the section entitled "Command Line Options".
For example, "/V" could be substituted for "/P" to cause MC to
pause ÃÃonlyÄÄ when a file might be overwritten. Or the "/P" and
"/M" options might be combined as "/PM" to cause MC both to pause
and to force monochrome display.

Á
àÁA word of warning. Unless you know exactly what you are
doing, do not make any changes to ÃÃCreateÄÄ, except for changes
described above. Each command is there for a purpose. If you
promise to be very careful, you may delete the comments after you
have made the appropriate changes.

Á
àÁYou should be aware of one restriction as you modify the
ÃÃCreateÄÄ macro. WordPerfect imposes a 59©character limitation on
commands using the à ÃShell/DOS CommandÄ Ä feature. This means that
the combined length of FullPN and CmdLine cannot exceed 59
characters. (Note: When counting the number of characters, do
not count à Ã{SYSTEM}Ä Ä15~à Ã{SYSTEM}Ä Ä12~ as 22 characters instead count
the number of characters in the full path name of the current
document. Thus if the current document is
"C:\SOURCE\HEADER.TXT", then à Ã{SYSTEM}Ä Ä15~à Ã{SYSTEM}Ä Ä12~ would
evaluate to 20 characters.)

Á
àÁIn the unlikely event you exceed the 59©character maximum,
there are a some remedial measures you might take. If the
default drive is always C:, then it can be eliminated from the
path name of MC in the variable "FullPN" and from the output pathÔ Ø'Ô in the "CmdLine" variable. If the source file will always be
located in the current directory, then à Ã{SYSTEM}Ä Ä15~ can be
eliminated from the source file specification in the "CmdLine"
variable.

Á
àÁFinally, you can use ".." commands to put the output files
in a sister directory to the one with the source files. (Two
directories that have the same parent directory are known as
sister directories. Thus C:\WP\DOCS is a sister directory to
C:\WP\MACRO because they both share C:\WP as the parent
directory.) If the source files are always placed in C:\WP\DOCS
you can indicate a destination directory of C:\WP\MACRO as:
..\MACRO. Incidentally, if the ".." nomenclature seems a
perversely obscure, the blame should be assigned to DOS and not
to me.

Á
àÁCombining the preceding suggestions, the relevant variable
assignments might read:

Á
àÁà Ã{ASSIGN}Ä ÄFullPN~\WP\MC~

and

Á
àÁà Ã{ASSIGN}Ä ÄCmdLine~/P à Ã{SYSTEM}Ä Ä12~ ..\MACRO~

Á
àÁIf ÃÃCreateÄÄ determines that the length of the à ÃShell/DOS
CommandÄ Ä command line exceeds 59 characters, it will offer you the
option of running MC without the command line options or exiting
from ÃÃCreateÄÄ.

Á
àÁSince MC requires a scant 56K of memory to perform all its
functions, you should have no problem running it from within
WordPerfect. If MC detects that there is insufficient memory, it
will issue a message to that effect. This is only likely to
happen if you have a very large document in the other window. In
that event, you should exit from the large document and try
running MC again. If you continue to have insufficient memory
problems and you are using the MPE4WP-I keyboard, you should
switch to the MPE4WP keyboard and install the MPE4WP file macros.
Please see the section entitled "Installing MPE4WP" for further
details. You may also wish to consult the entry entitled
"Memory" in the reference section of the WordPerfect manual.

Á
àÁÃÃCreateÄÄ also has the salutary effect of clearing your macro
from WordPerfect's "cache". You may thus run your new macro
immediately after compilation, even if you had just run a
previous version with the same name.

ÙÙÔ €%ԌÁà
ìÁÃÃA Note on Source FilesÄă

Á
àÁThe complete source files for the MPE4WP macros may be
generated easily with M2T. The macros with help screens may look
formidable with their double open braces and the distorted
looking boxes. Do not be discouraged, you will rarely need the
double braces. Drawing boxes with MPE4WP is much simpler than in
the Macro Editor. If you ignore those aspects of the MPE4WP
macros that are generic to the mission of macro creation, you may
find some helpful routines.

Á
àÁYou should be aware that, with the exception of ÃÃCreateÄÄ, the
macros in the MPE4WP-I keyboard have been compacted by
eliminating all formatting tabs and hard returns, thereby saving
about 5K of memory. If you wish to modify or study the operation
of the MPE4WP macros, please use the accompanying macro files.

Á
àÁThe ÃÃCreateÄÄ, ÃÃSpecial KeysÄÄ, and ÃÃMenuÄÄ macros use the à Ã{ELSE}Ä Ä
command in connection with à Ã{CASE}Ä Ä. If you are using an interim
release of WordPerfect dated August 20, 1990, or later, you may
substitute the à Ã{OTHERWISE}Ä Ä command for à Ã{ELSE}Ä Ä. In brief,
à Ã{OTHERWISE}Ä Ä is required when a à Ã{CASE}Ä Ä statement combined with
à Ã{ELSE}Ä Ä is nested in an à Ã{IF}Ä Ä statement. The three MPE4WP macros
that use à Ã{CASE}Ä Ä have been structured to avoid this problem, so
the substitution is not necessary.

ÙÙ
à ÃMC.COMÄ Ä

Á
àÁMC.COM converts macro source files into WordPerfect macros.
The files may be WordPerfect documents or ASCII files. MC
automatically recognizes whether the source file is a WordPerfect
document or ASCII file. MC uses only 56K of RAM, so it may be
run within WordPerfect using the à ÃShell/Dos CommandÄ Ä feature. The
ÃÃCreateÄÄ macro, described above, automates the entire process. The
following section describes the use of MC as a freestanding
program.

Á
àÁMC was created with the following design considerations:
accuracy, speed, ease of use, and minimal memory usage. MC
provides extensive on screen prompts, so much of the following
discussion is superfluous.

Á
àÁIf you are not using ÃÃCreateÄÄ, start up MC simply by typing MC
at the DOS prompt. (Command line options are described below.)
MC will first ask for the name of your source file. Enter the
name, using MC's built©in editor. If the source file is not in
your current directory, you may specify the full path name. The
editor supports the following keys:
ÐÌX°à @ p
 Ð0`Àð !ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿX°0 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÌÐÙÙ
Home:Á0 ÁMove cursor to beginning of file name
End:Á0 ÁMove cursor to end of file nameÔ Ø'ԌALT-C:Á0 ÁClear input field
CTRL-Y:Á0 ÁClear input field
ALT-R:Á0 ÁRestore input field
CTRL-EndÁ0 ÁDel to end
Insert:Á0 ÁToggle insert and typeover
ÙÙEnter:Á0 ÁAccept input
Down:Á0 ÁMove to next editing field (from Source)
Up:€
0 ÂMove to previous editing field (from Macro or
Destination)Æ(#0 Æ
ESCape:€0 ÂMove to previous editing field, if any, then
quit.Æ(#0 Æ
ÐÌX°0 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿX°8 h ˜
Èø(Xˆ¸èH!x#ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÌÐ
Á
ÁIf you understand the DOS directory abbreviations ".." and
".", you will find that MC does too. The full path name
including drive, directory and file name, cannot exceed 58
characters. If the full path name of your file is more than 58
characters, there are two things you can do. One is to move the
file to a higher directory. The other is to rethink your
directory organization strategy.

Á
ÁAfter you have entered the source file name press either
à ÃEnterÄ Ä or the DOWN arrow. MC will verify that the file exists and
will fill in its full path name. MC will then prompt you for the
name of your new macro. MC assumes that you wish to place your
new macro in the same directory as the source file, with the same
root name and the extension ".WPM". If this assumption is
incorrect, the prompt may be edited. Unlike some other input
routines, the prompt is not obliterated when you type a letter in
the first position. If the assumption is completely off base,
press ALT-C or CTRL-Y to clear the input field. If you want your
new macro to have the same root name as the source file, you need
only specify the output directory; MC will be responsible for
filling in the macro name. If you omit the ".WPM" extension from
the name of your macro file, MC will add it for you. If you do
not want your macro to have an extension, put a period after the
name of the macro.

Á
ÁMC supplies a warning when an existing file may be
overwritten. MC differs from WordPerfect, however, in the
following respect. You do not receive more than one warning, and
you do not hit any special keys to proceed. You just hit à ÃEnterÄ Ä.
Since you probably want to overwrite an existing macro with the
same root name as your source file, you ignore a warning by
pressing à ÃEnterÄ Ä and MC continues processing. You press any key
other than à ÃEnterÄ Ä to revise the name of the macro file. In the
simplest case, you type the name of the source file, press à ÃEnterÄ Ä
twice, and you are through. If you wish to revise the name of
your source file, press ESCape or the UP arrow. If you do not
like warnings and you do not want prompts, then you should see
the section on "Using the Command Line".
Ô 'ԌÁ
ÁIf you make an error entering the source or macro file name,
MC will do its best to identify the error and give you an
opportunity to correct it. Use the UP and DOWN arrows to move
between the source and macro input fields until you are
satisfied.

Á
ÁWhen you have satisfactorily entered the source and macro
file names, MC will process your file. You should find this an
extremely fast procedure.

ÙÙ
Áà
ì'ÁÃÃMC.ERRÄă

Á
ÁMC searches for certain errors in your source file. Such
errors as misspelled Macro and Key Commands, and unintentionally
omitted open and close braces are identified. Regrettably, MC
does not identify errors in macro syntax, such as missing tildes
(the bane of WordPerfect macro programmers). If MC finds any
apparent errors, it will incorporate the questionable command in
your macro as text. It then looks for a file called MC.ERR in
the same directory as MC. If MC.ERR exists, MC will append a
list of the new errors to the end. Otherwise, MC will create a
new file MC.ERR.

Á
ÁMC.ERR identifies the file that is being processed and lists
all misspelled Macro and Key Commands. If one brace is missing,
then MC.ERR will print the preceding or following 16 characters,
depending on whether the open or close brace is omitted. This
16-character string will be truncated, however, when it would
include all or part of another command. In order to maintain a
running log of errors and to avoid having more than one MC.ERR
file in several directories, MC.ERR is always placed in the same
directory as MC. If you do not want an error file, use the /N
command switch when you start MC, i.e. MC /N.

ÙÙ
Áà ì%ÁÃÃWild CardsÄă

Á
ÁTo process more than one file at a time, you may use DOS
wild cards. The source files may be WordPerfect documents, ASCII
files, or a combination of the two. When MC sees that you have
used a wild card in the source file name it will check and advise
you how many files will be processed. You may press ESCape to
revise your entry. Since MC will faithfully follow your
instructions, it is best to be as specific as possible. For
example, specifying "*.*" as your source specification is
inadvisable, because it may encompass more than source files as
well as more than one file with the same root name. The
specification "*.TXT" would be suitably specific. In any event,
if you get a message that MC is ready to process 500 files and
you thought there were only 6, you can press the ESCape key to
revise the file specification. Regardless of what you use asÔ Ø'Ô your source specification, MC (and DOS, too, for that matter)
will not allow you to have two files with the same name in the
same directory.

Á
ÁIn a wildcard operation, you may choose only the destination
directory. You will be prompted with the name of the directory
containing your source files. As with all MC prompts, you may
edit this one as you please. You should not enter a file name.
The new macros will have the same root name as your source files
and the extension ".WPM". When you think about it, there really
is not too much to specify in terms of output file names in a
wild card operation, except for an alternative extension.
Modifying the root name can be done, but requires more knowledge
of wild card usage than most people care to possess. Leave the
destination field blank to have your new macros placed in the
default directory.

Á
ÁWhen you have selected the destination directory. You will
be advised if any files located there match the root file
specification of your source files combined with the extension
".WPM". For example, if you enter the file specification
"*.TXT", MC will tell you if any files match the specification
"*.WPM"; i.e., the root name "*" combined with the extension
".WPM". This may not be too informative, because the
specification for the root name is so general. For example, if
you have specified "*.TXT" to process the three files: FIND.TXT,
FORMAT.TXT, and PRINT.TXT and the macros MARGIN.WPM and
HEADER.WPM are in the destination directory, you will get a
warning message, even though no files will be overwritten,
because none of the ".TXT" file shares the same root name with
any of the ".WPM" files. It would have been possible to make MC
more precise in this respect, but would have required more
memory, and MC has been designed to minimize memory usage. Press
"Ã ÃVÄ Ä" at the warning message to have MC warn you before overwriting
an existing file.

Á
ÁWhen processing Wild Cards, MC uses the same rules as DOS.
Thus any characters after an asterisk (*) are ignored and do not
serve to limit the scope of the wild card. In other words, to
DOS "H*EADER.TXT" is equivalent to "H*.TXT"; all characters after
the asterisk are ignored.

ÙÙ
Áà
ìÁÃÃCommand Line ProcessingÄă

Á
ÁMC.COM also has the capacity to process files from the
command line. The format for command line processing is as
follows:

Áà
ìÁMC [/options] [source file] [macro file]ƒ
Ô 'ԌÒƄ°Œ
@  (#‚P
¨ (#ÆÒÅxŇSource
fileÔ ÈÔ The name of the file that will be converted to a
macro. Full path names and wild cards are
permitted. If you specify a source file only
and do not specify a macro file name, the new
macro will be placed in the same directory as
the source file with the same root name and the
extension ".WPM".ÅxÅÔ! °!Ô¯
ŘŇMacro
fileÔ Ô The name of the new macro. If you specify the
destination directory only and do not specify a
macro file name, the new macro will have the
same root name as the source file and the
extension ".WPM". If you specify a macro file
name only and do not specify a path, the macro
will be placed in the default directory. If you
omit the extension of the macro file, the
extension ".WPM" will be added. In wild card
operations, only the destination directory may
be specified.ŘÅÔ! Ð@
!Ô¯
Á
ÁValid options are:

ÅÈŇ/PÔ 0Ô Pause to verify command line entryÅÈÅÔ! 0ø0!Ô¯
ÅÈŇ/VÔ ÀÔ Verify before overwriting existing fileÅÈÅÔ! ÀˆÀ!Ô¯
ÅÈŇ/MÔ PÔ Force monochrome displayÅÈÅÔ! PP!Ô¯
ÅÈŇ/NÔ àÔ No error fileÅÈÅÔ! à¨à!Ô¯

Á
ÁThe /P and /V options are required only if you specify a
source file on the command line when you run MC. They are
unnecessary when you enter the source file name from within MC.
The /P option is more inclusive than /V in that /P always pauses,
/V pauses only when a file may be overwritten. Options may
appear before or after the source and macro file names and may be
grouped under one slash. Thus /PNM is equivalent to /P /N /M.


à ÃM2T.COMÄ Ä

Á
ÁM2T.COM is the Macro Decompiler. It converts macro files to
WordPerfect or ASCII files. (It cannot be named MD.COM because
of a conflict with the DOS "Make Directory" command, so it is
called M2T for "Macro to Text". The designation "Text" is
something of a misnomer, because "text" generally refers to ASCII
files and by default M2T produces files formatted for
WordPerfect. The source of this incongruity is historical:
Version 1 of M2T only produced ASCII files.)
Ô 'ԌÁ
ÁCommand usage for M2T is similar to that of MC. To start
it, simply type M2T. By default, M2T produces files formatted as
WordPerfect documents. If you prefer files in ASCII format, use
the /A option. Since M2T does not produce an error file, there
is no /N switch. With the exceptions of the /A and /N options,
command line operation of M2T is similar to that of MC.

Á
ÁLike MC, M2T begins by asking for the name of a source file,
except that in the case of M2T, the source file is a macro. If
you omit an extension from the name of your macro, M2T will add
the extension ".WPM", just as WordPerfect does. The default
extension for the output file is ".TXT". You may change the
extension if you wish.

Á
ÁM2T automatically processes the output text file to conform
to the format understood by MC. This means that M2T will add an
extra open brace if you have used the open brace as text. M2T
does not add extra close braces, since they are usually
unnecessary. M2T will include the description from an existing
macro (if it has one), at the top of the text file. For
additional information about formatting source files, see the
section entitled "Formatting Text Files for MC".

Á
ÁSince many text editors and word processors do not directly
support the ASCII characters from 1 to 31 (the control codes) M2T
converts them to their numerical form enclosed in brackets. Thus
ASCII character number 3 (ÀÀ) becomes à Ã{3}Ä Ä. For additional
information about the à Ã{n}Ä Ä notation, see the section entitled
"Character Positioning Codes".

Á
ÁIf ASCII output is selected with the /A option, M2T will
interpret special characters in the WordPerfect character set
that are not also ASCII characters, in the standard format
understood by MC; i.e. as two numbers in brackets separated by a
comma. The first number is the character set, the second is the
number of the character in the set. For additional information
on the WordPerfect character set, see the section entitled "The
WordPerfect Character Set".

Á
ÁM2T does not write an error file corresponding to MC.ERR.
In a fully operational macro, there should not be any errors to
report. M2T understands all Macro and Key Commands supported by
the current release of WordPerfect. If new Macro or Key Commands
are included in a future interim release of WordPerfect, M2T will
print the number of the new command in the format à Ã{MACRO CMD n}Ä Ä
or à Ã{KEY CMD n}Ä Ä, where "n" is the command number. Of course, you
can expect that a new release of MPE4WP will be released
instantaneously to support the new release of WordPerfect. (For
more information on the à Ã{MACRO CMD n}Ä Ä and à Ã{KEY CMD n}Ä Ä notation,
see the section entitled "Anti©Obsolescence".)
Ô 'ԌÁ
ÁThere are other programs that will convert macros into ASCII
text or WordPerfect format. The output of these programs may
require editing for use by MC. Some imitate the Macro Editor by
using centered dots instead of spaces. Others use variants of
Macro or Key Commands instead of the exact form utilized by
WordPerfect. Minor variations, like the substitution of
à Ã{Left Search}Ä Ä for à Ã{Search Left}Ä Ä, are not serious, if all you are
planning to do is print or study the output, but they will not be
understood by MC. In addition, you will have to edit any
information about version and description that may be added to
the text.

ÙÙ
à ÃMAKING BOXES WITH MPE4WPÄ Ä

Á
ÁCreating boxed messages in the Macro Editor is an ordeal
that many forgo. With MPE4WP, however, creating boxes is
simplified with WordPerfect's line draw tools and MPE4WP's
ÃÃPositionÄÄ and ÃÃAttributeÄÄ macros. By following these steps, you can
create attractive boxed prompts for your WordPerfect macros:
ÒT(a) A. 1. a.(1)(a) i) a) 1.(a) i.(1)(a)(i) 1) a)TÒ
Á
ÁØ€1.Ø As a preliminary matter, you may wish to select a wider
"paper size" to prevent your boxes and messages from wrapping
around on themselves. (Keystrokes: Ã Ã{Format}Ä Äps) The wider paper
size permits part of the box or message to scroll off to the
right of the screen, but I find this preferable to having the
boxes wrapped on the screen. Selection of a small font size will
accomplish the same objective.

Á
ÁI also set tab spacing at 3 units apart, corresponding to
the spacing in the Macro Editor. Setting paper size, fonts, and
tab spacing at the WordPerfect editing screen will have no effect
on final macro output. They are simply conveniences in drafting
source file.

Á
ÁØ€2.Ø Each message must begin with a à Ã{PROMPT}Ä Ä, à Ã{CHAR}Ä Ä, or
other prompt command at the beginning, and a tilde at the end.
For convenience, I sometimes save this for the last step.

Á
ÁØ€3.Ø Begin the message by entering the text that you intend
to use with your screen. Allow enough white space to the left
and top of the text to permit the use of line draw characters.
Use spaces, not tabs, to create white space to the left of the
message.

Á
ÁØ€4.Ø Draw a box around the text using the WordPerfect Line
Draw tools. To avoid adding spurious spaces, the left edge of
the box should be flush against the left margin and a hard return
should be flush against the right edge of the box. Delete any
spurious little arrows that WordPerfect leaves on the screen
after a line draw operation, or they will be incorporated in your
macro.Ô Ø' Ԍ
Á
ÁØ€5.Ø Use the ÃÃPositionÄÄ macro to determine the vertical and
horizontal coordinates of the box. Press CTRL-P, then block the
top edge of the box, from the upper left corner to the upper
right corner, and press à ÃEnterÄ Ä. Now move the top of the box
around on the screen until you are satisfied with the location.
In many cases you want to center the box horizontally: Press
Shift-F6, just as you would in WordPerfect.

Á
ÁWhen the box is located on the screen to your satisfaction,
press à ÃEnterÄ Ä. ÃÃPositionÄÄ will pause to permit you to relocate the
cursor to the upper left corner of the box. Press à ÃEnterÄ Ä, and the
coordinates in the form {^P}{c}{r}, where "c" is a column number
and "r" is a row number, will be entered for you. When you
convert your source file to a macro, the column and row numbers
will be converted to the applicable ASCII characters.

Á
ÁÃÃPositionÄÄ can be used to fill in the other coordinates of the
box. Press CTRL-P, move the cursor to the location for the next
coordinate codes and press à ÃNÄ Ä (for next row). ÃÃPositionÄÄ will fill
in the coordinate codes for the next row. (This assumes the
customary case that the rows increase, but the columns remain the
same.) Alternatively, you can simply block and copy the
coordinates for the upper left corner and copy them to the left
of the box where required, then change the row coordinates.

Á
ÁA properly positioned box might look like this:

ÅxÅÃ Ã{^P}{29}{10}Ä ÄÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀ
à Ã{^P}{29}{11}Ä ÄÀ À Hello from MPE4WP À À
à Ã{^P}{29}{12}Ä ÄÀ À Drawing boxed À À
à Ã{^P}{29}{13}Ä ÄÀ À messages is easy, À À
à Ã{^P}{29}{14}Ä ÄÀ À Isn't it? À À
à Ã{^P}{29}{15}Ä ÄÀ!ÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀ À
ÅxÅ
Á
ÁIn version 1 of MPE4WP, you could use WordPerfect's
automatic numbering feature to increment the row lines. If you
do, however, you à ÃÃÃmustÄÄÄ Ä save your file in generic word processing
format. Since you will probably forget this crucial requirement,
I do not recommend using automatic numbering.

Á
ÁØ€6.Ø Attribute commands may now be added to embellish the
screen. Attributes, such as bold, underline and mnemonic,
determine the appearance of on©screen messages. Each attribute
has special control codes to turn the attribute on and to turn it
off. Since there are 16 possible attributes, it used to be
difficult to remember which is which.

Á
ÁThe ÃÃAttributeÄÄ macro streamlines the procedure of adding
attribute commands. Pressing CTRL-A brings up a menu bar on the
bottom of the screen. The mnemonic for each attribute is
highlighted with its own attribute. Thus the B in à ÃBÄ Äold isÔ Ø'!Ô highlighted with the bold attribute and the U in the ÃÃUÄÄnderline is
highlighted with the underline attribute. The word "Attribute"
on the third line from the bottom of the screen is highlighted
with the attribute of the last attribute selected. It would
appear like this: Ã
ÃAttributeÄ
Ä if the last attribute selected was
"Redline". Each time an attribute is selected, ÃÃAttributeÄÄ cycles
between Attribute On and Attribute Off. Next to the Attribute
reminder, the menu indicates whether the next attribute command
is set for "On" or "Off". "On" and "Off" can also be toggled
with à ÃTabÄ Ä.

Á
ÁPressing the applicable mnemonic key will insert the
appropriate attribute in your source file. Each time you use the
macro it remembers the last attribute you selected and whether it
was "On" or "Off". Thus, you can insert the complementary
attribute simply by pressing à ÃEnterÄ Ä. A typical sequence might be
؁(a)Ø CTRL-A (run the macro), ؁(b)Ø B (turn on Bold), ؁(c)Ø type a
message, ؁(d)Ø CTRL-A (call the macro again), ؁(e)Ø Ã ÃEnterÄ Ä (turn Bold
off).

Á
ÁRemember that attributes are user selected and will vary
from one installed version of WordPerfect to another. In general
the safest attributes when writing macros for general use are
bold, reverse, and mnemonic, since they are the ones most
commonly used by WordPerfect for its own messages.

Á
ÁDo not be disturbed if the box in your source file becomes
distorted by the addition of attribute Commands, so long as you
use the correct character positioning codes and do not
inadvertently add spaces, the message will appear correctly when
the macro is executed.

Á
ÁØ€7.Ø I find it simplest to prepare the boxes in à ÃDoc 2Ä Ä. I
then test them by creating a temporary macro that only contains a
à Ã{PROMPT}Ä Ä with the message and closing tilde. After I am
satisfied the message works in a test macro, I copy it into the
source file in à ÃDoc 1Ä Ä.

ÙÙ
à ÃKEY MACROSÄ Ä

Á
ÁUnlike the WordPerfect Macro Editor, MPE4WP allows you to
insert Key Macros into your macros. (WordPerfect does permit the
inclusion of Key Macros when a macro is initially defined.)
Frankly, this is a mixed blessing, since Key Macros will
frequently cause your macro to hang. Inserting the Key Macro
command is not the same as nesting or chaining to a file macro.
Thus, your macro is suddenly hit with a series of keystrokes for
which it is unprepared.

Á
ÁI regret not having been methodical enough to formulate any
general rules about the use of Key Macros, but I do have thisÔ Ø'"Ô advice. Because they reside permanently in memory, Key Macros
should be restricted to relatively small macros that are used
frequently. In addition, Key Macros are not desirable because
you must go into the à ÃEdit KeyboardÄ Ä screen to edit them. Finally,
to use a Key Macro in a macro, you must keep track of its number,
which might change when you revise your keyboard. Consequently,
instead of using Key Macros for large or infrequently used
macros, you should use ALT-keys or a small Key Macro that in turn
calls a file macro.

Á
ÁKey Macros that call larger file macros take one of the
following forms:

Á
ÁÒT 1.(a) i.(1)(a)(i) 1) a) 1.(a) i.(1)(a)(i) 1) a)TÒØ€1.Ø Ã Ã{Macro}Ä Ä“[Your macro's name here]“Ã Ã{Enter}Ä Ä.

Á
ÁØ€2.Ø Ã Ã{NEST}Ä Ä“[Your macro's name here]~, or

Á
ÁØ€3.Ø Ã Ã{CHAIN}Ä Ä“[Your macro's name here]~

Á
ÁThe first alternative is slightly more versatile than the
other two. Suppose, for example, you have a macro called
TEMP.WPM that you use for temporary chores and that you would
like to assign to CTRL-T. Go to the à ÃKeyboard: EditÄ Ä menu
(Keystrokes: Ã Ã{Setup}Ä Äk). Position the cursor over the keyboard
file you wish to modify and press à Ã{Enter}Ä Ä. Now press à ÃCÄ Ä for
Create. You will be prompted for a key; press CTRL-T.
WordPerfect will place you in the tedious Macro Editor, but for a
small macro like this, that is tolerable. Delete the default
à Ã{^T}Ä Ä command and type à Ã{Macro}Ä ÄTemp“Ã Ã{Enter}Ä Ä. (Remember, in the
Macro Editor, you do not actually type Key Commands. You press
CTRL-V, then press the key associated with the Key Command.)
Press à ÃExitÄ Ä when you are finished. The resulting Key Macro will
be as functional as an ALT-macro. You may run the macro by
pressing CTRL-T or define it by pressing ALT©F10 followed by
CTRL-T.

Á
ÁIf you are using my program MALT (More Alt-Keys for the
Perfects), you can add more than 90 macro keys that use CapsLock
as an auxiliary shift key. An additional 90 small macros can be
maintained in a master library macro. Any one of the library
macros can be accessed by using ScrollLock as an auxiliary shift
key. MALT uses only 512 bytes of RAM, can be uninstalled, and
does not interfere with the normal operation of CapsLock or
ScrollLock.

ÙÙ
à ÃANTI-OBSOLESCENCEÄ Ä

Á
ÁMC and M2T support all Macro and Key Commands accessible in
the present release of WordPerfect 5.1. From time to time
WordPerfect Corporation adds new Macro and Key Commands. For
example, the à Ã{OTHERWISE}Ä Ä command was added to the August 20, 1990Ô Ø'#Ô interim release of WordPerfect 5.1. MC and M2T will, of course,
be revised immediately to support new commands, whenever they are
made available. In the meantime, new commands may be accessed
the instant they are released by WordPerfect Corporation by using
the MPE4WP commands à Ã{MACRO CMD n}Ä Ä and à Ã{KEY CMD n}Ä Ä, where "n" is
the number of a Macro or Key Command. (Of course, you will also
need the updated version of WordPerfect. MPE4WP can teach
WordPerfect to do some new tricks, but it can't teach an old
version of WordPerfect to recognize a new command.)

Á
ÁEvery Macro and Key Command has a number as well as a name.
The numbers are listed in Appendix K to the WordPerfect 5.1
manual, under the instructions for à Ã{STEP ON}Ä Ä. Any new command
will also have a number, which should be included with the
information accompanying the interim release. (If the number is
not included in the release materials, you may obtain it by
calling WordPerfect's toll free number, or by taking the steps
outlined below.) To access a new Macro Command with MPE4WP,
simply type à Ã{MACRO CMD n}Ä Ä, where "n" is the number of the new
Macro Command. Similarly, a new Key Command would be accessed by
typing à Ã{KEY CMD n}Ä Ä, where "n" is the number of the new Key
Command. (Note: You can also use the à Ã{MACRO CMD n}Ä Ä and
à Ã{KEY CMD n}Ä Ä terminology to access existing commands, although you
probably will not want to.)

Á
ÁHere are the steps to take to find the number of the new
Macro or Key Command without reading the literature accompanying
the interim release and without calling WordPerfect Corporation.
Use the Macro Editor in the new release of WordPerfect to create
a short macro. The first command should be à Ã{STEP ON}Ä Ä, the second
one should be the new command. Press à ÃExitÄ Ä to leave the Macro
Editor, then run the short macro. A prompt will appear at the
bottom of the screen telling you the Macro or Key Command number.
Alternatively, you could process a macro containing a new Macro
or Key Command with M2T. The resulting text file will give the
number of the new command in the à Ã{MACRO CMD n}Ä Ä or à Ã{KEY CMD n}Ä Ä
format.

ÙÙ
à ÃMACRO PROGRAMMING TIPS
Ä Ä
Á
ÁThe process of programming WordPerfect macros is often one
of trial and error. Rather than deleting text in the course of
development, I frequently prefer to put the deleted material in a
WordPerfect document comment. (I am referring in this case to a
text comment created by blocking text and pressing CTRL-F5,C.)
Like all formatting commands (except tabs and WordPerfect special
characters), the comment is ignored when processed by MC. You
could also create a macro comment (à Ã{;}Ä Ä or à Ã{:}Ä Ä), but this
frequently involves deleting or disguising intervening tildes.
Incidentally, a simple method for disguising tildes is to block
the fragment you wish to comment off, then use à ÃReplaceÄ Ä toÔ Ø'$Ô substitute a hard tilde (à Ã{~}Ä Ä) for the conventional macro tildes.
Remember to place a comment command (à Ã{;}Ä Ä or à Ã{:}Ä Ä) before the
fragment and a conventional macro tilde at the end.

Á
ÁWhen creating and debugging macros, it is sometimes
convenient to give a macro a dummy name that can be run with one
of the small Key Macros in the form described in the section
entitled "Key Macros". I tell WordPerfect to name the
work-in-progress "WIP". Now when I run MC, using ÃÃCreateÄÄ
(CTRL-C), it will automatically create a macro called "WIP.WPM".
When ÃÃCreateÄÄ returns me to WordPerfect, I can run the latest
iteration of the macro by hitting the key to which I have
assigned the WIP Key Macro (Ã Ã{Macro}Ä ÄWIPÃ Ã{Enter}Ä Ä) Since, ÃÃCreateÄÄ
also has the effect of clearing the WordPerfect cache, the new
version of WIP.WPM will run immediately. For your convenience,
the WIP key has been assigned to CTRL-\ on the MPE4WP/MPE4WP-I
keyboard. When you have debugged your work©in©progress, remember
to give your source file its permanent name.

Á
ÁIf you have a curious nature, you may (if you haven't
already) try running M2T on an existing macro, then re-compiling
the result with MC in order to compare the re-compiled version
with the original. Do not be startled to find that the length of
the re-compiled version may be slightly different from that of
the original. When WordPerfect retrieves a macro with very long
lines into the Macro Editor, it will sometimes add a special code
that is the equivalent of a soft return. M2T and MC ignore these
macro "soft returns" since they add nothing to the operation of
the macro and were not intended to be part of the macro by the
macro's author. The omission of the "soft returns" will not
prevent you from later retrieving the macro into the Macro
Editor.

Á
ÁIf you examine the macros in the MPE4WP-I keyboard, you will
see that (with the exception of ÃÃCreateÄÄ, they have been compacted,
i.e. the optional tabs and hard returns that are used for
formatting purposes have been deleted.) This has the salutary
effect of making a smaller macro. The disadvantage of making an
indecipherable macro is negated by the fact that you still have
the properly formatted source file.

Á
ÁTo make a compacted macro, first save your source file with
the tab and hard return formatting intact. Move to the top of
the document and use the à ÃReplaceÄ Ä feature to delete all tabs.
(Keystrokes: Ã Ã{Replace}{Tab}{Search}{Search}Ä Ä). Follow the same
steps to à ÃReplaceÄ Ä all hard returns. Now save the file again, keep
the same root name, but use the extension ".TMP" or some other
phoney extension. Then run ÃÃCreateÄÄ to convert the compacted file
to a macro. MC will convert the source file to a macro with the
same root name and the extension ".WPM". Finally, go back and
delete the file with the ".TMP" extension.
Ô Ø'%ԌÙÙ
à ÃPROGRAM NOTESÄ Ä

Á
ÁThe entire file conversion procedure in M2T and the bulk of
the file conversion procedure in MC©©as well various routines in
both programs to enhance the user interface©©are written in
assembly language. I am indebted to Ethan Winer's ÃÃBASIC
Techniques and UtilitiesÄÄ for its excellent introduction to
assembly language. It would not be possible to exaggerate the
contribution of Michael Abrash's definitive work ÃÃZen of Assembly
LanguageÄÄ.

Á
ÁMost of the user interface in MC and M2T are written in
Microsoft Professional Development System (PDS) BASIC 7.10, using
routines contained in Crescent Software's QuickPak Professional,
and linked with Crescent's P.D.Q. Crescent is dedicated to the
proposition that Basic is created equal. (Don't blame them for
that joke; it's mine.) Crescent believes that programs written
in the BASIC language can be equivalent to those written in
assembly language and C. If MC and M2T do not support this
premise, I hope they do nothing to detract from it. The Crescent
documentation and there assembly language source code has been as
instructive to me as their routines have been useful.

Á
ÁMC and M2T utilize information about WordPerfect macro and
document file structure taken from the ÃÃWordPerfect Developer's
ToolkitÄÄ. During the process of development I have also referred
to Gordon McComb's book ÃÃWordPerfect 5.1 Macros and TemplatesÄÄ,
which I found to be a helpful reference. I have also noted
Gordon's commendable generosity in distributing macros and
information about macros on electronic bulletin board systems.

Á
ÁThis documentation was originally prepared using XyWrite,
then imported into WordPerfect for formatting. Symantec's
GrandView proved to be awesomely powerful in analyzing thorny
programming strategies. I should also add that these programs
were created while running under DesqView, a superior alternative
to (ugh) Windows.

ÙÙ
à ÃSTANDARD DISCLAIMERSÄ Ä

Á
ÁBy now all personal computer users should realize that only
the blandest warranties are attached to software. This software
is no different from any other in that respect. Accordingly,
there are no warranties of merchantability or fitness for a
particular purpose, nor will the author be responsible for any
damages (incidental, consequential, or otherwise) in excess of
the purchase price. MPE4WP has been thoroughly tested by me and
I believe it will work as described. If you encounter problems,
please let me know.
Ô Ø'&ԌÙÙ
à ÃREGISTRATION/LICENSE/COPYRIGHTÄ Ä

Á
ÁMPE4WP is a user supported program. It is not public
domain. If you are using MPE4WP for personal use and find the
program is worth $20, you should pay a $20 registration fee. If
you feel the program is worth more than $20, you still only pay
$20. MPE4WP has deliberately been priced low to encourage
registration. MPE4WP may not be used in business without a
license. For information about securing a license to use MPE4WP
in business, please see the section entitled "Business Use".

Á
ÁThe source code for and all of the MPE4WP macros are
copyrighted by me in their entirety. Authorized users are,
however, encouraged to incorporate in their macros any useful
routines they find in the MPE4WP macros. In that case, I would
enjoy seeing an appropriate acknowledgement, but it is not
obligatory.


ÅÅÁà
ì#ÁÃÃHow to RegisterÄă

Á
ÁTo register MPE4WP for personal use, please send your $20
check or money order to:

Á
ÁÁ8 ÁÁh ÁMichael H. Shacter
Á
ÁÁ8 ÁÁh Á10309 Parkwood Drive
Á
ÁÁ8 ÁÁh ÁKensington, Maryland 20895-4041
ÅÅ
Á
ÁIn exchange, you will receive an acknowledgement and at
least $20 worth of satisfaction. Please note that you will not
be sent a disk, only a registration number. A combined
registration for MPE4WP and my other program, MALT, is available
for $30.00. If you have already registered MALT, you may
register MPE4WP for an additional $15. If you absolutely must
have a copy of MPE4WP on disk, please send an additional $5.
Please (a) specify 5ÀÀ or 3ÀÀ disk size, (b) include 5% sales tax
if you are a Maryland resident, and (c) be patient. For your
convenience, a registration form is included with this package.
Please see the file REGISTER.FRM.

Á
ÁAs of the date of this release, MPE4WP may be found on
CompuServe in library 4 of the WPUSERS forum, where the most
current version is always known as MPE4WP.ZIP. There is no cost
for registered users of version 1 to upgrade to version 2 (aside
from the cost, if any, of securing a physical copy). Registered
users may secure the most current version of my programs from me
for a $5 shipping and handling fee. Please remember to specify
disk size.

ÙÙÔ ''ԌÁà
ì$ÁÃÃBusiness UseÄă

Á
ÁA license is required to use MPE4WP in business, after a
reasonable trial period. Business use includes use by
governmental entities, non©profit organizations, and any other
use that is not strictly personal. You may obtain a license by
writing to me at the above address. The license fee will depend
on the number of MPE4WP users in your business. Discounts are
available for multiple copies. Please feel free to submit a
reasonable proposal, including any special requirements for
customization you may have. Remember, if you are using MPE4WP to
make money, I am too, and in this respect, my expectation of a
living is superior to yours.

ÙÙ
Áà
ì!ÁÃÃOther restrictionsÄă

Á
ÁAll authorized users are granted a limited license to make
copies of MPE4WP without charge, subject to the restrictions
contained elsewhere in this document as well these:

ÂX
ÂÁ8 Á(a) MPE4WP must be distributed in absolutely unmodified
form, including the programs, macro files, and
documentation. You may modify the MPE4WP macros for your
own use, but you may not redistribute them in their modified
form.Æ(#Æ

ÂX
ÂÁ8 Á(b) For-profit use of MPE4WP without a license is
prohibited.Æ(#Æ

ÂX
ÂÁ8 Á(c) MPE4WP may not be included or bundled with any
other product for any reason.Æ(#Æ

Á
ÁNot-for-profit user's groups, such as the Capital PC User
Group, are permitted to charge a small fee for materials,
handling, postage, and general overhead. No other organization
is permitted to charge for distribution of copies of MPE4WP.

Á
ÁElectronic bulletin board system operators are encouraged to
post MPE4WP on their bulletin board systems for downloading by
their users, if the above conditions are met, and if no special
fee is necessary to access the MPE4WP files (a general fee to
access the BBS is acceptable). Likewise, all authorized users
are encouraged to upload to MPE4WP to BBS meeting these
requirements.


  3 Responses to “Category : Word Perfect
Archive   : MPE4WP22.ZIP
Filename : MANUAL.MPE

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: http://www.os2museum.com/wp/mtswslnk/