From 80b43a5d29922e186e058a550957879d029fc6ec Mon Sep 17 00:00:00 2001
From: rlar <rlar>
Date: Sun, 15 Apr 2018 13:56:41 +0200
Subject: [PATCH] reinstate some usefull comments

---
 src/include/ngspice/cpdefs.h         | 12 +++++-------
 src/spicelib/devices/bjt/bjtdefs.h   |  6 +++++-
 src/spicelib/devices/jfet/jfetdefs.h |  2 +-
 src/spicelib/devices/res/resdefs.h   |  6 +++---
 4 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/src/include/ngspice/cpdefs.h b/src/include/ngspice/cpdefs.h
index 721e6b834..4adeb6c6b 100644
--- a/src/include/ngspice/cpdefs.h
+++ b/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.
  */
diff --git a/src/spicelib/devices/bjt/bjtdefs.h b/src/spicelib/devices/bjt/bjtdefs.h
index 78a030289..c8d526cb1 100644
--- a/src/spicelib/devices/bjt/bjtdefs.h
+++ b/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,
diff --git a/src/spicelib/devices/jfet/jfetdefs.h b/src/spicelib/devices/jfet/jfetdefs.h
index 3b1dc92d6..afa47b6b5 100644
--- a/src/spicelib/devices/jfet/jfetdefs.h
+++ b/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,
diff --git a/src/spicelib/devices/res/resdefs.h b/src/spicelib/devices/res/resdefs.h
index cade85975..a6e162124 100644
--- a/src/spicelib/devices/res/resdefs.h
+++ b/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
 };