修改注释

Src/Draw/hDraw.h

@@ -5,18 +5,14 @@
 
 #define SCREEN_CENTER -1073741824
 
+/** \brief 墙的信息 */
 struct WallInf {
-	/**
-	 * \brief 墙点种类
-	 *
-	 *   直: 0, 弯: 1
-	 *   末端: 2, 十字: 3, 三岔: 4
-	 */
-	int num;
-	/** \brief 旋转角度 */
-	double angle;
-	/** \brief 翻转状态 */
-	SDL_RendererFlip flip;
+	int num;               /**< 墙点种类
+                                直: 0, 弯: 1
+                                末端: 2, 十字: 3, 三岔: 4
+                            */
+	double angle;          /**< 旋转角度 */
+	SDL_RendererFlip flip; /**< 翻转状态 */
 
 	WallInf(int num=0, double angle=0, SDL_RendererFlip flip=SDL_FLIP_NONE):
 			num(num),
@@ -75,16 +71,10 @@ static struct WallDrawInf: public WallInf {
 /** \brief 游戏渲染设置 */
 class GameDrawSet {
 protected:
-	/**
-	 * \brief 人物
-	 *
-	 *   地图数据&游戏动作
-	 */
-	GameFge* drawGameFge = nullptr;
-	/** \brief 窗口 */
-	SDL_Window* drawWindow = nullptr;
-	/** \brief 渲染器 */
-	SDL_Renderer* drawRen = nullptr;
+	GameFge* drawGameFge;   /**< 人物 */
+
+	SDL_Window* drawWindow; /**< 窗口 */
+	SDL_Renderer* drawRen;  /**< 渲染器 */
 
 	/**
 	 * \brief 单帧持续时间
@@ -121,12 +111,10 @@ class GameDrawSet {
 
 /** \brief 存放字体中单个字符数据 */
 struct Font {
-	/** \brief 字符材质 */
-	SDL_Texture* chara;
-	/** \brief 字符宽度 */
-	unsigned int width;
-	/** \brief 字符高度 */
-	unsigned int height;
+	SDL_Texture* chara;  /**< 字符材质 */
+
+	unsigned int width;  /**< 字符宽度 */
+	unsigned int height; /**< 字符高度 */
 
 	Font(SDL_Texture* chara=nullptr, unsigned int width=16, unsigned int height=16):
 		chara(chara),
@@ -138,10 +126,8 @@ struct Font {
 /** \brief 显示文字 */
 class GameDrawWord: protected GameDrawSet {
 private:
-	/** \brief 字符宽度 */
-	int charaWidth;
-	/** \brief 字符高度 */
-	int charaHeight;
+	int charaWidth;  /**< 字符宽度 */
+	int charaHeight; /**< 字符高度 */
 
 	/**
 	 * \brief 所有字符
@@ -258,7 +244,9 @@ class GameDraw: private GameDrawWord {
 	 *
 	 *   令窗口以指定颜色半透明化
 	 *
-	 * \param r, g, b 颜色分量
+	 * \param r 红色颜色分量
+	 * \param g 绿色颜色分量
+	 * \param b 蓝色颜色分量
 	 */
 	void SetScreenDarken(int r, int g, int b);
 

Src/Map/hMap.h

@@ -5,10 +5,8 @@
 
 /** \brief 位置 */
 struct Cod {
-	/** \brief 纵坐标 */
-	int y;
-	/** \brief 横坐标 */
-	int x;
+	int y; /**< 纵坐标 */
+	int x; /**< 横坐标 */
 
 	bool operator ==(const Cod& cd) {
 		if(cd.x == x && cd.y == y) return true;
@@ -48,17 +46,13 @@ struct Cod {
 
 /** \brief 迷宫信息 */
 static struct MazeInf {
-	/** \brief 迷宫宽度 */
-	const int xLength;
-	/** \brief 迷宫长度 */
-	const int yLength;
-
-	/** \brief 金币数量 */
-	const int coin;
-	/** \brief 星星数量 */
-	const int star;
-	/** \brief 恶魔数量 */
-	const int demon;
+	const int xLength; /**< 迷宫宽度 */
+	const int yLength; /**< 迷宫长度 */
+
+	const int coin;    /**< 金币数量 */
+	const int star;    /**< 星星数量 */
+	const int demon;   /**< 恶魔数量 */
+
 
 	MazeInf(
 			int xLength, int yLength,
@@ -78,8 +72,7 @@ typedef std::vector<Cod> CodList;
 /** \brief 生成游戏地图 */
 class GameMap {
 private:
-	/** \brief 所有路点 */
-	CodList roadPoint;
+	CodList roadPoint; /**< 所有路点 */
 	/**
 	 * \brief 添加所有路点
 	 */
@@ -178,12 +171,10 @@ class GameMap {
 	bool GetDemonPath(int** maze, const Cod& cd, CodList& path, int num);
 
 public:
-	/** \brief Demon活动点 */
-	CodList* demonPoint;
-	/** \brief 迷宫地图 */
-	int** mapMaze;
-	/** \brief 迷宫终点 */
-	Cod mapEnd{};
+	CodList* demonPoint; /**< Demon活动点 */
+
+	int** mapMaze;       /**< 迷宫地图 */
+	Cod mapEnd{};        /**< 迷宫终点 */
 
 	GameMap();
 	~GameMap();
@@ -212,13 +203,10 @@ class GameFge: public GameMap {
 	 */
 	int* demonPos;
 
-	/** \brief 人物位置 */
-	struct Cod fgeCod;
+	Cod fgeCod; /**< 人物位置 */
 
-	/** \brief 人物金币数量 */
-	int fgeCoin;
-	/** \brief 人物星星数量 */
-	int fgeStar;
+	int fgeCoin;       /**< 人物金币数量 */
+	int fgeStar;       /**< 人物星星数量 */
 
 	/**
 	 * \brief 是否获得足够星星