A few comment fixes for nsc.[ch] file.[ch]

diff --git a/include/file.h b/include/file.h
index f66dd3ba5ddcb45163bfab387ae3805afadc33f3..bd6ff3b1d42ab38e3c93f422e0176e4f674d995f 100644 (file)
--- a/include/file.h
+++ b/include/file.h
@@ -61,6 +61,7 @@ struct empfile {
     /* User callbacks, may all be null */
     /*
      * Called after element initialization.  ELT is the element.
+     * May modify the element.
      */
     void (*oninit)(void *elt);
     /*
@@ -107,7 +108,7 @@ struct emptypedstr {
 #define EFF_XY         bit(1)
 #define EFF_OWNER      bit(2)
 #define EFF_GROUP      bit(3)
-/* Table is allocated statically */
+/* Table cache is allocated statically */
 #define EFF_STATIC     bit(4)
 /* Table has a sentinel (all zero, not counted as elt), implies EFF_MEM */
 #define EFF_SENTINEL   bit(5)

diff --git a/include/nsc.h b/include/nsc.h
index 45876681b77e055aab6a744886f0628b6828bf17..9abab00270de7b671a5cf63971924ceb716154f4 100644 (file)
--- a/include/nsc.h
+++ b/include/nsc.h
@@ -207,12 +207,12 @@ enum {
  * ca_len is zero), or an array of ca_len elements of that type.
  * If ca_get is not null, the selector is virtual.  Values can be
  * obtained by calling ca_get(VAL, NP, CTXO), where VAL has been
- * initialized my from the selector and an index by nstr_mksymval(),
+ * initialized from the selector and an index by nstr_mksymval(),
  * NP points to the country to use for coordinate translation and
  * access control (null for none), and CTXO is the context object.
  * See struct valstr for details.
  * Because virtual selectors don't have a setter method, xundump must
- * be made to ignore them, e.g. by setting NSC_EXTRA.
+ * be made to ignore them, by setting NSC_EXTRA.
  * If flag NSC_DEITY is set, only to deities can use this selector.
  * If flag NSC_EXTRA is set, xdump and xundump ignore this selector.
  * If flag NSC_CONST is set, the datum can't be changed from its

diff --git a/src/lib/common/file.c b/src/lib/common/file.c
index a95de92f521f2b6e33f6fbb8f00db9e9bef8248e..9da797c4c61230ba945fcfb85179c5f4c9f56a10 100644 (file)
--- a/src/lib/common/file.c
+++ b/src/lib/common/file.c
@@ -246,7 +246,7 @@ ef_open_view(int type, int base)
 }
 
 /*
- * Close the file-backed table TYPE (EF_SECTOR, ...).
+ * Close the open table TYPE (EF_SECTOR, ...).
  * Return non-zero on success, zero on failure.
  */
 int
@@ -715,7 +715,7 @@ ef_extend(int type, int count)
 }
 
 /*
- * Initialize element ID for EP in BUF.
+ * Initialize element ID for table TYPE in BUF.
  * FIXME pass buffer size!
  * BUF is marked fresh with ef_mark_fresh().
  */