doxygen cleanup

doomsday/engine/portable/src/cl_player.c

@@ -22,7 +22,7 @@
  * Boston, MA  02110-1301  USA
  */
 
-/*
+/**
  * cl_player.c: Clientside Player Management
  */
 
@@ -121,7 +121,7 @@ void Cl_LocalCommand(void)
  * it to the player in question. Returns false only if the list of
  * deltas ends.
  *
- * THIS FUNCTION IS NOW OBSOLETE (only used with PSV_FRAME packets)
+ * \deprecated THIS FUNCTION IS NOW OBSOLETE (only used with PSV_FRAME packets)
  */
 int Cl_ReadPlayerDelta(void)
 {
@@ -148,9 +148,10 @@ int Cl_ReadPlayerDelta(void)
         clmobj_t *old = s->cmo;
         int     newid = Msg_ReadShort();
 
-        //// Make sure the 'new' mobj is different than the old one;
-        //// there will be linking problems otherwise.
-        //// \fixme What causes the duplicate sending of mobj ids?
+        /** Make sure the 'new' mobj is different than the old one;
+        * there will be linking problems otherwise.
+        * \fixme What causes the duplicate sending of mobj ids?
+	*/
         if(newid != s->mobjId)
         {
             s->mobjId = newid;

doomsday/engine/portable/src/p_control.c

@@ -22,7 +22,7 @@
  * Boston, MA  02110-1301  USA
  */
 
-/*
+/**
  * p_control.c: Player Controls
  */
 
@@ -57,7 +57,7 @@ enum
 	CTL_LOOK
 };
 
-/*
+/**
  * The control descriptors contain a mapping between symbolic control
  * names and the identifier numbers.
  */ 
@@ -70,7 +70,7 @@ typedef struct controlclass_s {
 	controldesc_t *desc;
 } controlclass_t;
 
-/*
+/**
  * Each player has his own control state table.
  */
 typedef struct controlstate_s {
@@ -116,7 +116,7 @@ static controlstate_t ctlState[DDMAXPLAYERS];
 
 // CODE --------------------------------------------------------------------
 
-/**
+/***
  * Register the console commands and cvars of the player controls subsystem. 
  */
 void P_RegisterControl(void)
@@ -284,7 +284,7 @@ static controldesc_t *controlAdd(uint class, const char *name)
  * All the symbolic names must be unique and at most MAX_DESCRIPTOR_LENGTH
  * chars long!
  *
- * @param class         Control class of the descriptor being registered.
+ * @param cClass        Control class of the descriptor being registered.
  * @param name          A unique name for the new control descriptor.
  */
 void P_RegisterPlayerControl(uint cClass, const char *name)
@@ -663,8 +663,9 @@ void P_ControlAxisDelta(int player, uint axisControlIndex, float delta)
  */
 void P_ControlTicker(timespan_t time)
 {
-	//// \fixme  Player class turn speed.
-	//// angleturn[3] = {640, 1280, 320};	// + slow turn
+	/** \fixme  Player class turn speed.
+	* angleturn[3] = {640, 1280, 320};	// + slow turn
+	*/
 	uint        i;
 	float       pos, mul;