From 2fc1071fd2cef6a88ebb49788dc942fbb4d45b4d Mon Sep 17 00:00:00 2001
From: Deskull <desull@users.sourceforge.jp>
Date: Tue, 15 Jul 2014 21:07:41 +0900
Subject: [PATCH] Add Doxygen comments to functions of cave calculation in
 spells2.c.

---
 src/spells2.c | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/src/spells2.c b/src/spells2.c
index d89a032aa..dda0a9af9 100644
--- a/src/spells2.c
+++ b/src/spells2.c
@@ -4370,7 +4370,13 @@ static int next_to_open(int cy, int cx, bool (*pass_bold)(int, int))
 	return (MAX(len, blen));
 }
 
-
+/*!
+ * @brief 周辺に関数ポインタの条件に該当する地形がいくつあるかを計算する / Determine how much contiguous open space this grid is next to
+ * @param cy Y座標
+ * @param cx X座標
+ * @param pass_bold 地形条件を返す関数ポインタ
+ * @return 該当地形の数
+ */
 static int next_to_walls_adj(int cy, int cx, bool (*pass_bold)(int, int))
 {
 	int i;
@@ -4391,8 +4397,13 @@ static int next_to_walls_adj(int cy, int cx, bool (*pass_bold)(int, int))
 }
 
 
-/*
- * Aux function -- see below
+/*!
+ * @brief 部屋内にある一点が該当地形数かどうかを返す / Aux function -- see below
+ * @param y 部屋内のy座標1点
+ * @param x 部屋内のx座標1点
+ * @param only_room 部屋内地形のみをチェック対象にするならば TRUE
+ * @param pass_bold 地形条件を返す関数ポインタ
+ * @return 該当地形の数
  */
 static void cave_temp_room_aux(int y, int x, bool only_room, bool (*pass_bold)(int, int))
 {
-- 
2.11.0