Documentation polishing.
authorEric S. Raymond <esr@thyrsus.com>
Mon, 5 Feb 2024 12:43:23 +0000 (07:43 -0500)
committerEric S. Raymond <esr@thyrsus.com>
Mon, 5 Feb 2024 12:43:23 +0000 (07:43 -0500)
advent.adoc

index 9e628e008f2c3badb7bc820c330e114787b907fe..d7231f60c3ae6963e55b05ecfcceee0cab7fabf3 100644 (file)
@@ -20,9 +20,9 @@ adventure".  To learn more about the changes since the 350-point
 original, type 'news' at the command prompt.
 
 There is an 'adventure' in the BSD games package that is a C port by
 original, type 'news' at the command prompt.
 
 There is an 'adventure' in the BSD games package that is a C port by
-Jim Gillogly of the Don Woods's 1977 version of this game.  To avoid a name
-collision, this game builds as 'advent', reflecting the fact that the
-PDP-10 on which the game originally ran limited filenames to 6 characters.
+Jim Gillogly of the 1977 version.  To avoid a name collision, this game
+builds as 'advent', reflecting the fact that the PDP-10 on which the
+game originally ran limited filenames to 6 characters.
 
 This version is released as open source with the permission and
 encouragement of the original authors.
 
 This version is released as open source with the permission and
 encouragement of the original authors.
@@ -34,7 +34,8 @@ command history.
 
 Some minor bugs and message typos have been fixed.  Otherwise, the
 "version" command is almost the only way to tell you're not running
 
 Some minor bugs and message typos have been fixed.  Otherwise, the
 "version" command is almost the only way to tell you're not running
-Don's 1977 version.
+Don's 1977 version until you get to the new cave sections added for
+2.5.
 
 To exit the game, type Ctrl-D (EOF).
 
 
 To exit the game, type Ctrl-D (EOF).
 
@@ -44,9 +45,9 @@ There have been no gameplay changes.
 
 -l:: Log commands to specified file.
 
 
 -l:: Log commands to specified file.
 
--r:: Restore game from specified file
+-r:: Restore game from specified save file
 
 
--a:: Load from specified file and autosave to it on exit or signal.
+-a:: Load from specified save file and autosave to it on exit or signal.
 
 -o:: Old-style.  Reverts some minor cosmetic fixes in game
      messages. Restores original interface, no prompt or line editing.
 
 -o:: Old-style.  Reverts some minor cosmetic fixes in game
      messages. Restores original interface, no prompt or line editing.
@@ -59,9 +60,9 @@ argument of '-' is taken as a directive to read from standard input.
 
 == BUGS ==
 
 
 == BUGS ==
 
-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 binary save file format is fragile, dependent on your machine's
+endianness, and unlikely to survive through version bumps. There are
+version and emdianness checks when attempting to restore from a save.
 
 The input parser was the first attempt *ever* at natural-language
 parsing in a game and has some known deficiencies.  While later text
 
 The input parser was the first attempt *ever* at natural-language
 parsing in a game and has some known deficiencies.  While later text