Update doxygen comment style.

src/variable.cpp

@@ -14,8 +14,10 @@
    See the COPYING file for more details.
 */
 
-//! @file variable.cpp
-//! Manage WML-variables.
+/**
+ *  @file variable.cpp
+ *  Manage WML-variables.
+ */
 
 #include "global.hpp"
 
@@ -31,8 +33,10 @@
 
 namespace
 {
-	//! @todo FIXME: the variable repository should be
-	// a class of variable.hpp, and not the game_state.
+	/** 
+	 * @todo FIXME: the variable repository should be
+	 * a class of variable.hpp, and not the game_state.
+	 */
 	game_state* repos = NULL;
 
 	// map to track temp storage of inserted tags on the heap
@@ -494,7 +498,7 @@ void scoped_recall_unit::activate()
 namespace {
 bool recursive_activation = false;
 
-//! Turns on any auto-stored variables
+/** Turns on any auto-stored variables */
 void activate_scope_variable(std::string var_name)
 {
 	if(recursive_activation)

src/variable.hpp

@@ -85,7 +85,7 @@ public:
 		unsigned index_offset_;
 	};
 
-	//! In-order iteration over all children.
+	/** In-order iteration over all children. */
 	all_children_iterator ordered_begin() const;
 	all_children_iterator ordered_end() const;