From: Markus Armbruster <armbru@pond.sub.org>
Date: Mon, 25 Apr 2011 08:45:04 +0000 (+0200)
Subject: A few comment fixes for nsc.[ch] file.[ch]
X-Git-Tag: v4.3.28~89
X-Git-Url: http://git.pond.sub.org/?p=empserver;a=commitdiff_plain;h=6e4772b175ce077e78a33adcc9f0caca035ebe10

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

diff --git a/include/file.h b/include/file.h
index f66dd3ba5..bd6ff3b1d 100644
--- 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 45876681b..9abab0027 100644
--- 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 a95de92f5..9da797c4c 100644
--- 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().
  */