Add Doxygen comment to cave.c.

Fix typo.

diff --git a/src/birth.c b/src/birth.c
index 0ba255b..8d3f5b1 100644 (file)
--- a/src/birth.c
+++ b/src/birth.c
@@ -1892,7 +1892,7 @@ static cptr class_jouhou[MAX_CLASS] =
 #endif
 };
 
-/*! Àµ³Î¤Î²òÀâ¥á¥Ã¥»¡¼¥¸¥Æ¡¼¥Ö¥ë */
+/*! À­³Ê¤Î²òÀâ¥á¥Ã¥»¡¼¥¸¥Æ¡¼¥Ö¥ë */
 static cptr seikaku_jouhou[MAX_SEIKAKU] =
 {
 #ifdef JP

diff --git a/src/cave.c b/src/cave.c
index 2939187..4fa4f66 100644 (file)
--- a/src/cave.c
+++ b/src/cave.c
@@ -1,31 +1,35 @@
-/* File: cave.c */
-
-/*
- * Copyright (c) 1997 Ben Harrison, James E. Wilson, Robert A. Koeneke
- *
- * This software may be copied and distributed for educational, research,
- * and not for profit purposes provided that this copyright and statement
- * are included in all such copies.  Other copyrights may also apply.
+/*!
+ * @file cave.c
+ * @brief ¥À¥ó¥¸¥ç¥ó¤Î´ðÁÃÉôʬ¼ÂÁõ(¼ç¤Ë¥Þ¥¹¤Î¼ÂÁõ) / low level dungeon routines -BEN-
+ * @date 2013/12/30
+ * @author
+ * Copyright (c) 1997 Ben Harrison, James E. Wilson, Robert A. Koeneke\n
+ *\n
+ * This software may be copied and distributed for educational, research,\n
+ * and not for profit purposes provided that this copyright and statement\n
+ * are included in all such copies.  Other copyrights may also apply.\n
+ * \n
+ * Support for Adam Bolt's tileset, lighting and transparency effects\n
+ * by Robert Ruehlmann (rr9@angband.org)\n
+ * \n
+ * 2013 Deskull Doxygen¸þ¤±¤Î¥³¥á¥ó¥ÈÀ°Íý\n
  */
 
-/* Purpose: low level dungeon routines -BEN- */
-
 
 #include "angband.h"
 
-
-/*
- * Support for Adam Bolt's tileset, lighting and transparency effects
- * by Robert Ruehlmann (rr9@angband.org)
- */
-
-static byte display_autopick;
+static byte display_autopick; /*!< ¼«Æ°½¦¤¤¾õÂÖ¤ÎÀßÄê¥Õ¥é¥° */
 static int match_autopick;
-static object_type *autopick_obj;
-static int feat_priority;
-
-/*
- * Distance between two points via Newton-Raphson technique
+static object_type *autopick_obj; /*!< ³Æ¼ï¼«Æ°½¦¤¤½èÍý»þ¤Ë»È¤¦¥ª¥Ö¥¸¥§¥¯¥È¥Ý¥¤¥ó¥¿ */
+static int feat_priority; /*!< ¥Þ¥Ã¥×½Ì¾®É½¼¨»þ¤Ëɽ¼¨¤¹¤Ù¤­ÃÏ·Á¤ÎÍ¥ÀèÅÙ¤òÊݴɤ¹¤ë */
+
+/*!
+ * @brief 2ÅÀ´Ö¤Îµ÷Î¥¤ò¥Ë¥å¡¼¥È¥ó¡¦¥é¥×¥½¥óË¡¤Ç»»½Ð¤¹¤ë / Distance between two points via Newton-Raphson technique
+ * @param y1 1ÅÀÌܤÎyºÂɸ
+ * @param x1 1ÅÀÌܤÎxºÂɸ
+ * @param y2 2ÅÀÌܤÎyºÂɸ
+ * @param x2 2ÅÀÌܤÎxºÂɸ
+ * @return 2ÅÀ´Ö¤Îµ÷Î¥
  */
 int distance (int y1, int x1, int y2, int x2)
 {
@@ -58,9 +62,10 @@ int distance (int y1, int x1, int y2, int x2)
        return d;
 }
 
-
-/*
- * Return TRUE if the given feature is a trap
+/*!
+ * @brief ÃÏ·Á¤¬æ«»ý¤Á¤Ç¤¢¤ë¤«¤ÎȽÄê¤ò¹Ô¤¦¡£ / Return TRUE if the given feature is a trap
+ * @param feat ÃÏ·Á¾ðÊó¤ÎID
+ * @return æ«»ý¤Á¤ÎÃÏ·Á¤Ê¤é¤ÐTRUE¤òÊÖ¤¹¡£
  */
 bool is_trap(int feat)
 {