OSDN Git Service

[modify]スクリーンダンプで「'」と「"」のエスケープを追加
[hengband/hengband.git] / src / xtra1.c
index 22163a5..8c44f6b 100644 (file)
@@ -101,8 +101,13 @@ s16b modify_stat_value(int value, int amount)
 
 
 
-/*
+/*!
+ * @brief 画面左の能力値表示を行うために指定位置から13キャラ分を空白消去後指定のメッセージを明るい青で描画する /
  * Print character info at given row, column in a 13 char field
+ * @param info 表示文字列
+ * @param row 描画列
+ * @param col 描画行
+ * @return なし
  */
 static void prt_field(cptr info, int row, int col)
 {
@@ -114,8 +119,10 @@ static void prt_field(cptr info, int row, int col)
 }
 
 
-/*
- *  Whether daytime or not
+/*!
+ * @brief ゲーム時間が日中かどうかを返す /
+ * Whether daytime or not
+ * @return 日中ならばTRUE、夜ならばFALSE
  */
 bool is_daytime(void)
 {
@@ -126,8 +133,12 @@ bool is_daytime(void)
                return FALSE;
 }
 
-/*
+/*!
+ * @brief 現在の日数、時刻を返す /
  * Extract day, hour, min
+ * @param day 日数を返すための参照ポインタ
+ * @param hour 時数を返すための参照ポインタ
+ * @param min 分数を返すための参照ポインタ
  */
 void extract_day_hour_min(int *day, int *hour, int *min)
 {
@@ -150,8 +161,10 @@ void extract_day_hour_min(int *day, int *hour, int *min)
        *min = (1440 * turn_in_today / A_DAY) % 60;
 }
 
-/*
+/*!
+ * @brief ゲーム時刻を表示する /
  * Print time
+ * @return なし
  */
 void prt_time(void)
 {
@@ -169,7 +182,10 @@ void prt_time(void)
        c_put_str(TERM_WHITE, format("%2d:%02d", hour, min), ROW_DAY, COL_DAY+7);
 }
 
-
+/*!
+ * @brief 現在のマップ名を返す /
+ * @return マップ名の文字列参照ポインタ
+ */
 cptr map_name(void)
 {
        if (p_ptr->inside_quest && is_fixed_quest_idx(p_ptr->inside_quest)
@@ -187,8 +203,9 @@ cptr map_name(void)
                return d_name+d_info[dungeon_type].name;
 }
 
-/*
- * Print dungeon
+/*!
+ * @brief 現在のマップ名を描画する / Print dungeon
+ * @return なし
  */
 static void prt_dungeon(void)
 {
@@ -209,10 +226,10 @@ static void prt_dungeon(void)
 }
 
 
-
-
-/*
- * Print character stat in given row, column
+/*!
+ * @brief プレイヤー能力値を描画する / Print character stat in given row, column
+ * @param stat 描画するステータスのID
+ * @return なし
  */
 static void prt_stat(int stat)
 {
@@ -249,75 +266,75 @@ static void prt_stat(int stat)
 
 
 /*
- *  Data structure for status bar
+ * 画面下部に表示する状態表示定義ID / Data structure for status bar
  */
-#define BAR_TSUYOSHI 0
-#define BAR_HALLUCINATION 1
-#define BAR_BLINDNESS 2
-#define BAR_PARALYZE 3
-#define BAR_CONFUSE 4
-#define BAR_POISONED 5
-#define BAR_AFRAID 6
-#define BAR_LEVITATE 7
-#define BAR_REFLECTION 8
-#define BAR_PASSWALL 9
-#define BAR_WRAITH 10
-#define BAR_PROTEVIL 11
-#define BAR_KAWARIMI 12
-#define BAR_MAGICDEFENSE 13
-#define BAR_EXPAND 14
-#define BAR_STONESKIN 15
-#define BAR_MULTISHADOW 16
-#define BAR_REGMAGIC 17
-#define BAR_ULTIMATE 18
-#define BAR_INVULN 19
-#define BAR_IMMACID 20
-#define BAR_RESACID 21
-#define BAR_IMMELEC 22
-#define BAR_RESELEC 23
-#define BAR_IMMFIRE 24
-#define BAR_RESFIRE 25
-#define BAR_IMMCOLD 26
-#define BAR_RESCOLD 27
-#define BAR_RESPOIS 28
-#define BAR_RESNETH 29
-#define BAR_RESTIME 30
-#define BAR_DUSTROBE 31
-#define BAR_SHFIRE 32
-#define BAR_TOUKI 33
-#define BAR_SHHOLY 34
-#define BAR_EYEEYE 35
-#define BAR_BLESSED 36
-#define BAR_HEROISM 37
-#define BAR_BERSERK 38
-#define BAR_ATTKFIRE 39
-#define BAR_ATTKCOLD 40
-#define BAR_ATTKELEC 41
-#define BAR_ATTKACID 42
-#define BAR_ATTKPOIS 43
-#define BAR_ATTKCONF 44
-#define BAR_SENSEUNSEEN 45
-#define BAR_TELEPATHY 46
-#define BAR_REGENERATION 47
-#define BAR_INFRAVISION 48
-#define BAR_STEALTH 49
-#define BAR_SUPERSTEALTH 50
-#define BAR_RECALL 51
-#define BAR_ALTER 52
-#define BAR_SHCOLD 53
-#define BAR_SHELEC 54
-#define BAR_SHSHADOW 55
-#define BAR_MIGHT 56
-#define BAR_BUILD 57
-#define BAR_ANTIMULTI 58
-#define BAR_ANTITELE 59
-#define BAR_ANTIMAGIC 60
-#define BAR_PATIENCE 61
-#define BAR_REVENGE 62
-#define BAR_RUNESWORD 63
-#define BAR_VAMPILIC 64
-#define BAR_CURE 65
-#define BAR_ESP_EVIL 66
+#define BAR_TSUYOSHI 0      /*!< 下部ステータス表示: オクレ兄さん状態 */
+#define BAR_HALLUCINATION 1 /*!< 下部ステータス表示: 幻覚 */
+#define BAR_BLINDNESS 2     /*!< 下部ステータス表示: 盲目 */
+#define BAR_PARALYZE 3      /*!< 下部ステータス表示: 麻痺 */
+#define BAR_CONFUSE 4       /*!< 下部ステータス表示: 混乱 */
+#define BAR_POISONED 5      /*!< 下部ステータス表示: 毒 */
+#define BAR_AFRAID 6        /*!< 下部ステータス表示: 恐怖 */
+#define BAR_LEVITATE 7      /*!< 下部ステータス表示: 浮遊 */
+#define BAR_REFLECTION 8    /*!< 下部ステータス表示: 反射 */
+#define BAR_PASSWALL 9      /*!< 下部ステータス表示: 壁抜け */
+#define BAR_WRAITH 10       /*!< 下部ステータス表示: 幽体化 */
+#define BAR_PROTEVIL 11     /*!< 下部ステータス表示: 対邪悪結界 */
+#define BAR_KAWARIMI 12     /*!< 下部ステータス表示: 変わり身 */
+#define BAR_MAGICDEFENSE 13 /*!< 下部ステータス表示: 魔法の鎧 */
+#define BAR_EXPAND 14       /*!< 下部ステータス表示: 横伸び */
+#define BAR_STONESKIN 15    /*!< 下部ステータス表示: 石肌化 */
+#define BAR_MULTISHADOW 16  /*!< 下部ステータス表示: 影分身 */
+#define BAR_REGMAGIC 17     /*!< 下部ステータス表示: 魔法防御 */
+#define BAR_ULTIMATE 18     /*!< 下部ステータス表示: 究極の耐性 */
+#define BAR_INVULN 19       /*!< 下部ステータス表示: 無敵化 */
+#define BAR_IMMACID 20      /*!< 下部ステータス表示: 酸免疫 */
+#define BAR_RESACID 21      /*!< 下部ステータス表示: 酸耐性 */
+#define BAR_IMMELEC 22      /*!< 下部ステータス表示: 電撃免疫 */
+#define BAR_RESELEC 23      /*!< 下部ステータス表示: 電撃耐性 */
+#define BAR_IMMFIRE 24      /*!< 下部ステータス表示: 火炎免疫 */
+#define BAR_RESFIRE 25      /*!< 下部ステータス表示: 火炎耐性 */
+#define BAR_IMMCOLD 26      /*!< 下部ステータス表示: 冷気免疫 */
+#define BAR_RESCOLD 27      /*!< 下部ステータス表示: 冷気耐性 */
+#define BAR_RESPOIS 28      /*!< 下部ステータス表示: 毒耐性 */
+#define BAR_RESNETH 29      /*!< 下部ステータス表示: 地獄耐性 */
+#define BAR_RESTIME 30      /*!< 下部ステータス表示: 時間逆転耐性 */
+#define BAR_DUSTROBE 31     /*!< 下部ステータス表示: 破片オーラ */
+#define BAR_SHFIRE 32       /*!< 下部ステータス表示: 火炎オーラ */
+#define BAR_TOUKI 33        /*!< 下部ステータス表示: 闘気 */
+#define BAR_SHHOLY 34       /*!< 下部ステータス表示: 聖なるオーラ */
+#define BAR_EYEEYE 35       /*!< 下部ステータス表示: 目には目を */
+#define BAR_BLESSED 36      /*!< 下部ステータス表示: 祝福 */
+#define BAR_HEROISM 37      /*!< 下部ステータス表示: 士気高揚 */
+#define BAR_BERSERK 38      /*!< 下部ステータス表示: 狂戦士化 */
+#define BAR_ATTKFIRE 39     /*!< 下部ステータス表示: 焼棄スレイ */
+#define BAR_ATTKCOLD 40     /*!< 下部ステータス表示: 冷凍スレイ */
+#define BAR_ATTKELEC 41     /*!< 下部ステータス表示: 電撃スレイ */
+#define BAR_ATTKACID 42     /*!< 下部ステータス表示: 溶解スレイ */
+#define BAR_ATTKPOIS 43     /*!< 下部ステータス表示: 毒殺スレイ */
+#define BAR_ATTKCONF 44     /*!< 下部ステータス表示: 混乱打撃 */
+#define BAR_SENSEUNSEEN 45  /*!< 下部ステータス表示: 透明視 */
+#define BAR_TELEPATHY 46    /*!< 下部ステータス表示: テレパシー */
+#define BAR_REGENERATION 47 /*!< 下部ステータス表示: 急回復 */
+#define BAR_INFRAVISION 48  /*!< 下部ステータス表示: 赤外線視力 */
+#define BAR_STEALTH 49      /*!< 下部ステータス表示: 隠密 */
+#define BAR_SUPERSTEALTH 50 /*!< 下部ステータス表示: 超隠密 */
+#define BAR_RECALL 51       /*!< 下部ステータス表示: 帰還待ち */
+#define BAR_ALTER 52        /*!< 下部ステータス表示: 現実変容待ち */
+#define BAR_SHCOLD 53       /*!< 下部ステータス表示: 冷気オーラ */
+#define BAR_SHELEC 54       /*!< 下部ステータス表示: 電撃オーラ */
+#define BAR_SHSHADOW 55     /*!< 下部ステータス表示: 影のオーラ */
+#define BAR_MIGHT 56        /*!< 下部ステータス表示: 腕力強化 */
+#define BAR_BUILD 57        /*!< 下部ステータス表示: 肉体強化 */
+#define BAR_ANTIMULTI 58    /*!< 下部ステータス表示: 反増殖 */
+#define BAR_ANTITELE 59     /*!< 下部ステータス表示: 反テレポート */
+#define BAR_ANTIMAGIC 60    /*!< 下部ステータス表示: 反魔法 */
+#define BAR_PATIENCE 61     /*!< 下部ステータス表示: 我慢 */
+#define BAR_REVENGE 62      /*!< 下部ステータス表示: 宣告 */
+#define BAR_RUNESWORD 63    /*!< 下部ステータス表示: 魔剣化 */
+#define BAR_VAMPILIC 64     /*!< 下部ステータス表示: 吸血 */
+#define BAR_CURE 65         /*!< 下部ステータス表示: 回復 */
+#define BAR_ESP_EVIL 66     /*!< 下部ステータス表示: 邪悪感知 */
 
 static struct {
        byte attr;
@@ -470,12 +487,24 @@ static struct {
 };
 #endif
 
+/*!
+ * @brief 32ビット変数配列の指定位置のビットフラグを1にする。
+ * @param FLG フラグ位置(ビット)
+ * @return なし
+ */
 #define ADD_FLG(FLG) (bar_flags[FLG / 32] |= (1L << (FLG % 32)))
+
+/*!
+ * @brief 32ビット変数配列の指定位置のビットフラグが1かどうかを返す。
+ * @param FLG フラグ位置(ビット)
+ * @return 1ならば0以外を返す
+ */
 #define IS_FLG(FLG) (bar_flags[FLG / 32] & (1L << (FLG % 32)))
 
 
-/*
- *  Show status bar
+/*!
+ * @brief 下部に状態表示を行う / Show status bar
+ * @return なし
  */
 static void prt_status(void)
 {
@@ -706,9 +735,9 @@ static void prt_status(void)
 }
 
 
-
-/*
- * Prints "title", including "wizard" or "winner" as needed.
+/*!
+ * @brief プレイヤーの称号を表示する / Prints "title", including "wizard" or "winner" as needed.
+ * @return なし
  */
 static void prt_title(void)
 {
@@ -761,8 +790,9 @@ static void prt_title(void)
 }
 
 
-/*
- * Prints level
+/*!
+ * @brief プレイヤーのレベルを表示する / Prints level
+ * @return なし
  */
 static void prt_level(void)
 {
@@ -795,8 +825,9 @@ static void prt_level(void)
 }
 
 
-/*
- * Display the experience
+/*!
+ * @brief プレイヤーの経験値を表示する / Display the experience
+ * @return なし
  */
 static void prt_exp(void)
 {
@@ -848,8 +879,9 @@ static void prt_exp(void)
        }
 }
 
-/*
- * Prints current gold
+/*!
+ * @brief プレイヤーの所持金を表示する / Prints current gold
+ * @return なし
  */
 static void prt_gold(void)
 {
@@ -860,9 +892,9 @@ static void prt_gold(void)
 }
 
 
-
-/*
- * Prints current AC
+/*!
+ * @brief プレイヤーのACを表示する / Prints current AC
+ * @return なし
  */
 static void prt_ac(void)
 {
@@ -882,8 +914,9 @@ static void prt_ac(void)
 }
 
 
-/*
- * Prints Cur/Max hit points
+/*!
+ * @brief プレイヤーのHPを表示する / Prints Cur/Max hit points
+ * @return なし
  */
 static void prt_hp(void)
 {
@@ -926,8 +959,9 @@ static void prt_hp(void)
 }
 
 
-/*
- * Prints players max/cur spell points
+/*!
+ * @brief プレイヤーのMPを表示する / Prints players max/cur spell points
+ * @return なし
  */
 static void prt_sp(void)
 {
@@ -972,8 +1006,9 @@ static void prt_sp(void)
 }
 
 
-/*
- * Prints depth in stat area
+/*!
+ * @brief 現在のフロアの深さを表示する / Prints depth in stat area
+ * @return なし
  */
 static void prt_depth(void)
 {
@@ -1020,8 +1055,9 @@ static void prt_depth(void)
 }
 
 
-/*
- * Prints status of hunger
+/*!
+ * @brief プレイヤーの空腹状態を表示する / Prints status of hunger
+ * @return なし
  */
 static void prt_hunger(void)
 {
@@ -1065,10 +1101,11 @@ static void prt_hunger(void)
 }
 
 
-/*
- * Prints Searching, Resting, Paralysis, or 'count' status
+/*!
+ * @brief プレイヤーの行動状態を表示する / Prints Searching, Resting, Paralysis, or 'count' status
+ * @return なし
+ * @details
  * Display is always exactly 10 characters wide (see below)
- *
  * This function was a major bottleneck when resting, so a lot of
  * the text formatting code was optimized in place below.
  */
@@ -1218,8 +1255,9 @@ static void prt_state(void)
 }
 
 
-/*
- * Prints the speed of a character.                    -CJS-
+/*!
+ * @brief プレイヤーの行動速度を表示する / Prints the speed of a character.                     -CJS-
+ * @return なし
  */
 static void prt_speed(void)
 {
@@ -1288,6 +1326,10 @@ static void prt_speed(void)
 }
 
 
+/*!
+ * @brief プレイヤーの呪文学習可能状態を表示する
+ * @return なし
+ */
 static void prt_study(void)
 {
        int wid, hgt, row_study, col_study;
@@ -1307,6 +1349,10 @@ static void prt_study(void)
 }
 
 
+/*!
+ * @brief プレイヤーのものまね可能状態を表示する
+ * @return なし
+ */
 static void prt_imitation(void)
 {
        int wid, hgt, row_study, col_study;
@@ -1331,7 +1377,10 @@ static void prt_imitation(void)
        }
 }
 
-
+/*!
+ * @brief プレイヤーの負傷状態を表示する
+ * @return なし
+ */
 static void prt_cut(void)
 {
        int c = p_ptr->cut;
@@ -1371,7 +1420,10 @@ static void prt_cut(void)
 }
 
 
-
+/*!
+ * @brief プレイヤーの朦朧状態を表示する
+ * @return なし
+ */
 static void prt_stun(void)
 {
        int s = p_ptr->stun;
@@ -1396,7 +1448,12 @@ static void prt_stun(void)
 
 
 
-/*
+/*!
+ * @brief モンスターの体力ゲージを表示する
+ * @param riding TRUEならば騎乗中のモンスターの体力、FALSEならターゲットモンスターの体力を表示する。表示位置は固定。
+ * @return なし
+ * @details
+ * <pre>
  * Redraw the "monster health bar"     -DRS-
  * Rather extensive modifications by   -BEN-
  *
@@ -1409,6 +1466,7 @@ static void prt_stun(void)
  * "health-o-meter").  Clear health bar if nothing is being tracked.
  * Auto-track current target monster when bored.  Note that the
  * health-bar stops tracking any monster that "disappears".
+ * </pre>
  */
 static void health_redraw(bool riding)
 {
@@ -1545,8 +1603,9 @@ static void health_redraw(bool riding)
 
 
 
-/*
- * Display basic info (mostly left of map)
+/*!
+ * @brief プレイヤーのステータスを一括表示する(左側部分) / Display basic info (mostly left of map)
+ * @return なし
  */
 static void prt_frame_basic(void)
 {
@@ -1596,8 +1655,9 @@ static void prt_frame_basic(void)
 }
 
 
-/*
- * Display extra info (mostly below map)
+/*!
+ * @brief プレイヤーのステータスを一括表示する(下部分) / Display extra info (mostly below map)
+ * @return なし
  */
 static void prt_frame_extra(void)
 {
@@ -1623,8 +1683,9 @@ static void prt_frame_extra(void)
 }
 
 
-/*
- * Hack -- display inventory in sub-windows
+/*!
+ * @brief サブウィンドウに所持品一覧を表示する / Hack -- display inventory in sub-windows
+ * @return なし
  */
 static void fix_inven(void)
 {
@@ -1656,13 +1717,21 @@ static void fix_inven(void)
 }
 
 
-/*
- * Print monster info in line
+/*!
+ * @brief モンスターの現在数を一行で表現する / Print monster info in line
+ * @param x 表示列
+ * @param y 表示行
+ * @param m_ptr 思い出を表示するモンスター情報の参照ポインタ
+ * @param n_same モンスターの数の現在数
+ * @details
+ * <pre>
  * nnn X LV name
  *  nnn : number or unique(U) or wanted unique(W)
  *  X   : symbol of monster
  *  LV  : monster lv if known
  *  name: name of monster
+ * @return なし
+ * </pre>
  */
 static void print_monster_line(int x, int y, monster_type* m_ptr, int n_same){
        char buf[256];
@@ -1705,9 +1774,12 @@ static void print_monster_line(int x, int y, monster_type* m_ptr, int n_same){
        //Term_addstr(-1, TERM_WHITE, look_mon_desc(m_ptr, 0));
 }
 
- /*
-       max_lines : 最大何行描画するか.
-*/
+/*!
+ * @brief モンスターの出現リストを表示する / Print monster info in line
+ * @param x 表示列
+ * @param y 表示行
+ * @param max_lines 最大何行描画するか
+ */
 void print_monster_list(int x, int y, int max_lines){
        int line = y;
        monster_type* last_mons = NULL;
@@ -1765,8 +1837,10 @@ void print_monster_list(int x, int y, int max_lines){
                if(last_mons)print_monster_line(x, line++, last_mons, n_same);
        }
 }
-/*
- * Hack -- display monster list in sub-windows
+
+/*!
+ * @brief 出現中モンスターのリストをサブウィンドウに表示する / Hack -- display monster list in sub-windows
+ * @return なし
  */
 static void fix_monster_list(void)
 {
@@ -1790,7 +1864,7 @@ static void fix_monster_list(void)
 
                Term_clear();
 
-               target_set_prepare_look();//モンスター一覧を生成,ソート
+               target_set_prepare_look(); //モンスター一覧を生成,ソート
                print_monster_list(0, 0, h);
 
                /* Fresh */
@@ -1803,9 +1877,10 @@ static void fix_monster_list(void)
 
 
 
-
-/*
+/*!
+ * @brief 現在の装備品をサブウィンドウに表示する / 
  * Hack -- display equipment in sub-windows
+ * @return なし
  */
 static void fix_equip(void)
 {
@@ -1837,8 +1912,10 @@ static void fix_equip(void)
 }
 
 
-/*
- * Hack -- display equipment in sub-windows
+/*!
+ * @brief 現在の習得済魔法をサブウィンドウに表示する / 
+ * Hack -- display spells in sub-windows
+ * @return なし
  */
 static void fix_spell(void)
 {
@@ -1870,8 +1947,10 @@ static void fix_spell(void)
 }
 
 
-/*
+/*!
+ * @brief 現在のプレイヤーステータスをサブウィンドウに表示する / 
  * Hack -- display character in sub-windows
+ * @return なし
  */
 static void fix_player(void)
 {
@@ -1904,12 +1983,11 @@ static void fix_player(void)
        }
 }
 
-
-
-/*
+/*!
+ * @brief ゲームメッセージ履歴をサブウィンドウに表示する / 
  * Hack -- display recent messages in sub-windows
- *
  * XXX XXX XXX Adjust for width and split messages
+ * @return なし
  */
 static void fix_message(void)
 {
@@ -1956,9 +2034,12 @@ static void fix_message(void)
 }
 
 
-/*
+/*!
+ * @brief 簡易マップをサブウィンドウに表示する / 
  * Hack -- display overhead view in sub-windows
- *
+ * XXX XXX XXX Adjust for width and split messages
+ * @return なし
+ * @details
  * Note that the "player" symbol does NOT appear on the map.
  */
 static void fix_overhead(void)
@@ -1999,8 +2080,10 @@ static void fix_overhead(void)
 }
 
 
-/*
+/*!
+ * @brief ダンジョンの地形をサブウィンドウに表示する / 
  * Hack -- display dungeon view in sub-windows
+ * @return なし
  */
 static void fix_dungeon(void)
 {
@@ -2032,8 +2115,10 @@ static void fix_dungeon(void)
 }
 
 
-/*
- * Hack -- display monster recall in sub-windows
+/*!
+ * @brief モンスターの思い出をサブウィンドウに表示する / 
+ * Hack -- display dungeon view in sub-windows
+ * @return なし
  */
 static void fix_monster(void)
 {
@@ -2065,8 +2150,10 @@ static void fix_monster(void)
 }
 
 
-/*
+/*!
+ * @brief ベースアイテム情報をサブウィンドウに表示する / 
  * Hack -- display object recall in sub-windows
+ * @return なし
  */
 static void fix_object(void)
 {
@@ -2098,10 +2185,13 @@ static void fix_object(void)
 }
 
 
-/*
+
+/*!
+ * @brief プレイヤーの現在学習可能な魔法数を計算し、増減に応じて魔法の忘却、再学習を処置する。 /
  * Calculate number of spells player should have, and forget,
  * or remember, spells until that number is properly reflected.
- *
+ * @return なし
+ * @details
  * Note that this function induces various "status" messages,
  * which must be bypasses until the character is created.
  */
@@ -2450,11 +2540,12 @@ static void calc_spells(void)
        }
 }
 
-
-/*
+/*!
+ * @brief プレイヤーの最大MPを計算する /
  * Calculate maximum mana.  You do not need to know any spells.
  * Note that mana is lowered by heavy (or inappropriate) armor.
- *
+ * @return なし
+ * @details
  * This function induces status messages.
  */
 static void calc_mana(void)
@@ -2769,9 +2860,12 @@ static void calc_mana(void)
 
 
 
-/*
+/*!
+ * @brief プレイヤーの最大HPを計算する /
  * Calculate the players (maximal) hit points
  * Adjust current hitpoints if necessary
+ * @return なし
+ * @details
  */
 static void calc_hitpoints(void)
 {
@@ -2850,13 +2944,11 @@ static void calc_hitpoints(void)
        }
 }
 
-
-
-/*
- * Extract and set the current "lite radius"
- *
+/*!
+ * @brief プレイヤーの光源半径を計算する / Extract and set the current "lite radius"
+ * @return なし
+ * @details
  * SWD: Experimental modification: multiple light sources have additive effect.
- *
  */
 static void calc_torch(void)
 {
@@ -2933,9 +3025,10 @@ static void calc_torch(void)
 }
 
 
-
-/*
+/*!
+ * @brief プレイヤーの所持重量制限を計算する /
  * Computes current weight limit.
+ * @return 制限重量(ポンド)
  */
 u32b weight_limit(void)
 {
@@ -2949,12 +3042,21 @@ u32b weight_limit(void)
        return i;
 }
 
-
+/*!
+ * @brief プレイヤーが現在右手/左手に武器を持っているか判定する /
+ * @param i 判定する手のID(右手:0 左手:1)
+ * @return 持っているならばTRUE
+ */
 bool buki_motteruka(int i)
 {
        return ((inventory[i].k_idx && object_is_melee_weapon(&inventory[i])) ? TRUE : FALSE);
 }
 
+/*!
+ * @brief 射撃武器がプレイヤーにとって重すぎるかどうかの判定 /
+ * @param o_ptr 判定する射撃武器のアイテム情報参照ポインタ
+ * @return 重すぎるならばTRUE
+ */
 bool is_heavy_shoot(object_type *o_ptr)
 {
        int hold = adj_str_hold[p_ptr->stat_ind[A_STR]];
@@ -2962,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 */
@@ -2985,6 +3092,7 @@ int bow_tval_ammo(object_type *o_ptr)
                        return TV_BOLT;
                }
                case SV_CRIMSON:
+               case SV_HARP:
                {
                        return TV_NO_AMMO;
                }
@@ -2993,7 +3101,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;
@@ -3070,11 +3183,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
@@ -3089,6 +3205,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)
 {
@@ -4888,8 +5005,7 @@ void calc_bonuses(void)
                }
        }
 
-       if (p_ptr->ryoute)
-               hold *= 2;
+       if (p_ptr->ryoute) hold *= 2;
 
        for(i = 0 ; i < 2 ; i++)
        {
@@ -5646,10 +5762,9 @@ void calc_bonuses(void)
                if ((inventory[i].tval == TV_NATURE_BOOK) && (inventory[i].sval == 2)) have_sw = TRUE;
                if ((inventory[i].tval == TV_CRAFT_BOOK) && (inventory[i].sval == 2)) have_kabe = TRUE;
        }
-       for (this_o_idx = cave[py][px].o_idx; this_o_idx; this_o_idx = next_o_idx)
-       {
-               object_type *o_ptr;
 
+       for (this_o_idx = cave[p_ptr->y][p_ptr->x].o_idx; this_o_idx; this_o_idx = next_o_idx)
+       {
                /* Acquire object */
                o_ptr = &o_list[this_o_idx];
 
@@ -5693,8 +5808,10 @@ void calc_bonuses(void)
 
 
 
-/*
- * Handle "p_ptr->notice"
+/*! 
+ * @brief p_ptr->notice のフラグに応じた更新をまとめて行う / Handle "p_ptr->notice"
+ * @return なし
+ * @details 更新処理の対象はアイテムの自動破壊/アイテムの結合/アイテムの並び替え。
  */
 void notice_stuff(void)
 {
@@ -5725,8 +5842,10 @@ void notice_stuff(void)
 }
 
 
-/*
- * Handle "p_ptr->update"
+/*! 
+ * @brief p_ptr->update のフラグに応じた更新をまとめて行う / Handle "p_ptr->update"
+ * @return なし
+ * @details 更新処理の対象はプレイヤーの能力修正/光源寿命/HP/MP/魔法の学習状態、他多数の外界の状態判定。
  */
 void update_stuff(void)
 {
@@ -5838,8 +5957,10 @@ void update_stuff(void)
 }
 
 
-/*
- * Handle "p_ptr->redraw"
+/*! 
+ * @brief p_ptr->redraw のフラグに応じた更新をまとめて行う / Handle "p_ptr->redraw"
+ * @return なし
+ * @details 更新処理の対象はゲーム中の全描画処理
  */
 void redraw_stuff(void)
 {
@@ -6031,8 +6152,10 @@ void redraw_stuff(void)
 }
 
 
-/*
- * Handle "p_ptr->window"
+/*! 
+ * @brief p_ptr->window のフラグに応じた更新をまとめて行う / Handle "p_ptr->window"
+ * @return なし
+ * @details 更新処理の対象はサブウィンドウ全般
  */
 void window_stuff(void)
 {
@@ -6130,8 +6253,10 @@ void window_stuff(void)
 }
 
 
-/*
+/*!
+ * @brief 全更新処理をチェックして処理していく
  * Handle "p_ptr->update" and "p_ptr->redraw" and "p_ptr->window"
+ * @return なし
  */
 void handle_stuff(void)
 {
@@ -6145,7 +6270,11 @@ void handle_stuff(void)
        if (p_ptr->window) window_stuff();
 }
 
-
+/*!
+ * @brief プレイヤーの現在開いている手の状態を返す
+ * @param riding_control 乗馬中により片手を必要としている状態ならばTRUEを返す。
+ * @return 開いている手のビットフラグ
+ */
 s16b empty_hands(bool riding_control)
 {
        s16b status = EMPTY_HAND_NONE;
@@ -6163,6 +6292,10 @@ s16b empty_hands(bool riding_control)
 }
 
 
+/*!
+ * @brief プレイヤーが防具重量制限のある職業時にペナルティを受ける状態にあるかどうかを返す。
+ * @return ペナルティが適用されるならばTRUE。
+ */
 bool heavy_armor(void)
 {
        u16b monk_arm_wgt = 0;
@@ -6181,6 +6314,9 @@ bool heavy_armor(void)
        return (monk_arm_wgt > (100 + (p_ptr->lev * 4)));
 }
 
+/*!
+ * @brief 実ゲームプレイ時間を更新する
+ */
 void update_playtime(void)
 {
        /* Check if the game has started */