From de32d37f06290e6b219d16716a73ee0bced28c20 Mon Sep 17 00:00:00 2001
From: deskull <deskull@0568b783-4c39-0410-ac80-bf13821ea2a2>
Date: Sat, 25 Jan 2014 12:26:10 +0000
Subject: [PATCH] Add Doxygen comment to cmd5.c.

---
 src/cmd5.c | 32 ++++++++++++++++++++++++++------
 1 file changed, 26 insertions(+), 6 deletions(-)

diff --git a/src/cmd5.c b/src/cmd5.c
index d4c43186e..5f084fd7e 100644
--- a/src/cmd5.c
+++ b/src/cmd5.c
@@ -13,6 +13,11 @@
 
 #include "angband.h"
 
+/*!
+ * @brief ÎΰèËâË¡¤Ë±þ¤¸¤Æµ»Ç½¤Î̾¾Î¤òÊÖ¤¹¡£
+ * @param tval ËâË¡½ñ¤Îtval
+ * @return ÎΰèËâË¡¤Îµ»Ç½Ì¾¾Î¤òÊݴɤ·¤¿Ê¸»úÎó¥Ý¥¤¥ó¥¿
+ */
 cptr spell_category_name(int tval)
 {
 	switch (tval)
@@ -39,19 +44,27 @@ cptr spell_category_name(int tval)
 	}
 }
 
+
+bool select_the_force = FALSE;
+
 /*
+ * @brief ÎΰèËâË¡¤Î±ÜÍ÷¡¢³Ø½¬¡¢»ÈÍÑÁªÂò¤¹¤ë¥¤¥ó¥¿¡¼¥Õ¥§¥¤¥¹½èÍý
  * Allow user to choose a spell/prayer from the given book.
- *
+ * @param sn ÁªÂò¤·¤¿ËâË¡ID¤òÊÖ¤¹»²¾È¥Ý¥¤¥ó¥¿
+ * @param prompt ËâË¡¤òÍøÍѤ¹¤ëºÝ¤ÎÆ°»ìɽµ­
+ * @param sval ËâÆ»½ñ¤Îsval
+ * @param learned ±ÜÍ÷/»ÈÍÑÁªÂò¤Ê¤é¤ÐTRUE¡¢³Ø½¬½èÍý¤Ê¤éFALSE
+ * @param use_realm ËâË¡ÎΰèID
+ * @return
+ * <pre>
  * If a valid spell is chosen, saves it in '*sn' and returns TRUE
  * If the user hits escape, returns FALSE, and set '*sn' to -1
  * If there are no legal choices, returns FALSE, and sets '*sn' to -2
  *
  * The "prompt" should be "cast", "recite", or "study"
  * The "known" should be TRUE for cast/pray, FALSE for study
+ * </pre>
  */
-
-bool select_the_force = FALSE;
-
 static int get_spell(int *sn, cptr prompt, int sval, bool learned, int use_realm)
 {
 	int         i;
@@ -334,7 +347,11 @@ static int get_spell(int *sn, cptr prompt, int sval, bool learned, int use_realm
 	return TRUE;
 }
 
-
+/*
+ * @brief ¥ª¥Ö¥¸¥§¥¯¥È¤¬¥×¥ì¥¤¥ä¡¼¤¬»ÈÍѲÄǽ¤ÊËâÆ»½ñ¤«¤É¤¦¤«¤òȽÄꤹ¤ë
+ * @param ȽÄꤷ¤¿¤¤¥ª¥Ö²ñ¥¸¥§¥¯¥È¤Î¹½Â¤Âλ²¾È¥Ý¥¤¥ó¥¿
+ * @return ³Ø½¬¤Ç¤­¤ëËâÆ»½ñ¤Ê¤é¤ÐTRUE¤òÊÖ¤¹
+ */
 static bool item_tester_learn_spell(object_type *o_ptr)
 {
 	s32b choices = realm_choices2[p_ptr->pclass];
@@ -359,7 +376,10 @@ static bool item_tester_learn_spell(object_type *o_ptr)
 	return (FALSE);
 }
 
-
+/*
+ * @brief ¥×¥ì¥¤¥ä¡¼¤¬ËâÆ»½ñ¤ò°ìºý¤â»ý¤Ã¤Æ¤¤¤Ê¤¤¤«¤òȽÄꤹ¤ë
+ * @return ËâÆ»½ñ¤ò°ìºý¤â»ý¤Ã¤Æ¤¤¤Ê¤¤¤Ê¤éTRUE¤òÊÖ¤¹
+ */
 static bool player_has_no_spellbooks(void)
 {
 	int         i;
-- 
2.11.0