home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / GAMES / colossal.lzh / advent.doc < prev    next >
Text File  |  1991-09-19  |  4KB  |  116 lines

  1.  
  2.  
  3.                             7 JUNE 1991
  4.  
  5.         Notes on ADVENTURE  (for OS9/68K)
  6.  
  7.  
  8.     1)  TO PLAY ADVENTURE
  9.     The ADVENTURE game requires one single sided drive & 96K of
  10.     memory.  ADVENT must be in the execution directory or accessable
  11.     via the search PATH. The following files  MUST  be present in the 
  12.     current directory:
  13.  
  14.             ADVENT1.TXT
  15.             ADVENT2.TXT
  16.             ADVENT3.TXT
  17.             ADVENT4.TXT
  18.  
  19.  
  20.     The game may be started by typing       "ADVENT<cr>".
  21.     A saved game may be restarted by typing "ADVENT -r<cr>".
  22.     Debug data will be output by typing     "ADVENT -d -d -d<cr>".
  23.     Helpful instructions will be output by
  24.     typing                                  "ADVENT -?<cr>"
  25.  
  26.  
  27.     2)  TO HACK ADVENTURE
  28.     The ADVENTURE game source files are header, code or
  29.     text files. A make file is also provided.
  30.  
  31.     MAKEFILE    - a make file to rebuild the Adventure system
  32.  
  33.     ADVENT    .C    - initialization
  34.     ENGLISH    .C    - interpret game player's commands
  35.     DATABASE.C    - text file management & output
  36.     ITVERB    .C    - intransitive verbs execution
  37.     VERB    .C    - transitive verbs execution
  38.     TURN    .C    - analysis & execution of player's command
  39.     SAVE    .C  - save and restore a game
  40.     LTOA    .C    - source for a function needed by ADVENT0
  41.     ADVENT0    .C    - utility to create "ADVTEXT.H" file
  42.  
  43.     ADVENT1    .TXT    - long  cave description
  44.     ADVENT2    .TXT    - short cave description
  45.     ADVENT3    .TXT    - long & short object description
  46.     ADVENT4    .TXT    - conversational descriptions & responses
  47.     ADVENT    .DOC    - this ADVENTURE documentation file
  48.  
  49.     ADVENT    .H    - #define & structure statements
  50.     ADVWORD    .H    - words & codes array
  51.     ADVCAVE    .H    - cave & travel arrays
  52.     ADVTEXT    .H    - TXT file message indexes
  53.     ADVDEF    .H    - data constants & variables definitions
  54.     ADVDEC    .H    - data constants & variables declarations
  55.  
  56.     WARNING:
  57.     The TXT files are the ASCII text messages used throughout the
  58.     game.  They may be modified ONLY if you have the utility
  59.     program, "ADVENT0" or the source "ADVENT0.C".  This program
  60.     creates the header file "ADVTEXT.H" which is "#include"d into
  61.     "ADVENT.C" during compilation.  After ANY changes to the "TXT"
  62.     files, recreate a new "ADVTEXT.H" file and rebuild ADVENT.  
  63.     Make sure that the four "TXT" files are in the current directory 
  64.     and ADVENT0 is in the execution directory, then type "ADVENT0<cr>".
  65.  
  66.     "Any changes" includes porting the game to a new computer as the
  67.     line separators in text files may differ (CR/LF in MS-DOS against
  68.     LF in Unix and CR in OS9/68K). In other words, compile ADVENT0 and
  69.     use it to recreate ADVTEXT.H before compiling ADVENT.
  70.  
  71.     The game was first released in the Public Domain for the IBM PC. 
  72.     This involved translation from BDS C to CII C86 and standardizing on 
  73.     UNIX standard i/o library functions plus some DOS-specific memory 
  74.     management functions. The following changes were instituted:
  75.  
  76.     0) UNIX standard i/o
  77.     1) "include"d header files & "extern"al statements added
  78.     2) cave/travel  data arrays are now internal
  79.     3) word/code    data arrays are now internal
  80.     4) TXT message index arrays are now internal
  81.     5) TXT file format doesn't require # terminator character
  82.     6) save & restore game overlays intergrated with "ADVENT.C"
  83.     7) word/code syntax parsing optimized in "ENGLISH.C"
  84.        BINARY LEX-ORDERED WORD LOOK-UP added in "DATABASE.C"
  85.     8) TXT message indexing & output optimized in "DATABASE.C"
  86.     9) TXT message typos corrected
  87.     A) created "ADVENT0.C" utility (cf. #1, #4 & #5)
  88.     B) created "ADVENT.DOC" documentation file
  89.  
  90.     The modifications described above were implemented by:
  91.     Jerry D. Pohl
  92.     1922 Junction Avenue
  93.     San Jose, CA 95131
  94.     (408) 298-1262 / (408) 298-3185        (both 8..6, m..f)
  95.  
  96.  
  97.     The version described above was ported to OS9/68K. This involved the 
  98.     following changes:
  99.  
  100.     1) writing an OS9 version of ltoa().
  101.     2) introducing declarations of printf() and probj()
  102.        to advent.h
  103.     3) using #define to allow fputc() as an alias of putc()
  104.     4) using #define to allow setmem() as an alias of memset()
  105.     5) modifying rspeak() for text files with <cr> separator
  106.        in place of <cr><lf>
  107.     6) rewriting the save/restore game functions to use write()
  108.        and read() in place of counted loops.
  109.     7) setting up a make file
  110.  
  111.     These modifications were carried out by:
  112.     Martin Gregorie
  113.     10 Sadlers Mead
  114.     Harlow, Essex 
  115.     U.K.            (0279) 445 174
  116.