Add Doxygen comment to bldg.c.

diff --git a/src/bldg.c b/src/bldg.c
index fe2e574..2033094 100644 (file)
--- a/src/bldg.c
+++ b/src/bldg.c
@@ -1305,8 +1305,10 @@ static int do_poker(void)
 #undef IS_JOKER
 /* end of poker codes --Koka */
 
-/*
- * gamble_comm
+/*!
+ * @brief ¥«¥¸¥Î£±¥×¥ì¥¤¤´¤È¤Î¥á¥¤¥ó¥ë¡¼¥Á¥ó / gamble_comm
+ * @param cmd ¥×¥ì¥¤¤¹¤ë¥²¡¼¥àID
+ * @return ¤Ê¤·
  */
 static bool gamble_comm(int cmd)
 {
@@ -1742,6 +1744,13 @@ msg_print("
        return (TRUE);
 }
 
+/*!
+ * @brief ¥â¥ó¥¹¥¿¡¼Æ®µ»¾ì¤Ë»²²Ã¤Ç¤­¤ë¥â¥ó¥¹¥¿¡¼¤ÎȽÄê
+ * @param r_idx ¥â¥ó¥¹¥¿¡¼£É£Ä
+ * @details ´ð½à¤ÏNEVER_MOVE MULTIPLY QUANTUM RF7_AQUATIC RF7_CHAMELEON¤Î¤¤¤º¤ì¤â»ý¤¿¤º¡¢
+ * ¼«Çú°Ê³°¤Î¤Ê¤ó¤é¤«¤ÎHP¹¶·â¼êÃʤò»ý¤Ã¤Æ¤¤¤ë¤³¤È¡£
+ * @return »²²Ã¤Ç¤­¤ë¤«Èݤ«
+ */
 static bool vault_aux_battle(int r_idx)
 {
        int i;
@@ -1773,6 +1782,11 @@ static bool vault_aux_battle(int r_idx)
        return (TRUE);
 }
 
+/*!
+ * @brief ¥â¥ó¥¹¥¿¡¼Æ®µ»¾ì¤Ë»²²Ã¤¹¤ë¥â¥ó¥¹¥¿¡¼¤ò¥ê¥»¥Ã¥È¤¹¤ë¡£
+ * @param ¤Ê¤·
+ * @return ¤Ê¤·
+ */
 void battle_monsters(void)
 {
        int total, i;
@@ -1990,6 +2004,11 @@ void battle_monsters(void)
        }
 }
 
+/*!
+ * @brief ¥â¥ó¥¹¥¿¡¼Æ®µ»¾ì¤Î¥á¥¤¥ó¥ë¡¼¥Á¥ó
+ * @param ¤Ê¤·
+ * @return ÅÒ¤±¤ò³«»Ï¤·¤¿¤«Èݤ«
+ */
 static bool kakutoujou(void)
 {
        s32b maxbet;
@@ -2151,6 +2170,11 @@ msg_print("
        return (FALSE);
 }
 
+/*!
+ * @brief ËÜÆü¤Î¾Þ¶â¼ó¾ðÊó¤òɽ¼¨¤¹¤ë¡£
+ * @param ¤Ê¤·
+ * @return ¤Ê¤·
+ */
 static void today_target(void)
 {
        char buf[160];
@@ -2183,6 +2207,11 @@ c_put_str(TERM_YELLOW, "
        p_ptr->today_mon = today_mon;
 }
 
+/*!
+ * @brief ¥Ä¥Á¥Î¥³¤Î¾Þ¶â¼ó¾ðÊó¤òɽ¼¨¤¹¤ë¡£
+ * @param ¤Ê¤·
+ * @return ¤Ê¤·
+ */
 static void tsuchinoko(void)
 {
        clear_bldg(4,18);
@@ -2201,6 +2230,11 @@ c_put_str(TERM_WHITE, "bones       ----   $100,000", 10, 10);
 #endif
 }
 
+/*!
+ * @brief Ä̾ï¤Î¾Þ¶â¼ó¾ðÊó¤òɽ¼¨¤¹¤ë¡£
+ * @param ¤Ê¤·
+ * @return ¤Ê¤·
+ */
 static void shoukinkubi(void)
 {
        int i;
@@ -2255,7 +2289,10 @@ c_put_str(TERM_YELLOW, "Wanted monsters", 6, 10);
 }
 
 
-/* List of prize object */
+
+/*!
+ * ¾Þ¶â¼ó¤ÎÊ󽷥ơ¼¥Ö¥ë / List of prize object
+ */
 static struct {
        s16b tval;
        s16b sval;
@@ -2286,8 +2323,11 @@ static struct {
        {TV_SCROLL, SV_SCROLL_ARTIFACT},
 };
 
-
-/* Get prize */
+/*!
+ * @brief ¾Þ¶â¼ó¤Î°ú¤­´¹¤¨½èÍý / Get prize
+ * @param ¤Ê¤·
+ * @return ³Æ¼ï¾Þ¶â¼ó¤Î¤¤¤º¤ì¤«¤Ç¤â´¹¶â¤¬¹Ô¤ï¤ì¤¿¤«Èݤ«¡£
+ */
 static bool kankin(void)
 {
        int i, j;
@@ -2566,7 +2606,12 @@ bool get_nightmare(int r_idx)
        return (TRUE);
 }
 
-
+/*!
+ * @brief °­Ì´¥â¡¼¥É»þ¤Ë¿ç̲/Ëãáã¤Ë´Ù¤Ã¤¿ºÝ¤ÎEldritchHorror½èÍý
+ * @param r_idx ¶¸µ¤¤Î¸µ¶§¤È¤Ê¤ë¥â¥ó¥¹¥¿¡¼¤Î£É£Ä
+ * @return ¤Ê¤·
+ * @todo ½ÅÊ£´Ø¿ô¤¢¤ê¡¢Í×¥ê¥Õ¥¡¥¯¥¿¥ê¥ó¥°¡£
+ */
 void have_nightmare(int r_idx)
 {
        bool happened = FALSE;
@@ -2844,14 +2889,17 @@ msg_print("
 }
 
 
-/*
- * inn commands
- * Note that resting for the night was a perfect way to avoid player
- * ghosts in the town *if* you could only make it to the inn in time (-:
- * Now that the ghosts are temporarily disabled in 2.8.X, this function
- * will not be that useful.  I will keep it in the hopes the player
- * ghost code does become a reality again. Does help to avoid filthy urchins.
- * Resting at night is also a quick way to restock stores -KMW-
+/*!
+ * @brief ½É²°¤ÎÍøÍÑ¥µ¥Ö¥ë¡¼¥Á¥ó
+ * @details inn commands\n
+ * Note that resting for the night was a perfect way to avoid player\n
+ * ghosts in the town *if* you could only make it to the inn in time (-:\n
+ * Now that the ghosts are temporarily disabled in 2.8.X, this function\n
+ * will not be that useful.  I will keep it in the hopes the player\n
+ * ghost code does become a reality again. Does help to avoid filthy urchins.\n
+ * Resting at night is also a quick way to restock stores -KMW-\n
+ * @param cmd ½É²°¤ÎÍøÍÑ»ÜÀßID
+ * @return »ÜÀߤÎÍøÍѤ¬¼ÂºÝ¤Ë¹Ô¤ï¤ì¤¿¤«Èݤ«¡£
  */
 static bool inn_comm(int cmd)
 {