Return to README.txt CVS log

Up to [contributed] / early-roguelike

Annotation of early-roguelike/README.txt, Revision 1.1.1.1

1.1       rubenllo    1: --- Early Roguelike Collection
                      2:
                      3: This is the source for the Roguelike Gallery's versions of Rogue and other
                      4: early roguelike games, including Super-Rogue, Advanced Rogue, and XRogue.
                      5:
                      6: The code was obtained from the Roguelike Restoration Project (Web site at
                      7: rogue.rogueforge.net).  Modifications have been made for compatibility with the
                      8: dgamelaunch play system, and compliance with modern C compiler standards.  Some
                      9: bugs have also been fixed, and the build process slightly improved.  The
                     10: essential flavor of a codebase half as old as stored-program computing
                     11: machinery remains unchanged.  The gameplay and the user interface will be kept
                     12: true to the originals.
                     13:
                     14: This collection does not contain the versions of Rogue commercially released by
                     15: Epyx for DOS, the Mac, and other graphical platforms of the 1980's.  Nor does
                     16: it include Rogue Clone, a reimplementation sometimes found in BSD or Linux
                     17: distributions.
                     18:
                     19: UltraRogue has recently been added to the collection.  It is still in an
                     20: experimental state, with several known bugs.
                     21:
                     22: --- Installation
                     23:
                     24: To install on Unix (including OS X):
                     25:
                     26: If you checked out the source from Mercurial, run 'autoreconf' first.
                     27:
                     28: Build by running './configure' and then 'make' within each game's subdirectory.
                     29: If you only want to play the games from one user account, 'configure' won't
                     30: need any options.  The games will keep the high score lists in whatever
                     31: directory you run them from.
                     32:
                     33: For a multi-user installation, you will need to set the '--enable-setgid',
                     34: '--enable-savedir', '--enable-scorefile', and '--enable-logfile' options.  Run
                     35: 'make install' with root privileges after building.
                     36:
                     37: There are other possible options; run './configure --help' for a full list.
                     38:
                     39: To install on Windows:
                     40:
                     41: Visual Studio solution and project files are included.  They are still being
                     42: tested but should work with Visual Studio 2015 on Windows 8.1.
                     43:
                     44: You will need pdcurses before you can build.  Create a folder called 'pdcurses'
                     45: in this folder and copy into it curses.h, term.h, and pdcurses.lib from the
                     46: pdcurses distribution.
                     47:
                     48: You can also build on Windows using MinGW.  Make sure pdcurses is installed.
                     49: You will have to go into the '/lib' folder and copy 'libpdcurses.a' to
                     50: 'libcurses.a', and 'libpdcurses.dll.a' to 'libcurses.dll.a'; this should get
                     51: fixed soon.
                     52:
                     53: It is recommended to run 'configure' with the '--disable-logfile' option, and
                     54: 'make' with the 'LDFLAGS=-static' option.
                     55:
                     56: UltraRogue is not yet integrated with Autoconf or the Visual Studio solution
                     57: file.
                     58:
                     59: See the individual games' subdirectories for further documentation.  Some of
                     60: the manpages may be outdated, but the guides to playing should be accurate.
                     61:
                     62: The games can be played via SSH or the Web at rlgallery.org.
                     63:
                     64: --- Licensing
                     65:
                     66: Each game is covered by its own license, usually some variant of the 4-clause
                     67: BSD license.  See the LICENSE.TXT files in the individual subdirectories for
                     68: more details.
                     69:
                     70: All modifications made by the Roguelike Gallery are available under the same
                     71: terms as the game to which they were made.
                     72:
                     73: --- Bugs
                     74:
                     75: The original authors claimed that the list of bugs was "probably infinite".  If
                     76: you encounter one of these, please report it on the bug tracker at
                     77: https://bitbucket.org/ElwinR/rl.