Fix some comment warnings.

diff --git a/src/avatar.c b/src/avatar.c
index dcc7917..5bfa4a5 100644 (file)
--- a/src/avatar.c
+++ b/src/avatar.c
@@ -207,7 +207,6 @@ static s16b get_realm_virtues(byte realm)
 /*!
  * @brief ºîÀ®Ãæ¤Î¥×¥ì¥¤¥ä¡¼¥­¥ã¥é¥¯¥¿¡¼¤ËÆÁ8¼ïÎà¤òÍ¿¤¨¤ë¡£ / Select virtues & reset values for a new character
  * @details ¿¦¶È¤Ë±þ¤¸¤Æ1¡Á4¼ï¤¬¸ÇÄê¡¢¼ï²¤Ë±þ¤¸¤Æ1¼ïÎबͿ¤¨¤é¤ì¡¢¸å¤Ï½ÅÊ£¤Ê¤¯¥é¥ó¥À¥à¤ËÁªÂò¤µ¤ì¤ë¡£
 /*!
  * @brief ºîÀ®Ãæ¤Î¥×¥ì¥¤¥ä¡¼¥­¥ã¥é¥¯¥¿¡¼¤ËÆÁ8¼ïÎà¤òÍ¿¤¨¤ë¡£ / Select virtues & reset values for a new character
  * @details ¿¦¶È¤Ë±þ¤¸¤Æ1¡Á4¼ï¤¬¸ÇÄê¡¢¼ï²¤Ë±þ¤¸¤Æ1¼ïÎबͿ¤¨¤é¤ì¡¢¸å¤Ï½ÅÊ£¤Ê¤¯¥é¥ó¥À¥à¤ËÁªÂò¤µ¤ì¤ë¡£

- * @param ¤Ê¤·

  * @return ¤Ê¤·
  */
 void get_virtues(void)
  * @return ¤Ê¤·
  */
 void get_virtues(void)


@@ -416,7 +415,7 @@ void get_virtues(void)
 
 /*!
  * @brief Âбþ¤¹¤ëÆÁ¤ò¥×¥ì¥¤¥ä¡¼¤¬¥¹¥í¥Ã¥È¤ËÅÐÏ¿¤·¤Æ¤¤¤ë¾ì¹ç¤Ë²Ã¸º¤ò¹Ô¤¦¡£
 
 /*!
  * @brief Âбþ¤¹¤ëÆÁ¤ò¥×¥ì¥¤¥ä¡¼¤¬¥¹¥í¥Ã¥È¤ËÅÐÏ¿¤·¤Æ¤¤¤ë¾ì¹ç¤Ë²Ã¸º¤ò¹Ô¤¦¡£

- * @detail ÈϰϤÏ-125¡Á125¡¢´ðËÜŪ¤ËÀäÂÐÃͤ¬Â礭¤¤¤Û¤ÉÀäÂÐÃͤ¬¾å¤¬¤ê¿É¤¯¤Ê¤ë¡£
+ * @details ÈϰϤÏ-125¡Á125¡¢´ðËÜŪ¤ËÀäÂÐÃͤ¬Â礭¤¤¤Û¤ÉÀäÂÐÃͤ¬¾å¤¬¤ê¿É¤¯¤Ê¤ë¡£

  * @param virtue ÆÁ¤ÎID
  * @param amount ²Ã¸ºÎÌ
  * @return ¤Ê¤·
  * @param virtue ÆÁ¤ÎID
  * @param amount ²Ã¸ºÎÌ
  * @return ¤Ê¤·

diff --git a/src/bldg.c b/src/bldg.c
index 666ec40..99bb5c2 100644 (file)
--- a/src/bldg.c
+++ b/src/bldg.c
@@ -3043,7 +3043,7 @@ msg_print("
 
 /*!
  * @brief ¥¯¥¨¥¹¥È¾ðÊó¤òɽ¼¨¤·¤Ä¤Ä½èÍý¤¹¤ë¡£/ Display quest information
 
 /*!
  * @brief ¥¯¥¨¥¹¥È¾ðÊó¤òɽ¼¨¤·¤Ä¤Ä½èÍý¤¹¤ë¡£/ Display quest information

- * @param quest ¥¯¥¨¥¹¥È¤ÎID
+ * @param questnum ¥¯¥¨¥¹¥È¤ÎID

  * @param do_init ¥¯¥¨¥¹¥È¤Î³«»Ï½èÍý(TRUE)¡¢·ë²Ì½èÍý¤«(FALSE)
  * @return ¤Ê¤·
  */
  * @param do_init ¥¯¥¨¥¹¥È¤Î³«»Ï½èÍý(TRUE)¡¢·ë²Ì½èÍý¤«(FALSE)
  * @return ¤Ê¤·
  */


@@ -4408,9 +4408,9 @@ static int repair_broken_weapon(int bcost)
 /*!
  * @brief ¥¢¥¤¥Æ¥à¤Î¶¯²½¤ò¹Ô¤¦¡£ / Enchant item
  * @param cost £±²óËè¤ÎÈñÍÑ
 /*!
  * @brief ¥¢¥¤¥Æ¥à¤Î¶¯²½¤ò¹Ô¤¦¡£ / Enchant item
  * @param cost £±²óËè¤ÎÈñÍÑ

- * @to_hit Ì¿Ãæ¤ò¥¢¥Ã¥×¤µ¤»¤ëÎÌ
- * @to_dam ¥À¥á¡¼¥¸¤ò¥¢¥Ã¥×¤µ¤»¤ëÎÌ
- * @to_ac £Á£Ã¤ò¥¢¥Ã¥×¤µ¤»¤ëÎÌ
+ * @param to_hit Ì¿Ãæ¤ò¥¢¥Ã¥×¤µ¤»¤ëÎÌ
+ * @param to_dam ¥À¥á¡¼¥¸¤ò¥¢¥Ã¥×¤µ¤»¤ëÎÌ
+ * @param to_ac £Á£Ã¤ò¥¢¥Ã¥×¤µ¤»¤ëÎÌ

  * @return ¼ÂºÝ¤Ë¤«¤«¤Ã¤¿ÈñÍÑ
  */
 static bool enchant_item(int cost, int to_hit, int to_dam, int to_ac)
  * @return ¼ÂºÝ¤Ë¤«¤«¤Ã¤¿ÈñÍÑ
  */
 static bool enchant_item(int cost, int to_hit, int to_dam, int to_ac)

diff --git a/src/cave.c b/src/cave.c
index 54a34a3..5127ece 100644 (file)
--- a/src/cave.c
+++ b/src/cave.c
@@ -114,7 +114,6 @@ bool is_hidden_door(cave_type *c_ptr)
 
 /*!
  * @brief LOS(Line Of Sight / »ëÀþ¤¬Ä̤äƤ¤¤ë¤«)¤ÎȽÄê¤ò¹Ô¤¦¡£
 
 /*!
  * @brief LOS(Line Of Sight / »ëÀþ¤¬Ä̤äƤ¤¤ë¤«)¤ÎȽÄê¤ò¹Ô¤¦¡£

- * @param c_ptr ¥Þ¥¹¹½Â¤ÂΤλ²¾È¥Ý¥¤¥ó¥¿

  * @param y1 »ÏÅÀ¤ÎyºÂɸ
  * @param x1 »ÏÅÀ¤ÎxºÂɸ
  * @param y2 ½ªÅÀ¤ÎyºÂɸ
  * @param y1 »ÏÅÀ¤ÎyºÂɸ
  * @param x1 »ÏÅÀ¤ÎxºÂɸ
  * @param y2 ½ªÅÀ¤ÎyºÂɸ


@@ -384,7 +383,7 @@ bool los(int y1, int x1, int y2, int x2)
 /*!
  * @brief »ØÄꤵ¤ì¤¿ºÂɸ¤Î¥Þ¥¹¤¬¸½ºß¾È¤é¤µ¤ì¤Æ¤¤¤ë¤«¤òÊÖ¤¹¡£ / Check for "local" illumination
  * @param y yºÂɸ
 /*!
  * @brief »ØÄꤵ¤ì¤¿ºÂɸ¤Î¥Þ¥¹¤¬¸½ºß¾È¤é¤µ¤ì¤Æ¤¤¤ë¤«¤òÊÖ¤¹¡£ / Check for "local" illumination
  * @param y yºÂɸ

- * @param y xºÂɸ
+ * @param x xºÂɸ

  * @return »ØÄꤵ¤ì¤¿ºÂɸ¤Ë¾ÈÌÀ¤¬¤«¤«¤Ã¤Æ¤¤¤ë¤Ê¤éTRUE¤òÊÖ¤¹¡£¡£
  */
 static bool check_local_illumination(int y, int x)
  * @return »ØÄꤵ¤ì¤¿ºÂɸ¤Ë¾ÈÌÀ¤¬¤«¤«¤Ã¤Æ¤¤¤ë¤Ê¤éTRUE¤òÊÖ¤¹¡£¡£
  */
 static bool check_local_illumination(int y, int x)


@@ -435,7 +434,7 @@ static bool check_local_illumination(int y, int x)
 /*!
  * @brief »ØÄꤵ¤ì¤¿ºÂɸ¤Î¾ÈÌÀ¾õÂÖ¤ò¹¹¿·¤¹¤ë / Update "local" illumination
  * @param y yºÂɸ
 /*!
  * @brief »ØÄꤵ¤ì¤¿ºÂɸ¤Î¾ÈÌÀ¾õÂÖ¤ò¹¹¿·¤¹¤ë / Update "local" illumination
  * @param y yºÂɸ

- * @param y xºÂɸ
+ * @param x xºÂɸ

  * @return ¤Ê¤·
  */
 void update_local_illumination(int y, int x)
  * @return ¤Ê¤·
  */
 void update_local_illumination(int y, int x)


@@ -598,7 +597,7 @@ bool player_can_see_bold(int y, int x)
 /*!
  * @brief »ØÄꤵ¤ì¤¿ºÂɸ¤ò¥×¥ì¥¤¥ä¡¼¼ý¤á¤é¤ì¤Æ¤¤¤Ê¤¤¾õÂÖ¤«¤É¤¦¤« / Returns true if the player's grid is dark
  * @param y yºÂɸ
 /*!
  * @brief »ØÄꤵ¤ì¤¿ºÂɸ¤ò¥×¥ì¥¤¥ä¡¼¼ý¤á¤é¤ì¤Æ¤¤¤Ê¤¤¾õÂÖ¤«¤É¤¦¤« / Returns true if the player's grid is dark
  * @param y yºÂɸ

- * @param y xºÂɸ
+ * @param x xºÂɸ

  * @return »ë³Ð¤Ë¼ý¤á¤é¤ì¤Æ¤¤¤Ê¤¤¤Ê¤éTRUE¤òÊÖ¤¹
  * @details player_can_see_bold()´Ø¿ô¤ÎÊÖ¤êÃͤÎÈÝÄê¤òÊÖ¤·¤Æ¤¤¤ë¡£
  */
  * @return »ë³Ð¤Ë¼ý¤á¤é¤ì¤Æ¤¤¤Ê¤¤¤Ê¤éTRUE¤òÊÖ¤¹
  * @details player_can_see_bold()´Ø¿ô¤ÎÊÖ¤êÃͤÎÈÝÄê¤òÊÖ¤·¤Æ¤¤¤ë¡£
  */


@@ -611,7 +610,7 @@ bool no_lite(void)
 /*!
  * @brief »ØÄꤵ¤ì¤¿ºÂɸ¤¬ÃϿ̤䳬ÃÊÀ¸À®¤ÎÂоݤȤʤë¥Þ¥¹¤«¤òÊÖ¤¹¡£ / Determine if a given location may be "destroyed"
  * @param y yºÂɸ
 /*!
  * @brief »ØÄꤵ¤ì¤¿ºÂɸ¤¬ÃϿ̤䳬ÃÊÀ¸À®¤ÎÂоݤȤʤë¥Þ¥¹¤«¤òÊÖ¤¹¡£ / Determine if a given location may be "destroyed"
  * @param y yºÂɸ

- * @param y xºÂɸ
+ * @param x xºÂɸ

  * @return ³Æ¼ï¤ÎÊѹ¹¤¬²Äǽ¤Ê¤éTRUE¤òÊÖ¤¹¡£
  * @details 
  * ¾ò·ï¤Ï±Êµ×ÃÏ·Á¤Ç¤Ê¤¯¡¢¤Ê¤ª¤«¤Ä³ºÅö¤Î¥Þ¥¹¤Ë¥¢¡¼¥Æ¥£¥Õ¥¡¥¯¥È¤¬Â¸ºß¤·¤Ê¤¤¤«¡¢¤Ç¤¢¤ë¡£±Ñ¸ì¤Îµì¥³¥á¥ó¥È¤ËÈ¿¤·¤Æ¡öÇ˲õ¡ö¤ÎÍÞ»ßȽÄê¤Ë¤Ï¸½ºß»È¤ï¤ì¤Æ¤¤¤Ê¤¤¡£
  * @return ³Æ¼ï¤ÎÊѹ¹¤¬²Äǽ¤Ê¤éTRUE¤òÊÖ¤¹¡£
  * @details 
  * ¾ò·ï¤Ï±Êµ×ÃÏ·Á¤Ç¤Ê¤¯¡¢¤Ê¤ª¤«¤Ä³ºÅö¤Î¥Þ¥¹¤Ë¥¢¡¼¥Æ¥£¥Õ¥¡¥¯¥È¤¬Â¸ºß¤·¤Ê¤¤¤«¡¢¤Ç¤¢¤ë¡£±Ñ¸ì¤Îµì¥³¥á¥ó¥È¤ËÈ¿¤·¤Æ¡öÇ˲õ¡ö¤ÎÍÞ»ßȽÄê¤Ë¤Ï¸½ºß»È¤ï¤ì¤Æ¤¤¤Ê¤¤¡£

diff --git a/src/defines.h b/src/defines.h
index 1d8559d..a5b1408 100644 (file)
--- a/src/defines.h
+++ b/src/defines.h
@@ -1,5 +1,5 @@
 /*!
 /*!

- *  @file degine.h
+ *  @file defines.h

  *  @brief ¼çÍפʥޥ¯¥íÄêµÁ¥Ø¥Ã¥À / Purpose: global constants and macro definitions
  *  @date 2014/01/02
  *  @author
  *  @brief ¼çÍפʥޥ¯¥íÄêµÁ¥Ø¥Ã¥À / Purpose: global constants and macro definitions
  *  @date 2014/01/02
  *  @author

diff --git a/src/dungeon.c b/src/dungeon.c
index 00fd642..6fda692 100644 (file)
--- a/src/dungeon.c
+++ b/src/dungeon.c
@@ -1024,7 +1024,7 @@ static void regenmagic(int regen_amount)
 /*!
  * @brief 100¥²¡¼¥à¥¿¡¼¥óËè¤Î¥â¥ó¥¹¥¿¡¼¤ÎHP¼«Á³²óÉü½èÍý / Regenerate the monsters (once per 100 game turns)
  * @return ¤Ê¤·
 /*!
  * @brief 100¥²¡¼¥à¥¿¡¼¥óËè¤Î¥â¥ó¥¹¥¿¡¼¤ÎHP¼«Á³²óÉü½èÍý / Regenerate the monsters (once per 100 game turns)
  * @return ¤Ê¤·

- * @memo XXX XXX XXX Should probably be done during monster turns.
+ * @note XXX XXX XXX Should probably be done during monster turns.

  */
 static void regen_monsters(void)
 {
  */
 static void regen_monsters(void)
 {


@@ -1071,7 +1071,7 @@ static void regen_monsters(void)
 /*!
  * @brief 30¥²¡¼¥à¥¿¡¼¥óËè¤Î¥Ü¡¼¥ëÃæ¥â¥ó¥¹¥¿¡¼¤ÎHP¼«Á³²óÉü½èÍý / Regenerate the captured monsters (once per 30 game turns)
  * @return ¤Ê¤·
 /*!
  * @brief 30¥²¡¼¥à¥¿¡¼¥óËè¤Î¥Ü¡¼¥ëÃæ¥â¥ó¥¹¥¿¡¼¤ÎHP¼«Á³²óÉü½èÍý / Regenerate the captured monsters (once per 30 game turns)
  * @return ¤Ê¤·

- * @memo XXX XXX XXX Should probably be done during monster turns.
+ * @note XXX XXX XXX Should probably be done during monster turns.

  */
 static void regen_captured_monsters(void)
 {
  */
 static void regen_captured_monsters(void)
 {


@@ -1529,7 +1529,7 @@ static void check_music(void)
 
 /*!
  * @brief ¸½ºß¼ö¤¤¤òÊÝ»ý¤·¤Æ¤¤¤ëÁõÈ÷Éʤò°ì¤Ä¥é¥ó¥À¥à¤Ëõ¤·½Ð¤¹ / Choose one of items that have cursed flag
 
 /*!
  * @brief ¸½ºß¼ö¤¤¤òÊÝ»ý¤·¤Æ¤¤¤ëÁõÈ÷Éʤò°ì¤Ä¥é¥ó¥À¥à¤Ëõ¤·½Ð¤¹ / Choose one of items that have cursed flag

- * @flag õ¤·½Ð¤·¤¿¤¤¼ö¤¤¥Õ¥é¥°ÇÛÎó
+ * @param flag õ¤·½Ð¤·¤¿¤¤¼ö¤¤¥Õ¥é¥°ÇÛÎó

  * @return ³ºÅö¤Î¼ö¤¤¤¬°ì¤Ä¤Ç¤â¤¢¤Ã¤¿¾ì¹ç¤Ë¥é¥ó¥À¥à¤ËÁª¤Ð¤ì¤¿ÁõÈ÷ÉʤΥª¥Ö¥¸¥§¥¯¥È¹½Â¤Âλ²¾È¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£\n
  * ¼ö¤¤¤¬¤Ê¤¤¾ì¹çNULL¤òÊÖ¤¹¡£
  */
  * @return ³ºÅö¤Î¼ö¤¤¤¬°ì¤Ä¤Ç¤â¤¢¤Ã¤¿¾ì¹ç¤Ë¥é¥ó¥À¥à¤ËÁª¤Ð¤ì¤¿ÁõÈ÷ÉʤΥª¥Ö¥¸¥§¥¯¥È¹½Â¤Âλ²¾È¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£\n
  * ¼ö¤¤¤¬¤Ê¤¤¾ì¹çNULL¤òÊÖ¤¹¡£
  */


@@ -5590,7 +5590,7 @@ static void process_upkeep_with_speed(void)
 /*!
  * @brief ¥×¥ì¥¤¥ä¡¼¤Î¹ÔÆ°½èÍý / Process the player
  * @return ¤Ê¤·
 /*!
  * @brief ¥×¥ì¥¤¥ä¡¼¤Î¹ÔÆ°½èÍý / Process the player
  * @return ¤Ê¤·

- * @memo
+ * @note

  * Notice the annoying code to handle "pack overflow", which\n
  * must come first just in case somebody manages to corrupt\n
  * the savefiles by clever use of menu commands or something.\n
  * Notice the annoying code to handle "pack overflow", which\n
  * must come first just in case somebody manages to corrupt\n
  * the savefiles by clever use of menu commands or something.\n


@@ -6203,7 +6203,7 @@ msg_print("
 /*!
  * @brief ¸½ºß¥×¥ì¥¤¥ä¡¼¤¬¤¤¤ë¥À¥ó¥¸¥ç¥ó¤ÎÁ´ÂνèÍý / Interact with the current dungeon level.
  * @return ¤Ê¤·
 /*!
  * @brief ¸½ºß¥×¥ì¥¤¥ä¡¼¤¬¤¤¤ë¥À¥ó¥¸¥ç¥ó¤ÎÁ´ÂνèÍý / Interact with the current dungeon level.
  * @return ¤Ê¤·

- * @memo
+ * @note

  * This function will not exit until the level is completed,\n
  * the user dies, or the game is terminated.\n
  */
  * This function will not exit until the level is completed,\n
  * the user dies, or the game is terminated.\n
  */


@@ -6518,7 +6518,7 @@ msg_print("
 /*!
  * @brief Á´¥æ¡¼¥¶¥×¥í¥Õ¥¡¥¤¥ë¤ò¥í¡¼¥É¤¹¤ë / Load some "user pref files"
  * @return ¤Ê¤·
 /*!
  * @brief Á´¥æ¡¼¥¶¥×¥í¥Õ¥¡¥¤¥ë¤ò¥í¡¼¥É¤¹¤ë / Load some "user pref files"
  * @return ¤Ê¤·

- * @memo
+ * @note

  * Modified by Arcum Dagsson to support
  * separate macro files for different realms.
  */
  * Modified by Arcum Dagsson to support
  * separate macro files for different realms.
  */

diff --git a/src/flavor.c b/src/flavor.c
index 0f3a689..fe54927 100644 (file)
--- a/src/flavor.c
+++ b/src/flavor.c
@@ -1278,7 +1278,9 @@ bool object_is_quest_target(object_type *o_ptr)
 
 /*!
  * @brief ¥ª¥Ö¥¸¥§¥¯¥È¤Î³Æɽµ­¤òÊÖ¤¹¥á¥¤¥ó´Ø¿ô / Creates a description of the item "o_ptr", and stores it in "out_val".
 
 /*!
  * @brief ¥ª¥Ö¥¸¥§¥¯¥È¤Î³Æɽµ­¤òÊÖ¤¹¥á¥¤¥ó´Ø¿ô / Creates a description of the item "o_ptr", and stores it in "out_val".

+ * @param buf ɽµ­¤òÊÖ¤¹¤¿¤á¤Îʸ»úÎ󻲾ȥݥ¤¥ó¥¿

  * @param o_ptr ÆÃÀ­Ã»½Ìɽµ­¤òÆÀ¤¿¤¤¥ª¥Ö¥¸¥§¥¯¥È¹½Â¤ÂΤλ²¾È¥Ý¥¤¥ó¥¿
  * @param o_ptr ÆÃÀ­Ã»½Ìɽµ­¤òÆÀ¤¿¤¤¥ª¥Ö¥¸¥§¥¯¥È¹½Â¤ÂΤλ²¾È¥Ý¥¤¥ó¥¿

+ * @param mode ɽµ­¤Ë´Ø¤¹¤ë¥ª¥×¥·¥ç¥ó»ØÄê

  * @return ¸½ºß¥¯¥¨¥¹¥ÈãÀ®ÌÜŪ¤Î¥¢¥¤¥Æ¥à¤Ê¤é¤ÐTRUE¤òÊÖ¤¹¡£
  * @details
  * One can choose the "verbosity" of the description, including whether\n
  * @return ¸½ºß¥¯¥¨¥¹¥ÈãÀ®ÌÜŪ¤Î¥¢¥¤¥Æ¥à¤Ê¤é¤ÐTRUE¤òÊÖ¤¹¡£
  * @details
  * One can choose the "verbosity" of the description, including whether\n

diff --git a/src/hex.c b/src/hex.c
index e5a1223..224d4bc 100644 (file)
--- a/src/hex.c
+++ b/src/hex.c
@@ -283,7 +283,7 @@ void revenge_spell(void)
 
 /*!
  * @brief Éü½²¥À¥á¡¼¥¸¤ÎÄɲäò¹Ô¤¦
 
 /*!
  * @brief Éü½²¥À¥á¡¼¥¸¤ÎÄɲäò¹Ô¤¦

- * @param ÃßÀѤµ¤ì¤ë¥À¥á¡¼¥¸ÎÌ
+ * @param dam ÃßÀѤµ¤ì¤ë¥À¥á¡¼¥¸ÎÌ

  * @return ¤Ê¤·
  */
 void revenge_store(int dam)
  * @return ¤Ê¤·
  */
 void revenge_store(int dam)