home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / dbmenu.zip / DBMENU.DOC next >
Text File  |  1988-01-08  |  33KB  |  721 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                  dBMENU
  30.                  dBASE III + Menu Application Generator
  31.                          Version 4.0 - 01/07/88
  32.                   (c) BTSOFT Systems, Inc. - 1987, 1988
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                                     BTSOFT Systems, Inc.
  56.                                          MicroTek Consulting Group, Inc.
  57.                                                       Post Office Box 95
  58.                                             Hewlett, New York 11557-0095
  59.  
  60.  
  61.  
  62.  
  63.                                      dBMENU
  64.                                Table Of Contents
  65.  
  66.        I. Acknowledgments...........................................1
  67.       II. Introduction/Background...................................1
  68.      III. ShareWare.................................................1
  69.       IV. Registration..............................................1
  70.        V. Programming Conventions...................................2
  71.       VI. Environment...............................................2
  72.             Disk Space Requirements.................................2
  73.      VII. Technical Information.....................................2
  74.     VIII. License Agreement.........................................2
  75.       IX. Running...................................................3
  76.             A. Loading Options:.....................................3
  77.                 1. dBMENU [?] [filename] [/C] [/Q]..................3
  78.             B. Program Name.........................................3
  79.             C. Author (Optional)....................................4
  80.             D. Purpose (Optional)...................................4
  81.             E. Notes (Optional).....................................4
  82.             F. Menu Number..........................................4
  83.             G. Upper Right Corner (Optional)........................4
  84.             H. Menu Title...........................................5
  85.             I. Menu Subtitle (Optional).............................5
  86.             J. LightBar/Straight Menu...............................5
  87.             K. Color Selection......................................5
  88.             L. Force Selection Highlight............................5
  89.             M. Level Letter.........................................5
  90.                 1. Company Name (Optional)..........................5
  91.             N. Options - Yes/No Selectors...........................6
  92.                 1. Return to Previous Menu..........................6
  93.                 2. Return to Master Menu............................6
  94.                 3. Exit to DOS......................................6
  95.                 4. Option Explanation ..............................6
  96.                 5. dCode ...........................................6
  97.             O. Number of menu Options...............................6
  98.             P. Include Left Arrow Trap..............................7
  99.             Q. Screen Information...................................7
  100.                 1. dVariables.......................................7
  101.                 2. dBytes...........................................7
  102.                 3. Option Number....................................7
  103.                 4. Options Remaining................................7
  104.                 5. Option Selector..................................7
  105.                 6. Escape to Abort..................................7
  106.             R. Selection Letter/Number..............................7
  107.             S. Menu Option..........................................7
  108.             T. Option Message ......................................8
  109.             U. dCode ...............................................8
  110.             V. DO [.PRG file] ......................................8
  111.     X. Advanced Options.............................................8
  112.             A. Merged Code..........................................8
  113.     License Agreement (Form) .......................................9
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  120.  
  121.  
  122.  
  123.                                      dBMENU
  124.                      dBASE III + Menu Application Generator
  125.                              Version 4.0 - 01/07/88
  126.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  127.  
  128.                                                            BTSOFT Systems, Inc.
  129.                                                 MicroTek Consulting Group, Inc.
  130.                                                              Post Office Box 95
  131.                                                    Hewlett, New York 11557-0095
  132.                                                                      -----
  133.                                                                  (516) 599-1158
  134.                                                         (Eastern Standard Time)
  135.  
  136. I. Acknowledgments
  137.         dBASE, dBASE II, dBASE III, and dBASE III PLUS are registered 
  138.     trademarks of Ashton-Tate (Torrance,CA); FoxBASE and FoxBASE + are 
  139.     trademarks of Fox Software (Perrysburg, OH); Clipper is a trademark of 
  140.     Nantucket Corporation (Los Angeles, CA); dBCOMPILER and QuickSilver are 
  141.     trademarks of WordTech Systems, Inc. (Orinda, CA); MS-DOS is a registered 
  142.     trademark of MicroSoft Corp.; and PC-DOS is a registered trademark of IBM 
  143.     Corp.; IBM PC/XT/AT & PS/2 are products of International Business Machines 
  144.     Corp. (IBM Corp.); Turbo BASIC is a registered trademark of Borland 
  145.     International (Scotts Valley, CA)
  146.  
  147. II. Introduction/Background
  148.         This program was developed to save countless hours of development time 
  149.     when working in a dBase III+ environment.  A key factor in developing a 
  150.     database system is the ease of use to the end-user.  dBMENU will produce 
  151.     uniform application menus in dBASE III+ code which is easily read, and will 
  152.     run error-free.
  153.         When dBASE II, and later the dBASE III series of databases were 
  154.     introduced, I used to spend many hours coding my menus and various other 
  155.     routines.  Over the course of time, I found fast efficient ways of writing 
  156.     my code.  The biggest problem I found, was either to copy the code and 
  157.     change the variables, or to rewrite the module I was working on.  The most 
  158.     complex menu this generator can produce would take a good programmer a 
  159.     minimum of a half hour to write, never having seen the code before.
  160.         The dBASE III+ menu application generator was developed to cut down the 
  161.     programming time while creating menus.  Even without the use of this 
  162.     instruction manual, you should be able to create a full blown menu within 
  163.     3-5 minutes; assuming you have all the titles and module names set aside.
  164.  
  165. III. ShareWare
  166.         dBMENU is distributed through a unique marketing approach called 
  167.     shareware.  Shareware does not mean free software.  Shareware is just a 
  168.     distribution concept.  All that this means is that we are allowing this 
  169.     piece of software to be distributed freely.  You can copy it for your 
  170.     friends or associates, and conversely you can receive a copy from them. You 
  171.     are allowed to try/Evaluate this program to see if it meets your needs.  If 
  172.     it does, and you use this product, you should become a registered user.  
  173.     Shareware makes it basis on the honor system.
  174.  
  175.  
  176.  
  177.  
  178.  
  179.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  180.  
  181. dBMENU Ver: 4.0                                                   Page # 
  182.  
  183. IV. Registration
  184.     A. Single User License
  185.             You can register this program by sending a check or money order in 
  186.         the amount of Twenty-Five US Dollars ($25.), along with your name, 
  187.         address, and daytime telephone number to the address mentioned 
  188.         throughout this manual, or in section IV C.
  189.  
  190.     B. Site License
  191.  
  192.             A site license is also available for this product, a site license 
  193.         allows for unlimited copies of this program to be run on multiple 
  194.         machines at a given site.  This license can be obtained by sending a 
  195.         check or money order in the amount of One Hundred Fifty US Dollars 
  196.         ($150.), along with your name, company, address, and business telephone 
  197.         number to the address mentioned throughout this manual, or in section 
  198.         IV C below.
  199.  
  200.     C. Registration Address
  201.  
  202.             BTSOFT Systems, Inc.
  203.             dBMENU Registration
  204.             Post Office Box 95
  205.             Hewlett, New York 11557-0095
  206.  
  207.         Upon receiving your payment, you will be placed on our mailing list for 
  208.     all future revisions and new product announcements.  You will also be sent 
  209.     the latest release of dBMENU with your own serial number.  You will be 
  210.     informed about undocumented software switches.  Finally, for every copy of 
  211.     your dBMENU which is registered, you will receive a $5.00 rebate.
  212.  
  213. V. Programming Conventions
  214.     A. No Double Quotes (") are acceptable as inputted text.
  215.     B. All Data to be entered is alphanumeric.
  216.     C. An Audible Beep is used to alert you to an error in input.
  217.  
  218. VI. Environment
  219.     This program requires the following to work properly:
  220.     A. IBM PC/XT/AT (or 100% Compatibles)
  221.     B. 256K Random Access Memory (RAM)
  222.     C. MS-DOS 2.1+ -or- PC-DOS 2.1+
  223.     D. Disk Space Requirements
  224.         1. Maximum Output File Size
  225.             a. LightBar - 28k
  226.             b. Straight Menu - 24k
  227.     E. One of The Following dBASE type Environments:
  228.         1. dBASE III PLUS Ver: 1.1 (or compatible operating environment)
  229.         2. FoxBASE or FoxBASE +
  230.         3. Clipper
  231.         4. dBCOMPILER or QuickSilver
  232.  
  233. VII. Technical Information
  234.         The dBMENU generator was written in BASIC and compiled using 
  235.     Borland's Turbo BASIC compiler.  There is no 80x87 support for this 
  236.     program.  Due to file size limitations (Borland), this system really can 
  237.     not be enhanced any more than its present state.
  238.  
  239.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  240.  
  241. dBMENU Ver: 4.0                                                   Page # 
  242.  
  243.         The menu generator was written on an IBM AT (8MHz) w/80287 and has been 
  244.     tested on most of the major brand and clone PCs (processors ranging from 
  245.     8088 to 80386 and machines from original PCs to the IBM PS/2 line) with out 
  246.     fault.  This doesn't mean that the program won't fail; however this program 
  247.     does not use any special BIOS calls which would limit its use to a 
  248.     particular brand or type of PC.
  249.  
  250. VIII. License Agreement
  251.  
  252.         BTSOFT Systems, Inc. and MicroTek Consulting Group, Inc. (herein 
  253.     referred to as BSI/MCGI), grants to the Purchaser and Purchaser accepts a 
  254.     nontransferable and nonexclusive license to use, on a single computer 
  255.     (unless the product is site licensed), dBMENU and accompanying 
  256.     materials provided to Purchaser by BSI/MCGI.  Purchaser is hereby licensed 
  257.     only to read the program from its medium into the memory of a single 
  258.     computer solely for the purpose of executing the program.  BSI/MCGI shall 
  259.     have the right to terminate this license if purchaser violates any of its 
  260.     provisions.  Purchaser agrees that dBMENU and accompanying materials 
  261.     are the property of BSI/MCGI and that BSI/MCGI shall maintain title to and 
  262.     ownership of dBMENU at all times.  BSI/MCGI warrants that all disks 
  263.     provided constitute an accurate duplication of dBMENU and BSI/MCGI will 
  264.     replace any disks found to be defective within 30 days from date of 
  265.     purchase.  BSI/MCGI will not honor this warranty where a software product 
  266.     disk has been subjected to physical abuse, or used in defective or 
  267.     non-compatible equipment.  BSI/MCGI makes no warranties of any kind, 
  268.     expressed or implied, with respect to the quality, performance, accuracy, 
  269.     or fitness of dBMENU for any particular purpose.  BSI/MCGI assumes no 
  270.     responsibility for any decisions made or actions taken on the part of the 
  271.     Purchaser because of the use of dBMENU.  In no event shall BSI/MCGI, or 
  272.     any of its representatives, be liable for any loss of profit or any other 
  273.     damages, including but not limited to special, incidental, consequential or 
  274.     other damages, arising out of the use or inability to use this product - 
  275.     even if BSI/MCGI or an authorized agent of such has been advised of the 
  276.     possibility of such damages - or for any claim by any other party. 
  277.         BSI/MCGI reserves the right to make changes, enhancements and 
  278.     improvements to dBMENU at any time and without notice.  Acceptance 
  279.     (registration) of this software, or use of dBMENU for any period beyond 
  280.     the thirty day (30) ShareWare agreement constitutes your assumed acceptance 
  281.     of this agreement and subjects you to its contents.
  282.  
  283. IX. Running
  284.         This program can be run, stand-alone directly from DOS by typing 
  285.     "dBMENU", or it can be run from within dBASE III PLUS by typing 
  286.     "!dBMENU" at the dot prompt.
  287.  
  288.     A. Loading Options:
  289.         1. dBMENU [?] [filename] [/C] [/Q]
  290.             Typing dBMENU at the DOS prompt will invoke the menu generator 
  291.             without any special functions.
  292.             a. [?]
  293.                 By typing dBMENU ? at the DOS prompt, you will get a list of 
  294.                 the current options available when running the program.
  295.             b. [filename]
  296.                 The filename is any 8 characters which results in a legal DOS 
  297.                 file.  No extensions are permissible.  This filename is the 
  298.                 
  299.                                      (c) BTSOFT Systems, Inc. - 1987, 1988
  300.                 
  301.                  dBMENU Ver: 4.0                                                   Page # 
  302.  
  303.                 output file which dBMENU will write the code to.
  304.             c. [/C]
  305.                 This option will eliminate the bulk of the programming comments 
  306.                 in the .PRG file.
  307.             d. [/Q]
  308.                 This option will quit out of the Sample Menu which is displayed 
  309.                 when running dBMENU.
  310.             e. Combination Choices:
  311.                 These switches can be run alone or in combination with one 
  312.                 another.  For example, you might want to shut off the sample 
  313.                 display and have the output sent to TEST
  314.  
  315.                         dBMENU Test /Q
  316.  
  317.     B. Program Name
  318.         This is the output filename to which the dBMENU Generator will store 
  319.         the dBASE III+ code.
  320.         1.  The name must be a valid DOS filename with up to eight (8) 
  321.             Characters Maximum.
  322.         2.  Do not include ".PRG" extension, as dBMENU will do this for you 
  323.             automatically.  If you want the program file to have any other 
  324.             extension, at DOS you will have to rename it.
  325.             a.  If the program name exists in the current directory you have 
  326.                 two (2) options:
  327.                 (1) Yes
  328.                     Which will backup then existing file (.BAK), and create a 
  329.                     new file.
  330.                 (2) No
  331.                     Which will allow you to re-enter the Program filename.
  332.  
  333.     C. Author (Optional)
  334.         1.      This option is useful for identifying person or group or team 
  335.             who used the dBMENU program to setup this menu.  You are allowed 
  336.             to enter up to 40 alphanumeric characters in this field.
  337.         2. Input File
  338.                 If you want a particular Author's name to appear in each file 
  339.             that this program generates, it is possible to write the person 
  340.             (team) name to a file called AUTHOR.DBM and include it in the 
  341.             current directory where dBMENU is being executed.
  342.  
  343.     D. Purpose (Optional)
  344.             This option is useful for identifying purpose for creating this 
  345.         menu.  You are allowed to enter up to 40 alphanumeric characters in 
  346.         this field.
  347.  
  348.     E. Notes (Optional)
  349.         1.      This option allows up to ten (10) lines of programming notes.  
  350.             Each Line allows for 60 alphanumeric characters.  Depressing the 
  351.             Enter Key on a blank line will terminate this function and proceed 
  352.             to the next.
  353.         2. Input File
  354.                 If you have certain notes which you want to appear in each file 
  355.             that this program generates, it is possible to write the notes (up 
  356.             to 30 lines) in a file called NOTES.DBM and include it in the 
  357.             current directory where dBMENU is being executed.
  358.  
  359.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  360.  
  361. dBMENU Ver: 4.0                                                   Page # 
  362.  
  363.     F. Menu Number (Optional)
  364.             This option allows for up to 7 alphanumeric characters.  This will 
  365.         be displayed in the upper left-hand corner of the menu, next to the 
  366.         word "Menu".  Example:
  367.  
  368.                 Typing "1.23" will produce "Menu 1.23" on the Menu.
  369.                 Typing "Test" will produce "Menu Test" on the Menu.
  370.  
  371.     G. Upper Right Corner (Optional)
  372.             This will display 12 Alphanumeric characters in the upper 
  373.         right-hand corner of the menu application.  If you want, you can have 
  374.         certain dBASE functions (such as date or time) displayed here.
  375.             1.  Regular text should just be typed as such.
  376.             2.  dBASE Code starts with a backwards accent mark (below the tilde 
  377.                 "~" key).  Example:
  378.  
  379.                 `DATE()          -or-        `TIME()
  380.  
  381.     H. Menu Title
  382.         1.      This required text will be Centered and Displayed in the upper 
  383.             center of the Menu Application, will be double boxed, and can be a 
  384.             maximum of 48 Characters in length.
  385.         2. Input File
  386.                 If you want a particular Title to appear in each file that this 
  387.             program generates, it is possible to write the title to a file 
  388.             called TITLE.DBM and include it in the current directory where 
  389.             dBMENU is being executed.
  390.  
  391.     I. Menu Subtitle (Optional)
  392.             This section allows for two optional text lines which will be 
  393.         Centered and Displayed in the upper center of the Menu Application, 
  394.         along with the title, and will be included in the title box.  If only 
  395.         one Sub-Title is selected, it will be displayed two (2) lines below the 
  396.         main menu title.  If both Subtitles are used, they will be listed one 
  397.         below the other, with no blank lines separating them.  Each of these 
  398.         subtitles can be a maximum of 48 Characters in length.
  399.  
  400.     J. LightBar/Straight Menu
  401.             1.  LightBar will allow you cursor control as well as direct 
  402.                 letter/number selection of an option.  A Bar of light will 
  403.                 display the current menu  selection in reverse video (in the 
  404.                 colors you selected).
  405.             2.  The straight menu takes up less memory, and only allows the 
  406.                 user to make a choice by selecting the letter or number for the 
  407.                 given option.  The cursor keys are disabled.
  408.  
  409.     K. Color Selection
  410.             Since certain colors conflict with one another, the program has 
  411.         been modified so that once a Background color is selected, it will be 
  412.         impossible to make the Foreground, Boarder, or LightBar colors the same 
  413.         as the background.
  414.         1. Background
  415.         2. Foreground
  416.         3. Border Lines
  417.             Lines surrounding titles and options.
  418.  
  419.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  420.  
  421. dBMENU Ver: 4.0                                                   Page # 
  422.  
  423.         4. LightBar (Not Available with Straight Menu Selection)
  424.  
  425.     L. Force Selection Highlight (Not Available with Straight Menu)
  426.             There will be times where the on screen instructions for cursor 
  427.         movement will be inappropriate if displayed in the LightBar Colors, or 
  428.         you just might want black letters on a white background (white letters 
  429.         on black background if the background is white.
  430.  
  431.     M. Level Letter
  432.             Since the majority of the generated application menu is based on 
  433.         variables each menu, and sub-menu (nested menus) should have different 
  434.         nesting letters.
  435.         1. Duplicate nesting letters will cause previous menus to fail.
  436.         2. A-Z are the only valid selections for this option.
  437.             a. If Nested Level letter "A" is selected:
  438.                 (1) Company Name (Optional)
  439.                     a)  You will be allowed to enter 40 alphanumeric characters 
  440.                         for a company name.  This information will be centered 
  441.                         on the bottom line of the menu application.  Example:
  442.  
  443.                 BTSOFT Systems, Inc.     -will be displayed as-
  444.  
  445.                       (c) BTSOFT Systems, Inc. - 1987
  446.  
  447.                     The year that follows the copyright notice is obtained from 
  448.                     the system date/clock.
  449.  
  450.                 b)  If you want a particular Company's name to appear in each 
  451.             Nested Level "A" file that this program generates, it is possible 
  452.             to write the company name to a file called COMPANY.DBM and include 
  453.             it in the current directory where dBMENU is being executed.
  454.  
  455.     N. Options - Yes/No Selectors
  456.         1. Return to Previous Menu
  457.             This option should be selected if the menu you are generating is a 
  458.             sub-menu.  This option uses the dBASE III+ command to return to the 
  459.             previous routine.
  460.             a.  If you select this option in your main menu, you will be 
  461.                 dropped at the dBASE III+ dot prompt.
  462.         2. Return to Master Menu
  463.                 This option should be selected if the menu you are generating 
  464.             is a sub-menu.  This option uses the dBASE III+ command to return 
  465.             to the main program routine (top of the menu nest).
  466.             a.  If you select this option in your main menu, you will be 
  467.                 dropped at the dBASE III+ dot prompt.
  468.         3. Exit to DOS
  469.                 This option should be selected if the menu you are generating 
  470.             is either the main menu or if it is a sub-menu.  This option uses 
  471.             the dBASE III+ command to Close All Databases and files, and Quit 
  472.             to DOS.
  473.         4. Option Explanation (Optional if Selected)
  474.             This part of the User Interface will display a box in the lower 
  475.             center of the menu, and displays the text you wrote to describe 
  476.             this option.  The text changes with the cursor movement only.
  477.  
  478.  
  479.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  480.  
  481. dBMENU Ver: 4.0                                                   Page # 
  482.  
  483.         5. dCode (Optional if Selected)
  484.             Up to nine lines of dBase III+ executable code.
  485.  
  486.     O. Number of menu Options
  487.             The number of menu options is based on whether you selected Exit to 
  488.         DOS, Return To Previous Menu, and Option Explanation.  If you select 
  489.         none of these options you can have up to 26 selections in your menu 
  490.         application.  Depending on how many selections you made, your choices 
  491.         will be limited between 16 and 26.
  492.         1.      This screen will inform you what is the maximum number of 
  493.             options to remain in the single column format (information is on 
  494.             bottom of this menu screen).
  495.  
  496.     P. Include Left Arrow Trap
  497.             If you selected enough options that requires the menu to be in a 
  498.         two column format, you will be asked if you want to include a left 
  499.         arrow trap.  As stated in the April 1987 issue of the Ashton-Tate's 
  500.         TechNotes (Page 16), "In dBASE III PLUS version 1.1, the INKEY() 
  501.         function does not trap Leftarrow."
  502.         1.      For this reason, say <Y>es if you are using Runtime Module or 
  503.             Compiler other than dBASE III+.  (Compilers such as Clipper, 
  504.             FoxBase, QuickSilver, etc.; and Runtime Modules/Replacements such 
  505.             as FoxBase Plus, etc.)
  506.         2.      If you are only running under dBASE III PLUS say <N>o to this 
  507.             question, or whenever the leftarrow is depressed, the results will 
  508.             be unreliable.
  509.  
  510.     Q. Screen Information
  511.             When entering the Option Information, there is certain screen 
  512.         information that you should be aware of, and they are:
  513.         1. dVariables
  514.                 This information is located in the upper left corner of the 
  515.             menu generator.  "dVariables" are the amount of dBASE III+ 
  516.             variables that will be used by your ".PRG" file.
  517.         2. dBytes
  518.                 This information is located in the upper right corner of the 
  519.             menu generator.  "dBytes" are the amount of dBASE III+ bytes that 
  520.             will be used by your ".PRG" file.
  521.         3. Option Number
  522.                 This is the number of the option you are currently working on.  
  523.             (This number will increase as you enter more options.)
  524.         4. Options Remaining
  525.             This is the number of the remaining options, that the user will 
  526.             select from.  (This number will decrease as you enter more 
  527.             options.)
  528.         5. Escape to Abort
  529.                 This function can be performed at any time during the dBMENU 
  530.             operation.  This will abort the program and return you to DOS.  If 
  531.             and when you select this option, the filename you were working on 
  532.             will be deleted.
  533.  
  534.     R. Selection Letter/Number
  535.             This is the keyboard character that the user must depress to select 
  536.         the associated text option.  This is only one character in length.  All 
  537.  
  538.         
  539.                              (c) BTSOFT Systems, Inc. - 1987, 1988
  540.         
  541.          dBMENU Ver: 4.0                                                   Page # 
  542.  
  543.         alphabetic characters will be converted Upper to Lower and Lower to 
  544.         Upper.  What this means is that if the user selects EITHER the upper or 
  545.         lower case character, this option will be selected.  REMEMBER: Only 
  546.         Alphabetic characters will be converted.
  547.  
  548.     S. Menu Option
  549.             This is the description that will appear next to the Letter, 
  550.         Number, Character that the user must depress to select this option.
  551.         1.  If this is a single column format that you can type up to 50 
  552.             Alphanumeric characters.
  553.         2.  If this is a two (2) column format then you can only type up to 22 
  554.             characters.
  555.  
  556.     T. Option Message (If Selected in section N #4 above)
  557.             This section allows for up to 50 alphanumeric characters which will 
  558.         describe or explain the associated Menu Option.  Even if you select 
  559.         this option, you do not have to type text.  When the LightBar is moved 
  560.         to the associated menu option the explanation box will be blank.
  561.  
  562.     U. dCode (If Selected in section N #5 above)
  563.             This section allows for up to 60 text (alphanumeric) characters 
  564.         which you would want your menu to execute from dBase.  This section is 
  565.         also optional, and will allow for a maximum of 9 lines of executable 
  566.         code.  Depressing <ENTER> on a blank line will terminate the function 
  567.         of this option.
  568.  
  569.     V. DO [.PRG file]
  570.             This is the program file which would be executed should the 
  571.         associated option be selected from your menu.  This would be any VALID 
  572.         dBase III+ program filename (any legal DOS filename) without the 
  573.         extension, since dBASE assumes .PRG, and FoxBase assumes .FOX, etc.
  574.  
  575. X. Advanced Options
  576.  
  577.         A. Merged Code
  578.                 This system provides the user the ability to incorporate 
  579.             standard or "Canned" text into your menu application.  You might, 
  580.             for example, have a security routine which applies to all the menus 
  581.             you create.  This routine can be inserted/merged into the menu at 
  582.             certain merge points.
  583.                 The code you wish to have merged into the menu must reside in a 
  584.             file called:
  585.  
  586.                     MERGEx.DBM  (x is the merge level)
  587.  
  588.                 There are eight (8) merge locations and, as mentioned above, 
  589.             the information would be extracted from MERGE1.DBM through 
  590.             MERGE8.DBM.  If you run the dBMENU generator without using the 
  591.             switch settings [/Q, /C], the menu generator will commend out the 
  592.             positions for the merged text; however, the list below should help 
  593.             you get an idea where the merged text will appear.
  594.  
  595.                   Level               Location:
  596.                 MERGE1.DBM       After Header Comments
  597.                 MERGE2.DBM       Before Program Title Display
  598.  
  599.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  600.  
  601. dBMENU Ver: 4.0                                                   Page # 
  602.  
  603.                 MERGE3.DBM       After Program Title Display
  604.                 MERGE4.DBM       During Display Option Messages
  605.                 MERGE5.DBM       During Keyboard Trapping
  606.                 MERGE6.DBM       After Valid Key Selection
  607.                 MERGE7.DBM       Before Performing Selected Menu Item
  608.                 MERGE8.DBM       Last Line Before ENDDO of Menu Loop
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  660.  
  661. dBMENU Ver: 4.0                                                   Page # 
  662.  
  663.  
  664.  
  665.  
  666.                             License to Use Agreement
  667.  
  668.     BTSOFT Systems, Inc. and MicroTek Consulting Group, Inc. (herein referred 
  669. to as BSI/MCGI), grants to the Purchaser and Purchaser accepts a 
  670. nontransferable and nonexclusive license to use, on a single computer, 
  671. dBMENU and accompanying materials provided to Purchaser by BSI/MCGI.  
  672. Purchaser is hereby licensed only to read the program from its medium into the 
  673. memory of a single computer solely for the purpose of executing the program.  
  674. BSI/MCGI shall have the right to terminate this license if purchaser violates 
  675. any of its provisions.  Purchaser agrees that dBMENU and accompanying 
  676. materials are the property of BSI/MCGI and that BSI/MCGI shall maintain title 
  677. to and ownership of dBMENU at all times.  BSI/MCGI warrants that all disks 
  678. provided constitute an accurate duplication of dBMENU and BSI/MCGI will 
  679. replace any disks found to be defective within 30 days from date of purchase.  
  680. BSI/MCGI will not honor this warranty where a software product disk has been 
  681. subjected to physical abuse, or used in defective or non-compatible equipment.  
  682. BSI/MCGI makes no warranties of any kind, expressed or implied, with respect to 
  683. the quality, performance, accuracy, or fitness of dBMENU for any particular 
  684. purpose.  BSI/MCGI assumes no responsibility for any decisions made or actions 
  685. taken on the part of the Purchaser because of the use of dBMENU.  In no 
  686. event shall BSI/MCGI, or any of its representatives, be liable for any loss of 
  687. profit or any other damages, including but not limited to special, incidental, 
  688. consequential or other damages, arising out of the use or inability to use this 
  689. product - even if BSI/MCGI or an authorized agent of such has been advised of 
  690. the possibility of such damages - or for any claim by any other party. 
  691.     BSI/MCGI reserves the right to make changes, enhancements and improvements 
  692. to dBMENU at any time and without notice.  Purchaser whose signature 
  693. appears below agrees to the terms of the above License.  However, even if you 
  694. fail to return this agreement, use of dBMENU for any period beyond the 
  695. thirty day (30) ShareWare agreement constitutes your assumed acceptance of this 
  696. agreement and subjects you to its contents.
  697.  
  698.     Accepted by:                                   Date:              
  699.  
  700. Return within 30 days to BTSOFT Systems, Inc., P.O. Box 95, Hewlett, NY 
  701. 11557-0095 insure support of your purchase.
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.                      (c) BTSOFT Systems, Inc. - 1987, 1988
  720.  
  721.