Magic-number elimination.
[open-adventure.git] / advent.adoc
1 = advent(6) =
2 :doctype: manpage
3
4 == NAME ==
5 advent - Colossal Cave Adventure
6
7 == SYNOPSIS ==
8 *advent* [-l logfile] [-o] [-r savefile] [-s]
9
10 == DESCRIPTION ==
11 The original Colossal Cave Adventure from 1976-77 was the origin of all
12 later text adventures, dungeon-crawl (computer) games, and computer-hosted
13 roleplaying games.
14
15 This is the last version released by Crowther & Woods, its original
16 authors, in 1995.  It has been known as "adventure 2.5" and "430-point
17 adventure".  To learn more about the changes since the 350-point
18 original, type 'news' at the command prompt.
19
20 There is an 'adventure' in the BSD games package that is a C port by
21 Jim Gillogly of the 1976 ancestor of this game.  To avoid a name
22 collision, this game builds as 'advent', reflecting the fact that the
23 PDP-10 on which the game originally ran limited filenames to 6 characters.
24
25 This version is released as open source with the permission and
26 encouragement of the original authors.
27
28 Unlike the original, this version supports use of your arrow keys to edit
29 your command line in place.  Basic Emacs keystrokes are supported, and
30 your up/down arrows access a command history.
31
32 Otherwise, the "version" command is about the only way to tell you're not
33 running Don's original.
34
35 To exit the game, type Ctrl-D (EOF).
36
37 There have been no gameplay changes.
38
39 == OPTIONS ==
40
41 -l:: Log commands to specified file.
42
43 -r:: Restore game from specified file
44
45 -o:: Old-style.  Restores original interface, no prompt or line editing.
46      Also ignores new-school one-letter commands l, x, g, z, i. Also
47      case-smashes and truncates unrecognized text when echoed.
48
49 == BUGS ==
50
51 The binary save file format is fragile, dependent on your machine word
52 size and endianness, and unlikely to survive through version bumps. There
53 is a version check.
54
55 == REPORTING BUGS ==
56 Report bugs to Eric S. Raymond <esr@thyrsus.com>.  The project page is
57 at http://catb.org/~esr/open-adventure
58
59 == SEE ALSO ==
60 wumpus(6), adventure(6), zork(6), rogue(6), nethack(6).