home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / EDUCATIO / THING.ZIP / THING.DOC < prev    next >
Encoding:
Text File  |  1990-08-06  |  13.7 KB  |  289 lines

  1.                           Thing Puzzle Users Guide
  2.                      A fun computer puzzle for all ages
  3.                       (c) Copyright 1990 Unistar, Inc.
  4.                                by Unistar Inc.
  5.                                  mark@unistar
  6.  
  7.  
  8.         INTRODUCTION
  9.  
  10.         Background
  11.  
  12.             The original program was written as  a  challenge  to
  13.         myself  and as a way of getting used to the curses screen
  14.         management  package  I  had  purchased.  This   Shareware
  15.         release contains a number of enhancements to the original
  16.         program.  This program  is  modeled  after  those  little
  17.         children's  puzzles  that usually have four rows and four
  18.         columns of movable plastic pieces less the one piece that
  19.         is  missing  so that you can move things round. There are
  20.         many different puzzles like this,  the  simple  ones  are
  21.         numbered from one to fifteen, while others are made up of
  22.         pictures that you move  around  to  reorder  the  puzzle.
  23.         This  program  uses  numbers,  you move them around until
  24.         they are in order with the  piece  numbered  one  in  the
  25.         upper  left  corner  and the blank or missing piece is in
  26.         the lower right-hand corner. The program  allows  you  to
  27.         select  a  puzzle from four by four, or 16 squares to one
  28.         that is nine by nine squares or eighty-one squares.
  29.  
  30.         Requirements
  31.  
  32.             THING requires PC-DOS or MS-DOS 3.0 or higher to run,
  33.         one  floppy  or  hard  drive, and any standard monitor in
  34.         graphics mode. Your computer will need to have  at  least
  35.         384K to run the puzzle program.
  36.  
  37.         GENERAL FEATURES
  38.  
  39.             THING is very simple to operate. When you run  THING,
  40.         you  are  presented with a screen that contains your game
  41.         board in the upper left corner of the screen, the program
  42.         title,  game  size,  and  move  count  in the upper right
  43.         corner of the screen, and a line at  the  bottom  of  the
  44.         screen  that  tells how to turn the help menu on and off.
  45.         When the on-screen help is on, it  is  displayed  on  the
  46.         right side of the screen.
  47.  
  48.             The game board is a grid of  numbers  arranged  in  a
  49.         square.  The starting point of the square is in the upper
  50.         left corner of the screen and increases in  size  to  the
  51.         right  and  downward  for  larger size games. The default
  52.         game is a four by four square and is the simplest to win.
  53.         The  game  board  is  initially displayed with all of the
  54.         numbers scrambled around on the board, and you  must  re-
  55.         arrange them so that they are in numerical order. You can
  56.         use your cursor keys on the keyboard if your computer has
  57.         them,  or  you  can use the letters L, R, U, or D to move
  58.         left, right, up or down. You can also quit the game  with
  59.         or without saving it to play at a later time. If you save
  60.         a game, the next time you start  the  program,  the  game
  61.         will automatically load the game that was last saved.
  62.  
  63.             Once you have completed the game, you will  be  shown
  64.         the  scoreboard of previous winners, and you will be told
  65.         that you won, and if you made it on  the  scoreboard.  If
  66.         you  quit  the game without saving, you will be shown the
  67.         scoreboard, but you will not be on it.
  68.  
  69.         RUNNING THE PROGRAM
  70.  
  71.             THING  is  normally  run  without  any  command  line
  72.         arguments,  and  defaults to a game board of four squares
  73.         by four squares. If you wish to play a game with a larger
  74.         game  board,  you  can  do  so  by running THING with the
  75.         arguments '-nx' where x is the  number  of  squares  down
  76.         each  side, the minimum squares that you can play with is
  77.         '- n4', the default, and the maximum  is  '-n9'.  If  you
  78.         wanted  to  play  a  game  using a 9 by 9 game board, you
  79.         would run the program like this;
  80.  
  81.         thing -n9
  82.  
  83.         and you would have the largest  game  board  possible  at
  84.         this  time.  When you save a game, the game board size is
  85.         saved too, and running THING with any size specified will
  86.         cause  the  size  to  be  ignored if there is currently a
  87.         saved game to play.
  88.  
  89.         CONFIGURING THE PROGRAM
  90.  
  91.             Configuration of THING is easy, the only  thing  that
  92.         may  have  to  be  done  is  to  set the TERM environment
  93.         variable. For Unix and Xenix users, this  should  be  set
  94.         already  when  you logged in. For DOS users, you may have
  95.         to set this if your machine is not 100% PC/XT compatible.
  96.         THING uses the ASPEN SCIENTIFIC curses window development
  97.         package, a package that closely emulates the UNIX  curses
  98.         package.  THING  defaults  to  using direct memory-mapped
  99.         video I/O, this is the fastest mode, but it is  also  the
  100.         least  portable.  If  you  have  problems  running  THING
  101.         without any TERM  variable  set,  then  try  using  these
  102.         settings, one at a time until it works;
  103.  
  104.         TERM  value       description  ibm-pc           Color  or
  105.         monochrome memory mapped video output (default)
  106.  
  107.         bios-pc         Color or monochrome IBM BIOS output
  108.  
  109.         ansi-pc          monochrome  ANSI.SYS  compatible  output
  110.         (requires ANSI.SYS)
  111.  
  112.         c_ansi-pc         Color   ANSI.SYS   compatible    output
  113.         (requires ANSI.SYS)
  114.  
  115.             Those modes that require ANSI.SYS have to have a line
  116.         that  reads  "device=ansi.sys",  in your config.sys file,
  117.         for  more  information  about  ansi.sys  and  config.sys,
  118.         consult your DOS manual.
  119.  
  120.             To set the TERM variable, you need to type  something
  121.         like  this  from  the  DOS prompt; "set TERM=bios-pc", or
  122.         whichever TERM value you need.
  123.  
  124.             If THING is going to be  run  on  a  100%  IBM  PC/XT
  125.         compatible,  then  you don't need to set TERM, or you can
  126.         set TERM to "ibm-pc". If THING will be run in MS-WINDOWS,
  127.         TI-Emulate, or some other emulation environment, then try
  128.         setting TERM to "bios-pc", if THING  will  be  run  on  a
  129.         machine  which  is  not IBM PC/XT compatible, or if it is
  130.         running on an emulator and "bios-pc" does not work,  then
  131.         set TERM to "ansi-pc" or "c_ansi-pc".
  132.  
  133.         COMMANDS WHILE PLAYING THE PROGRAM
  134.  
  135.             When THING is running, a line at the  bottom  of  the
  136.         screen  will  tell  you how to turn the on-screen help on
  137.         and off. All the commands are listed  on  the  menu.  The
  138.         commands are basically of three types, movement commands,
  139.         game exit commands, and miscellaneous commands.
  140.  
  141.         Movement commands.
  142.  
  143.             Movement commands are what allow you to  move  around
  144.         on  the  game  board  and to move pieces around. When the
  145.         game starts, your pointer is located on the  upper  left-
  146.         hand  game  piece,  you  move  it around using either the
  147.         cursor arrow keys or by using keyboard keys.  The  cursor
  148.         arrow  keys  are  the  easiest  to  use  but may not work
  149.         correctly on all ASCII terminals. When  the  cursor  keys
  150.         are  not  working  correctly,  you  can  use the four key
  151.         listed below to move  the  game  pointer  around  in  the
  152.         direction indicated.
  153.  
  154.             Key     Direction Moved
  155.             ---     ---------------
  156.             L       Left
  157.             R       Right
  158.             U       Up
  159.             D       Down
  160.  
  161.             When you use the above  four  keyboard  keys  or  the
  162.         cursor  arrow  keys  the game pointer will wrap around on
  163.         the same column or row when the edge of the game board is
  164.         reached.  You  can  also  use  the TAB key to move to the
  165.         right one position, and when the right edge of  the  game
  166.         board  is reached, the game pointer will wrap down to the
  167.         first position on the next lowest row, or will to go  the
  168.         top leftmost position of you are already on the last game
  169.         square.
  170.  
  171.         Exit commands.
  172.  
  173.             THING has two exit commands. When you are playing the
  174.         game,  if  you  wish  to  exit the game and save it until
  175.         later, then you can press the 'E' key, if you wish to end
  176.         the current game and not save it, press the 'Q' key. When
  177.         the 'E' key is pressed, THING will say it is  saving  the
  178.         game, and then will exit back to the computer's operating
  179.         system, you will not be show the scoreboard, if you press
  180.         'Q'  to  quit  without  saving,  you  will  be  shown the
  181.         scoreboard, and you will be told that you did not win.
  182.  
  183.         Miscellaneous commands.
  184.  
  185.             THING has two miscellaneous commands,  if  you  press
  186.         the  '?'  key  while playing the game, the on-screen help
  187.         will be turned on and displayed if it  was  already  off,
  188.         and  it  will  be  turned  off  and that help area of the
  189.         screen will be cleared if it was already on. If  you  are
  190.         playing  THING  from  a  ASCII  terminal  or  a  terminal
  191.         emulator program it is possible for a burst of line noise
  192.         to  put random characters, or garbage on the screen, when
  193.         this happens, hold  down  the  key  marked  'Control'  or
  194.         'Ctrl'  and  press  the  letter 'L' and then release both
  195.         keys, this will cause THING to rewrite  the  screen  with
  196.         all the garbage removed.
  197.  
  198.  
  199.             THING is a rather simple puzzle program right now, if
  200.         there  are  any  features that you think would be nice to
  201.         have added, please let  us  know  and  we  will  consider
  202.         adding them.
  203.  
  204.         KNOWN PROBLEMS
  205.  
  206.             There are no known  problems  within  THING  at  this
  207.         time.
  208.  
  209.         SHAREWARE
  210.  
  211.             THING is user supported  software  for  the  IBM  PC,
  212.         compatibles,  and  for  machines  capable  of emulating a
  213.         PC/XT. THING is made available for a free ten  day  trial
  214.         period.  If  you find this program useful or interesting,
  215.         you may license the program for noncommercial use on  one
  216.         machine by sending $15.00 to:
  217.  
  218.                         THING
  219.                         c/o Unistar, Inc.
  220.                         P. O. Box 23563
  221.                         New Orleans LA, 70181
  222.  
  223.             You may use all updates that you may  receive  via  a
  224.         bbs or from us free once you have registered THING.  When
  225.         you register the program, you will receive a disk in  the
  226.         mail  with  the  current  version  of THING if there is a
  227.         newer version from the one you are using. For those  that
  228.         do  not  have  THING and would like to receive a copy you
  229.         can do so by sending  a  $15  registration  fee  plus  $4
  230.         postage  and  handling ($19 total) Please specify 360K or
  231.         1.2Meg disk (I don't have 3.5" disks).
  232.  
  233.             THING may be licensed for commercial use on up to  10
  234.         computers at a single site or set of contiguous sites for
  235.         $75.00. A commercial site is defined  as  a  business  or
  236.         individual   using   THING   as  part  of  it's  business
  237.         activities, including recreation and relaxation  by  it's
  238.         employees  (during lunch time of course.) Bulletin boards
  239.         that charge a fee for access to the system  or  charge  a
  240.         fee  for  higher  access to the files or 'doors' sections
  241.         are classified as a business even though they may not  be
  242.         licensed as such in their local municipalities.
  243.  
  244.             Clubs, schools, universities and other  organizations
  245.         may license THING for $45.00 per 6 copies.
  246.  
  247.             If you use THING as part of a commercial demo or as a
  248.         game  for  another  application you must obtain a license
  249.         from Unistar, Inc.  and pay a $1/copy  royalty  for  each
  250.         copy shipped.
  251.  
  252.             All other rights are reserved.
  253.  
  254.             THING may not be  changed  or  modified  in  any  way
  255.         except  by  the  copyright  holder.   THING may be freely
  256.         distributed for the ten day trial period as  long  as  it
  257.         remains in its complete form.  Regardless of how the copy
  258.         is obtained, it is requested that all users  comply  with
  259.         the licensing agreement.
  260.  
  261.             All warranties are disclaimed,  including  damage  to
  262.         hardware  and/or software from use of this product. In no
  263.         event shall  Unistar  Inc.  be  liable  to  you  for  any
  264.         damages,  including  lost  profits, lost savings or other
  265.         incidental or consequential damages arising out  of  your
  266.         use  or  inability to use the program, or any other claim
  267.         by any other party.
  268.  
  269.             Contact Unistar Inc. for special modifications.
  270.  
  271.             Any suggestions or comments should be mailed directly
  272.         to Unistar Inc at above address or via electronic mail to
  273.         mark@unistar.UUCP                                      or
  274.         rex.cs.tulane.edu!mgse!napsac!wmb!liz!unistar!mark.
  275.  
  276.         History of the program
  277.  
  278.         release 1.0     30 July 1990    First shareware release
  279.  
  280.             Microsoft,  MS-WINDOWS,  MS,  MS-DOS  and  Xenix  are
  281.         registered  trademarks  of Microsoft Corporation, IBM and
  282.         PC-DOS are registered trademark, and PC-XT is a trademark
  283.         of  International Business Machines Corporation.  TI is a
  284.         trademark of Texas Instruments Corporation.   UNIX  is  a
  285.         trademark of Bell Laboratories.
  286.  
  287.             (c) Copyright 1990 Unistar, Inc. All rights reserved.
  288.  
  289.