From 913effe3ee4de1c17652f318c93b5ddbd21d5bde Mon Sep 17 00:00:00 2001
From: deskull <deskull@0568b783-4c39-0410-ac80-bf13821ea2a2>
Date: Fri, 27 Dec 2013 14:45:18 +0000
Subject: [PATCH] Add Doxygen comment to bldg.c.

---
 src/bldg.c | 53 +++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 41 insertions(+), 12 deletions(-)

diff --git a/src/bldg.c b/src/bldg.c
index 452d44757..28bdcba48 100644
--- a/src/bldg.c
+++ b/src/bldg.c
@@ -3417,12 +3417,24 @@ static u32b calc_expect_dice(u32b dam, int mult, int div, bool force, int weight
 	return dam;
 }
 
-/*
- * Display the damage figure of an object
- * (used by compare_weapon_aux)
- *
- * Only accurate for the current weapon, because it includes
- * the current +dam of the player.
+
+/*!
+ * @brief Éð´ï¤Î³Æ¾ò·ïËè¤Î¥À¥á¡¼¥¸´üÂÔÃͤòɽ¼¨¤¹¤ë¡£
+ * @param r ɽ¼¨¹Ô
+ * @param c ɽ¼¨Îó
+ * @param mindice ¥À¥¤¥¹ÉôʬºÇ¾®ÃÍ
+ * @param maxdice ¥À¥¤¥¹ÉôʬºÇÂçÃÍ
+ * @param blows ¹¶·â²ó¿ô
+ * @param dam_bonus ¥À¥á¡¼¥¸½¤ÀµÃÍ
+ * @param attr ¾ò·ïÆâÍÆ
+ * @param color ¾ò·ïÆâÍƤÎɽ¼¨¿§
+ * @details
+ * Display the damage figure of an object\n
+ * (used by compare_weapon_aux)\n
+ * \n
+ * Only accurate for the current weapon, because it includes\n
+ * the current +dam of the player.\n
+ * @return ¤Ê¤·
  */
 static void show_weapon_dmg(int r, int c, int mindice, int maxdice, int blows, int dam_bonus, cptr attr, byte color)
 {
@@ -3448,11 +3460,17 @@ static void show_weapon_dmg(int r, int c, int mindice, int maxdice, int blows, i
 }
 
 
-/*
- * Show the damage figures for the various monster types
- *
- * Only accurate for the current weapon, because it includes
- * the current number of blows for the player.
+/*!
+ * @brief Éð´ï°ì¤ÄËè¤Î¥À¥á¡¼¥¸¾ðÊó¤òɽ¼¨¤¹¤ë¡£
+ * @param o_ptr ¥ª¥Ö¥¸¥§¥¯¥È¤Î¹½Â¤ÂΤλ²¾È¥Ý¥¤¥ó¥¿¡£
+ * @param col ɽ¼¨¤¹¤ë¹Ô¤Î¾åü
+ * @param r ɽ¼¨¤¹¤ëÎó¤Îº¸Ã¼
+ * @details
+ * Show the damage figures for the various monster types\n
+ * \n
+ * Only accurate for the current weapon, because it includes\n
+ * the current number of blows for the player.\n
+ * @return ¤Ê¤·
  */
 static void compare_weapon_aux(object_type *o_ptr, int col, int r)
 {
@@ -3656,6 +3674,12 @@ static void compare_weapon_aux(object_type *o_ptr, int col, int r)
 	}
 }
 
+/*!
+ * @brief ¥â¥ó¥¹¥¿¡¼¤Ø¤ÎÌ¿ÃæΨ¤Î·×»»
+ * @param to_h Ì¿ÃæÃÍ
+ * @param ac ŨAC
+ * @return ¤Ê¤·
+ */
 static int hit_chance(int to_h, int ac)
 {
 	int chance = 0;
@@ -3672,7 +3696,12 @@ static int hit_chance(int to_h, int ac)
 	return chance;
 }
 
-/*
+/*!
+ * @brief Éð´ï¾¢¤Ë¤ª¤±¤ëÉð´ï°ì¤ÄËè¤Î´°Á´¾ðÊó¤òɽ¼¨¤¹¤ë¡£
+ * @param o_ptr ¥ª¥Ö¥¸¥§¥¯¥È¤Î¹½Â¤ÂΤλ²¾È¥Ý¥¤¥ó¥¿¡£
+ * @param row ɽ¼¨¤¹¤ëÎó¤Îº¸Ã¼
+ * @param col ɽ¼¨¤¹¤ë¹Ô¤Î¾åü
+ * @details
  * Displays all info about a weapon
  *
  * Only accurate for the current weapon, because it includes
-- 
2.11.0