home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_100 / 159_01 / environ.doc < prev    next >
Text File  |  1990-06-01  |  5KB  |  107 lines
  1. Notes on Adventure Environment
  2. written April 26, 1981
  3.  
  4.         This disk was written and and compiled under version 1.3x and
  5. will NOT compile under version 1.4 and later without changes to the
  6. source.  Specifically dbuff in advent.h on or about line 134 must be
  7. declared so that it is compatible with the 1.4 file i/o.  The com files
  8. on the disk will require at least a 46k system to execute, but
  9. recompiling under 1.4 will add about 1k to the memory requirements
  10. (except that 1.4 produces tighter code).
  11.         The com files provided were debugged on a system including
  12. a 48k Altair equipped with 2 Micropolis drives, and a Processor
  13. Technology VDM.
  14.         To begin play, type advent. To resume a saved game type
  15. "advent -r".
  16.  
  17. Added notes on making this ADVENTURE work in BDS-C Version 1.43
  18. Environment  written 17 May 1981 by L. C. Calhoun.
  19.  
  20.         At Robert Ward's request, I brought this program up on
  21. the 1.43 compiler.  Only one change was required..to add the
  22. small section on buffering from BDSCIO.H to ADVENT.H, and to
  23. change dbuff[134] in ADVENT.H to dbuff[BUFSIZ].  I did review
  24. the other program files for potential changes, and added a
  25. title and note to the head of each for the record.  The compile
  26. and link control syntaxes differ between V 1.4 and older versions.
  27. I made the appropriate changes, and created two submit files;
  28. ADVCOMP.SUB and ADVLINK.SUB.  These must (of course) run on
  29. disk a:, but they are set up for all the c utilities to be on
  30. disk a: and the actual c programs with their .CRL files to be
  31. on b:.  Just PIP these two sub files over to the a: disk where
  32. CC1, CC2, C.CCC, CLINK, DEFF*  etc. hang out.  Only one file
  33. needs to be read two times during linkage - TURN.CRL while
  34. EADVENT.COM is being linked.  Otherwise, it went smoothly
  35. in conversion.
  36.  
  37.         Mr. Jaeger (me too, I must admit) was worried that
  38. the greater buffer size used in the standard V 1.43 library
  39. would have a bad effect on the program length.  I compiled
  40. without the -o option for optimization.  Lo and behold,
  41. the program appears to be considerably shorter.  I was able
  42. to external set the data (-e6A00) much lower than in the
  43. submit files supplied.  I could have even gone lower.
  44. I compiled a second time with the e option in CC1 to -e6A00,
  45. see ADVCOMP.SUB.  Dog gone if the code didn't end at 5EC8.
  46. However, the variables end at 7CA1 even with the -e6A00,
  47. so I didn't bother.
  48.  
  49.         The re-compiles were done on an ALTAIR 8800B, with
  50. a 60K CPM 2.2 system, ADM-3A display, and TARBEL single side
  51. single density controlling four Shugart 801R's.  I checked
  52. the elboeroom callouts during compile, and the least amount
  53. of elboeroom was 20K whilst compiling TURN.C.  So, it appears
  54. that the re-compiled version will compile and run on
  55. a 40K system with about 4K of stack space.  You can pick
  56. up another 2K of stack space by editing the ADVCOMP.SUB file
  57. for the option -e6000 if it's worthwhile.  Thank you Mr. Zolman.
  58.  
  59. ***********************************************************************
  60.  
  61. Written on Sept 18, 1985
  62.  
  63. Port of source code to the MS-DOS environment with the following
  64. target compilers:
  65.  
  66.                   Eco-C88          Version 2.72
  67.                   Lattice C        Version 2.14
  68.                   DeSmet C         Version 2.41
  69.  
  70. Most of the changes required involved the use of file I/O and the
  71. database offset index arrays used in the program.  Conditional code
  72. was added at various points in order to allow the same source to
  73. compile under the three target compilers.  The modules EADVENT.C and
  74. SAVEADV.C were modified from main drivers to called functions in order
  75. that the entire program could be linked into a single executable
  76. module.
  77.  
  78. Under MS-DOS version 2 or higher the default number of files is one
  79. too few to enable the program to run.  A FILES=10 should be added
  80. in your CONFIG.SYS file (I've been using 12).
  81.  
  82. I was unable to get the Lattice version to operate properly using
  83. buffered file I/O.  It appeared that the file offsets returned by
  84. lseek() and ftell() were incorrect while using buffered I/O.  I'm
  85. still scratching my head over this one.  I disabled file buffering
  86. on the Lattice version and it worked perfectly.  Well .... not
  87. exactly perfectly.  Lets put it this way, it operates properly.  A
  88. dead snail could beat it in a race but it does operate as advertised.
  89. If anyone has a clue for a fix to this it would be most appreciated.
  90.  
  91. All versions of the program were compiled on an IBM/PC with 640K and
  92. running under PC-DOS V2.10.  The executable modules were also tried
  93. under PC-DOS V3.00 and on a TIPC with 512K running under MS-DOS V2.13.
  94. The program operated as expected under all configurations.
  95.  
  96. Bob Withers
  97.  
  98. *****************************************************************************
  99.  
  100. Written on June 2nd, 1990
  101.  
  102. The code was once again ported to compile under Microsoft C V5.10 and V6.00
  103. under both MSDOS and OS/2.  Numerous changes and code restructuring were
  104. performed.  See comments in file ADVENT.C for details.
  105.  
  106. Bob Withers
  107.