short example of where I am going with doxygen

Here is a short patch that shows what I intend to go with doxygen in libX11.

wt

Index: src/xyY.c
===================================================================
RCS file: /cvs/xlibs/X11/src/xyY.c,v
retrieving revision 1.6
diff -u -3 -p -r1.6 xyY.c
--- a/src/xyY.c 5 Mar 2004 09:16:42 -0000       1.6
+++ b/src/xyY.c 11 Mar 2004 02:24:31 -0000
@@ -22,17 +22,14 @@
  * RESULTING FROM LOSS OF USE, DATA, OR PROFITS, WHETHER IN AN ACTION OF
  * CONTRACT, NEGLIGENCE, OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  * CONNECTION WITH THE USE OR THE PERFORMANCE OF THIS SOFTWARE.
+ */
+/**
+ * \file
+ *   This file contains routines that support the CIE xyY
+ *   color space to include conversions to and from the CIE
+ *   XYZ space.
  *
- *     NAME
- *             CIExyY.c
- *
- *     DESCRIPTION
- *             This file contains routines that support the CIE xyY
- *             color space to include conversions to and from the CIE
- *             XYZ space.
- *
- *     DOCUMENTATION
- *             "TekColor Color Management System, System Implementor's Manual"
+ *   Docuementation:"TekColor Color Management System, System Implementor's
Manual"
  */
 /* $XFree86: xc/lib/X11/xyY.c,v 1.3 2001/01/17 19:41:57 dawes Exp $ */
 
-- 
Warren Turkal
President, GOLUM, Inc.
http://www.golum.org