From 0fec83ebc89bd6b86f772d942b7c39b13f773d3a Mon Sep 17 00:00:00 2001
From: Tavian Barnes <tavianator@tavianator.com>
Date: Thu, 12 Jun 2014 13:45:06 -0400
Subject: Add a C89 compliance test for the headers.

Technically we still require a couple things from C99 like "bool",
but it works with -std=c89 under gcc.
---
 libdimension/dimension/tcolor.h | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

(limited to 'libdimension/dimension/tcolor.h')

diff --git a/libdimension/dimension/tcolor.h b/libdimension/dimension/tcolor.h
index b50178d..4432dd1 100644
--- a/libdimension/dimension/tcolor.h
+++ b/libdimension/dimension/tcolor.h
@@ -23,19 +23,19 @@
  * Colors with transparency information.
  */
 
-/// A transparent color.
+/** A transparent color. */
 typedef struct dmnsn_tcolor {
-  dmnsn_color c; ///< Color.
-  double T;      ///< Transparency.
-  double F;      ///< Proportion of filtered transparency.
+  dmnsn_color c; /**< Color. */
+  double T;      /**< Transparency. */
+  double F;      /**< Proportion of filtered transparency. */
 } dmnsn_tcolor;
 
-/// A standard format string for colors.
+/** A standard format string for colors. */
 #define DMNSN_TCOLOR_FORMAT "TColor<%g, %g, %g, %g, %g>"
-/// The appropriate arguements to printf() a color.
+/** The appropriate arguements to printf() a color. */
 #define DMNSN_TCOLOR_PRINTF(tc) (tc).c.R, (tc).c.G, (tc).c.B, (tc).T, (tc).F
 
-/// Create a tcolor.
+/** Create a tcolor. */
 DMNSN_INLINE dmnsn_tcolor
 dmnsn_new_tcolor(dmnsn_color c, double T, double F)
 {
@@ -43,10 +43,10 @@ dmnsn_new_tcolor(dmnsn_color c, double T, double F)
   return ret;
 }
 
-/// Convert a dmnsn_color into a dmnsn_tcolor.
+/** Convert a dmnsn_color into a dmnsn_tcolor. */
 #define DMNSN_TCOLOR(c) dmnsn_new_tcolor(c, 0.0, 0.0)
 
-/// Create a tcolor with individually-specified components.
+/** Create a tcolor with individually-specified components. */
 DMNSN_INLINE dmnsn_tcolor
 dmnsn_new_tcolor5(double R, double G, double B, double T, double F)
 {
@@ -54,7 +54,7 @@ dmnsn_new_tcolor5(double R, double G, double B, double T, double F)
   return ret;
 }
 
-/// Return the color at \p n on a gradient from \p c1 at 0 to \p c2 at 1.
+/** Return the color at \p n on a gradient from \p c1 at 0 to \p c2 at 1. */
 DMNSN_INLINE dmnsn_tcolor
 dmnsn_tcolor_gradient(dmnsn_tcolor c1, dmnsn_tcolor c2, double n)
 {
@@ -65,7 +65,7 @@ dmnsn_tcolor_gradient(dmnsn_tcolor c1, dmnsn_tcolor c2, double n)
   );
 }
 
-/// Filter \p light through \p filter.
+/** Filter \p light through \p filter. */
 DMNSN_INLINE dmnsn_color
 dmnsn_tcolor_filter(dmnsn_color light, dmnsn_tcolor filter)
 {
@@ -75,7 +75,7 @@ dmnsn_tcolor_filter(dmnsn_color light, dmnsn_tcolor filter)
   return dmnsn_color_add(filtered, transmitted);
 }
 
-/// Remove the filtered component of a tcolor.
+/** Remove the filtered component of a tcolor. */
 DMNSN_INLINE dmnsn_tcolor
 dmnsn_tcolor_remove_filter(dmnsn_tcolor tcolor)
 {
@@ -89,7 +89,7 @@ dmnsn_tcolor_remove_filter(dmnsn_tcolor tcolor)
   return tcolor;
 }
 
-/// Saturate the tcolor components to [0.0, 1.0].
+/** Saturate the tcolor components to [0.0, 1.0]. */
 DMNSN_INLINE dmnsn_tcolor
 dmnsn_tcolor_saturate(dmnsn_tcolor tcolor)
 {
@@ -99,14 +99,14 @@ dmnsn_tcolor_saturate(dmnsn_tcolor tcolor)
   return tcolor;
 }
 
-/// Return whether a tcolor contains any NaN components.
+/** Return whether a tcolor contains any NaN components. */
 DMNSN_INLINE bool
 dmnsn_tcolor_isnan(dmnsn_tcolor tcolor)
 {
-  return dmnsn_color_isnan(tcolor.c) || isnan(tcolor.T) || isnan(tcolor.F);
+  return dmnsn_color_isnan(tcolor.c) || dmnsn_isnan(tcolor.T) || dmnsn_isnan(tcolor.F);
 }
 
-// Standard tcolors
+/* Standard tcolors */
 
-/// Clear.
+/** Clear. */
 #define dmnsn_clear dmnsn_new_tcolor5(0.0, 0.0, 0.0, 1.0, 0.0)
-- 
cgit v1.2.3