[Refactor] diplay_monster_attacks以下を実態に合わせて改名、doxygen追加

～～_blowsと～～_blows_jp/enは、実体が1回の打撃ついてなのでblowに変更。
～～_attacksはつまるところ_blowsなので変更。
ヘッダの不要な宣言を削除。

diff --git a/src/lore/monster-lore.c b/src/lore/monster-lore.c
index 1db4b23..522ee70 100644 (file)
--- a/src/lore/monster-lore.c
+++ b/src/lore/monster-lore.c
@@ -209,6 +209,6 @@ void process_monster_lore(player_type *player_ptr, MONRACE_IDX r_idx, monster_lo
     display_monster_immunities(lore_ptr);
     display_monster_alert(lore_ptr);
     display_monster_drops(lore_ptr);
-    display_monster_attacks(lore_ptr);
+    display_monster_blows(lore_ptr);
     display_monster_guardian(lore_ptr);
 }

diff --git a/src/view/display-lore-attacks.c b/src/view/display-lore-attacks.c
index 2e98252..36f1aee 100644 (file)
--- a/src/view/display-lore-attacks.c
+++ b/src/view/display-lore-attacks.c
@@ -9,7 +9,16 @@
 #endif
 
 #ifdef JP
-static void display_monster_blows_jp(lore_type *lore_ptr, int attack_numbers, int d1, int d2, int m)
+/*!
+ * @brief [日本語]モンスター打撃の1回分を出力する
+ * @param lore_ptr 思い出情報へのポインタ
+ * @param attack_numbers 打撃の最大回数
+ * @param d1 ダメージダイス数
+ * @param d2 ダメージダイス面
+ * @param m 打撃の何番目か
+ * @return なし
+ */
+static void display_monster_blow_jp(lore_type *lore_ptr, int attack_numbers, int d1, int d2, int m)
 {
     if (attack_numbers == 0) {
         hooked_roff(format("%^sは", wd_he[lore_ptr->msex]));
@@ -48,8 +57,16 @@ static void display_monster_blows_jp(lore_type *lore_ptr, int attack_numbers, in
         hooked_roff("、");
 }
 #else
-
-static void display_monster_blows_en(lore_type *lore_ptr, int attack_numbers, int d1, int d2, int m)
+/*!
+ * @brief [英語]モンスター打撃の1回分を出力する
+ * @param lore_ptr 思い出情報へのポインタ
+ * @param attack_numbers 打撃の最大回数
+ * @param d1 ダメージダイス数
+ * @param d2 ダメージダイス面
+ * @param m 打撃の何番目か
+ * @return なし
+ */
+static void display_monster_blow_en(lore_type *lore_ptr, int attack_numbers, int d1, int d2, int m)
 {
     if (attack_numbers == 0) {
         hooked_roff(format("%^s can ", wd_he[lore_ptr->msex]));
@@ -76,15 +93,27 @@ static void display_monster_blows_en(lore_type *lore_ptr, int attack_numbers, in
 }
 #endif
 
-void display_monster_blows(lore_type *lore_ptr, int m, int attack_numbers)
+/*!
+ * @brief モンスター打撃の1回分を出力する(日英切替への踏み台)
+ * @param lore_ptr 思い出情報へのポインタ
+ * @param m 打撃の何番目か
+ * @param attack_numbers 打撃の最大回数
+ * @return なし
+ */
+void display_monster_blow(lore_type *lore_ptr, int m, int attack_numbers)
 {
     int d1 = lore_ptr->r_ptr->blow[m].d_dice;
     int d2 = lore_ptr->r_ptr->blow[m].d_side;
-    void (*display_monster_blows_pf)(lore_type *, int, int, int, int) = _(display_monster_blows_jp, display_monster_blows_en);
+    void (*display_monster_blows_pf)(lore_type *, int, int, int, int) = _(display_monster_blow_jp, display_monster_blow_en);
     (*display_monster_blows_pf)(lore_ptr, attack_numbers, d1, d2, m);
 }
 
-void display_monster_attacks(lore_type *lore_ptr)
+/*!
+ * @brief モンスターの思い出に打撃に関する情報を出力する
+ * @param lore_ptr 思い出情報へのポインタ
+ * @return なし
+ */
+void display_monster_blows(lore_type *lore_ptr)
 {
     const int max_attack_numbers = 4;
     for (int m = 0; m < max_attack_numbers; m++) {
@@ -103,7 +132,7 @@ void display_monster_attacks(lore_type *lore_ptr)
 
         set_monster_blow_method(lore_ptr, m);
         set_monster_blow_effect(lore_ptr, m);
-        display_monster_blows(lore_ptr, m, attack_numbers);
+        display_monster_blow(lore_ptr, m, attack_numbers);
         attack_numbers++;
     }
 

diff --git a/src/view/display-lore-attacks.h b/src/view/display-lore-attacks.h
index 38a3aea..0d4b8b8 100644 (file)
--- a/src/view/display-lore-attacks.h
+++ b/src/view/display-lore-attacks.h
@@ -3,5 +3,4 @@
 #include "system/angband.h"
 #include "lore/lore-util.h"
 
-void display_monster_blows(lore_type *lore_ptr, int m, int attack_numbers);
-void display_monster_attacks(lore_type *lore_ptr);
+void display_monster_blows(lore_type *lore_ptr);