Comment improvements.

diff --git a/adventure.yaml b/adventure.yaml
index 18780a3839ac9ee045c1d35df6b4053c78893c32..cb577bd97b464454f2e10fe4bb3225a9e4e3f889 100644 (file)
--- a/adventure.yaml
+++ b/adventure.yaml
@@ -112,12 +112,14 @@
 # message when the message is printed.  These sequences are:
 #       %d = an integer
 #       %s = an ASCII string
-#      %S = The letter 's' or nothing (if a previous %d value is exactly 1)
+#      %S = the letter 's' or nothing (if a previous %d value is exactly 1)
 #      %V = substitute program version string
 #
 # Copyright (c) 2017 by Eric S. Raymond
 # SPDX-License-Identifier: BSD-2-clause
 
+# Motion names of the form MOT_* are not explicitly referenced in the
+# locations YAML, but usually get compiled into generated C.
 motions: !!omap
 - MOT_0:
     words: !!null