Doc fixes & clarifications.

include/loan.h

@@ -43,7 +43,7 @@ struct lonstr {
     short l_uid;
     natid l_lonee;		/* sucker */
     s_char l_status;		/* loan status */
-    short l_sell;		/* pointer to trade file */
+    short l_sell;		/* pointer to trade file (unused) */
     int l_irate;		/* interest rate */
     int l_ldur;			/* intended duration */
     long l_amtpaid;		/* amount paid so far */

include/match.h

@@ -36,7 +36,7 @@
 
 #include <stddef.h>
 
-/* returned by stmtch() */
+/* returned by stmtch() and comtch() */
 #define M_IGNORE        -3
 #define M_NOTUNIQUE	-2
 #define M_NOTFOUND	-1

include/treaty.h

@@ -42,7 +42,7 @@ struct trtstr {
     s_char trt_fill;
     short trt_acond;		/* conditions for proposer */
     short trt_bcond;		/* conditions for accepter */
-    float trt_bond;		/* amount of bond involved */
+    float trt_bond;		/* amount of bond involved (unused) */
     time_t trt_exp;		/* expiration date */
 };
 

src/lib/common/stmtch.c

@@ -45,7 +45,7 @@
  * several.
  * Each array element has a pointer to its name stored at offset OFFS.
  * Search stops when this name is a null pointer or empty.  NEEDLE is
- * compared to element names with mineq().
+ * compared to element names with mineq(NEEDLE, NAME).
  * ELT_SIZE gives the size of an array element.
  */
 int

src/lib/subs/nstr.c

@@ -391,6 +391,7 @@ nstr_coerce_val(struct valstr *val, nsc_type to, char *str)
 
 /*
  * Evaluate VAL.
+ * If VAL is symbolic, evaluate it into a promoted value type.
  * Use coordinate system of country CNUM.
  * PTR points to a context object of the type that was used to compile
  * the value.