home *** CD-ROM | disk | FTP | other *** search
/ Game Killer / Game_Killer.bin / 488.MAHSHELL.DOC < prev    next >
Text File  |  1990-08-23  |  19KB  |  413 lines
  1.                          Mah Jongg Tile Set Manager
  2.                                 Version 3.0
  3.  
  4. Mah Jongg Tile Set Manager, Version 3.0 (MAHSHELL.EXE), is a program from
  5. JSSJ Software that manages your Mah Jongg Tile Set Library.  MAHSHELL.EXE
  6. works with Nels Anderson's MAHJONGG.EXE Version 3.3, which provides the
  7. ability to design custom tile sets.  In addition, MAHSHELL lets you
  8. establish a setup command for the various Mah Jongg parameters that you
  9. usually include in your command line when MAHJONGG.EXE is run.  The
  10. parameters supported are:
  11.  
  12.            -n    Bypass the Title Page
  13.            -m    Use a MOUSE
  14.            -tn   Play a timed game
  15.            -cn   Set Background color
  16.            -dn   Set MOUSE Cursor color
  17.            -y    Y/N prompt after selecting tiles
  18.  
  19. MAHSHELL.EXE currently supports EGA and VGA systems only.  Because I do not
  20. have access to any computers with Hercules, EGA Monochrome or Laptop
  21. displays, I have not implemented the -h, -l or -li options.  If someone is
  22. willing to test such versions, I would be happy to add the code.   
  23.  
  24. The program can also utilize a Microsoft-compatible Mouse if available.  The
  25. program will recognize the presence of the mouse driver.  MAHSHELL
  26. recognizes the press of any mouse button to select Tile Sets or commands.
  27.  
  28.  
  29. Version 3.0 adds two significant features:
  30.  
  31.      1)    Previous versions of MAHSHELL supported up to 50 tile sets.  Many
  32.            of the people registering the program recently have indicated that
  33.            this was becoming a real limitation.  One person reported over 80
  34.            tile sets in his collection.  Thus, this version supports 500 tile
  35.            sets.  
  36.  
  37.      2)    At approximately 1 megabytes of storage space per 30 tile sets, I
  38.            also decided to add compressed file support to 3.0.  Using Phil
  39.            Katz's PKWARE (PKZIP/PKUNZIP), MAHSHELL can optionally store your
  40.            tile sets in a .ZIP file.  Although this slightly increases the
  41.            time to start both MAHSHELL and MAHJONGG, it reduces the disk
  42.            storage requirements by about *85%*, a tradeoff that is well worth
  43.            the extra time.
  44.  
  45.  
  46. INSTALLING MAHSHELL.EXE
  47.  
  48. Installation is simple, just copy MAHSHELL.EXE into the directory that
  49. contains MAHJONGG.EXE and your tile sets (.TIL files).  If you used a
  50. previous version of MAHSHELL, BE SURE TO DELETE THE OLD MAHSHELL.DAT file,
  51. as the new format is not compatible with older versions.  Finally, make sure
  52. that PKZIP.EXE and PKUNZIP.EXE are in the same directory or in your PATH
  53. command.
  54. STARTING MAHSHELL
  55.  
  56. To start the program enter MAHSHELL at the MS-DOS prompt while in the
  57. directory where MAHSHELL.EXE, MAHJONGG.EXE and your .TIL files are stored
  58. (i.e. C:\GAMES>).  MAHSHELL can display up to 50 tile sets on the screen for
  59. selection for play.  If you have more than 50, MAHSHELL can page through up
  60. to 450 additional Tile Sets (500 total).  Unless this is your first time
  61. running MAHSHELL, the Tile Menu screen will appear as follows:
  62.  
  63.               ╔════════════════════════════════════════════════╗
  64.               ║        MAH JONGG TILE SET MANAGER (3.0)        ║
  65.               ║    Use Keyboard or MOUSE to select Tile Set    ║
  66.               ╚════════════════════════════════════════════════╝
  67.  
  68.   1 = ART        11 = KIDS
  69.   2 = ASCII      12 = LASVEGAS
  70.   3 = ASTRO      13 = LOGO
  71.   4 = BASEBALL   14 = MAHJONGG
  72.   5 = CABLETV    15 = MUSIC
  73.   6 = CARDS      16 = NUMBER
  74.   7 = COMPUTER   17 = PATS
  75.   8 = DOODLE     18 = REICH
  76.   9 = FLAGS      19 = TRUCK
  77.  10 = HARDWARE   20 = USAFANDY
  78.  
  79. ╔═════════════╤════════════╤════════════╤════════════╤════════════╤════════════╗
  80. ║ Tile No. __ │    Setup   │    PgUp    │    PgDn    │ Update Zip │    Exit    ║
  81. ╚═════════════╧════════════╧════════════╧════════════╧════════════╧════════════╝
  82.  
  83. Current parameters are:
  84.   Title=No  Mouse=Yes  Timed=No  BG Color= 1  Cursor= 14  Prompt=Yes  ZIP=ON
  85.  
  86.  
  87. Page  2 of  7                          (c) 1990 - JSSJ Software - Milwaukee, WI
  88.  
  89. ______________________________
  90.  
  91. The title box will indicate if MAHSHELL found your mouse driver or not by
  92. the prompt on the second line.  If MOUSE.SYS or MOUSE.COM is active, the
  93. text cursor (█) will also appear in the center of the screen.  Each tile set
  94. is assigned a number and displayed 50 per screen.  To select a tile set
  95. simply move the mouse cursor to the desired tile set and press any button on
  96. the mouse.  Alternatively, enter the number on the keyboard and press
  97. [ENTER].
  98.  
  99. The COMMAND LINE displays the command selections available in MAHSHELL.  
  100.  
  101. The parameter area displays the current settings for running Mah Jongg.  
  102.  
  103. Finally, in the lower lefthand corner is the page indicator.  If more than
  104. 50 tiles sets exist, this will indicate both the current page and the total
  105. number of pages.
  106. COMMANDS
  107.  
  108.  
  109. ╒═════════════╕
  110. │    SETUP    │
  111. ╘═════════════╛
  112.  
  113. Upon initial use, MAHSHELL will prompt for the setup options you wish to
  114. make standard.  These are saved in a file called MAHSHELL.DAT, and are used
  115. until you select the Setup Option (by pressing the 'S' key or pointing to
  116. the Setup box on the COMMAND LINE and pressing any mouse button).  Thus, you
  117. will only see this screen once unless you change your standard setup or
  118. delete the MAHSHELL.DAT file.
  119.  
  120. The setup routine will prompt you for the information it needs to run
  121. MAHJONGG, as well as the use of the compression option.  You should refer to
  122. your MAHJONGG documentation for the meaning of each parameter if you do not
  123. understand the prompt.  The first prompt that will appear is:
  124.  
  125.       ╔════════════════════════════════════════════════════════════════╗
  126.       ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  127.       ╠════════════════════════════════════════════════════════════════╣
  128.       ║  Do you wish to bypass the title page (Y or N)?                ║
  129.       ╚════════════════════════════════════════════════════════════════╝
  130.  
  131. Answer 'Y' or 'N', followed by the [ENTER] key.  MAHSHELL accepts UPPER or
  132. lower case responses.
  133.  
  134. The next prompt is:
  135.  
  136.       ╔════════════════════════════════════════════════════════════════╗
  137.       ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  138.       ╠════════════════════════════════════════════════════════════════╣
  139.       ║  Will you be using a MOUSE (Y or N)?                           ║
  140.       ╚════════════════════════════════════════════════════════════════╝
  141.  
  142. Answer 'Y' or 'N', followed by the [ENTER] key.  It appears that MAHJONGG
  143. ignores this parameter and uses the mouse if the driver is present. 
  144. However, be sure to answer 'Y' if you plan to use the mouse, otherwise,
  145. MAHSHELL will NOT prompt you for a Mouse Cursor Color.
  146.  
  147. The next prompt is:
  148.  
  149.       ╔════════════════════════════════════════════════════════════════╗
  150.       ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  151.       ╠════════════════════════════════════════════════════════════════╣
  152.       ║  Will you be playing a timed game (Y or N)?                    ║
  153.       ╚════════════════════════════════════════════════════════════════╝
  154.  
  155. Answer 'Y' or 'N', followed by the [ENTER] key.  If you answer 'Y', the
  156. following prompt will appear:
  157.  
  158.       ╔════════════════════════════════════════════════════════════════╗
  159.       ║                SETUP MAH JONGG TILE SET MANAGER                ║
  160.       ╠════════════════════════════════════════════════════════════════╣
  161.       ║  How long do you want the timed games?                         ║
  162.       ╚════════════════════════════════════════════════════════════════╝
  163.  
  164. Enter the length of time (in minutes) for the game.
  165.  
  166.  
  167.  
  168. COMMANDS (Continued)
  169.  
  170.  
  171. ╒═════════════╕
  172. │    SETUP    │ (Continued)
  173. ╘═════════════╛
  174.  
  175. The next prompt is:
  176.  
  177.       ╔════════════════════════════════════════════════════════════════╗
  178.       ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  179.       ╠════════════════════════════════════════════════════════════════╣
  180.       ║  Do you wish to have a (Y/N) prompt after selecting tiles?     ║
  181.       ╚════════════════════════════════════════════════════════════════╝
  182.  
  183. Answer 'Y' or 'N', followed by the [ENTER] key.
  184.  
  185. The next prompt is:
  186.  
  187.       ╔════════════════════════════════════════════════════════════════╗
  188.       ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  189.       ╠════════════════════════════════════════════════════════════════╣
  190.       ║  Do you wish to change the background color (Y or N)?          ║
  191.       ╚════════════════════════════════════════════════════════════════╝
  192.  
  193. Answer 'Y' or 'N', followed by the [ENTER] key.
  194.  
  195. If you responded 'Y' to the prompt, you will be asked to select a color:
  196.  
  197.       ╔════════════════════════════════════════════════════════════════╗
  198.       ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  199.       ╠════════════════════════════════════════════════════════════════╣
  200.       ║  Enter background color number from below (1-15)?              ║
  201.       ╚════════════════════════════════════════════════════════════════╝
  202.  
  203. As indicated, MAHSHELL displays the 15 available colors at the bottom of the
  204. screen.  Enter a number from 1 to 15 and press [ENTER].
  205.  
  206. If you indicated that you would be using the mouse in MAHJONGG, the
  207. following prompt will appear next:
  208.  
  209.       ╔════════════════════════════════════════════════════════════════╗
  210.       ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  211.       ╠════════════════════════════════════════════════════════════════╣
  212.       ║  Do you wish to change the MOUSE cursor color (Y or N)?        ║
  213.       ╚════════════════════════════════════════════════════════════════╝
  214.  
  215. Answer 'Y' or 'N', followed by the [ENTER] key.
  216.  
  217. If you responded 'Y' to the prompt, you will be asked to select a color:
  218.  
  219.      ╔════════════════════════════════════════════════════════════════╗
  220.      ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  221.      ╠════════════════════════════════════════════════════════════════╣
  222.      ║  Enter MOUSE cursor color number from below (1-15)?            ║
  223.      ╚════════════════════════════════════════════════════════════════╝
  224.  
  225. As in the case of the background color prompt, MAHSHELL displays the 15
  226. available colors at the bottom of the screen.  Enter a number from 1 to 15
  227. and press [ENTER].
  228.  
  229.  
  230. COMMANDS (Continued)
  231.  
  232.  
  233. ╒═════════════╕
  234. │    SETUP    │ (Continued)
  235. ╘═════════════╛
  236.  
  237. Next you will be prompted for the compression options.  There are several
  238. considerations concerning the use of this option.  First, PKZIP.EXE and
  239. PKUNZIP.EXE MUST be in the current directory or in a directory in your PATH
  240. command.  Second, there must be enough available disk space on the current
  241. drive for PKZIP to make the Zip file.  Although this is generally NOT a
  242. problem, always have a backup of your tile sets in case of an unforeseen
  243. problem.  
  244.  
  245. NOTE: I do not want to discourage you from using this feature, as it really
  246. saves a lot of disk space if you have a large number of tile sets.  However,
  247. PLEASE keep a current backup of your tile sets.
  248.  
  249.  
  250. The next prompts will vary depending on whether the compression option is ON
  251. or OFF (the default is OFF).  If the option is OFF, the following prompts
  252. and screens appear:
  253.  
  254.      ╔════════════════════════════════════════════════════════════════╗
  255.      ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  256.      ╠════════════════════════════════════════════════════════════════╣
  257.      ║  Do you wish to compress (ZIP) your tile sets (Y or N)?        ║
  258.      ╚════════════════════════════════════════════════════════════════╝
  259.  
  260. Answer 'Y' or 'N', followed by the [ENTER] key.
  261.  
  262. If you answer 'N', the MAHSHELL Tile Menu will appear.  If you answer 'Y",
  263. the following warning will appear:
  264.  
  265.         ╔════════════════════════════════════════════════════════════╗
  266.         ║          *** WARNING *** WARNING *** WARNING ***           ║
  267.         ╠════════════════════════════════════════════════════════════╣
  268.         ║                                                            ║
  269.         ║        This routine will compress all of your .TIL files   ║
  270.         ║   in the current directory into a file named MAH_TILE.ZIP, ║
  271.         ║   and then delete them.  Since there are error conditions  ║
  272.         ║   which may occur during the running of PKZIP.EXE that     ║
  273.         ║   are beyond the control of MAHSHELL.EXE, we recommend     ║
  274.         ║   that you make a backup of your .TIL files prior to       ║
  275.         ║   running this procedure.                                  ║
  276.         ║                                                            ║
  277.         ║   Do you wish to continue (Y or N)?                        ║
  278.         ║                                                            ║
  279.         ╚════════════════════════════════════════════════════════════╝
  280.  
  281. Answer 'Y' or 'N', followed by the [ENTER] key.  If you answer 'N', MAHSHELL
  282. will proceed to the Tile Menu.  If you enter 'Y', MAHSHELL will invoke
  283. PKZIP, compress your .TIL files, AND THEN DELETE YOUR TILE SETS.  As
  284. explained in the warning and on the previous page, DO NOT COMPRESS YOUR TILE
  285. SETS WITHOUT A CURRENT BACKUP!  The program will now display the Tile Menu.
  286.  
  287.  
  288. COMMANDS (Continued)
  289.  
  290.  
  291. ╒═════════════╕
  292. │    SETUP    │ (Continued)
  293. ╘═════════════╛
  294.  
  295. If the Zip option was ON when SETUP was selected, the following prompt will
  296. appear:
  297.  
  298.       ╔════════════════════════════════════════════════════════════════╗
  299.       ║               SETUP MAH JONGG TILE SET MANAGER                 ║
  300.       ╠════════════════════════════════════════════════════════════════╣
  301.       ║  Do you wish to keep your compressed tile sets (Y or N)?       ║
  302.       ╚════════════════════════════════════════════════════════════════╝
  303.  
  304. Answer 'Y' or 'N', followed by the [ENTER] key.  If you respond 'Y" then
  305. MAHSHELL will proceed to the Tile Menu.  If you answer 'N', the following
  306. warning will appear:
  307.  
  308.         ╔════════════════════════════════════════════════════════════╗
  309.         ║          *** WARNING *** WARNING *** WARNING ***           ║
  310.         ╠════════════════════════════════════════════════════════════╣
  311.         ║                                                            ║
  312.         ║        This routine will decompress your MAH_TILE.ZIP      ║
  313.         ║   file and place your tile sets (.TIL files) in the        ║
  314.         ║   current directory.  MAH_TILE.ZIP will then be DELETED.   ║
  315.         ║   Since there are error conditions which may occur during  ║
  316.         ║   the running of PKUNZIP.EXE that are beyond the control   ║
  317.         ║   of MAHSHELL.EXE, we recommend that you make a backup     ║
  318.         ║   of your .TIL files prior to running this procedure.      ║
  319.         ║                                                            ║
  320.         ║   Do you wish to continue (Y or N)?                        ║
  321.         ║                                                            ║
  322.         ╚════════════════════════════════════════════════════════════╝
  323.  
  324. Answer 'Y' or 'N', followed by the [ENTER] key.  If you enter 'N' then
  325. MAHSHELL will proceed to the Tile Menu, leaving your .ZIP file intact.  If
  326. you enter 'Y" then MAHSHELL will invoke PKUNZIP, decompress your .TIL files
  327. and DELETE the .ZIP file.  After PKUNZIP has finished, MAHSHELL will display
  328. the Tile Menu.
  329.  
  330.  
  331. ╒════════════╤════════════╕
  332. │    PgUp    │    PgDn    │
  333. ╘════════════╧════════════╛
  334.  
  335. If you have more than one page (50) tile sets, the [PgUp]/[PgDn] commands
  336. will page through the additional tile sets.  [PgUp] pages toward the TOP of
  337. the list, and [PgDn] pages toward the END of the list.  MAHSHELL displays
  338. these commands in Bright White if they are active or Gray if they are
  339. inactive.  For example, if you are on page 1 of 5, [PgUp] will be inactive
  340. and [PgDn] will be active.
  341.  
  342.  
  343. ╒════════════╕
  344. │ Update Zip │
  345. ╘════════════╛
  346.  
  347.  
  348. When you receive new tile sets, you may add them to the ZIP file using the
  349. Update ZIP command.  Place the new .TIL files in the directory with MAHJONGG
  350. and MAHSHELL and select this command by pressing the 'U' key or move the
  351. mouse cursor to the Update ZIP command and pressing any key on the mouse. 
  352. MAHSHELL will add the .TIL files to the .ZIP file.  Again, keep a current
  353. backup of your tile sets.  
  354. COMMANDS (Continued)
  355.  
  356.  
  357. ╒════════════╗
  358. │    Exit    ║
  359. ╘════════════╝
  360.  
  361. The exit command will terminate MAHSHELL.  Select the command by pressing
  362. the 'E' key or move the mouse cursor to the EXIT command and pressing any
  363. key on the mouse.
  364.  
  365.  
  366. OTHER INFORMATION
  367.  
  368. The program will also interface with one of our other products, the VGA Fun
  369. Pak.  Select the insert option in the Game Menu Program, and enter
  370. 'MAHSHELL' at the program name prompt.  At the Program description prompt,
  371. enter something like 'Nels Anderson's Mah Jongg'.  Enter 'EXE' at the
  372. program type prompt.  When you select that option, the Game Menu program
  373. will call MAHSHELL.EXE, and you can select the Tile Set you wish to play
  374. with.  Upon exiting MAHJONGG.EXE, you will be returned to the MAHSHELL
  375. program to play another game or exit.
  376.  
  377. The program reads all files in the current directory with an extension of
  378. '.TIL'.  It then creates a temporary file called TILES.TMP and extracts the
  379. names of the Tile Sets from the file name.  The temporary file is deleted
  380. immediately.  If you use the ZIP option, the .TMP file is created from the
  381. .TIL files in the .ZIP file.
  382.  
  383. Note that MAHSHELL.EXE, MAHSHELL.DAT, ?.TIL and MAHJONGG.EXE must be in the
  384. same directory, and that directory must be the current directory.  In
  385. addition to use the ZIP option, PKZIP.EXE and PKUNZIP.EXE must be in the
  386. same directory or in a directory in you PATH command.
  387.  
  388.  
  389. SHAREWARE
  390.  
  391. The Mah Jongg Tile Set Manager (MAHSHELL.EXE) program is distributed as
  392. Shareware, with payment of the registration fee based on the honor system.
  393. If the program is useful and you continue to use the program after an
  394. initial trial, you are requested to send $12 to:
  395.  
  396.                      Steve Shattuck
  397.                      5289 N. Lake Drive
  398.                      Whitefish Bay, WI 53217
  399.  
  400. Upgrades for previously registered users of MAHSHELL are available for $5 on
  401. 5¼" disk or $6 for 3½" disk.  A site license for 10 or more copies at a
  402. single location is available for $50.
  403.  
  404. It is also expected that you will separately register Nels Anderson's
  405. MAHJONGG.EXE program.  In any case, please register Nels' program even if
  406. you don't register mine.  I would certainly be upset to find that someone
  407. had registered MAHSHELL and not registered MAHJONGG!
  408.  
  409. Feel free to comment on the Mah Jongg Tile Set Manager and make suggestion
  410. for it's improvements.  I would also be interested in your favorite Tile
  411. Sets.  I can be reached on Exec-PC in Milwaukee, WI (414) 789-4210, the best
  412. BBS in the World!
  413.