Category : Word Perfect
Archive   : WONDRWP5.ZIP
Filename : WMENU.DOC

Output of file : WMENU.DOC contained in archive : WONDRWP5.ZIP


Pull-down Menu
Document Automation Macros
For WordPerfect 5.0


Clayton Groom
(CIS: 72470,1100) Disclaimer and License

Your first use of WONDERMENU constitutes agreement to the
following provisions. If you do not agree to them, please do not
use this program.

The macro programs that constitute the product "WonderMenu" are
not "Public Domain" and they are not "Freeware". WonderMenu, and
Form-Fill are copyrighted software products and are owned by
Clayton Groom. You are free to modify the macros that make up
the WonderMenu system for your own personal use only. You may not
distribute for payment, commercial benefit, or other
consideration, either the original or modified versions of the
macro program(s). You are encouraged to distribute the original,
unmodified archived files for others to evaluate. If you
continue to use this product, you are required to register. No
fee may be charged for the distribution of the WonderMenu system
without permission from the author.

The WonderMenu menu shell may be licenced for use in distributing
other macro products. Those interested in licensing the menu
shell and/or the Form-Fill interpreter, may contact us in writing
for more details. A Commercial Distribution, and a Consultants
licence are available.

This product is licensed "as is" without any warranty of
merchantability of fitness for a particular purpose, performance,
or otherwise; all warranties are expressly disclaimed. By using
the wondermenu system, you agree that neither Clayton Groom nor
any employees, affiliates, or other related parties will be
liable to you or any third party for any use of (or inability to
use) or performance of this product, or for any damages
whatsoever whether based on contract, tort or otherwise. Even if
we are notified of such possibility in advance. (Some states do
not allow the exclusion or limitation of incidental or
consequential damages, so the foregoing limitation may not apply
to you.)

Program and documentation Copyright (c) 1989 Clayton Groom. All
rights Reserved. No part of this Documentation or program may be
reproduced, photocopied, Stored on a retrieval system, or
transmitted except as provided by the license above.

WordPerfect is a registered trademark of WordPerfect Corporation.
All other product names are trademarks of their respective

Contact: Clayton Groom Compuserve user ID: 72470,1100
156 South Meridith #130
Pasadena, CA 91106

Comments and suggestion are appreciated!

This manual is completely composed and typeset in WordPerfect 5.0

From DOS, unarchive the files FORMS.ARC & MACROS.ARC into two
directories on a floppy (i.e. A:\FORMS & A:\MACROS)

1. Run WordPerfect and look under Setup (, L) to find
out where your macros directory is located (it should be
different from the directory where you have WP's program or data
files. If you do not have a Macros directory specified, then you
need to create one now. If you have a macro directory specified,
go to the next step.

To create a sub-directory for your macros, return to the editing
screen and press List Files , press = (the equal sign) to
change the default directory. Now type the complete path for
your macros directory (i.e. "C:\WP50\MACROS"), and press .
If you are prompted by WordPerfect "Create C:\WP50\MACROS?
(Y/N)," press Y (yes) to create the new directory.
Press Setup , L (7), K (3), and enter the name of the
directory that you just created.

2. Check your macros directory to see if you already have an
ALTM.WPM macro defined. If you do, rename it to something else,
so that it is not replaced by WonderMenu's ALTM macro.

3. Copy all the macro files from the floppy to your macros
directory. To do this, press List files , and enter the
drive letter where the Wonder Menu Floppy is located (i.e A:) and
press . Move the cursor bar to the "macros" sub-
directory of the floppy and press twice. This should
list all the macro files that are on the floppy. Now type F5> to mark all the files. Press "C" to "Copy" the macros, and
when prompted "Copy marked files to:", enter the full path-name
of your macros directory (i.e. C:\WP50\MACROS).

4. Create on your C: drive a directory for forms using the same
method outlined above to make the MACROS directory. The default
setting is c:\WP50\FORMS

5. Copy all the files in the FORMS directory of the floppy to
the FORMS directory you created on your hard disk using the same
method outlined above.

6. If you are installing the WonderMenu files to directories
different from the ones specified above, you will need to edit
the macro "-PATH.WPM". This macro contains the path information
to point to the same directory where you put the ".FRM" and
".MRG" files.To edit the macro type:
-PATH.WPM initially contains a path of "C:\WP50\FORMS\". Change
the text of the macro to contain the full path name of the
directory where you put the forms. Be sure to include the final
back-slash "\", or things will go real weird.

7. In order for the forms to work properly with your printer,
they will need to be converted into files for your printer. (If
you have a Laserjet II definition already [HPLASEII.PRS], then
this step is unnecessary.) To do this, get into Wordperfect,
select your default printer, and execute the macro FORMCONV.WPM
(FORMCONV). It will retrieve into WordPerfect
each form file (.FRM) from the "FORMS" directory specified in
step 5, causing it to be reformatted for your default printer,
and then save it back to the "FORMS" directory under the same
filename. What this does is convert the forms from a Laserjet
II document to a document for your default printer. Now when you
select MEMORANDUM from the menu, the form will be formatted for
your default printer.

CAUTION: This procedure will not work properly on some older
releases of WP 5.0. You may need to convert the forms manually,
by retrieving them, re-selecting your Default Printer, and then
saving the forms again. A better Alternative is to contact
WordPerfect and order the latest interim release of 5.0 (WP
orders Dept. 800-312-4566). WP 5.0 releases since 4-29-89 can
reformat a document automatically for your default printer
without creating an error message, and the conversion process
works correctly. Older version (1988) will add a "Phantom
printer" to the list of printers, and will not convert the
document until you manually re-select your default printer.

7. To invoke Wondermenu, you can select the WMENU.WPK keyboard
definition under Setup and use any one of several Alt-Key
combinations to invoke WonderMenu, or if you don't want to use
the keyboard definition, you can use the Alt-M macro. Differences
between the two methods are explained in the following
documentation. If the menu system does not appear, check your
setup to be sure that your macro directory is set to the
directory where you installed the macros.

That should complete the installation! If you have any major
difficulties getting the system to work, send me a message on
Compuserve, (72470,1100), or write me concerning the difficulty.
The Macro Menu System

WonderMenu is a set of WordPerfect macros that produces "pull-
down" style menus. WonderMenu contains about 35 functions useful
for preparing Business forms or other documents, and was written
with the typical business user in mind. To invoke WonderMenu,
press from within WordPerfect; the menu system will
appear over the current screen.

Navigating in WonderMenu
WonderMenu's macros are organized in eight "pull-down" menus
(with room for four additional menus). Only one menu is visible
at a time.
To select a menu item, use the arrow keys to move the cursor to
the desired selection, then press , or press the desired
selection's highlighted letter. The macro will begin running at
your cursor's location.

There are several ways you can access other menus:

With WMENU.WPK selected as a keyboard definition (under Setup),
you start WonderMenu by typing .
With WMENU.WPK de-selected, you can start WonderMenu by typing
Both of these methods will bring up the menus "Topbar". From the
topbar, you can enter a letter to pull-down the menu that the
mnemonic (letter) corresponds to, and that menu will be
You can also press the or to
highlight a different menu heading, and then press
or to display the corresponding menu.
Once a menu is displayed, you can press the or
key to move to an adjacent menu.
To switch directly from one menu to another, you can type Letter> where "Letter" is the mnemonic for the menu you want;
i.e. to move to the BLOCK menu.
Press or to exit the current menu and display
the "Topbar", then enter a mnemonic letter to select another
Pressing or will exit out of WonderMenu and
return to the Editing Screen.
can also be used to exit some menu choices (i.e. Bullet
list maker) and return you to the menu, where you selected the

To Activate WonderMenu and have it go directly to the menu you
want, you can Type , where "Letter" is the mnemonic
for the menu you want. For this to work, you must have selected
the WMENU.WPK keyboard definition under SETUP (see installation
instructions). WMENU.WPK also has other useful macros included
in it for your convenience. For example the HELP key has been
redefined to produce a horizontal key template, as well as tell
you what other special keys are available.

The Menus
Forms contains macros for several common business forms. Designs
contains macros for useful miscellaneous formats, such as labels
for Pendaflex folders. Block and Merge contain macros that
simplify and expand the functions available in WP. Edit contains
macros which allow the editing of headers and footers. Tools
contains handy miscellaneous macros for controlling your screens
appearance and readability. Custom is a blank menu that is open
for customization to those who like dabbling with macros. There
is also a macro called POPUP.WPM which you can use to create your
own Alt-Key popup menus.

WonderMenu forms have been written for use with an HP LaserJet II
or IID printer -- though will also work with other printers.
WordPerfect (April 29, 1989 or later release) will automatically
convert the forms for your default printer, if you do not have a
LaserJet printer definition. If the release date of your
WordPerfect program files is earlier than 4-29-89, it is highly
recommended that you obtain an update from WordPerfect (800)-
321-4566. Updates are free, or at a nominal cost.

Customizing Colors
WonderMenu's window colors are determined by the colors selected
for Bold, Underline, Bold & Underline and Reverse Video in
WordPerfect's Setup . You may want
to alter your color settings in order to make the menu look
Blocked Text This color is used for the cursor bar of the menus
and the top line of the screen. It should contrast greatly from
the color for normal text.
Bolded Text This color is used for the main field of the menu.
If you want the menu to stand out from your document, change the
background color of this setting to be different than the color
for the normal editing screen.
Underlined Text This color is used for the second line of the
screen topbar. It should have a different background color than
the normal editing screen.
Bold & underlined This color is used for the highlighted
mnemonic letters of the menus. Its background color should be the
same as that for Bold, and its foreground color should be the
same as for Underlined.

WonderMenu's Help System
Press from anywhere in the menu system for context-
sensitive help. For instance, pressing while highlighting
"Memorandum" brings up a help screen for the Memorandum form;
pressing while highlighting "Envelope" brings up a help
screen for the envelope form. (Note that is also Help on the
WordPerfect template.)

The "About WonderMenu" selection in the Forms menu brings up a
window with basic information on how to navigate in WonderMenu.
It also will show you what color selections you can change to
change th appearance of WonderMenu. Suggestion for best results:
Have the same background color for Bold, and Bold & Underlined.
Forms Menu

The options on this menu generate and help you complete certain
business forms.
The menu retrieves a file containing a blank copy, or template,
of the form. The "Form-Fill" macro then prompts you to enter
appropriate details (remember that to enter something means to
type it, then press .) If you wish to leave a space
blank, just press ; you can come back and fill it in
later. The "Form-Fill" macro merges your answers with the
template, producing a completed copy of a form, ready for the
main text body to be typed. (You may also type the text first,
move to the top of the document, type , and make a
selection to produce the desired form). The "Forms" macro fills
in the current date as text automatically. Save and edit the
form just as you would any WordPerfect document. Some forms
insert automatic headers on the second and succeeding pages; edit
these with or use the "Edit
Header options on the Edit menu.

This selection produces an interoffice memorandum.

Fax cover sheet
This is for making a FAX coversheet/message.

Letterhead Letter
This option formats a business letter for letterhead stationery
(with a two-inch margin). Prompts are:
Please Enter Person To: This will be the first line of the
inside address.

Please Enter Address Line 1:

Please Enter Address Line 2:

Is There a Third Address Line? (Y/N) If a Y is entered, the
prompt Please Enter Address Line 3: will be displayed. If not,
the macro moves to the next prompt.

Please Enter Salutation:

Please Enter the Text of the Letter: The letter's text will
appear in its proper place in the letter. When the body is
complete, press . If you prefer to compose the body after
the macro finishes, just press .

All margin/draft markers deleted. This message appears because
"Margins/Draft Out," from the Tools menu, has been run (see

Please Enter Sender's Name:

Please Enter Sender's Title:

Please Enter Secretary's Initials:

Business Letter
This performs exactly the same as the "Letterhead" form, but asks
for the sender's address and centers the document on the page.

This formats a long business envelope (9.5" x 4"). It assumes
you are using a pre-printed envelope, so it does not prompt for a
return address. You must have an envelope form in your printer
definition for this to work correctly.

Enter Name:

Enter Address Line #1:

Enter Address Line #2:

Enter Address Line #3 -- if None:

This macro is intended to print on an HP LaserJet II. The printer
will pause and display
"PF - FEED COM-10". Adjust the paper feed guides, open the rear
hinged door, and feed in an envelope with the flap beneath and to
the left.

Custom Form-fill
You may wish to customize some of the forms -- make a fax form
that always includes your fax telephone number, for instance, or
a memo that automatically fills in your name or your
supervisor's. The "Custom Form-Fill" option helps you to fill in
customized templates you have created.

To create a customized template, first retrieve the standard
template from C:\WP50\FORMS. The Memorandum template is
C:\WP50\FORMS\-MEMO.FRM; the fax form is -FAX-I.FRM; the business
letter is
-BUSLTR.FRM; the letterhead letter is
-LTRHEAD.FRM. Other examples of Form-Fill files can also be
found in the directory.

Commands and variables within the templates are enclosed in
brackets. Commands are in all-caps and variables are in mixed
case. You can change any of the mixed case text of the templates
with out affecting their function. Replace any variables you
wish with permanent information, removing the brackets as well as
the text of the variable. For instance, in -MEMO.FRM, you might
delete {Sender's Name}, replacing it with Mary Doe; {Sender's
Department}, replacing it with Accounting; and delete {Sender's
Phone Number}, replacing it with 304-6092. Then save the
template in the forms directory: C:\WP50\FORMS\(any filename you
choose). Your initials, or a one-letter name may prove most
convenient: m for memo, for instance.

To use the new template, select Custom Form-fill in WonderMenu.
The prompt Enter Form Name will appear; enter the name you
assigned to your customized template, such as mem. (You need
only enter the filename; the macro will automatically look for it
in C:\WP50\FORMS. If the file is not found in C:\WP50\FORMS, the
macro will look in your current directory for the file.
If you do not enter a file name, then the macro will use your on-
screen document as a template file.) The "Forms" macro will
continue as usual, but will skip the prompts you have already
filled in.

You can create any number of customized templates for each form.
For more information on the Form-Fill language used in the
template files, see the Form-Fill Language section in this

About WonderMenu
A window describing WonderMenu appears.
Designs Menu

These macros set up several helpful WordPerfect design layouts.

Bullet List
The sub-menu allows you to decide the tab settings for the list
as well as what character will be used beside each list item. If
you want to change the default tab settings, do so before
choosing the type of bullet character.

The bullet list choices include the following:

the normal bullet
the check box
þ the square
 the diamond
þ the hollow bullet
þ the small bullet
Any character the user defines.
How some of the selections print out will depend on the
capabilities of your printer.

Change Tab Settings: Highlight this option if you want to change
the default bullet (1.7") and text (1.9") positions. Once you
have changed the tab settings, press the highlighted letter for
the bullet type you wish for your listing and the new tabs will
be in effect for the list.

The bullet list starts immediately once the type of bullet has
been chosen. After completing each item entry, press to
go to the next list item. You may enter new items indefinitely.
To exit the bullet list, press . When is pressed, the
macro changes the tab setting back to the default (tabs set every
.5") and ends.

Pendaflex label
This macro quickly makes label tabs for Pendaflex folders -- and
the typewriter takes one more step toward the door! No prompts
are displayed; after invoking the macro, just type all folder
titles you need, pressing after each one. Then print.
The labels appear in Swiss Roman 12 point. You will need to cut
them by hand or with a paper cutter.

File cabinet label
Quickly makes file cabinet labels.

Enter Main Title:

Enter Sub-line #1:

Enter Sub-line #2:

Enter another (Y/N): Y
Press Y or to make another label. The prompts will
repeat, so you can make as many labels as you need. After you
have finished the last label, press N. The main title appears in
Swiss Roman 18 point; sub-lines appear in Swiss Roman 14 point.
Each label is in a graphics box which facilitates cutting.
Block Menu

Some of these macros are useful shortcuts for defining and
manipulating blocks of text or graphics. Others are simply menu-
oriented variations of WordPerfect functions
If you select a block before typing , then WonderMenu will
automatically go to the block menu. All Block items can work two
ways: If invoked when a block is already defined, they will
perform the menu selection you choose immediately. If invoked
without a block defined, they will force you to define a block
with prompts reading:

Place cursor at beginning of block and press
Place cursor at end of block and press .

Copy Block
In addition to copying a block within a document, this selection
copies a block between Document 1 and Document 2.

Copy to: 0 Current page
1 Other Document
2 Page #

Option 1 (Other Document) automatically switches to your other
document. If you don't have a second document, the macro creates
one for you. Option 2 (Page #) prompts for a Page #. Enter the
page you want the block copied to. You will automatically go to
that page.

Move Cursor; press to Retrieve.

You can turn on Reveal Codes to aid positioning the text within
format codes.

Move Block
In addition to moving a block within a document, this selection
moves a block between Document 1 and Document 2.

Move to: 0 Current page
1 Other Document
2 Page #

Option 1 (Other Document) automatically switches to your other
document. If you don't have a second document, the macro creates
one for you. Option 2 (Page #) prompts for a Page #. Enter the
page you want the block moved to. You will automatically go to
that page.

Move Cursor; press to Retrieve.

You can turn on Reveal Codes to aid positioning the text within
format codes.

Repeat Block
This option allows you to repeat a block within a document. It
prompts you with

Repeat BLOCK how many times:

Save to a File
This selection saves a block of text to a new file or files.

BLOCK NAME: This prompt asks for the name of the new file that
will contain the block.
If the name you type belongs to a file that already exists, the
macro prompts:

File already exists:

0 Retry: Brings back the BLOCK NAME: prompt.
1 Append: Adds the block of copy to the end of the named file
2 Replace: Deletes everything in the named file and replaces it
with the block.

Print Block
This option automatically prints a block on the currently
selected printer.

Copy to Envelope
This macro creates an envelope as the last page of your document
and copies the blocked text (presumably an address) to the proper
position on the envelope. You must have an envelope form in your
printer definition for this to work correctly.

This macro is intended to print on an HP LaserJet II. The printer
will pause and display a message of: "PF - FEED COM-10." Adjust
the paper feed guides, open the rear hinged door, and feed in an
envelope with the flap beneath and to the left.

Switch case
This selection automatically changes the block to all upper- or
lowercase letters.

1 Uppercase
2 Lowercase

Change Font
This changes the Base Font for a selected block of text. Only
the text of the block will appear in the font that you select.
The text before and after the block remains in whatever font was
set previously in the document.

A list of Base Fonts appears. Highlight the desired font and
press .
Merge Menu

These macros make creating and managing secondary merge files
easier. The secondary files created use named fields, which
means you can reference the field by number (1^) or by name
(Last Name^). (For more information on using named fields in
secondary merge files, see the WordPerfect manual.)

Merge File Maker
This macro makes creating a secondary merge file easier. It
prompts you for input, and does the hard work of putting the
necessary merge codes into the file. It also puts extra codes in
the file header so the "Add to Merge File" option, below, can be
used to add records to a file at a later time.

Enter the number of fields: That is, the number of fields each
record will contain.

Please enter the name of FIELD #1, etc.: For example, field #1
might be called Last Name, field 2 First Name etc.
As the field names are entered, they appear on the screen:

Last Name:

First Name:

Once the number of field names equal the number you have entered,
the following message appears above the field names:

Please Enter Field Information.
Press to EXIT Merge File Maker.

At this point, the cursor rests at the location of the first
field entry. After entering the first field information, press
and the cursor will go to the next field.

Once past the first field information, the message Press to
EXIT Merge File Maker changes to Press to UNDO the previous
field so any mistakes can be corrected. At the beginning of each
record, the message reverts to Press to EXIT Merge File

Note: This macro will not directly make fields of more than one
line. One way to use the macro to make fields of two lines would
be to enter the two lines as one, substituting an asterisk for
the Hard Return (1234 Halibut Way*Icehouse, ME 77777). After the
secondary file is complete, do a Replace , replacing the
asterisks with Hard Returns.

Add to Merge File
This makes it easy to add records to an existing secondary merge
file created using WonderMenu's "Merge File Maker" (see above).
Before selecting this option, be sure to retrieve a secondary
merge file created with "Merge File Maker". If no secondary
merge file is displayed on screen, the prompt

Secondary Merge File must be retrieved first.
Name of secondary merge file to retrieve:

is displayed. Enter the name of the desired secondary merge file.

The macro reads field names from the file's header, then prompts
you for the new information, placing the new records at the end
of the file. Pressing at the end of a record will exit this

Sort Merge File
This selection sorts any secondary merge file that was created
using the Merge File Maker option of the Merge menu or
WordPerfect Library's Notebook program. It "reads" and displays
the field names from the secondary file's header and then asks
you which field you want to sort the file on. Currently, the
sort is limited to one field.

Before selecting this option, be sure to retrieve the secondary
merge file first. If no secondary merge file is displayed on the
screen, the prompt

Secondary Merge File must be retrieved first.
Name of secondary merge file to retrieve:

is displayed. Enter the name of the desired secondary merge

The macro reads field names from the file's header and inputs
them to the screen with a corresponding number. The prompt

Enter Number of Field to Sort by:

is displayed. Enter the number of the field you wish to sort by
and press . The secondary file will then be sorted.

Address Book Maker
This macro creates secondary merge files in a convenient format
for addresses. Each address is one record, and the name,
address, city, state, and ZIP are each one field. The result is
a useful standard secondary merge file which can be sorted by any
field. WonderMenu's "Add to Merge File" option (see above) works
with "Address Book" files. "Insert Address Codes" and "Address
Label Merge" (see below) are designed to work with "Address Book"

Press after typing the data for each field.


Address Line 1:

Address Line 2:




Phone Number:

Hit When Done: After the phone number is entered, the
cursor returns to the Name prompt. If no more records are to be
added, press . (This prompt only appears when it is
appropriate to exit "Address Book Maker").

Insert Address codes
Invoke this macro in a primary file at a point where you want to
merge in an address from an "Address Book Maker" secondary file.
It inserts the following codes:


City^, ST^ ZIP^

The question mark in the third line ensures that no blank line is
inserted if some records do not contain Address Line 2. No
prompts are displayed.

Address Label Mrg
This selection makes creating address labels easy, from an
"Address book" file (see above) or from any 4-field secondary
merge file. The macro produces labels formatted for a 30-label
page or a 33-label page. After an option is selected, the prompt
is: Secondary Merge File Name:. Enter the name of the secondary
file, and the merge begins.
Print like any other document; feed the labels with the label
side up.
Edit Menu

This menu contains four versions of the same macro which allow a
user to edit Header A, Header B, Footer A, or Footer B. It does
not matter where the user is in the document.

Edit Header A
This choice allows the user to edit Header A in the document.

Edit Header B
This choice allows the user to edit Header B in the document.

Edit Footer A
This choice allows the user to edit Footer A in the document.

Edit Footer B
This choice allows the user to edit Footer B in the document.
Tools Menu

This menu contains a few "Wouldn't it be nice if..." macros.

Margins In
This macro automatically brings the right margin in to 3" so you
can read a whole line on the screen when using a proportional
font. It marks the new margin with <<>>. The margins
can be automatically restored with the "Margins/Draft Out" macro.

Draft In
This macro marks a document as a DRAFT version. It inserts
<<>> in large letters on your document. When the
document is final, just select "Margins/Draft Out" (see below).

Margins/Draft Out
Deletes the symbols <<< >>> and all text/codes contained within
the symbols. It is used to remove codes inserted by the "Margins
In" and the "Draft In" items of this menu. It will also work on
any other text and/or codes you may wish to automatically delete,
as long as they are within the symbols <<< and >>>.

Tab Ruler
This macro superimposes a Tab Ruler across the bottom of your
screen to help you measure tab spacings.

Split Screen
This macro splits your screen so two documents can be displayed
simultaneously. You can Switch from the top document to the
bottom document by pressing . The next selection,
"Normal Screen", returns you to a single document.

Normal Screen
Returns you to a single document screen. Reverses the "Split
Screen" and "Tab Ruler" selections.
Custom Menu

This menu is for those who have some experience working with
WordPerfect's macro language. It is available so that you can
put your own macros or forms on a menu. The filename of the
macro is -WMENU7.wpm, and its corresponding help file is -
WMhlp7.wpm. The macro is large, and may require that you have
the stand-alone Macro Editor 5.0 for you to edit it. There are
comments in the macro that will help you figure out how to put
items on the menu. More detailed instructions will be available
to those who order(ed) the Documented Macro List when ordering

Register Menu

Registration Notice
This screen displays WonderMenu's registration notice, and
displays who the copy is registered to.

Order Form
This option will Fill out an order form for WonderMenu using the
Form-Fill interpreter. If you have already registered, then you
really don't need to use this .

Form-Fill Commands
This sub-menu allows you to pick Form-fill commands, and have
them inserted into your document at the cursor position. The
menu is also directly available from the editing screen if you
are using the WMENU.WPK keyboard definition. To popup the menu,
type .
Document Automation System

The Form-fill language is a macro that provides an easy way to
automatically fill out forms. Using WordPerfect, anyone can
create standard document formats or Templates. With the addition
of Form-Fill lanuguage commands, These templates prompt the user
for information and place it in specified places in the document.
In other words, Form-fill eliminates the need to write a specific
macro to automate every form you create or use. Now the same
macros can turn any document into an on-screen "fill in the
blanks" form.

To use the Form-fill language, create a standard WordPerfect
document, with all formatting codes, headers, footers, boxes,
lines etc. in place. Then place Form-fill Variables and Commands
(documented below) into your document to prompt for variable
information. To enter Form-Fill commands into your document you
can pick them from the "Form-Fill Commands" option of the
Register menu; or, if you have are using the WMENU.WPK keyboard
definition, you can type to popup the same "Form-
Fill Commands" menu.
The commands or variables should be placed in your document in
the exact places that you want the text that will replace them to
go. For example, if you want to put a name on the third line of a
document, and you want the name to be bolded, you would put the
variable "{Name}" into the document on the third line between
Bold codes.

For specifics on each of the Form-fill commands please see the
section COMMANDS below.

Once you have created a form, and added appropriate variables,
save the file in your FORMS directory (usually C:\WP50\FORMS).
The file will be used as a template and will be merged into a
clean editing screen before the Form-fill interpreter is invoked.
This forces you to give the document a name if you want to save
it, rather than saving it under the name of your template file,
and wiping it out.
For a simple example of how to use the Form-fill language, we'll
customize the template for an interoffice memo. We'll make a
template that already has your name and department filled in.
First, retrieve the file -MEMO.FRM from C:\WP50\FORMS.

With -MEMO.FRM in the editing screen, notice the variables
located between the braces. It is these variables that the Form-
fill interpreter looks for and converts to prompts on the screen.
You will replace three of the variables, namely {Sender's Name},
{Sender's Department}, and {Sender's Phone Number} with the name
of your department, your name, and your phone number.

- Simply move the cursor to the {Sender's Name} variable and
delete it.
- Now type in your name, without braces.
- Move to the {Sender's Department} variable and delete it.
- Now type in your department name, without braces.
- Move to the {Sender's Phone Number} variable and delete it.
- Now type in your phone number, without braces.

Now that you have changed the file, save it under a different
filename in the directory C:\WP50\FORMS. In this case, use your
last name for the filename. (If you write memos for several
people, you can create separate template files for each of them,
and save them under a filename of their last name or their

You now have a template. What next? Clear your screen to an
empty document and type to call up the WonderMenu Forms
menu. The item Custom Form-fill, is the item you want to execute.
Either use the cursor keys to highlight the selection and then
press , or type the mnemonic character C and press
. You will be prompted for a template filename. Enter
the name of the file you just created and press . You
will be prompted for where you want to retrieve the template to
(top of document, cursor position or bottom of document). Just
hit enter to accept the default, which is "top". The template
should be loaded, and the Form-fill interpreter started. The two
prompts you removed will no longer appear. Answer the prompts.
When you are done, a completed interoffice memorandum will be
ready to print.

Uses the Variable (any text you want to be used as an on-screen
prompt) in a message box to ask the user for input. Input is
placed in the document at the location where the {Variable} was

This command will prompt the user for a YES or NO answer to the
question posed by your {Variable}. If a "yes" answer is given,
the text and commands between {YES} and {NO} will be left in the
document and the text between {NO} and {ENDASK} will be deleted.
If a "no" answer is given, the text and commands between {NO} and
{ENDASK} will be left in the document and the text between {YES}
and {NO} will be deleted.

Puts the text of the current date in the document. This command
will work in a header or footer.

{DEFAULT}{Default Value}{Variable}
Identical to a regular {Variable}, but presents a default value
(on the prompt bar at the top of the screen), which can be
accepted by pressing . Typing anything but will
cancel the default value, and what you type will be placed into
the document instead of the default. For example, a prompt for
{Addresee's Name} could be changed to {DEFAULT}{Kurt
Jester}{Addresee's Name}.

1. the end of a {REPEAT} command
2. The position where the cursor will stop on completion of the
fill-in process. It should always be the last Form-fill
command in the document.

Tests the Condition and execute either a "True" block or a
"False" block, based on the results of the test. If the
Condition is true, then the "False" block is deleted, and the
text of the "True" block is left in the document. The text of
the Condition could be set by merging information, such as ages,
in from a secondary merge file. The Form-fill interpreter could
then be invoked to process the {IF} statements. For example:

The same could be accomplished by using the {REPLACE} command:

{REPLACE}{Age}...text of document...

It works the same as the Macro Commands {IF} statement, but does
not allow for nesting.

Inserts an indent code into the document. This accommodates a
situation that can arise when WordPerfect will not allow an
indent code to be input because the Form-fill commands on that
line cause it to extend past the last tab set.

{MACRO}{Macro Name}
Will execute the macro Macro Name, and continue processing, if
the following condition is kept: The called macro must end in a
Macro Commands {RETURN} command. Macros can be run inside a
Header or Footer but must be written taking into consideration
that they will not be executed from the main editing screen.

Operates inside a {REPEAT} loop only. It puts the number of the
current input line into the document at the location of the {NUM}

Pauses for direct input into the document, allowing for the
entering of hard returns, format codes, etc. Works the same as
the Macro Language's {PAUSE} command, but allows for multiple
hard returns to be hit. The Variable is used in an input prompt
line at the top of the document.

Used to replicate a block of a document, including all formatting
codes and {Variable}s between the {REPEAT} and the {END}
commands. After each line or block entered, the interpreter will
ask you if you want to enter another line. If you do enter
another line, the same prompts will be repeated. This is useful
when creating a form that requires lists of information to be

Replaces all occurrences of the {Variable} throughout the current
editing screen. It cannot be nested inside any other command,
but can be placed inside a header, footer, or the main editing
screen. After completing the Replace, it will return to the
location in the document where the {REPLACE} command was.

Retrieves a file into the current document, at the location of
the command. Can be used in conjunction with an {ASK} command to
include differing paragraphs or sets of Form-Fill commands from a
separate file.

This command can be used in your document to save it to a file.
If the file exists, it is replaced automatically. The user is not
prompted to see if they want to replace the file or not. If the
file is a new one, no filename will exist. In the case of a new
file, the user will be prompted for a filename. If that filename
already exists, then they are asked if they want to replace the
existing file, then they are asked for a new filename and the
process starts again.

This command can be used in your document to save it to the file
"filename". If the file Filename already exists, the user is
prompted to see if they want to replace the file or not. If they
do not want to replace the existing file, then they are asked for
a new filename and the process starts again.

Inserts a tab code into the document. This accommodates a
situation that can arise when WordPerfect will not allow a tab
code to be input because the Form-fill commands on that line
cause it to extend past the last tab set. Clayton Groom
156 South Meridith #130
Pasadena, CA 91106
(CIS: 72470,1100)

* WonderMenu Registration Payment Form *

To order your registered copie(s) of WONDERMENU please fill out
the form below. Please use your mailing address only.
Shipments are normally made via U.S. First Class mail.

Date: ________

Name: ____________________ Title: _____________
Company: _________________
Address: ___________________________
Work Phone: {Work Phone} Home Phone: {Home Phone}
Compuserve Number: {Compuserve Number}

Please complete the worksheet below and include payment.
California State residents add sales tax.

Qty Description Per Unit Cost Total Cost

____ WonderMenu System 25.00 __________
____ Documented macro list 10.00 __________

Subtotal __________

California residents add Sales Tax __________

Total Enclosed __________

Orders are regularly sent on 360K 5.25" floppies. If you would
Prefer 3.5" floppies, please indicate so.

5.25" ____ 3.5" _____