From 8fe33a340b8979a73fa84f201c15519a9b5d0266 Mon Sep 17 00:00:00 2001
From: Tavian Barnes <tavianator@gmail.com>
Date: Sun, 14 Nov 2010 21:20:43 -0500
Subject: Document libdimension with Doxygen.

---
 libdimension/finish_combination.c | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

(limited to 'libdimension/finish_combination.c')

diff --git a/libdimension/finish_combination.c b/libdimension/finish_combination.c
index 1a54d22..49908bd 100644
--- a/libdimension/finish_combination.c
+++ b/libdimension/finish_combination.c
@@ -18,14 +18,16 @@
  * <http://www.gnu.org/licenses/>.                                       *
  *************************************************************************/
 
+/**
+ * @file
+ * Finish combinations.
+ */
+
 #include "dimension.h"
 #include <math.h>
 #include <stdlib.h>
 
-/*
- * Finish combinations
- */
-
+/** Diffuse combination callback. */
 static dmnsn_color
 dmnsn_finish_combination_diffuse_fn(const dmnsn_finish *finish,
                                     dmnsn_color light, dmnsn_color color,
@@ -46,6 +48,7 @@ dmnsn_finish_combination_diffuse_fn(const dmnsn_finish *finish,
   }
 }
 
+/** Specular combination callback. */
 static dmnsn_color
 dmnsn_finish_combination_specular_fn(const dmnsn_finish *finish,
                                      dmnsn_color light, dmnsn_color color,
@@ -69,6 +72,7 @@ dmnsn_finish_combination_specular_fn(const dmnsn_finish *finish,
   }
 }
 
+/** Ambient combination callback. */
 static dmnsn_color
 dmnsn_finish_combination_ambient_fn(const dmnsn_finish *finish,
                                     dmnsn_color pigment)
@@ -86,6 +90,7 @@ dmnsn_finish_combination_ambient_fn(const dmnsn_finish *finish,
   }
 }
 
+/** Reflection combination callback. */
 static dmnsn_color
 dmnsn_finish_combination_reflection_fn(const dmnsn_finish *finish,
                                        dmnsn_color reflect, dmnsn_color color,
@@ -106,6 +111,7 @@ dmnsn_finish_combination_reflection_fn(const dmnsn_finish *finish,
   }
 }
 
+/** Finish combination destructor callback. */
 static void
 dmnsn_finish_combination_free_fn(void *ptr)
 {
-- 
cgit v1.2.3