'\" t
.\"     Title: advent
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL-NS Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 04/08/2022
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "ADVENT" "6" "04/08/2022" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
advent \- Colossal Cave Adventure
.SH "SYNOPSIS"
.sp
\fBadvent\fR [\-l logfile] [\-o] [\-r savefile] [script\&...]
.SH "DESCRIPTION"
.sp
The original Colossal Cave Adventure from 1976\-77 was the origin of all later text adventures, dungeon\-crawl (computer) games, and computer\-hosted roleplaying games\&.
.sp
This is the last version released by Crowther & Woods, its original authors, in 1995\&. It has been known as "adventure 2\&.5" and "430\-point adventure"\&. To learn more about the changes since the 350\-point original, type \fInews\fR at the command prompt\&.
.sp
There is an \fIadventure\fR in the BSD games package that is a C port by Jim Gillogly of the 1976 ancestor of this game\&. To avoid a name collision, this game builds as \fIadvent\fR, reflecting the fact that the PDP\-10 on which the game originally ran limited filenames to 6 characters\&.
.sp
This version is released as open source with the permission and encouragement of the original authors\&.
.sp
Unlike the original, this version supports use of your arrow keys to edit your command line in place\&. Basic Emacs keystrokes are supported, and your up/down arrows access a command history\&.
.sp
Otherwise, the "version" command is about the only way to tell you\(cqre not running Don\(cqs original\&.
.sp
To exit the game, type Ctrl\-D (EOF)\&.
.sp
There have been no gameplay changes\&.
.SH "OPTIONS"
.PP
\-l
.RS 4
Log commands to specified file\&.
.RE
.PP
\-r
.RS 4
Restore game from specified file
.RE
.PP
\-o
.RS 4
Old\-style\&. Restores original interface, no prompt or line editing\&. Also ignores new\-school one\-letter commands l, x, g, z, i\&. Also case\-smashes and truncates unrecognized text when echoed\&.
.RE
.sp
Normally, game input is taken from standard input\&. If script file arguments are given, input is taken fron them instead\&. A script file argument of \fI\-\fR is taken as a directive to read from standard input\&.
.SH "BUGS"
.sp
The binary save file format is fragile, dependent on your machine word size and endianness, and unlikely to survive through version bumps\&. There is a version check\&.
.sp
The input parser was the first attempt \fBever\fR at natural\-language parsing in a game and has some known deficiencies\&. While later text adventures distinguished between transitive and intransitive verbs, Adventure\(cqs grammar distinguishes only between motion and action verbs\&. Motions are always immediate in their behavior, so both ACTION MOTION and MOTION ACTION (and even MOTION NOUN and MOTION MOTION) are invariably equivalent to MOTION (thus GO NORTH means NORTH and JUMP DOWN means JUMP)\&. Whereas, with actions and nouns, the parser collects words until it\(cqs seen one of each, and then dispatches; if it reaches the end of the command without seeing a noun, it\(cqll dispatch an "intransitive" action\&. This makes ACTION1 ACTION2 equivalent to ACTION2 (thus TAKE INVENTORY means INVENTORY), and NOUN ACTION equivalent to ACTION NOUN\&.
.sp
Thus you get anomalies like "eat building" interpreted as a command to move to the building\&. These should not be reported as bugs; instead, consider them historical curiosities\&.
.SH "REPORTING BUGS"
.sp
Report bugs to Eric S\&. Raymond <esr@thyrsus\&.com>\&. The project page is at http://catb\&.org/~esr/open\-adventure
.SH "SEE ALSO"
.sp
wumpus(6), adventure(6), zork(6), rogue(6), nethack(6)\&.