From: Eric S. Raymond <esr@thyrsus.com>
Date: Wed, 28 Jun 2017 14:51:47 +0000 (-0400)
Subject: Comment polishing.
X-Git-Tag: 1.1~58
X-Git-Url: https://jxself.org/git/?a=commitdiff_plain;h=ceb5c27218469fd3732cf6a9ed16d0a2c4e682df;p=open-adventure.git

Comment polishing.
---

diff --git a/main.c b/main.c
index 2eb427b..3d3a8fb 100644
--- a/main.c
+++ b/main.c
@@ -584,8 +584,8 @@ static bool playermove(token_t verb, int motion)
         game.oldloc = game.loc;
     }
 
-    /* Look for a way to fulfil the motion - kk indexes the beginning
-     * of the motion entries for here (game.loc). */
+    /* Look for a way to fulfil the motion verb passed in - kk indexes
+     * the beginning of the motion entries for here (game.loc). */
     for (;;) {
         if (T_TERMINATE(travel[kk]) || travel[kk].motion == motion)
             break;
@@ -606,14 +606,18 @@ static bool playermove(token_t verb, int motion)
         }
         ++kk;
     }
+
+    /* (ESR) We've found a destination that goes with the motion verb.
+     * Next we need to check any conditional(s) on this destination, and
+     * possibly on following entries. */
     scratchloc = T_HIGH(travel[kk]);
 
     do {
         /*
-         * (ESR) This special-travel loop may have to be repeated if it includes
-         * the plover passage.  Same deal for any future cases where we need to
-         * block travel and then redo it once the blocking condition has been
-         * removed.
+         * (ESR) This conditional-skip loop may have to be repeated if
+         * it includes the plover passage.  Same deal for any future
+         * cases where we need to block travel and then redo it once
+         * the blocking condition has been removed.
          */
         for (;;) { /* L12 loop */
             for (;;) {