From ceb5c27218469fd3732cf6a9ed16d0a2c4e682df Mon Sep 17 00:00:00 2001 From: "Eric S. Raymond" Date: Wed, 28 Jun 2017 10:51:47 -0400 Subject: [PATCH] Comment polishing. --- main.c | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) 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 (;;) { -- 2.31.1