• R/O
  • HTTP
  • SSH
  • HTTPS

hengband: Commit

変愚蛮怒のメインリポジトリです


Commit MetaInfo

Revisione2cbb58e9eb27d15371a8111b0d79ba9c6abf31f (tree)
Time2013-12-27 23:34:24
Authordeskull <deskull@0568...>
Commiterdeskull

Log Message

Add Doxygen comment to bldg.c.

Change Summary

Incremental Difference

--- a/src/bldg.c
+++ b/src/bldg.c
@@ -3050,8 +3050,11 @@ msg_print("
30503050 }
30513051
30523052
3053-/*
3054- * Display quest information
3053+/*!
3054+ * @brief クエスト情報を表示しつつ処理する。/ Display quest information
3055+ * @param quest クエストのID
3056+ * @param do_init クエストの開始処理(TRUE)、結果処理か(FALSE)
3057+ * @return なし
30553058 */
30563059 static void get_questinfo(int questnum, bool do_init)
30573060 {
@@ -3098,9 +3101,10 @@ sprintf(tmp_str, "
30983101 }
30993102 }
31003103
3101-
3102-/*
3103- * Request a quest from the Lord.
3104+/*!
3105+ * @brief クエスト処理のメインルーチン / Request a quest from the Lord.
3106+ * @param なし
3107+ * @return なし
31043108 */
31053109 static void castle_quest(void)
31063110 {
@@ -3221,8 +3225,10 @@ msg_format("
32213225 }
32223226
32233227
3224-/*
3225- * Display town history
3228+/*!
3229+ * @brief 町に関するヘルプを表示する / Display town history
3230+ * @param なし
3231+ * @return なし
32263232 */
32273233 static void town_history(void)
32283234 {
@@ -3241,7 +3247,14 @@ static void town_history(void)
32413247 screen_load();
32423248 }
32433249
3244-/* critical happens at i / 10000 */
3250+/*!
3251+ * @brief 射撃時クリティカルによるダメージ期待値修正計算(スナイパーの集中処理と武器経験値) / critical happens at i / 10000
3252+ * @param weight 武器の重量
3253+ * @param plus_ammo 矢弾のダメージ修正
3254+ * @param plus_bow 弓のダメージ修正
3255+ * @param dam 基本ダメージ量
3256+ * @return ダメージ期待値
3257+ */
32453258 s16b calc_crit_ratio_shot(int weight, int plus_ammo, int plus_bow, int dam)
32463259 {
32473260 int i;
@@ -3267,6 +3280,14 @@ s16b calc_crit_ratio_shot(int weight, int plus_ammo, int plus_bow, int dam)
32673280 return i;
32683281 }
32693282
3283+/*!
3284+ * @brief 射撃時クリティカルによるダメージ期待値修正計算(重量依存部分) / critical happens at i / 10000
3285+ * @param weight 武器の重量
3286+ * @param plus_ammo 矢弾のダメージ修正
3287+ * @param plus_bow 弓のダメージ修正
3288+ * @param dam 基本ダメージ量
3289+ * @return ダメージ期待値
3290+ */
32703291 s16b calc_expect_crit_shot(int weight, int plus_ammo, int plus_bow, int dam)
32713292 {
32723293 u32b num;
@@ -3300,6 +3321,15 @@ s16b calc_expect_crit_shot(int weight, int plus_ammo, int plus_bow, int dam)
33003321 return num;
33013322 }
33023323
3324+/*!
3325+ * @brief 攻撃時クリティカルによるダメージ期待値修正計算(重量と毒針処理) / critical happens at i / 10000
3326+ * @param weight 武器の重量
3327+ * @param plus 武器のダメージ修正
3328+ * @param dam 基本ダメージ
3329+ * @param meichuu 命中値
3330+ * @param dokubari 毒針処理か否か
3331+ * @return ダメージ期待値
3332+ */
33033333 s16b calc_expect_crit(int weight, int plus, int dam, s16b meichuu, bool dokubari)
33043334 {
33053335 u32b k, num;
@@ -3336,6 +3366,14 @@ s16b calc_expect_crit(int weight, int plus, int dam, s16b meichuu, bool dokubari
33363366 return num;
33373367 }
33383368
3369+/*!
3370+ * @brief 攻撃時スレイによるダメージ期待値修正計算 / critical happens at i / 10000
3371+ * @param dam 基本ダメージ
3372+ * @param mult スレイ倍率(掛け算部分)
3373+ * @param div スレイ倍率(割り算部分)
3374+ * @param force 理力特別計算フラグ
3375+ * @return ダメージ期待値
3376+ */
33393377 static s16b calc_slaydam(int dam, int mult, int div, bool force)
33403378 {
33413379 int tmp;
@@ -3357,6 +3395,20 @@ static s16b calc_slaydam(int dam, int mult, int div, bool force)
33573395 return tmp;
33583396 }
33593397
3398+/*!
3399+ * @brief 攻撃時の期待値計算(スレイ→重量クリティカル→切れ味効果)
3400+ * @param dam 基本ダメージ
3401+ * @param mult スレイ倍率(掛け算部分)
3402+ * @param div スレイ倍率(割り算部分)
3403+ * @param force 理力特別計算フラグ
3404+ * @param weight 重量
3405+ * @param plus 武器ダメージ修正
3406+ * @param meichuu 命中値
3407+ * @param dokubari 毒針処理か否か
3408+ * @param vorpal_mult 切れ味倍率(掛け算部分)
3409+ * @param vorpal_div 切れ味倍率(割り算部分)
3410+ * @return ダメージ期待値
3411+ */
33603412 static u32b calc_expect_dice(u32b dam, int mult, int div, bool force, int weight, int plus, s16b meichuu, bool dokubari, int vorpal_mult, int vorpal_div)
33613413 {
33623414 dam = calc_slaydam(dam, mult, div, force);
Show on old repository browser