From 5ec7cab04f087964aeeb4fd2b45abce6b0eff268 Mon Sep 17 00:00:00 2001
From: skyjake <skyjake@users.sf.net>
Date: Tue, 18 Dec 2012 09:02:49 +0200
Subject: [PATCH] Documentation: Fixed a couple of Doxygen issues

---
 doomsday/engine/include/map/sector.h  |  4 ++--
 doomsday/engine/include/map/sidedef.h |  6 +++---
 doomsday/engine/include/map/surface.h | 22 +++++++++++++++++++++-
 3 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/doomsday/engine/include/map/sector.h b/doomsday/engine/include/map/sector.h
index 1861324a5a..b2ba494249 100644
--- a/doomsday/engine/include/map/sector.h
+++ b/doomsday/engine/include/map/sector.h
@@ -36,7 +36,7 @@ extern "C" {
  *
  * @pre LineDef list must have been initialized.
  *
- * @param Sector  Sector instance.
+ * @param sector  Sector instance.
  */
 void Sector_UpdateAABox(Sector* sector);
 
@@ -45,7 +45,7 @@ void Sector_UpdateAABox(Sector* sector);
  *
  * @pre Axis-aligned bounding box must have been initialized.
  *
- * @param Sector  Sector instance.
+ * @param sector  Sector instance.
  */
 void Sector_UpdateArea(Sector* sector);
 
diff --git a/doomsday/engine/include/map/sidedef.h b/doomsday/engine/include/map/sidedef.h
index eacee3e5d2..c084a92fec 100644
--- a/doomsday/engine/include/map/sidedef.h
+++ b/doomsday/engine/include/map/sidedef.h
@@ -35,7 +35,7 @@ extern "C" {
  * defined by the associated LineDef's vertices and the plane heights of the
  * Sector on this side. If no LineDef is presently associated this is a no-op.
  *
- * @param sideDef  SideDef instance.
+ * @param side  SideDef instance.
  */
 void SideDef_UpdateBaseOrigins(SideDef* side);
 
@@ -51,7 +51,7 @@ void SideDef_UpdateSurfaceTangents(SideDef* sideDef);
 /**
  * Get a property value, selected by DMU_* name.
  *
- * @param sidedef  SideDef instance.
+ * @param sideDef  SideDef instance.
  * @param args  Property arguments.
  * @return  Always @c 0 (can be used as an iterator).
  */
@@ -60,7 +60,7 @@ int SideDef_GetProperty(const SideDef* sideDef, setargs_t* args);
 /**
  * Update a property value, selected by DMU_* name.
  *
- * @param sidedef  SideDef instance.
+ * @param sideDef  SideDef instance.
  * @param args  Property arguments.
  * @return  Always @c 0 (can be used as an iterator).
  */
diff --git a/doomsday/engine/include/map/surface.h b/doomsday/engine/include/map/surface.h
index b502a8354f..d55cb1101d 100644
--- a/doomsday/engine/include/map/surface.h
+++ b/doomsday/engine/include/map/surface.h
@@ -98,7 +98,12 @@ boolean Surface_SetMaterialOriginY(Surface* surface, float y);
 
 /**
  * Change surface color tint and alpha.
+ *
  * @param surface  Surface instance.
+ * @param red      Red color component (0...1).
+ * @param green    Green color component (0...1).
+ * @param blue     Blue color component (0...1).
+ * @param alpha    Alpha component (0...1).
  */
 boolean Surface_SetColorAndAlpha(Surface* surface, float red, float green, float blue, float alpha);
 
@@ -106,16 +111,31 @@ boolean Surface_SetColorAndAlpha(Surface* surface, float red, float green, float
  * Change surfacecolor tint.
  *
  * @param surface  Surface instance.
+ * @param red      Red color component (0...1).
  */
 boolean Surface_SetColorRed(Surface* surface, float red);
+
+/**
+ * Change surfacecolor tint.
+ *
+ * @param surface  Surface instance.
+ * @param green    Green color component (0...1).
+ */
 boolean Surface_SetColorGreen(Surface* surface, float green);
+
+/**
+ * Change surfacecolor tint.
+ *
+ * @param surface  Surface instance.
+ * @param blue     Blue color component (0...1).
+ */
 boolean Surface_SetColorBlue(Surface* surface, float blue);
 
 /**
  * Change surface alpha.
  *
  * @param surface  Surface instance.
- * @param alpha  New alpha value.
+ * @param alpha    New alpha value (0...1).
  */
 boolean Surface_SetAlpha(Surface* surface, float alpha);