reinstate some usefull comments

src/include/ngspice/cpdefs.h

@@ -68,15 +68,13 @@ struct histent {
 /* The values returned by cp_usrset(). */
 
 enum {
-    US_OK = 1,
-    US_READONLY,
-    US_DONTRECORD,
-    US_SIMVAR,
-    US_NOSIMVAR,
+    US_OK = 1,      /* Either not relevant or nothing special. */
+    US_READONLY,    /* Complain and don't set this var. */
+    US_DONTRECORD,  /* OK, but don't keep track of this one. */
+    US_SIMVAR,      /* OK, recorded in options struct */
+    US_NOSIMVAR,    /* Not OK, simulation param but circuit not loaded */
 };
 
-   /* Not OK, simulation param but circuit not loaded */
-
 /* Aliases. These will be expanded if the word is the first in an input
  * line. The substitution string may contain arg selectors.
  */

src/spicelib/devices/bjt/bjtdefs.h

@@ -710,7 +710,11 @@ enum {
     BJT_MOD_VBE_MAX,
     BJT_MOD_VBC_MAX,
     BJT_MOD_VCE_MAX,
-    BJT_QUEST_FT,
+};
+
+/* device questions */
+enum {
+    BJT_QUEST_FT = 211,
     BJT_QUEST_COLNODE,
     BJT_QUEST_BASENODE,
     BJT_QUEST_EMITNODE,

src/spicelib/devices/jfet/jfetdefs.h

@@ -270,7 +270,7 @@ enum {
     JFET_MOD_TNOM,
     JFET_MOD_KF,
     JFET_MOD_AF,
-    JFET_MOD_B,
+    JFET_MOD_B,  /* Modification for Sydney University JFET model */
     JFET_MOD_TCV,
     JFET_MOD_BEX,
     JFET_MOD_NLEV,

src/spicelib/devices/res/resdefs.h

@@ -18,9 +18,9 @@ Modified: 2000 AlansFixes
 /* indices to array of RES noise sources */
 
 enum {
-    RESTHNOIZ = 0,
-    RESFLNOIZ,
-    RESTOTNOIZ,
+    RESTHNOIZ = 0,  /* Thermal noise source */
+    RESFLNOIZ,      /* Flicker noise source */
+    RESTOTNOIZ,     /* Total noise          */
     /* finally, the number of noise sources */
     RESNSRCS
 };