home *** CD-ROM | disk | FTP | other *** search
/ 1,000 Games / Disc1.iso / ADVEN / ADOM0996 / ADOM-DOS.TXT next >
Text File  |  1997-07-24  |  7KB  |  196 lines
  1.          === DOS-specific informations about ADOM ===
  2.    === (c)  Copyright 1994, 1995, 1996, 1997 by Thomas Biskup ===
  3.              === All Rights Reserved ===
  4.  
  5.  
  6. TABLE OF CONTENTS
  7. -----------------
  8.  
  9. A. How to install ADOM
  10. B. How to recover after a crash
  11. C. Configuration files
  12. D. What is...?
  13. E. A word about path names
  14. F. Known bugs (please read this)
  15. G. DPMI services
  16.  
  17.  
  18. CONTENTS
  19. --------
  20.  
  21. A. How to install ADOM
  22. ----------------------
  23.  
  24. Installing ADOM is very simple.  This section will tell you how to install
  25. ADOM step by step.  An example will explain each step.  <ENTER> means
  26. that you have to press the enter key after that command. The '>' represents
  27. the command prompt of the DOS shell.
  28.  
  29. Let's assume that you want to install ADOM on your hard disk drive C: in
  30. the directory \games\adom.  The file ADOM-xxx.ZIP (xxx is normally the 
  31. current version number, e.g. 070) for the sake of the example is located
  32. on your floppy drive B:.  The directory C:\GAMES already exists.  You also
  33. have access to PKUNZIP.  You need to do the following:
  34.  
  35. c: <ENTER>
  36. cd \games <ENTER>
  37. mkdir adom <ENTER>
  38. cd adom <ENTER>
  39. copy B:\ADOM-xxx.ZIP <ENTER>
  40. pkunzip ADOM-xxx.ZIP <ENTER>
  41. del ADOM-xxx.ZIP <ENTER>
  42.  
  43. This will install the archive at the location you intended it to be (in the
  44. example).
  45.  
  46. Next you will have to set an environment variable, which will tell ADOM where
  47. to look for the highscore and where to save games. To do this you will have
  48. to edit the autoexec.bat file in the root directory of your boot drive (C:
  49. in most cases). Add the following line at the end of the autoexec.bat and 
  50. then save the file:
  51.  
  52. SET ADOM_HOME=C:\GAMES\ADOM
  53.  
  54. It is important to use the complete path, drive letter included. Finally you
  55. have to add the directory chosen for ADOM_HOME to your path. After you
  56. have done this just reboot the computer. Now you should be able to play
  57. ADOM.
  58.  
  59. If you don't set the ADOM_HOME environment variable, ADOM will create all
  60. necessary files during the game and the highscore file in a subdirectory
  61. of the directory you started ADOM in (called 'ADOM_DAT').  This variable 
  62. naturally is unnecessary if you always start ADOM from its home directory.
  63.  
  64. B. How to recover after a crash
  65. -------------------------------
  66.  
  67. If ADOM crashes you normally won't be able to just restart it without the
  68. risk of ruining further games, because several directories used by ADOM 
  69. will be in an unhealthy state. If ADOM crashes while you are playing you 
  70. will have to do the following two things to ensure, that you can play it
  71. safely in the future:
  72.  
  73. Look for the directory ADOM_DAT\TMPDAT (which might be found either in the 
  74. directory containing all the ADOM files [if you set the ADOM_HOME
  75. environment variable -- see A.] or in the directory from whence you started
  76. ADOM). Once you are in the directory containing ADOM_TMP do the following:
  77.  
  78. cd ADOM_DAT\TMPDAT <ENTER>
  79. del *.* <ENTER>
  80. cd ..
  81. rmdir ADOM_TMP
  82.  
  83. The document bugs.doc will tell you what to do, if you encounter a
  84. fatal bug in ADOM.
  85.  
  86.  
  87. C. Configuration files
  88. ----------------------
  89.  
  90. The DOS version of ADOM does not require any configuration files. 
  91. Appendix D in the manual explains how to write a local configuration file 
  92. individualizing your games. The file is called ADOM.CFG and has to be
  93. located either in the directory defined in the environment variable
  94. ADOM_HOME (see A. and B.) or in the current directory (if you did not
  95. define ADOM_HOME).
  96.  
  97. It is possible to create a file describing where ADOM can find the
  98. highscore file. This file has to be called 'ADOM_DS.CFG' and must be
  99. located in the root directory of the current drive. It has to contain 
  100. only one line: the name of the directory holding the highscore file.
  101.  
  102. Let's assume that you want to save the highscore in C:\DATA. Thus you
  103. would create he file C:\ADOM_DS.CFG which would contain
  104. C:\DATA
  105. as the only line.
  106.  
  107.  
  108. D. What is...?
  109. --------------
  110.  
  111.    adom.exe
  112.     The executable of the game. Just type its name at the command 
  113.     prompt to start the game.
  114.  
  115.    bugs.doc
  116.     The description of how to cope with bugs.
  117.  
  118.    license.doc
  119.     The license for ADOM.
  120.  
  121.    manual.doc
  122.     The manual containing all the information necessary to play the game.
  123.  
  124.    techstat.doc
  125.     A text fulfilling the author's desire for statistical and background
  126.     information about the game.
  127.  
  128.    adom-dos.txt
  129.     You are reading it right now.
  130.  
  131.    plans.doc
  132.     A file listing the programmers' plans concerning the future 
  133.     development of ADOM.
  134.  
  135.    adom.kbd
  136.     The keymap for the game.
  137.  
  138.    ADOM_DAT\
  139.     A directory created by ADOM to save games.
  140.  
  141.    ADOM_DAT\TMPDAT\
  142.     A temporary directory created by ADOM to store temporary data during
  143.     a game. This directory should be gone after a game is ended.  If this
  144.     is not so you are probably facing a bug.
  145.  
  146.    ADOM_DAT\SAVEDG\
  147.     A directory used to hold all the saved games.
  148.  
  149.    hiscore
  150.     The highscore file.
  151.  
  152.  
  153. E. A word about path names
  154. --------------------------
  155.  
  156. ADOM uses a certain way to handle path names unsimilar to what is
  157. usually used on DOS systems.  ADOM internally uses the '/' character
  158. to separate directory names.  Thus instead of using "C:\GAMES\ADOM"
  159. ADOM will use the path "C:/GAMES/ADOM".  This is just an internal
  160. detail which has no meaning for you, the user. If you type "adom -d"
  161. and get path names using the '/' just pretend that the '\' is
  162. used. When defining path names for ADOM, you don't have to care about
  163. this and can use the usual DOS conventions. ADOM internally converts
  164. DOS path names to the special format.  For those interested in the
  165. details of the implementation: this somewhat strange feature is there,
  166. because ADOM was compiled with the GCC for DOS, which internally uses
  167. the '/' character.
  168.  
  169. F. Known Bugs
  170. -------------
  171.  
  172. * ADOM does not seem to work when started from a drive created with 
  173.   the SUBST command (refer to your DOS-documentation, when you are using 
  174.   it).
  175.  
  176. * ADOM seems to have problems to work together with the cache program
  177.   from Norton Utilities (reported under DOS 6.22).  You might want to
  178.   disable the cache software before booting to play ADOM.
  179.  
  180. * If you have installed Windows 95, run ADOM only after rebooting to DOS
  181.   (and not just in a DOS window).  Win95 is extremely strange in some
  182.   ways... In most cases ADOM is known to work correctly even if started
  183.   from within Windows 95, but there have been some reports which seem
  184.   to indicate that some Win95 configurations might spell trouble.
  185.  
  186.   ADOM is also unable to handle the long filenames provided by Windows 95.
  187.  
  188.  
  189. G. DPMI services
  190. ----------------
  191.  
  192. ADOM needs a DPMI host to run.  If you don't have installed a DPMI server
  193. you can use the free DPMI server included in the ADOM package.  It's called
  194. CWSDPMI.EXE.  Simply run it immediately before starting ADOM and everything
  195. should be fine.  Details about CWSDPMI.EXE can be found in CWSDPMI.DOC.
  196.