From 8bf6e90c3470bffdac279cd61676afd758cb030b Mon Sep 17 00:00:00 2001
From: Deskull <desull@users.sourceforge.jp>
Date: Sun, 7 Sep 2014 20:34:23 +0900
Subject: [PATCH] =?utf8?q?Add=20Doxygen=20comments=20to=20functions=20for?=
 =?utf8?q?=20player=20status=20update=20in=20xtra1.c.=20xtra1.c=20?=
 =?utf8?q?=E3=81=AE=E3=83=97=E3=83=AC=E3=82=A4=E3=83=A4=E3=83=BC=E8=83=BD?=
 =?utf8?q?=E5=8A=9B=E5=80=A4=E6=9B=B4=E6=96=B0=E3=81=AB=E9=96=A2=E3=81=99?=
 =?utf8?q?=E3=82=8B=E9=96=A2=E6=95=B0=E3=81=AB=20Doxygen=20=E3=81=AE?=
 =?utf8?q?=E3=82=B3=E3=83=A1=E3=83=B3=E3=83=88=E3=82=92=E8=BF=BD=E5=8A=A0?=
 =?utf8?q?=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

---
 src/xtra1.c | 26 +++++++++++++++++++++-----
 1 file changed, 21 insertions(+), 5 deletions(-)

diff --git a/src/xtra1.c b/src/xtra1.c
index 903f353a3..1db43514f 100644
--- a/src/xtra1.c
+++ b/src/xtra1.c
@@ -3064,6 +3064,11 @@ bool is_heavy_shoot(object_type *o_ptr)
 	return (hold < o_ptr->weight / 10);
 }
 
+/*!
+ * @brief 射撃武器に対応する矢/弾薬のベースアイテムIDを返す /
+ * @param o_ptr 判定する射撃武器のアイテム情報参照ポインタ
+ * @return 対応する矢/弾薬のベースアイテムID
+ */
 int bow_tval_ammo(object_type *o_ptr)
 {
 	/* Analyze the launcher */
@@ -3095,7 +3100,12 @@ int bow_tval_ammo(object_type *o_ptr)
 	return 0;
 }
 
-/* calcurate the fire rate of target object */
+/*!
+ * @brief 装備中の射撃武器の威力倍率を返す /
+ * calcurate the fire rate of target object
+ * @param o_ptr 計算する射撃武器のアイテム情報参照ポインタ
+ * @return 射撃倍率の値(100で1.00倍)
+ */
 s16b calc_num_fire(object_type *o_ptr)
 {
 	int extra_shots = 0;
@@ -3172,11 +3182,14 @@ s16b calc_num_fire(object_type *o_ptr)
 	return num;
 }
 
-/*
+/*!
+ * @brief プレイヤーの全ステータスを更新する / 
  * Calculate the players current "state", taking into account
  * not only race/class intrinsics, but also objects being worn
  * and temporary spell effects.
- *
+ * @return なし
+ * @details
+ * <pre>
  * See also calc_mana() and calc_hitpoints().
  *
  * Take note of the new "speed code", in particular, a very strong
@@ -3191,6 +3204,7 @@ s16b calc_num_fire(object_type *o_ptr)
  * are actually added in later, at the appropriate place.
  *
  * This function induces various "status" messages.
+ * </pre>
  */
 void calc_bonuses(void)
 {
@@ -5795,8 +5809,10 @@ void calc_bonuses(void)
 
 
 
-/*
- * Handle "p_ptr->notice"
+/*! 
+ * @brief p_ptr->notice の状態に応じた更新をまとめて行う /  Handle "p_ptr->notice"
+ * @return なし
+ * @details 行う更新処理の対象はアイテムの自動破壊/アイテムの結合/アイテムの並び替え。
  */
 void notice_stuff(void)
 {
-- 
2.11.0