From f08db6a798c259b022434b91f650e43b8dc819e3 Mon Sep 17 00:00:00 2001
From: Deskull <desull@users.sourceforge.jp>
Date: Tue, 5 Aug 2014 21:58:14 +0900
Subject: [PATCH] Add Doxygen comments to functions for magic recharge in
 spell3.c.

---
 src/spells3.c | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/src/spells3.c b/src/spells3.c
index 70191d766..3ba2b3906 100644
--- a/src/spells3.c
+++ b/src/spells3.c
@@ -1890,7 +1890,7 @@ bool explosive_rune(void)
 
 
 /*!
- * @brief 自己分析の薬による全所持アイテム鑑定処理 /
+ * @brief 全所持アイテム鑑定処理 /
  * Identify everything being carried.
  * Done by a potion of "self knowledge".
  * @return なし
@@ -2851,8 +2851,11 @@ bool identify_fully(bool only_equip)
 }
 
 
-/*
+/*!
+ * @brief 魔力充填が可能なアイテムかどうか判定する /
  * Hook for "get_item()".  Determine if something is rechargable.
+ * @param o_ptr 判定するアイテムの情報参照ポインタ
+ * @return 魔力充填が可能ならばTRUEを返す
  */
 bool item_tester_hook_recharge(object_type *o_ptr)
 {
@@ -2870,9 +2873,12 @@ bool item_tester_hook_recharge(object_type *o_ptr)
 }
 
 
-/*
+/*!
+ * @brief 魔力充填処理 /
  * Recharge a wand/staff/rod from the pack or on the floor.
  * This function has been rewritten in Oangband and ZAngband.
+ * @param power 充填パワー
+ * @return ターン消費を要する処理まで進んだらTRUEを返す
  *
  * Sorcery/Arcane -- Recharge  --> recharge(plev * 4)
  * Chaos -- Arcane Binding     --> recharge(90)
-- 
2.11.0