home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / m18menu5.zip / M18MENU.DOC < prev    next >
Text File  |  1989-02-27  |  9KB  |  184 lines
  1.  
  2.  
  3.                       ┌─────────────────────────────────┐
  4.                       │       M18 Course Menu 5.0       │
  5.                       │          Documentation          │
  6.                       │            02-27-89             │
  7.                       │ Copyright 1989 Mark A. Albrecht │
  8.                       │       All Rights Reserved       │
  9.                       └─────────────────────────────────┘
  10.  
  11.       ┌────────────────────────────────────────────────────────────────┐
  12.       │                                                                │
  13.       │                     D I S C L A I M E R                        │
  14.       │                     ───────────────────                        │
  15.       │  The author, Mark A. Albrecht, makes no warranties expressed   │
  16.       │  or implied as to the quality or performance of this program,  │
  17.       │  nor its fitness for a particular purpose. The author will     │
  18.       │  not be held liable for any direct, indirect, incidental, or   │
  19.       │  consequential damages resulting from the use of this program. │
  20.       │  YOUR USE OF THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO THIS   │
  21.       │  DISCLAIMER and your release of the author from any form of    │
  22.       │  liability or litigation.                                      │
  23.       └────────────────────────────────────────────────────────────────┘
  24.  
  25.  
  26.         ┌─────────────┐
  27.     ────┤ DESCRIPTION ├────────────────────────────────────────────────────
  28.         └─────────────┘
  29.  
  30.         M18 Course Menu is a utility designed for use with Accolade Inc.'s
  31.     "Mean 18" computer golf game. (For the sake of clarity, the following
  32.     terms are used: "M18Menu" means this utility, and "Mean 18" means the
  33.     actual golf game.
  34.  
  35.     FEATURES:
  36.     ─────────
  37.  
  38.     - COURSE ARCHIVING: Each Mean 18 course file typically occupies in
  39.                         excess of 100K of disk space. Multiple courses eat
  40.                         up disk space fast. To help alleviate this problem,
  41.                         M18Menu utilizes PKWARE Inc.'s PKZIP and PKUNZIP
  42.                         file compression utilities to maintain course
  43.                         files. (PKZIP and PKUNZIP are Copyright 1989 PKWARE
  44.                         Inc., All Rights Reserved.) By using M18Menu, up to
  45.                         60-75% of the disk space occupied by course files is
  46.                         saved.
  47.  
  48.     - COURSE MENU:      M18Menu features a point-and-shoot menu listing all
  49.                         of the courses in the current directory. To play a
  50.                         particular course, just move the menu's cursor bar
  51.                         over the desired course's name, press RETURN, and
  52.                         M18Menu does all the work.
  53.  
  54.  
  55.         ┌──────────────────────┐
  56.     ────┤ SYSTEM REQUIREMENTS: ├───────────────────────────────────────────
  57.         └──────────────────────┘
  58.  
  59.     1. DOS 3.0 or later.
  60.     2. Accolade Inc.'s Mean 18, and 1 or more course files.
  61.     3. PKWARE Inc.'s PKZIP and PKUNZIP file compression/decompression
  62.        utilities.
  63.     4. Any monitor capable of displaying Mean 18 itself.
  64.     5. Though not essential, M18Menu was written for use on a hard disk.
  65.  
  66.  
  67.         ┌────────┐
  68.     ────┤ SETUP: ├─────────────────────────────────────────────────────────
  69.         └────────┘
  70.  
  71.     1. Copy the following to one directory:
  72.             a) Mean 18's GOLF.EXE, GOLF.DAT, *.M18, and *.HOF files;
  73.             b) M18MENU.EXE;
  74.             c) PKZIP.EXE" and "PKUNZIP.EXE" (unless they reside in a
  75.                directory included in your DOS "PATH" environment variable.
  76.  
  77.     2. If you have used a previous version of M18Menu and your courses are
  78.        contained in .ARC files then copy the enclosed utility ARC2ZIP.EXE
  79.        to the directory containing the archived courses and run it before
  80.        proceeding with these setup instructions. ARC2ZIP will search for
  81.        PKWARE's PKUNPAK and PKZIP and use the former to uncompress each
  82.        old archived course and then use the latter to re-compress each
  83.        course using the new format.
  84.  
  85.     3. Run "M18MENU.EXE". The first time M18Menu is run, it will search the
  86.        directory for all files having a filename extension of ".M18" and
  87.        ".HOF". It will then display a prompt informing you of the number of
  88.        course files found, and asking you if you wish to proceed with
  89.        archiving (compressing) each of the course files. Enter "Y" (for
  90.        "YES") and M18Menu will call PKZIP to create ".ZIP" files for each
  91.        of the courses found. Once all course files have been archived, all
  92.        ".M18" and ".HOF" files will be erased from the directory. When
  93.        finished, the directory will contain .ZIP file(s) having names
  94.        corresponding with the course file within each .ZIP file. M18Menu
  95.        will then pop up the point-and-shoot course menu listing the names
  96.        of all courses found in the directory. Press ESCAPE to exit
  97.        M18Menu, or highlight a desired course and press RETURN if you
  98.        wish to play the course.
  99.  
  100.  
  101.         ┌────────────┐
  102.     ────┤ OPERATION: ├─────────────────────────────────────────────────────
  103.         └────────────┘
  104.  
  105.         To play a course, simply run "M18MENU.EXE", select a course from
  106.     the menu, and M18Menu does the rest. Here's how it works:
  107.  
  108.         When a course is chosen from the menu, M18Menu calls PKUNZIP and
  109.     instructs it to extract the course file (".M18") and "Hall of Fame" file
  110.     (".HOF") from their respective .ZIP file.
  111.         Mean 18 ("GOLF.EXE") is then executed, and searches the directory
  112.     for the first filename having an extension of ".M18", which, of course,
  113.     will be the one we just un-archived. Mean 18 then loads the course. You
  114.     play the course, and exit from Mean 18 as usual.
  115.         After you finish play and exit Mean 18, M18Menu cleans up the
  116.     directory by calling PKZIP and instructing it to update the (".HOF")
  117.     file contained in the course's .ZIP file. M18Menu then erases the
  118.     ".HOF" file from the directory. Thus, the course's .ZIP file now
  119.     contains the ".M18" file and an updated ".HOF" file.
  120.         M18Menu will then redisplay the course menu. Select another course
  121.     to play or press ESCAPE and M18Menu will exit to DOS.
  122.  
  123.  
  124.         ┌──────────┐
  125.     ────┤ HISTORY: ├───────────────────────────────────────────────────────
  126.         └──────────┘
  127.  
  128.         Version
  129.         ───────
  130.             1.0 - First release (obviously). 1.0 simply featured a menu for
  131.                   selecting a course to play.
  132.  
  133.             2.0 - Added:
  134.                          - archiving/un-archiving of courses.
  135.                          - extensive error trapping.
  136.                          - more file details to selection menu.
  137.                          - minutia;
  138.             3.0 - Added:
  139.                          - auto-mono/color detection;
  140.                          - now supports up to 200 courses;
  141.                          - course menu file stats modified;
  142.                          - cosmetic changes;
  143.                          - minutia;
  144.                   Fixed:
  145.                          - bug in error trap on return from EXECing
  146.                            PKPAK (not fatal);
  147.                          - display bug which occurred on a, er...,
  148.                            "close compatible" (also not fatal);
  149.             4.0 - Added:
  150.                          - ability to highlite a course by pressing
  151.                            the character key corresponding to it's
  152.                            initial;
  153.  
  154.             5.0 - Added:
  155.                          - M18Menu now uses PKWARES's PKZIP and PKUNZIP
  156.                            file compression utilities and NO OTHER;
  157.  
  158.  
  159.         ┌──────────┐
  160.     ────┤ LICENCE: ├───────────────────────────────────────────────────────
  161.         └──────────┘
  162.  
  163.         Use of M18Menu is not free. I do not want you to send me anything,
  164.     but your licence to use M18Menu beyond a reasonable trial period is
  165.     conditioned upon your donation of $5-$10 to the charitable organization
  166.     of your choice. One of many such organizations I heartily recommend is
  167.     PETA: People for the Ethical Treatment of Animals. Your fulfillment of
  168.     this condition is deeply appreciated.
  169.  
  170.     Questions/Comments/Suggestions may be forwarded via modem by leaving a
  171.     message for Mark Albrecht:
  172.  
  173.                               NightHawk BBS
  174.                               (319)338-3683
  175.                               Sysop: Andy Flatt
  176.  
  177.  
  178.     or by dropping a note in the mail addressed to:
  179.  
  180.                               Mark A. Albrecht
  181.                               P.O. Box 2064
  182.                               Sioux City, IA 51104
  183.  
  184.