home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 7 Games / 07-Games.zip / angbd291.zip / compile.txt < prev    next >
Text File  |  2000-07-25  |  9KB  |  184 lines
  1. Compiling Angband 2.9.1
  2. =======================
  3.  
  4. Last updated on 15th July 2000 by Robert Ruehlmann
  5.  
  6.  
  7. ----------------------------------------------------------------------
  8. Quick and dirty compilation instructions
  9. ----------------------------------------------------------------------
  10.  
  11. For many platforms (including Windows and DOS), a "pre-compiled" archive
  12. is available, which contains everything you need to install and play
  13. Angband.  For other platforms, including most UNIX systems, you must
  14. compile the source code yourself.  Try the following non-trivial steps:
  15.  
  16. Step 1: Acquire.  Ftp to "export.andrew.cmu.edu:/angband/Source"
  17.                   Try "bin" and "mget angband*.tar.gz" and "y"
  18. Step 2: Extract.  Try "gunzip *.gz" then "tar -xvf *.tar"
  19. Step 3: Prepare.  Try "cd angband*/src", then edit "Makefile"
  20.                   You may also edit "h-config.h" and "config.h"
  21. Step 4: Compile.  Try "make", and then "cd .." if successful
  22. Step 5: Execute.  Try "angband -uTest" to initialize stuff
  23.  
  24. Step 6: Play....  Read the "online help" via the "?" command.
  25.  
  26. Of course, if you have a compiler, you can compile a (possibly customized)
  27. executable on almost any system.  You will need the "source archive" (as
  28. above), which contains the standard "src" and "lib" directories, and for
  29. some platforms (including Macintosh and Windows), you will also need an
  30. appropriate "extra archive", which contains some extra platform specific
  31. files, and instructions about how to use them.  Some "extra archives" may
  32. be found at the ftp site (including "/angband/Macintosh/ext-mac.sit.bin"
  33. and "/angband/Windows/ext-win.zip"), but be sure that you get a version
  34. of the "extra archive" designed for Angband 2.9.1.
  35.  
  36.  
  37. ----------------------------------------------------------------------
  38. DOS + DJGPP
  39. ----------------------------------------------------------------------
  40. (written by Robert Ruehlmann < rr9@angband.org >)
  41.  
  42. - Install DJGPP:
  43.     You can get the freely available DJGPP C Compiler from
  44.     < http://www.delorie.com/djgpp/ >.  On the DJGPP-page go to the
  45.     Zip-Picker < http://www.delorie.com/djgpp/zip-picker.html >.
  46.     This page helps you decide which ZIP files you need to download
  47.     and will even try to find a ftp-site near you.  The only thing you
  48.     need to change on this page is under 'Extra Stuff/Toolkits'.
  49.     Select the Allegro-library < http://www.talula.demon.co.uk/allegro/ >
  50.     if you want graphics and sound support.  Get all files suggested and
  51.     follow the installation instructions.
  52. - Install the Angband source:
  53.     Get the source code archive and the untgz tool from:
  54.     "ftp://export.andrew.cmu.edu/angband/Tool/untgz.exe" or
  55.     "ftp://ftp.sunet.se/pub/games/Angband/Tool/untgz.exe".
  56.     Then extract the source with untgz ("untgz angban~1.tgz").
  57. - Install other required files:
  58.     Get the "extra archive" from
  59.     < ftp://export.andrew.cmu.edu/angband/DOS-386/ext-dos.zip > or
  60.     < ftp://ftp.sunet.se/pub/games/Angband/DOS-386/ext-dos.zip >.
  61.     Go to the angband-291 directory and unzip the ext-dos archive into it.
  62.     Then get the graphics archive from
  63.     < ftp://export.andrew.cmu.edu/angband/Extra/angband-graf.zip > or
  64.     < ftp://ftp.sunet.se/pub/games/Angband/Extra/angband-graf.zip >
  65.     and unzip it into the lib/xtra/graf/ folder.
  66. - Select the makefile:
  67.     Go to the src-directory and rename 'makefile.dos' (or 'makefile.ibm'
  68.     if you don't want graphics and sound and didn't download the Allegro
  69.     library) to 'makefile'.
  70. - Compile Angband:
  71.     Run "make install".  Angband should now be compiled and installed
  72.     into the Angband folder.
  73. - Run Angband:
  74.     Go back to the Angband folder and run Angband.exe.
  75.  
  76.  
  77. ----------------------------------------------------------------------
  78. Windows 95/98/NT/2000 + MS Visual C++ 5.0/6.0
  79. ----------------------------------------------------------------------
  80. (written by Robert Ruehlmann < rr9@angband.org >)
  81.  
  82. - Install the Angband source:
  83.     Get the source code and the untgz tool from:
  84.     "ftp://export.andrew.cmu.edu/angband/Tool/untgz32.exe" or
  85.     "ftp://ftp.sunet.se/pub/games/Angband/Tool/untgz32.exe".
  86.     Then extract the source with "untgz32 angband-291-src.tgz".
  87. - Install other required files:
  88.     Get the "extra archive" from
  89.     < ftp://export.andrew.cmu.edu/angband/Windows/ext-win.zip > or
  90.     < ftp://ftp.sunet.se/pub/games/Angband/Windows/ext-win.zip >.
  91.     Go to the angband-291 directory and unzip the ext-win archive into it.
  92.     Again make sure the directory structure is preserved (use the -d
  93.     option in pkunzip).
  94.     Then get the graphics archive from
  95.     < ftp://export.andrew.cmu.edu/angband/Extra/angband-graf.zip > or
  96.     < ftp://ftp.sunet.se/pub/games/Angband/Extra/angband-graf.zip >
  97.     and unzip it into the lib/xtra/graf/ folder.
  98. - Open the project-file:
  99.     Go to the src-folder and open the file "Angband.dsw".  That opens
  100.     Visual C++ already properly configured for compiling Angband.
  101. - Compile Angband:
  102.     Select "Build Angband.exe" in the Build menu.  Angband should now
  103.     be compiled and the Angband.exe will be placed into the "angband-291"
  104.     directory.
  105. - Run Angband:
  106.     Go back to the Angband-folder and run the Angband.exe.
  107.  
  108.  
  109. ----------------------------------------------------------------------
  110. Windows 95/98/NT/2000 + Borland C++ 5.5 commandline tools
  111. ----------------------------------------------------------------------
  112. (written by Robert Ruehlmann < rr9@angband.org >)
  113.  
  114. - Getting the free commandline tools:
  115.     Download the Borland commandline tools from
  116.     http://www.borland.com/bcppbuilder/freecompiler/
  117.     and follow the installation instructions.
  118. - Install the Angband source:
  119.     Get the source code and  the untgz tool from:
  120.     "ftp://export.andrew.cmu.edu/angband/Tool/untgz32.exe" or
  121.     "ftp://ftp.sunet.se/pub/games/Angband/Tool/untgz32.exe".
  122.     Then extract the source with "untgz32 angband-291-src.tgz".
  123. - Install other required files:
  124.     Get the "extra archive" from
  125.     < ftp://export.andrew.cmu.edu/angband/Windows/ext-win.zip > or
  126.     < ftp://ftp.sunet.se/pub/games/Angband/Windows/ext-win.zip >.
  127.     Go to the angband-291 directory and unzip the ext-win archive into it.
  128.     Again make sure the directory structure is preserved (use the -d
  129.     option in pkunzip).
  130.     Then get the graphics archive from
  131.     < ftp://export.andrew.cmu.edu/angband/Extra/angband-graf.zip > or
  132.     < ftp://ftp.sunet.se/pub/games/Angband/Extra/angband-graf.zip >
  133.     and unzip it into the lib/xtra/graf/ folder.
  134. - Compile Angband:
  135.     Open a commandline window and go to the src-directory.  Run
  136.     "make -f makefile.bcc install".  Angband should now be compiled
  137.     and installed into the Angband folder.
  138. - Run Angband:
  139.     Go back to the Angband-folder and run the Angband.exe.
  140.  
  141.  
  142. ----------------------------------------------------------------------
  143. Linux + GCC
  144. ----------------------------------------------------------------------
  145. (written by Robert Ruehlmann < rr9@angband.org >)
  146.  
  147. - Install the Angband source:
  148.     Extract the source code with "tar -xvzf angband-291-src.tgz".
  149. - Install the graphics files:
  150.     If you want to use graphics under X11 then get the archive from
  151.     < ftp://export.andrew.cmu.edu/angband/Extra/angband-graf.zip > or
  152.     < ftp://ftp.sunet.se/pub/games/Angband/Extra/angband-graf.zip >
  153.     and unzip it into the lib/xtra/graf/ folder.
  154. - Prepare the makefile:
  155.     Go to the angband-291/src directory, rename Makefile.std to
  156.     Makefile.  The makefile is already configured properly to compile
  157.     a version with support for both console (using ncurses) and X11.
  158.     If this configuration doesn't work for you then you might have to
  159.     open the makefile with your favorite text-editor and select one
  160.     of the other variations for Linux.
  161. - Compiling Angband:
  162.     Run "make install".  Angband should now be compiled and installed
  163.     into the "angband-291" folder.  Go back to the angband-291
  164.     directory.
  165. - Setting the proper access rights for a single user:
  166.     If you don't have root-access to the machine, or just want to
  167.     set up the game for multiple users then you just have to make
  168.     angband executable with "chmod u+x angband".
  169.     You can skip the next step.
  170. - Setting the proper access rights for multiple users:
  171.     To allow proper use of Angband on a Linux system with multiple
  172.     users, you must make the angband executable owned and setuid to
  173.     games.  Note that you need root-access to change the ownership of
  174.     files.  Use "chown games angband" and "chmod +xs angband".
  175.      This makes the game executable for everyone, while turning on the
  176.      "suid bit". That bit makes the game run as if it were user "games",
  177.      so that the game has write access to savefiles and so on, but normal
  178.      users don't.  Then use "chown -R games lib" to make all files in the
  179.      lib-folder owned by the user games so that Angband can write
  180.      savefiles, scores, and other files.
  181. - Run Angband:
  182.     "./angband" should start Angband.
  183.  
  184.