X-Git-Url: https://jxself.org/git/?a=blobdiff_plain;f=advent.adoc;h=d2b60d6e8537c3eae17405fe9f6b12ede77dd45f;hb=ac0c5fc024792193286bc6cfbdca5fc08241bfc8;hp=cd4a8c2852d24b482b5282bf2c9953ea95981bca;hpb=129226b58a424b3436c3a6ef63663f3659cf7092;p=open-adventure.git

diff --git a/advent.adoc b/advent.adoc
index cd4a8c2..d2b60d6 100644
--- a/advent.adoc
+++ b/advent.adoc
@@ -5,7 +5,7 @@
 advent - Colossal Cave Adventure
 
 == SYNOPSIS ==
-*advent* [-l logfile] [-o] [-r savefile] [-s]
+*advent* [-l logfile] [-o] [-r savefile] [script...]
 
 == DESCRIPTION ==
 The original Colossal Cave Adventure from 1976-77 was the origin of all
@@ -40,11 +40,17 @@ There have been no gameplay changes.
 
 -l:: Log commands to specified file.
 
--s:: Suppress Emacs-like line editing and command history.
-
 -r:: Restore game from specified file
 
+-a:: Load from specified file and autosave to it on exit or signal.
+
 -o:: 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.
+
+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 '-' is taken as a directive to read from standard input.
 
 == BUGS ==
 
@@ -52,6 +58,24 @@ 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.
 
+The input parser was the first attempt *ever* at natural-language
+parsing in a game and has some known deficiencies.  While later text
+adventures distinguished between transitive and intransitive verbs,
+Adventure's 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's seen one of each, and then dispatches; if it reaches
+the end of the command without seeing a noun, it'll dispatch an
+"intransitive" action. This makes ACTION1 ACTION2 equivalent to
+ACTION2 (thus TAKE INVENTORY means INVENTORY), and NOUN ACTION
+equivalent to ACTION NOUN.
+
+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.
+
 == REPORTING BUGS ==
 Report bugs to Eric S. Raymond <esr@thyrsus.com>.  The project page is
 at http://catb.org/~esr/open-adventure