doxygen and better fail message.

Hmm..why does GetCharacters not return
the DefaultCharacter? Is this function perhaps misnamed?

src/CharacterManager.cpp

@@ -89,7 +89,7 @@ Character* CharacterManager::GetDefaultCharacter()
 	}
 
 	/* We always have the default character. */
-	ASSERT(0);
+	FAIL_M("There must be a default character available!");
 	return NULL;
 }
 

src/CharacterManager.h

@@ -1,19 +1,24 @@
-/* CharacterManager - Manage characters. */
-
 #ifndef CHARACTER_MANAGER_H
 #define CHARACTER_MANAGER_H
 
 class Character;
 struct lua_State;
 
+/** @brief Manage all of the Characters. */
 class CharacterManager
 {
 public:
+	/** @brief Set up the character manager. */
 	CharacterManager();
+	/** @brief Destroy the character manager. */
 	~CharacterManager();
 
 	void GetCharacters( vector<Character*> &vpCharactersOut );
+	/** @brief Get one installed character at random.
+	 * @return The random character. */
 	Character* GetRandomCharacter();
+	/** @brief Get the character assigned as the default.
+	 * @return The default character. */
 	Character* GetDefaultCharacter();
 	Character* GetCharacterFromID( RString sCharacterID );