Update to comments for doxygen

src/maths/cmaths/cmath.h

@@ -1,3 +1,7 @@
+/** \file cmath.h
+    \brief Header file for cmath*.c
+*/
+
 #ifndef ngspice_CMATH_H
 #define ngspice_CMATH_H
 

src/maths/cmaths/cmath1.c

@@ -17,18 +17,6 @@ Author: 1985 Wayne A. Christopher, U. C. Berkeley CAD Group
      and return a char * that is cast to complex or double.
 */
 
-/*
- * Routines to do complex mathematical functions. These routines require
- * the -lm libraries. We sacrifice a lot of space to be able
- * to avoid having to do a seperate call for every vector element,
- * but it pays off in time savings.  These routines should never
- * allow FPE's to happen.
- *
- * Complex functions are called as follows:
- *  cx_something(data, type, length, &newlength, &newtype),
- *  and return a char * that is cast to complex or double.
- *
- */
 
 #include <errno.h>
 

src/maths/cmaths/cmath1.h

@@ -1,8 +1,12 @@
 /*************
- * Header file for cmath1.c
- * 1999 E. Rouat
+ * 1999 E. Rouat 
+ * 3-Clause BSD
  ************/
 
+ /** \file cmath1.h
+     \brief Header file for cmath1.c, function prototypes
+ */
+
 #ifndef ngspice_CMATH1_H
 #define ngspice_CMATH1_H
 

src/maths/cmaths/cmath2.c

@@ -17,17 +17,6 @@ Author: 1985 Wayne A. Christopher, U. C. Berkeley CAD Group
      and return a char * that is cast to complex or double.
 */
 
-/*
- * Routines to do complex mathematical functions. These routines require
- * the -lm libraries. We sacrifice a lot of space to be able
- * to avoid having to do a seperate call for every vector element,
- * but it pays off in time savings.  These routines should never
- * allow FPE's to happen.
- *
- * Complex functions are called as follows:
- *  cx_something(data, type, length, &newlength, &newtype),
- *  and return a char * that is cast to complex or double.
- */
 
 #include "ngspice/ngspice.h"
 #include "ngspice/cpdefs.h"

src/maths/cmaths/cmath2.h

@@ -1,8 +1,12 @@
 /*************
- * Header file for cmath2.c
  * 1999 E. Rouat
+ * 3-Clause BSD
  ************/
 
+ /** \file cmath2.h
+     \brief Header file for cmath2.c, function prototypes
+ */
+
 #ifndef ngspice_CMATH2_H
 #define ngspice_CMATH2_H
 

src/maths/cmaths/cmath3.c

@@ -17,17 +17,6 @@ Author: 1985 Wayne A. Christopher, U. C. Berkeley CAD Group
      and return a char * that is cast to complex or double.
 */
 
-/*
- * Routines to do complex mathematical functions. These routines require
- * the -lm libraries. We sacrifice a lot of space to be able
- * to avoid having to do a seperate call for every vector element,
- * but it pays off in time savings.  These routines should never
- * allow FPE's to happen.
- *
- * Complex functions are called as follows:
- *  cx_something(data, type, length, &newlength, &newtype),
- *  and return a char * that is cast to complex or double.
- */
 
 #include "ngspice/ngspice.h"
 #include "ngspice/cpdefs.h"

src/maths/cmaths/cmath3.h

@@ -1,8 +1,12 @@
 /*************
- * Header file for cmath3.c
  * 1999 E. Rouat
+ * 3-Clause BSD
  ************/
 
+ /** \file cmath3.h
+     \brief Header file for cmath3.c, function prototypes
+ */
+
 #ifndef ngspice_CMATH3_H
 #define ngspice_CMATH3_H
 

src/maths/cmaths/cmath4.c

@@ -17,17 +17,6 @@ Author: 1985 Wayne A. Christopher, U. C. Berkeley CAD Group
      and return a char * that is cast to complex or double.
 */
 
-/*
- * Routines to do complex mathematical functions. These routines require
- * the -lm libraries. We sacrifice a lot of space to be able
- * to avoid having to do a seperate call for every vector element,
- * but it pays off in time savings.  These routines should never
- * allow FPE's to happen.
- *
- * Complex functions are called as follows:
- *  cx_something(data, type, length, &newlength, &newtype),
- *  and return a char * that is cast to complex or double.
- */
 
 #include "ngspice/ngspice.h"
 #include "ngspice/plot.h"

src/maths/cmaths/cmath4.h

@@ -1,8 +1,12 @@
 /*************
- * Header file for cmath4.c
  * 1999 E. Rouat
+ * 3-Clause BSD
  ************/
 
+ /** \file cmath4.h
+	 \brief Header file for cmath4.c, function prototypes
+ */
+
 #ifndef ngspice_CMATH4_H
 #define ngspice_CMATH4_H