diff --git a/src/maths/cmaths/cmath1.c b/src/maths/cmaths/cmath1.c
index c074613a8..3d08c2626 100644
--- a/src/maths/cmaths/cmath1.c
+++ b/src/maths/cmaths/cmath1.c
@@ -3,6 +3,20 @@ Copyright 1990 Regents of the University of California.  All rights reserved.
 Author: 1985 Wayne A. Christopher, U. C. Berkeley CAD Group
 **********/
 
+/** \file cmath1.c
+    \brief functions for the control language parser
+
+    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.
+*/
+
 /*
  * Routines to do complex mathematical functions. These routines require
  * the -lm libraries. We sacrifice a lot of space to be able
diff --git a/src/maths/cmaths/cmath2.c b/src/maths/cmaths/cmath2.c
index 0b94affaf..721321fa0 100644
--- a/src/maths/cmaths/cmath2.c
+++ b/src/maths/cmaths/cmath2.c
@@ -3,6 +3,20 @@ Copyright 1990 Regents of the University of California.  All rights reserved.
 Author: 1985 Wayne A. Christopher, U. C. Berkeley CAD Group
 **********/
 
+/** \file cmath2.c
+    \brief functions for the control language parser
+
+    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.
+*/
+
 /*
  * Routines to do complex mathematical functions. These routines require
  * the -lm libraries. We sacrifice a lot of space to be able
diff --git a/src/maths/cmaths/cmath3.c b/src/maths/cmaths/cmath3.c
index e2903c54e..2f688b1d0 100644
--- a/src/maths/cmaths/cmath3.c
+++ b/src/maths/cmaths/cmath3.c
@@ -3,6 +3,20 @@ Copyright 1990 Regents of the University of California.  All rights reserved.
 Author: 1985 Wayne A. Christopher, U. C. Berkeley CAD Group
 **********/
 
+/** \file cmath3.c
+    \brief functions for the control language parser
+
+    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.
+*/
+
 /*
  * Routines to do complex mathematical functions. These routines require
  * the -lm libraries. We sacrifice a lot of space to be able
diff --git a/src/maths/cmaths/cmath4.c b/src/maths/cmaths/cmath4.c
index 475559456..20e233d86 100644
--- a/src/maths/cmaths/cmath4.c
+++ b/src/maths/cmaths/cmath4.c
@@ -3,6 +3,20 @@ Copyright 1990 Regents of the University of California.  All rights reserved.
 Author: 1985 Wayne A. Christopher, U. C. Berkeley CAD Group
 **********/
 
+/** \file cmath4.c
+    \brief functions for the control language parser
+
+    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.
+*/
+
 /*
  * Routines to do complex mathematical functions. These routines require
  * the -lm libraries. We sacrifice a lot of space to be able
diff --git a/src/maths/cmaths/info.dir b/src/maths/cmaths/info.dir
new file mode 100644
index 000000000..c8c33f641
--- /dev/null
+++ b/src/maths/cmaths/info.dir
@@ -0,0 +1,5 @@
+
+/** \dir cmaths
+
+    This directory contains four files with all functions for dealing with vectors in the control language 
+    */
\ No newline at end of file