home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / WORD / WPWONDER.ZIP / WMENU.DOC < prev   
Text File  |  1989-10-06  |  44KB  |  1,060 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                              Wonder
  13.                               Menu
  14.  
  15.                          Pull-down Menu
  16.                                and
  17.                     Document Automation Macros
  18.                        For WordPerfect 5.0
  19.  
  20.  
  21.  
  22.  
  23.                                by
  24.  
  25.                           Clayton Groom
  26.                         (CIS: 72470,1100) Disclaimer and License
  27.  
  28. Your first use of WONDERMENU constitutes agreement to the
  29. following provisions.  If you do not agree to them, please do not
  30. use this program.
  31.  
  32. The macro programs that constitute the product "WonderMenu" are
  33. not "Public Domain" and they are not "Freeware".  WonderMenu, and
  34. Form-Fill are copyrighted software products and are owned by
  35. Clayton Groom.  You are free to modify the macros that make up
  36. the WonderMenu system for your own personal use only. You may not
  37. distribute for payment, commercial benefit, or other
  38. consideration, either the original or modified versions of the
  39. macro program(s).  You are encouraged to distribute the original,
  40. unmodified archived files for others to evaluate.  If you
  41. continue to use this product, you are required to register.  No
  42. fee may be charged for the distribution of the WonderMenu system
  43. without permission from the author. 
  44.  
  45. The WonderMenu menu shell may be licenced for use in distributing
  46. other macro products.  Those interested in licensing the menu
  47. shell and/or the Form-Fill interpreter, may contact us in writing
  48. for more details.  A Commercial Distribution, and a Consultants
  49. licence are available. 
  50.  
  51. This product is licensed "as is" without any warranty of
  52. merchantability of fitness for a particular purpose, performance,
  53. or otherwise; all warranties are expressly disclaimed.  By using
  54. the wondermenu system, you agree that neither Clayton Groom nor
  55. any employees, affiliates, or other related parties will be
  56. liable to you or any third party for any use of (or inability to
  57. use) or performance of this product, or for any damages
  58. whatsoever whether based on contract, tort or otherwise.  Even if
  59. we are notified of such possibility in advance.  (Some states do
  60. not allow the exclusion or limitation of incidental or
  61. consequential damages, so the foregoing limitation may not apply
  62. to you.) 
  63.  
  64. Program and documentation Copyright (c) 1989 Clayton Groom.  All
  65. rights Reserved.  No part of this Documentation or program may be
  66. reproduced, photocopied, Stored on a retrieval system, or
  67. transmitted except as provided by the license above.
  68.  
  69. WordPerfect is a registered trademark of WordPerfect Corporation. 
  70. All other product names are trademarks of their respective
  71. owners.
  72.  
  73. Contact:  Clayton Groom            Compuserve user ID: 72470,1100
  74.           156 South Meridith #130
  75.           Pasadena, CA  91106
  76.  
  77.           Comments and suggestion are appreciated!
  78.  
  79. This manual is completely composed and typeset in WordPerfect 5.0
  80. Installation
  81.  
  82. From DOS, unarchive the files FORMS.ARC & MACROS.ARC into two
  83. directories on a floppy (i.e. A:\FORMS & A:\MACROS)
  84.  
  85. 1.  Run WordPerfect and look under Setup (<Shift F1>, L) to find
  86. out where your macros directory is located (it should be
  87. different from the directory where you have WP's program or data
  88. files.  If you do not have a Macros directory specified, then you
  89. need to create one now.  If you have a macro directory specified,
  90. go to the next step.
  91.  
  92. To create a sub-directory for your macros, return to the editing
  93. screen and press List Files <F5>, press = (the equal sign) to
  94. change the default directory.  Now type the complete path for
  95. your macros directory (i.e. "C:\WP50\MACROS"), and press <Enter>.
  96. If you are prompted by WordPerfect "Create C:\WP50\MACROS?
  97. (Y/N)," press Y (yes) to create the new directory.
  98. Press Setup <Shift F1>, L (7), K (3), and enter the name of the
  99. directory that you just created.
  100.  
  101. 2.  Check your macros directory to see if you already have an
  102. ALTM.WPM macro defined.  If you do, rename it to something else,
  103. so that it is not replaced by WonderMenu's ALTM macro.
  104.  
  105. 3.  Copy all the macro files from the floppy to your macros
  106. directory.  To do this, press List files <F5>, and enter the
  107. drive letter where the Wonder Menu Floppy is located (i.e A:) and
  108. press <Enter>.  Move the cursor bar to the "macros" sub-
  109. directory of the floppy and press <Enter> twice.  This should
  110. list all the macro files that are on the floppy.  Now type <Alt-
  111. F5> to mark all the files. Press "C" to "Copy" the macros, and
  112. when prompted "Copy marked files to:", enter the full path-name
  113. of your macros directory (i.e. C:\WP50\MACROS).
  114.  
  115. 4.  Create on your C: drive a directory for forms using the same
  116. method outlined above to make the MACROS directory.  The default
  117. setting is c:\WP50\FORMS
  118.  
  119. 5.  Copy all the files in the FORMS directory of the floppy to
  120. the FORMS directory you created on your hard disk using the same
  121. method outlined above.
  122.  
  123. 6.  If you are installing the WonderMenu files to directories
  124. different from the ones specified above, you will need to edit
  125. the macro "-PATH.WPM".   This macro contains the path information
  126. to point to the same directory where you put the ".FRM"  and
  127. ".MRG" files.To edit the macro type:
  128.           <Ctrl-F10>-PATH<Enter> E, A. 
  129. -PATH.WPM initially contains a path of "C:\WP50\FORMS\".  Change
  130. the text of the macro to contain the full path name of the
  131. directory where you put the forms.  Be sure to include the final
  132. back-slash "\", or things will go real weird. 
  133.  
  134. 7.  In order for the forms to work properly with your printer,
  135. they  will need to be converted into files for your printer. (If
  136. you have a Laserjet II definition already [HPLASEII.PRS], then
  137. this step is unnecessary.)  To do this, get into Wordperfect,
  138. select your default printer, and execute the macro FORMCONV.WPM
  139. (<Alt-F10>FORMCONV<Enter>).  It will retrieve into WordPerfect
  140. each form file (.FRM) from the "FORMS" directory  specified in
  141. step 5, causing it to be reformatted for your  default printer,
  142. and then save it back to the "FORMS" directory under the same
  143. filename.  What this does is convert  the forms from a Laserjet
  144. II document to a document for your default printer.  Now when you
  145. select MEMORANDUM from the  menu, the form will be formatted for
  146. your default printer.
  147.  
  148. CAUTION:  This procedure will not work properly on some older
  149. releases of WP 5.0.  You may need to convert the forms manually,
  150. by retrieving them, re-selecting your Default Printer, and then
  151. saving the forms again.  A better Alternative is to contact
  152. WordPerfect and order the latest interim release of 5.0 (WP
  153. orders Dept. 800-312-4566).  WP 5.0 releases since 4-29-89 can
  154. reformat a document automatically for your default printer
  155. without creating an error message, and the conversion process
  156. works correctly.  Older version (1988) will add a "Phantom
  157. printer" to the list of printers, and will not convert the
  158. document until you manually re-select your default printer.
  159.  
  160. 7.  To invoke Wondermenu, you can select the WMENU.WPK keyboard
  161. definition under Setup and use any one of several Alt-Key
  162. combinations to invoke WonderMenu, or if you don't want to use
  163. the keyboard definition, you can use the Alt-M macro. Differences
  164. between the two methods are explained in the following
  165. documentation.  If the menu system does not appear, check your
  166. setup to be sure that your macro directory is set to the
  167. directory where you installed the macros.
  168.  
  169. That should complete the installation!  If you have any major
  170. difficulties getting the system to work, send me a message on
  171. Compuserve, (72470,1100), or write me concerning the difficulty. 
  172.                    WonderMenu
  173.                     The Macro Menu System
  174.  
  175.  
  176. WonderMenu is a set of WordPerfect macros that produces "pull-
  177. down" style menus.  WonderMenu contains about 35 functions useful
  178. for preparing Business forms or other documents, and was written
  179. with the typical business user in mind.  To invoke WonderMenu,
  180. press <Alt-M> from within WordPerfect; the menu system will
  181. appear over the current screen.
  182.  
  183.  
  184. Navigating in WonderMenu
  185. WonderMenu's macros are organized in eight "pull-down"  menus
  186. (with room for four additional menus).  Only one menu is visible
  187. at a time.
  188. To select a menu item, use the arrow keys to move the cursor to
  189. the desired selection, then press <Enter>, or press the desired
  190. selection's highlighted letter.  The macro will begin running at
  191. your cursor's location.
  192.  
  193. There are several ways you can access other menus:
  194.  
  195. With WMENU.WPK selected as a keyboard definition (under Setup),
  196. you start WonderMenu by typing <Alt-W>.
  197. With WMENU.WPK de-selected, you can start WonderMenu by typing
  198. <Alt-M>.
  199. Both of these methods will bring up the menus "Topbar".  From the
  200. topbar, you can enter a letter to pull-down the menu that the
  201. mnemonic (letter) corresponds to, and that menu will be
  202. displayed.
  203. You can also press the  <Right Arrow> or <Left Arrow> to
  204. highlight a different menu heading, and then press <Down Arrow>
  205. or <Enter> to display the corresponding menu.
  206. Once a menu is displayed, you can press the <Right Arrow> or
  207. <Left Arrow> key to move to an adjacent menu.
  208. To switch directly from one menu to another, you can type <Ctrl-
  209. Letter> where "Letter" is the mnemonic for the menu you want;
  210. i.e. <Ctrl-B> to move to the BLOCK menu.
  211. Press <Escape> or <Space> to exit the current menu and display
  212. the "Topbar", then enter a mnemonic letter to select another
  213. menu.
  214. Pressing <Cancel> or <Exit> will exit out of WonderMenu and
  215. return to the Editing Screen.
  216. <Cancel> can also be used to exit some menu choices (i.e. Bullet
  217. list maker) and return you to the menu, where you selected the
  218. item.
  219.  
  220. WMENU.WPK
  221. To Activate WonderMenu and have it go directly to the menu you
  222. want, you can Type <Alt-Letter>, where "Letter" is the mnemonic
  223. for the menu you want.  For this to work, you must have selected
  224. the WMENU.WPK keyboard definition under SETUP (see installation
  225. instructions).  WMENU.WPK also has other useful macros included
  226. in it for your convenience.  For example the HELP key has been
  227. redefined to produce a horizontal key template, as well as tell
  228. you what other special keys are available.
  229.  
  230. The Menus
  231. Forms contains macros for several common business forms.  Designs
  232. contains macros for useful miscellaneous formats, such as labels
  233. for Pendaflex folders.  Block and Merge contain macros that
  234. simplify and expand the functions available in WP.  Edit contains
  235. macros which allow the editing of headers and footers.  Tools
  236. contains handy miscellaneous macros for controlling your screens
  237. appearance and readability.  Custom is a blank menu that is open
  238. for customization to those who like dabbling with macros.  There
  239. is also a macro called POPUP.WPM which you can use to create your
  240. own Alt-Key popup menus.
  241.  
  242. WonderMenu forms have been written for use with an HP LaserJet II
  243. or IID printer -- though will also work with other printers. 
  244. WordPerfect (April 29, 1989 or later release) will automatically
  245. convert the forms for your default printer, if you do not have a
  246. LaserJet printer definition.  If the release date of your
  247. WordPerfect program files is earlier than 4-29-89, it is highly
  248. recommended that you obtain an update from WordPerfect (800)-
  249. 321-4566.  Updates are free, or at a nominal cost.
  250.  
  251. Customizing Colors
  252.  WonderMenu's window colors are determined by the colors selected
  253. for Bold, Underline, Bold & Underline and Reverse Video in
  254. WordPerfect's Setup <Shift-F1, 3(D), 2(C), 1(S)>.  You may want
  255. to alter your color settings in order to make the menu look
  256. better.
  257. Blocked Text   This color is used for the cursor bar of the menus
  258. and the top line of the screen. It should contrast greatly from
  259. the color for normal text.
  260. Bolded Text    This color is used for the main field of the menu.
  261. If you want the menu to stand out from your document, change the
  262. background color of this setting to be different than the color
  263. for the normal editing screen.
  264. Underlined Text     This color is used for the second line of the
  265. screen topbar. It should have a different background color than
  266. the normal editing screen.
  267. Bold & underlined   This color is used for the highlighted
  268. mnemonic letters of the menus. Its background color should be the
  269. same as that for Bold, and its foreground color should be the
  270. same as for Underlined.
  271.  
  272. WonderMenu's Help System
  273. Press <F3> from anywhere in the menu system for context-
  274. sensitive help.  For instance, pressing <F3> while highlighting
  275. "Memorandum" brings up a help screen for the Memorandum form;
  276. pressing <F3> while highlighting "Envelope" brings up a help
  277. screen for the envelope form. (Note that <F3> is also Help on the
  278. WordPerfect template.)
  279.  
  280. The "About WonderMenu" selection in the Forms menu brings up a
  281. window with basic information on how to navigate in WonderMenu. 
  282. It also will show you what color selections you can change to
  283. change th appearance of WonderMenu.  Suggestion for best results: 
  284. Have the same background color for Bold, and Bold & Underlined.
  285.                    Forms Menu
  286.  
  287.  
  288. The options on this menu generate and help you complete certain
  289. business forms.
  290. The menu retrieves a file containing a blank copy, or template,
  291. of the form.  The "Form-Fill" macro then prompts you to enter
  292. appropriate details (remember that to enter something means to
  293. type it, then press <Enter>.)  If you wish to leave a space
  294. blank, just press <Enter>; you can come back and fill it in
  295. later.  The "Form-Fill" macro merges your answers with the
  296. template, producing a completed copy of a form, ready for the
  297. main text body to be typed.  (You may also type the text first,
  298. move to the top of the document, type <Alt-M>, and make a
  299. selection to produce the desired form).  The "Forms" macro fills
  300. in the current date as text automatically.   Save and edit the
  301. form just as you would any WordPerfect document.  Some forms
  302. insert automatic headers on the second and succeeding pages; edit
  303. these with <Shift-F8, 2(P), 3(H), 1(A), 5(E)> or use the "Edit
  304. Header options on the Edit menu.
  305.  
  306. Memorandum
  307. This selection produces an interoffice memorandum.
  308.  
  309. Fax cover sheet
  310. This is for making a FAX coversheet/message.
  311.  
  312. Letterhead Letter
  313. This option formats a business letter for letterhead stationery
  314. (with a two-inch margin).  Prompts are:
  315. Please Enter Person To:  This will be the first line of the
  316. inside address.
  317.  
  318. Please Enter Address Line 1:
  319.  
  320. Please Enter Address Line 2:
  321.  
  322. Is There a Third Address Line? (Y/N)  If a Y is entered, the
  323. prompt Please Enter Address Line 3: will be displayed.  If not,
  324. the macro moves to the next prompt.
  325.  
  326. Please Enter Salutation:
  327.  
  328. Please Enter the Text of the Letter:  The letter's text will
  329. appear in its proper place in the letter.  When the body is
  330. complete, press <F7>.  If you prefer to compose the body after
  331. the macro finishes, just press <F7>.
  332.  
  333. All margin/draft markers deleted.  This message appears because
  334. "Margins/Draft Out," from the Tools menu, has been run (see
  335. below).
  336.  
  337. Please Enter Sender's Name:
  338.  
  339. Please Enter Sender's Title:
  340.  
  341. Please Enter Secretary's Initials:
  342.  
  343.  
  344. Business Letter
  345. This performs exactly the same as the "Letterhead" form, but asks
  346. for the sender's address and centers the document on the page.
  347.  
  348. Envelope
  349. This formats a long business envelope (9.5" x 4").  It assumes
  350. you are using a pre-printed envelope, so it does not prompt for a
  351. return address.  You must have an envelope form in your printer
  352. definition for this to work correctly.
  353.  
  354. Enter Name:
  355.  
  356. Enter Address Line #1:
  357.  
  358. Enter Address Line #2:
  359.  
  360. Enter Address Line #3 -- <Enter> if None:
  361.  
  362. This macro is intended to print on an HP LaserJet II. The printer
  363. will pause and display  
  364. "PF - FEED COM-10".  Adjust the paper feed guides, open the rear
  365. hinged door, and feed in an envelope with the flap beneath and to
  366. the left. 
  367.  
  368. Custom Form-fill
  369. You may wish to customize some of the forms -- make a fax form
  370. that always includes your fax telephone number, for instance, or
  371. a memo that automatically fills in your name or your
  372. supervisor's.  The "Custom Form-Fill" option helps you to fill in
  373. customized templates you have created.  
  374.  
  375. To create a customized template, first retrieve the standard
  376. template from C:\WP50\FORMS.  The Memorandum template is
  377. C:\WP50\FORMS\-MEMO.FRM; the fax form is -FAX-I.FRM; the business
  378. letter is 
  379. -BUSLTR.FRM; the letterhead letter is 
  380. -LTRHEAD.FRM.  Other examples of Form-Fill files can also be
  381. found in the directory.
  382.  
  383. Commands and variables within the templates are enclosed in
  384. brackets.  Commands are in all-caps and variables are in mixed
  385. case.  You can change any of the mixed case text of the templates
  386. with out affecting their function.  Replace any variables you
  387. wish with permanent information, removing the brackets as well as
  388. the text of the variable. For instance, in -MEMO.FRM, you might
  389. delete {Sender's Name}, replacing it with Mary Doe; {Sender's
  390. Department}, replacing it with Accounting; and delete {Sender's
  391. Phone Number}, replacing it with 304-6092.  Then save the
  392. template in the forms directory: C:\WP50\FORMS\(any filename you
  393. choose).  Your initials, or a one-letter name may prove most
  394. convenient: m for memo, for instance.
  395.  
  396. To use the new template, select Custom Form-fill in WonderMenu. 
  397. The prompt Enter Form Name will appear; enter the name you
  398. assigned to your customized template, such as mem.  (You need
  399. only enter the filename; the macro will automatically look for it
  400. in C:\WP50\FORMS. If the file is not found in C:\WP50\FORMS, the
  401. macro will look in your current directory for the file.
  402. If you do not enter a file name, then the macro will use your on-
  403. screen document as a template file.) The "Forms" macro will
  404. continue as usual, but will skip the prompts you have already
  405. filled in.
  406.  
  407. You can create any number of customized templates for each form. 
  408. For more information on the Form-Fill language used in the
  409. template files, see the Form-Fill Language section in this
  410. documentation.
  411.  
  412.  
  413. About WonderMenu
  414. A window describing WonderMenu appears.
  415.                    Designs Menu
  416.  
  417.  
  418. These macros set up several helpful WordPerfect design layouts.
  419.  
  420. Bullet List
  421. The sub-menu allows you to decide the tab settings for the list
  422. as well as what character will be used beside each list item.  If
  423. you want to change the default tab settings, do so before
  424. choosing the type of bullet character.
  425.  
  426. The bullet list choices include the following:
  427.  
  428.      the normal bullet
  429.      the check box
  430. ■    the square 
  431.     the diamond
  432. ■    the hollow bullet
  433. ■    the small bullet
  434. Any character the user defines.
  435. How some of the selections print out will depend on the
  436. capabilities of your printer.
  437.  
  438. Change Tab Settings:  Highlight this option if you want to change
  439. the default bullet (1.7") and text (1.9") positions.  Once you
  440. have changed the tab settings, press the highlighted letter for
  441. the bullet type you wish for your listing and the new tabs will
  442. be in effect for the list. 
  443.  
  444. The bullet list starts immediately once the type of bullet has
  445. been chosen.  After completing each item entry, press <Enter> to
  446. go to the next list item.  You may enter new items indefinitely. 
  447. To exit the bullet list, press <F7>.  When <F7> is pressed, the
  448. macro changes the tab setting back to the default (tabs set every
  449. .5") and ends.
  450.  
  451. Pendaflex label
  452. This macro quickly makes label tabs for Pendaflex folders -- and
  453. the typewriter takes one more step toward the door!  No prompts
  454. are displayed; after invoking the macro, just type all folder
  455. titles you need, pressing <Enter> after each one.  Then print. 
  456. The labels appear in Swiss Roman 12 point.  You will need to cut
  457. them by hand or with a paper cutter.
  458.  
  459. File cabinet label
  460. Quickly makes file cabinet labels.
  461.  
  462. Enter Main Title:
  463.  
  464. Enter Sub-line #1:
  465.  
  466. Enter Sub-line #2:
  467.  
  468. Enter another (Y/N): Y
  469. Press Y or <Enter> to make another label. The prompts will
  470. repeat, so you can make as many labels as you need.  After you
  471. have finished the last label, press N.  The main title appears in
  472. Swiss Roman 18 point; sub-lines appear in Swiss Roman 14 point.
  473. Each label is in a graphics box which facilitates cutting.
  474.                    Block Menu
  475.  
  476.  
  477. Some of these macros are useful shortcuts for defining and
  478. manipulating blocks of text or graphics.  Others are simply menu-
  479. oriented variations of WordPerfect functions 
  480. If you select a block before typing <Alt-M>, then WonderMenu will
  481. automatically go to the block menu.  All Block items can work two
  482. ways:  If invoked when a block is already defined, they will
  483. perform the menu selection you choose immediately.  If invoked
  484. without a block defined, they will force you to define a block
  485. with prompts reading:
  486.  
  487. Place cursor at beginning of block and press <Enter>
  488.  and 
  489. Place cursor at end of block and press <Enter>.
  490.  
  491.  
  492. Copy Block
  493. In addition to copying a block within a document, this selection
  494. copies a block between Document 1 and Document 2.
  495.  
  496. Copy to:  0  Current page
  497.           1  Other Document 
  498.           2  Page #
  499.  
  500. Option 1 (Other Document) automatically switches to your other
  501. document. If you don't have a second document, the macro creates
  502. one for you. Option 2 (Page #) prompts for a Page #.  Enter the
  503. page you want the block copied to. You will automatically go to
  504. that page.
  505.  
  506. Move Cursor; press <Enter> to Retrieve.
  507.  
  508. You can turn on Reveal Codes to aid positioning the text within
  509. format codes.
  510.  
  511. Move Block
  512. In addition to moving a block within a document, this selection
  513. moves a block between Document 1 and Document 2.
  514.  
  515. Move to:  0  Current page
  516.           1  Other Document 
  517.           2  Page #
  518.  
  519. Option 1 (Other Document) automatically switches to your other
  520. document. If you don't have a second document, the macro creates
  521. one for you. Option 2 (Page #) prompts for a Page #.  Enter the
  522. page you want the block moved to. You will automatically go to
  523. that page.
  524.  
  525. Move Cursor; press <Enter> to Retrieve. 
  526.  
  527. You can turn on Reveal Codes to aid positioning the text within
  528. format codes.
  529.  
  530. Repeat Block
  531. This option allows you to repeat a block within a document.  It
  532. prompts you with 
  533.  
  534. Repeat BLOCK how many times: 
  535.  
  536. Save to a File
  537. This selection saves a block of text to a new file or files.  
  538.  
  539. BLOCK NAME:  This prompt asks for the name of the new file that
  540. will contain the block.
  541. If the name you type belongs to a file that already exists, the
  542. macro prompts:
  543.  
  544. File already exists:
  545.  
  546. 0  Retry:  Brings back the BLOCK NAME: prompt.
  547. 1  Append:  Adds the block of copy to the end of the named file
  548. 2  Replace:  Deletes everything in the named file and replaces it
  549. with the block.
  550.  
  551. Print Block
  552. This option automatically prints a block on the currently
  553. selected printer.
  554.  
  555. Copy to Envelope
  556. This macro creates an envelope as the last page of your document
  557. and copies the blocked text (presumably an address) to the proper
  558. position on the envelope.  You must have an envelope form in your
  559. printer definition for this to work correctly.
  560.  
  561. This macro is intended to print on an HP LaserJet II. The printer
  562. will pause and display a message of: "PF - FEED COM-10."  Adjust
  563. the paper feed guides, open the rear hinged door, and feed in an
  564. envelope with the flap beneath and to the left.
  565.  
  566. Switch case
  567. This selection automatically changes the block to all upper- or
  568. lowercase letters.
  569.  
  570. 1  Uppercase
  571. 2  Lowercase
  572.  
  573. Change Font
  574. This changes the Base Font for a selected block of text.  Only
  575. the text of the block will appear in the font that you select. 
  576. The text before and after the block remains in whatever font was
  577. set previously in the document.
  578.  
  579. A list of Base Fonts appears.  Highlight the desired font and
  580. press <Enter>.
  581.                    Merge Menu
  582.  
  583. These macros make creating and managing secondary merge files
  584. easier.  The secondary files created use named fields, which
  585. means you can reference the field by number (1^) or by name
  586. (Last Name^).  (For more information on using named fields in
  587. secondary merge files, see the WordPerfect manual.)
  588.  
  589. Merge File Maker
  590. This macro makes creating a secondary merge file easier.  It
  591. prompts you for input, and does the hard work of putting the
  592. necessary merge codes into the file.  It also puts extra codes in
  593. the file header so the "Add to Merge File" option, below, can be
  594. used to add records to a file at a later time.
  595.  
  596. Enter the number of fields:  That is, the number of fields each
  597. record will contain.  
  598.  
  599. Please enter the name of FIELD #1, etc.:  For example, field #1
  600. might be called Last Name, field 2 First Name etc.
  601. As the field names are entered, they appear on the screen: 
  602.  
  603. Last Name:
  604.  
  605. First Name:
  606.  
  607. Once the number of field names equal the number you have entered,
  608. the following message appears above the field names:
  609.  
  610. Please Enter Field Information.
  611. Press <F1> to EXIT Merge File Maker.
  612.  
  613. At this point, the cursor rests at the location of the first
  614. field entry.  After entering the first field information, press
  615. <Enter> and the cursor will go to the next field.
  616.  
  617. Once past the first field information, the message Press <F1> to
  618. EXIT Merge File Maker changes to Press <F1> to UNDO the previous
  619. field so any mistakes can be corrected.  At the beginning of each
  620. record, the message reverts to Press <F1> to EXIT Merge File
  621. Maker.
  622.  
  623. Note:  This macro will not directly make fields of more than one
  624. line.  One way to use the macro to make fields of two lines would
  625. be to enter the two lines as one, substituting an asterisk for
  626. the Hard Return (1234 Halibut Way*Icehouse, ME 77777).  After the
  627. secondary file is complete, do a Replace <Alt-F2>, replacing the
  628. asterisks with Hard Returns.
  629.  
  630. Add to Merge File
  631. This makes it easy to add records to an existing secondary merge
  632. file created using WonderMenu's "Merge File Maker" (see above).  
  633. Before selecting this option, be sure to retrieve a secondary
  634. merge file created with "Merge File Maker".  If no secondary
  635. merge file is displayed on screen, the prompt 
  636.  
  637. Secondary Merge File must be retrieved first.
  638. Name of secondary merge file to retrieve:
  639.  
  640. is displayed. Enter the name of the desired secondary merge file.
  641.  
  642. The macro reads field names from the file's header, then prompts
  643. you for the new information, placing the new records at the end
  644. of the file.  Pressing <F1> at the end of a record will exit this
  645. option.
  646.  
  647. Sort Merge File
  648. This selection sorts any secondary merge file that was created
  649. using the Merge File Maker option of the Merge menu or
  650. WordPerfect Library's Notebook program.  It "reads" and displays
  651. the field names from the secondary file's header and then asks
  652. you which field you want to sort the file on.  Currently, the
  653. sort is limited to one field.
  654.  
  655. Before selecting this option, be sure to retrieve the secondary
  656. merge file first.  If no secondary merge file is displayed on the
  657. screen, the prompt 
  658.  
  659. Secondary Merge File must be retrieved first.
  660. Name of secondary merge file to retrieve:
  661.  
  662. is displayed.  Enter the name of the desired secondary merge
  663. file.
  664.  
  665. The macro reads field names from the file's header and inputs
  666. them to the screen with a corresponding number.  The prompt
  667.  
  668. Enter Number of Field to Sort by:
  669.  
  670. is displayed.  Enter the number of the field you wish to sort by
  671. and press <Enter>.  The secondary file will then be sorted.
  672.  
  673. Address Book Maker
  674. This macro creates secondary merge files in a convenient format
  675. for addresses.  Each address is one record, and the name,
  676. address, city, state, and ZIP are each one field.  The result is
  677. a useful standard secondary merge file which can be sorted by any
  678. field.  WonderMenu's "Add to Merge File" option (see above) works
  679. with "Address Book" files.  "Insert Address Codes" and "Address
  680. Label Merge" (see below) are designed to work with "Address Book"
  681. files.
  682.  
  683. Press <Enter> after typing the data for each field.
  684.  
  685. Name:
  686.  
  687. Address Line 1:
  688.  
  689. Address Line 2:
  690.  
  691. City:
  692.  
  693. State:
  694.  
  695. ZIP:
  696.  
  697. Phone Number:
  698.  
  699. Hit <F1> When Done:  After the phone number is entered, the
  700. cursor returns to the Name prompt.  If no more records are to be
  701. added, press <F1>.  (This prompt only appears when it is
  702. appropriate to exit "Address Book Maker").
  703.  
  704. Insert Address codes
  705. Invoke this macro in a primary file at a point where you want to
  706. merge in an address from an  "Address Book Maker" secondary file. 
  707. It inserts the following codes:
  708.  
  709. Name^
  710. Address1^
  711. Address2?^
  712. City^, ST^  ZIP^
  713.  
  714. The question mark in the third line ensures that no blank line is
  715. inserted if some records do not contain Address Line 2.  No
  716. prompts are displayed. 
  717.  
  718. Address Label Mrg
  719. This selection makes creating address labels easy, from an
  720. "Address book" file (see above) or from any 4-field secondary
  721. merge file.  The macro produces labels formatted for a 30-label
  722. page or a 33-label page.  After an option is selected, the prompt
  723. is:  Secondary Merge File Name:.  Enter the name of the secondary
  724. file, and the merge begins.   
  725. Print like any other document; feed the labels with the label
  726. side up.
  727.                    Edit Menu
  728.  
  729.  
  730. This menu contains four versions of the same macro which allow a
  731. user to edit Header A, Header B, Footer A, or Footer B.  It does
  732. not matter where the user is in the document.
  733.  
  734. Edit Header A
  735. This choice allows the user to edit Header A in the document.
  736.  
  737. Edit Header B
  738. This choice allows the user to edit Header B in the document.
  739.  
  740. Edit Footer A
  741. This choice allows the user to edit Footer A in the document.
  742.  
  743. Edit Footer B
  744. This choice allows the user to edit Footer B in the document.
  745.                    Tools Menu
  746.  
  747.  
  748. This menu contains a few "Wouldn't it be nice if..." macros.
  749.  
  750. Margins In
  751. This macro automatically brings the right margin in to 3" so you
  752. can read a whole line on the screen when using a proportional
  753. font. It marks the new margin with <<<Margins In>>>.  The margins
  754. can be automatically restored with the "Margins/Draft Out" macro.
  755.  
  756. Draft In
  757. This macro marks a document as a DRAFT version.  It inserts
  758. <<<DRAFT>>>  in large letters on your document.  When the
  759. document is final, just select "Margins/Draft Out" (see below).
  760.  
  761. Margins/Draft Out
  762. Deletes the symbols <<< >>> and all text/codes contained within
  763. the symbols.  It is used to remove codes inserted by the "Margins
  764. In" and the "Draft In" items of this menu.  It will also work on
  765. any other text and/or codes you may wish to automatically delete,
  766. as long as they are within the symbols <<< and >>>.
  767.  
  768. Tab Ruler
  769. This macro superimposes a Tab Ruler across the bottom of your
  770. screen to help you measure tab spacings.
  771.  
  772. Split Screen
  773. This macro splits your screen so two documents can be displayed
  774. simultaneously.  You can Switch from the top document to the
  775. bottom document by pressing <Shift-F3>.  The next selection,
  776. "Normal Screen", returns you to a single document.
  777.  
  778. Normal Screen
  779. Returns you to a single document screen.  Reverses the "Split
  780. Screen" and "Tab Ruler" selections.
  781.                    Custom Menu
  782.  
  783.  
  784. This menu is for those who have some experience working with
  785. WordPerfect's macro language.  It is available so that you can
  786. put your own macros or forms on a menu.  The filename of the
  787. macro is -WMENU7.wpm, and its corresponding help file is -
  788. WMhlp7.wpm.  The macro is large, and may require that you have
  789. the stand-alone Macro Editor 5.0 for you to edit it.  There are
  790. comments in the macro that will help you figure out how to put
  791. items on the menu.  More detailed instructions will be available
  792. to those who order(ed) the Documented Macro List when ordering
  793. WonderMenu.
  794.  
  795.                     Register Menu
  796.  
  797. Registration Notice
  798. This screen displays WonderMenu's registration notice, and
  799. displays who the copy is registered to.
  800.  
  801. Order Form
  802. This option will Fill out an order form for WonderMenu using the
  803. Form-Fill interpreter.  If you have already registered, then you
  804. really don't need to use this .
  805.  
  806. Form-Fill Commands
  807. This sub-menu allows you to pick Form-fill commands, and have
  808. them inserted into your document at the cursor position.  The
  809. menu is also directly available from the editing screen if you
  810. are using the WMENU.WPK keyboard definition.  To popup the menu,
  811. type <Ctrl-Insert>.
  812.                    Form-Fill
  813.                     Document Automation System
  814.  
  815.  
  816. The Form-fill language is a macro that provides an easy way to
  817. automatically fill out forms.  Using WordPerfect, anyone can
  818. create standard document formats or Templates.  With the addition
  819. of Form-Fill lanuguage commands, These templates prompt the user
  820. for information and place it in specified places in the document.
  821. In other words, Form-fill eliminates the need to write a specific
  822. macro to automate every form you create or use.  Now the same
  823. macros can turn any document into an on-screen "fill in the
  824. blanks" form.
  825.  
  826. HOW TO USE:
  827. To use the Form-fill language, create a standard WordPerfect
  828. document, with all formatting codes, headers, footers, boxes,
  829. lines etc. in place. Then place Form-fill Variables and Commands
  830. (documented below) into your document to prompt for variable
  831. information.  To enter Form-Fill commands into your document you
  832. can pick them from the "Form-Fill Commands" option of the
  833. Register menu; or, if you have are using the WMENU.WPK keyboard
  834. definition, you can type <Ctrl-Insert> to popup the same "Form-
  835. Fill Commands" menu.
  836. The commands or variables should be placed in your document in
  837. the exact places that you want the text that will replace them to
  838. go. For example, if you want to put a name on the third line of a
  839. document, and you want the name to be bolded, you would put the
  840. variable  "{Name}" into the document on the third line between
  841. Bold codes.
  842.  
  843. For specifics on each of the Form-fill commands please see the
  844. section COMMANDS below.
  845.  
  846. Once you have created a form, and added appropriate variables,
  847. save the file in your FORMS directory (usually C:\WP50\FORMS). 
  848. The file will be used as a template and will be merged into a
  849. clean editing screen before the Form-fill interpreter is invoked. 
  850. This forces you to give the document a name if you want to save
  851. it, rather than saving it under the name of your template file,
  852. and wiping it out.
  853. EXAMPLE:
  854. For a simple example of how to use the Form-fill language, we'll
  855. customize the template for an interoffice memo.  We'll make a
  856. template that already has your name and department filled in. 
  857. First, retrieve the file -MEMO.FRM from C:\WP50\FORMS.
  858.  
  859. With -MEMO.FRM in the editing screen, notice the variables
  860. located between the braces.  It is these variables that the Form-
  861. fill interpreter looks for and converts to prompts on the screen. 
  862. You will replace three of the variables, namely {Sender's Name},
  863. {Sender's Department}, and {Sender's Phone Number} with the name
  864. of your department, your name, and your phone number.
  865.  
  866. -    Simply move the cursor to the {Sender's Name} variable and
  867.      delete it.
  868. -    Now type in your name, without braces.
  869. -    Move to the {Sender's Department} variable and delete it.
  870. -    Now type in your department name, without braces.
  871. -    Move to the {Sender's Phone Number} variable and delete it.
  872. -    Now type in your phone number, without braces.
  873.  
  874. Now that you have changed the file, save it under a different
  875. filename in the directory C:\WP50\FORMS. In this case, use your
  876. last name for the filename. (If you write memos for several
  877. people, you can create separate template files for each of them,
  878. and save them under a filename of their last name or their
  879. initials).
  880.  
  881. You now have a template. What next?  Clear your screen to an
  882. empty document and type <Alt-F> to call up the WonderMenu Forms
  883. menu. The item Custom Form-fill, is the item you want to execute. 
  884. Either use the cursor keys to highlight the selection and then
  885. press <Enter>, or type the mnemonic character C and press
  886. <Enter>.  You will be prompted for a template filename.  Enter
  887. the name of the file you just created and press <Enter>.  You
  888. will be prompted for where you want to retrieve the template to
  889. (top of document, cursor position or bottom of document).  Just
  890. hit enter to accept the default, which is "top".  The template
  891. should be loaded, and the Form-fill interpreter started.  The two
  892. prompts you removed will no longer appear.  Answer the prompts. 
  893. When you are done, a completed interoffice memorandum will be
  894. ready to print.
  895.                    COMMANDS & SYNTAX:
  896.  
  897. {Variable}
  898. Uses the Variable (any text you want to be used as an on-screen
  899. prompt) in a message box to ask the user for input. Input is
  900. placed in the document at the location where the {Variable} was
  901. located.
  902.  
  903. {ASK}{Variable}{YES}...{NO}...{ENDASK}
  904. This command will prompt the user for a YES or NO answer to the
  905. question posed by your {Variable}.  If a "yes" answer is given,
  906. the text and commands between {YES} and {NO} will be left in the
  907. document and the text between {NO} and {ENDASK} will be deleted.
  908. If a "no" answer is given, the text and commands between {NO} and
  909. {ENDASK} will be left in the document and the text between {YES}
  910. and {NO} will be deleted.
  911.  
  912. {DATE}
  913. Puts the text of the current date in the document.  This command
  914. will work in a header or footer.
  915.  
  916. {DEFAULT}{Default Value}{Variable}
  917. Identical to a regular {Variable}, but presents a default value
  918. (on the prompt bar at the top of the screen), which can be
  919. accepted by pressing <Enter>.  Typing anything but <Enter> will
  920. cancel the default value, and what you type will be placed into
  921. the document instead of the default.  For example, a prompt for
  922. {Addresee's Name} could be changed to {DEFAULT}{Kurt
  923. Jester}{Addresee's Name}.
  924.  
  925. {END}
  926. Signifies: 
  927. 1.   the end of a {REPEAT} command
  928. 2.   The position where the cursor will stop on completion of the
  929.      fill-in process. It should always be the last Form-fill
  930.      command in the document.
  931.  
  932. {IF}{Condition}...{ELSE}...{ENDIF}
  933. Tests the Condition and execute either a "True" block or a
  934. "False" block, based on the results of the test.  If the
  935. Condition is true, then the "False" block is deleted, and the
  936. text of the "True" block is left in the document.  The text of
  937. the Condition could be set by merging information, such as ages,
  938. in from a secondary merge file.  The Form-fill interpreter could
  939. then be invoked to process the {IF} statements. For example: 
  940. {IF}{^Fage^>21}...{ELSE}...{ENDIF}
  941.  
  942. The same could be accomplished by using the {REPLACE} command:
  943.  
  944. {REPLACE}{Age}...text of document...
  945. {IF}{{Age}>21}...{ELSE}...{ENDIF}
  946.  
  947. It works the same as the Macro Commands {IF} statement, but does
  948. not allow for nesting.
  949.  
  950. {INDENT}
  951. Inserts an indent code into the document.  This accommodates a
  952. situation that can arise when WordPerfect will not allow an
  953. indent code to be input because the Form-fill commands on that
  954. line cause it to extend past the last tab set.
  955.  
  956. {MACRO}{Macro Name}
  957. Will execute the macro Macro Name, and continue processing, if
  958. the following condition is kept:  The called macro must end in a
  959. Macro Commands {RETURN} command.  Macros can be run inside a
  960. Header or Footer but must be written taking into consideration
  961. that they will not be executed from the main editing screen.
  962.  
  963. {NUM}
  964. Operates inside a {REPEAT} loop only.  It puts the number of the
  965. current input line into the document at the location of the {NUM}
  966. command.
  967.  
  968. {PAUSE}{Variable}
  969. Pauses for direct input into the document, allowing for the
  970. entering of hard returns, format codes, etc.  Works the same as
  971. the Macro Language's {PAUSE} command, but allows for multiple
  972. hard returns to be hit.  The Variable is used in an input prompt
  973. line at the top of the document.
  974.  
  975. {REPEAT}...{END}
  976. Used to replicate a block of a document, including all formatting
  977. codes and {Variable}s between the {REPEAT} and the {END}
  978. commands.  After each line or block entered, the interpreter will
  979. ask you if you want to enter another line.  If you do enter
  980. another line, the same prompts will be repeated.  This is useful
  981. when creating a form that requires lists of information to be
  982. entered.
  983.  
  984. {REPLACE}{Variable}
  985. Replaces all occurrences of the {Variable} throughout the current
  986. editing screen.  It cannot be nested inside any other command,
  987. but can be placed inside a header, footer, or the main editing
  988. screen.  After completing the Replace, it will return to the
  989. location in the document where the {REPLACE} command was.
  990.  
  991. {RETRIEVE}{filename}
  992. Retrieves a file into the current document, at the location of
  993. the command.  Can be used in conjunction with an {ASK} command to
  994. include differing paragraphs or sets of Form-Fill commands from a
  995. separate file.
  996.  
  997. {SAVE}{filename}
  998. This command can be used in your document to save it to a file. 
  999. If the file exists, it is replaced automatically. The user is not
  1000. prompted to see if they want to replace the file or not.  If the
  1001. file is a new one, no filename will exist.  In the case of a new
  1002. file, the user will be prompted for a filename. If that filename
  1003. already exists, then they are asked if they want to replace the
  1004. existing file, then they are asked for a new filename and the
  1005. process starts again.
  1006.  
  1007. {SAVEAS}{filename}
  1008. This command can be used in your document to save it to the file
  1009. "filename".  If the file Filename already exists, the user is
  1010. prompted to see if they want to replace the file or not.  If they
  1011. do not want to replace the existing file, then they are asked for
  1012. a new filename and the process starts again.
  1013.  
  1014. {TAB}
  1015. Inserts a tab code into the document.  This accommodates a
  1016. situation that can arise when WordPerfect will not allow a tab
  1017. code to be input because the Form-fill commands on that line
  1018. cause it to extend past the last tab set. Clayton Groom 
  1019.                     156 South Meridith #130
  1020.                     Pasadena, CA 91106 
  1021.                          (CIS: 72470,1100) 
  1022.  
  1023.           ****************************************** 
  1024.           *  WonderMenu Registration Payment Form  * 
  1025.           ****************************************** 
  1026.  
  1027. To order your registered copie(s) of WONDERMENU please fill out
  1028. the form below.  Please use your mailing address only.
  1029. Shipments are normally made via U.S. First Class mail. 
  1030.  
  1031.  
  1032.                                         Date: ________
  1033.  
  1034. Name:  ____________________             Title: _____________ 
  1035. Company:  _________________ 
  1036. Address:  ___________________________ 
  1037.           ___________________________
  1038. Work Phone:  {Work Phone}     Home Phone:  {Home Phone} 
  1039. Compuserve Number:  {Compuserve Number} 
  1040.  
  1041. Please complete the worksheet below and include payment. 
  1042. California State residents add sales tax.
  1043. ALL CHECKS AND MONEY ORDERS MUST BE DRAWN ON U.S. ACCOUNTS ONLY. 
  1044.  
  1045. Qty       Description         Per Unit Cost       Total Cost 
  1046.  
  1047. ____     WonderMenu System        25.00          __________
  1048. ____     Documented macro list    10.00          __________
  1049.  
  1050.          Subtotal                                __________
  1051.  
  1052. California residents add Sales Tax               __________
  1053.  
  1054. Total Enclosed                                   __________
  1055.  
  1056.  
  1057. Orders are regularly sent on 360K 5.25" floppies.  If you would
  1058. Prefer 3.5" floppies, please indicate so.
  1059.  
  1060.    5.25" ____                      3.5" _____