annotate rogue4/INSTALL.txt @ 83:09db0cf536af

Properly handle invalid room references in savefiles. In all games, rs_write_room_reference() stored -1 for a nonexistent room, but rs_read_room_reference() did not check for out-of-bounds values, leading to pointers to rooms[-1], which sometimes caused crashes. rs_read_room_reference() has now been modified to use NULL instead. Some of the games required further changes to replace NULL with the pointer to the actual room. Others are capable of handling NULL for objects not in any room.
author John "Elwin" Edwards
date Thu, 08 Aug 2013 12:41:35 -0700
parents a31b2cb545c5
children c191a735f811
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 V4.
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 4.2 was released by Michael Toy, Ken Arnold, and Glenn Wichman, probably
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
7 early in 1982. Several updates were issued, and the major version number was
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
8 incremented, so the last of the series was Rogue 5.2, released April 1982.
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
54
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
17 On Unix, you can use the "./configure && make && make install" method. If
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
18 you don't need a system-wide installation, you should be able to ignore all
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
19 the options for "configure" and leave off the "make install".
31
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
20
54
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
21 If you want multi-user play, run configure with the proper options ("configure
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
22 --help" will explain what they do.) The important ones are savedir (where
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
23 saved games are stored), scorefile (the high score list), and logfile (the log
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
24 of all games played).
31
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
25
54
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
26 On Windows, I haven't tested the Visual Studio project files; the game should
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
27 build, but the scorefile might not work.
31
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
28
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
29 Playing
54
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
30 For more details, see rogue4.6 (the man page) and rogue4.me (Michael
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
31 Toy's "Guide to the Dungeons of Doom"). Troff format is a little outdated, but
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
32 you should be able to discover something with a text editor. I plan to add
a31b2cb545c5 rogue4: update the installation instructions.
elwin
parents: 31
diff changeset
33 versions in more common formats soon.
31
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
34
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
35 Contact
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
36 rlgallery.org admin: John "Elwin" Edwards <elwin@sdf.lonestar.org>