annotate rogue3/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
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
31
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
1 Roguelike Gallery (rlgallery.org)
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
2
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
3 This is the source code for the Roguelike Gallery's version of Rogue V3.
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
4
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
5 History
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
6 Rogue 3 was released by Michael Toy, Ken Arnold, and Glenn Wichman, probably
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
7 late in 1980. It went through several minor updates. The last, Rogue 3.6,
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
8 was completed mid-June 1981.
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
9
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
10 The Roguelike Restoration Project (rogue.rogueforge.net) updated the game to
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
11 work on modern systems.
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
12
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
13 The Roguelike Gallery's version has been slightly modified for compatibility
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
14 with dgamelaunch and security for multiple players.
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
15
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
16 Installing
90
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
17 Rogue V3 now uses autotools. Run 'autoreconf' and then './configure' to
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
18 configure for your system. Once that's finished, compile by running make. (I
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
19 haven't tested the Visual Studio project files on Windows, but they should
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
20 work.)
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
21
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
22 If you don't use any options with './configure', rogue3 will keep the high
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
23 score list in whatever directory you run it from. If you just want to play
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
24 the game yourself, this will work.
31
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
25
90
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
26 If you want multi-user play, use the '--enable-setgid' and '--enable-savedir'
106
c191a735f811 Update some of the documentation.
John "Elwin" Edwards
parents: 90
diff changeset
27 options to 'configure'. You will also likely want to use '--enable-scorefile'
c191a735f811 Update some of the documentation.
John "Elwin" Edwards
parents: 90
diff changeset
28 and '--enable-logfile' to set the locations of those files. After compiling,
c191a735f811 Update some of the documentation.
John "Elwin" Edwards
parents: 90
diff changeset
29 run 'make install'.
31
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
30
90
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
31 There are other possible features, including wizard (debugging) mode. To see
c9c6bb34734d rogue3: update the installation instructions.
John "Elwin" Edwards
parents: 31
diff changeset
32 the full list, run './configure --help'.
31
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
33
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
34 Playing
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
35 For more details, see readme36.html (contains the man page) and rogue36.html
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
36 (Michael Toy's "Guide to the Dungeons of Doom").
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
37
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
38 Contact
106
c191a735f811 Update some of the documentation.
John "Elwin" Edwards
parents: 90
diff changeset
39 rlgallery.org admin: John "Elwin" Edwards <elwin@sdf.org>