view rogue4/INSTALL.txt @ 111:7f8f43943b1f

Fix some terribly depressing corruption during restore. In rogue5/state.c, rs_read_daemons() zeroes out the argument and delay if the daemon slot is empty. Unfortunately that code ended up on the wrong side of the brace that closes the for loop, so instead of running after each daemon, it got run once after the loop exited, when the index was of course out of bounds. This tended to manifest, when compiled with -O2, by overwriting hw and setting it to NULL. When inventory() next ran, hw would be passed to wgetch(), which returns ERR when it gets a NULL argument. This made md_readchar() think something was wrong and autosave the game. Upon investigation, rogue3 was found to commit the same mistake. rogue4 and srogue don't zero the data. arogue5 already does it properly. Someday I am going to run all this through Valgrind. Someday when I am a kinder person who will not be driven to invoke hordes of trolls and centaurs upon the original authors.
author John "Elwin" Edwards
date Wed, 08 Jan 2014 16:44:16 -0500
parents c191a735f811
children
line wrap: on
line source

		       Roguelike Gallery (rlgallery.org)

This is the source code for the Roguelike Gallery's version of Rogue V4.

History
Rogue 4.2 was released by Michael Toy, Ken Arnold, and Glenn Wichman, probably 
early in 1982.  Several updates were issued, and the major version number was 
incremented, so the last of the series was Rogue 5.2, released April 1982.

The Roguelike Restoration Project (rogue.rogueforge.net) updated the game to 
work on modern systems.

The Roguelike Gallery's version has been slightly modified for compatibility 
with dgamelaunch and security for multiple players.

Installing
On Unix, you can use the "./configure && make && make install" method.  If
you don't need a system-wide installation, you should be able to ignore all 
the options for "configure" and leave off the "make install".

If you want multi-user play, run configure with the proper options ("configure
--help" will explain what they do.)  The important ones are savedir (where
saved games are stored), scorefile (the high score list), and logfile (the log
of all games played).  You should probably also use '--enable-setgid=games' and 
'--disable-lockfile'.

On Windows, I haven't tested the Visual Studio project files; the game should
build, but the scorefile might not work. 

Playing
For more details, see rogue4.6 (the man page) and rogue4.me (Michael
Toy's "Guide to the Dungeons of Doom").  Troff format is a little outdated, but
you should be able to discover something with a text editor.  I plan to add
versions in more common formats soon.

Contact
rlgallery.org admin: John "Elwin" Edwards <elwin@sdf.org>