リビジョン | 343e98b34c123510006d13c7aa5c2b70be965762 (tree) |
---|---|
日時 | 2013-12-28 22:33:30 |
作者 | deskull <deskull@0568...> |
コミッター | deskull |
Add Doxygen comment to birth.c.
@@ -3586,10 +3586,11 @@ static void init_turn(void) | ||
3586 | 3586 | } |
3587 | 3587 | |
3588 | 3588 | |
3589 | -/* | |
3590 | - * Try to wield everything wieldable in the inventory. | |
3591 | - * Code taken from Angband 3.1.0 under Angband license | |
3592 | - */ | |
3589 | +/*! | |
3590 | + * @brief 所持状態にあるアイテムの中から一部枠の装備可能なものを装備させる。 | |
3591 | + * @details アンデッド系種族は開始時刻を夜からにする。 | |
3592 | + * @return なし | |
3593 | + */ | |
3593 | 3594 | static void wield_all(void) |
3594 | 3595 | { |
3595 | 3596 | object_type *o_ptr; |
@@ -3651,9 +3652,10 @@ static void wield_all(void) | ||
3651 | 3652 | } |
3652 | 3653 | |
3653 | 3654 | |
3654 | -/* | |
3655 | - * Each player starts out with a few items, given as tval/sval pairs. | |
3656 | - * In addition, he always has some food and a few torches. | |
3655 | +/*! | |
3656 | + * プレイヤーの職業毎の初期装備テーブル。/\n | |
3657 | + * Each player starts out with a few items, given as tval/sval pairs.\n | |
3658 | + * In addition, he always has some food and a few torches.\n | |
3657 | 3659 | */ |
3658 | 3660 | static byte player_init[MAX_CLASS][3][2] = |
3659 | 3661 | { |
@@ -3851,9 +3853,10 @@ static byte player_init[MAX_CLASS][3][2] = | ||
3851 | 3853 | }, |
3852 | 3854 | }; |
3853 | 3855 | |
3854 | - | |
3855 | -/* | |
3856 | - * Hook function for human corpses | |
3856 | +/*! | |
3857 | + * @brief バルログが死体を食べられるモンスターかの判定 / Hook function for human corpses | |
3858 | + * @param r_idx モンスターID | |
3859 | + * @return 死体を食べられるならTRUEを返す。 | |
3857 | 3860 | */ |
3858 | 3861 | static bool monster_hook_human(int r_idx) |
3859 | 3862 | { |
@@ -3866,9 +3869,11 @@ static bool monster_hook_human(int r_idx) | ||
3866 | 3869 | return FALSE; |
3867 | 3870 | } |
3868 | 3871 | |
3869 | - | |
3870 | -/* | |
3871 | - * Add an outfit object | |
3872 | +/*! | |
3873 | + * @brief 初期所持アイテムの処理 / Add an outfit object | |
3874 | + * @detail アイテムを既知のものとした上でwield_all()関数により装備させる。 | |
3875 | + * @param o_ptr 処理したいオブジェクト構造体の参照ポインタ | |
3876 | + * @return なし | |
3872 | 3877 | */ |
3873 | 3878 | static void add_outfit(object_type *o_ptr) |
3874 | 3879 | { |
@@ -3886,10 +3891,10 @@ static void add_outfit(object_type *o_ptr) | ||
3886 | 3891 | } |
3887 | 3892 | |
3888 | 3893 | |
3889 | -/* | |
3890 | - * Init players with some belongings | |
3891 | - * | |
3892 | - * Having an item makes the player "aware" of its purpose. | |
3894 | +/*! | |
3895 | + * @brief 種族/職業/性格などに基づき初期所持アイテムを設定するメインセット関数。 / Init players with some belongings | |
3896 | + * @detail Having an item makes the player "aware" of its purpose. | |
3897 | + * @return なし | |
3893 | 3898 | */ |
3894 | 3899 | void player_outfit(void) |
3895 | 3900 | { |
@@ -4143,9 +4148,9 @@ void player_outfit(void) | ||
4143 | 4148 | k_info[lookup_kind(TV_POTION, SV_POTION_WATER)].aware = TRUE; |
4144 | 4149 | } |
4145 | 4150 | |
4146 | - | |
4147 | -/* | |
4148 | - * Player race | |
4151 | +/*! | |
4152 | + * @brief プレイヤーの種族選択を行う / Player race | |
4153 | + * @return なし | |
4149 | 4154 | */ |
4150 | 4155 | static bool get_player_race(void) |
4151 | 4156 | { |
@@ -4332,8 +4337,9 @@ static bool get_player_race(void) | ||
4332 | 4337 | } |
4333 | 4338 | |
4334 | 4339 | |
4335 | -/* | |
4336 | - * Player class | |
4340 | +/*! | |
4341 | + * @brief プレイヤーの職業選択を行う / Player class | |
4342 | + * @return なし | |
4337 | 4343 | */ |
4338 | 4344 | static bool get_player_class(void) |
4339 | 4345 | { |
@@ -4547,8 +4553,9 @@ static bool get_player_class(void) | ||
4547 | 4553 | } |
4548 | 4554 | |
4549 | 4555 | |
4550 | -/* | |
4551 | - * Player seikaku | |
4556 | +/*! | |
4557 | + * @brief プレイヤーの性格選択を行う / Player Player seikaku | |
4558 | + * @return なし | |
4552 | 4559 | */ |
4553 | 4560 | static bool get_player_seikaku(void) |
4554 | 4561 | { |
@@ -4792,6 +4799,10 @@ static bool get_player_seikaku(void) | ||
4792 | 4799 | } |
4793 | 4800 | |
4794 | 4801 | #ifdef ALLOW_AUTOROLLER |
4802 | +/*! | |
4803 | + * @brief オートローラで得たい能力値の基準を決める。 | |
4804 | + * @return なし | |
4805 | + */ | |
4795 | 4806 | static bool get_stat_limits(void) |
4796 | 4807 | { |
4797 | 4808 | int i, j, m, cs, os; |
@@ -5054,6 +5065,10 @@ static bool get_stat_limits(void) | ||
5054 | 5065 | #endif |
5055 | 5066 | |
5056 | 5067 | #ifdef ALLOW_AUTOROLLER |
5068 | +/*! | |
5069 | + * @brief オートローラで得たい年齢、身長、体重、社会的地位の基準を決める。 | |
5070 | + * @return なし | |
5071 | + */ | |
5057 | 5072 | static bool get_chara_limits(void) |
5058 | 5073 | { |
5059 | 5074 | #define MAXITEMS 8 |
@@ -5363,8 +5378,9 @@ static bool get_chara_limits(void) | ||
5363 | 5378 | #define HISTPREF_LIMIT 1024 |
5364 | 5379 | static char *histpref_buf = NULL; |
5365 | 5380 | |
5366 | -/* | |
5367 | - * Hook function for reading the histpref.prf file. | |
5381 | +/*! | |
5382 | + * @brief 生い立ちメッセージの内容をバッファに加える。 / Hook function for reading the histpref.prf file. | |
5383 | + * @return なし | |
5368 | 5384 | */ |
5369 | 5385 | void add_history_from_pref_line(cptr t) |
5370 | 5386 | { |
@@ -5374,7 +5390,10 @@ void add_history_from_pref_line(cptr t) | ||
5374 | 5390 | my_strcat(histpref_buf, t, HISTPREF_LIMIT); |
5375 | 5391 | } |
5376 | 5392 | |
5377 | - | |
5393 | +/*! | |
5394 | + * @brief 生い立ちメッセージをファイルからロードする。 | |
5395 | + * @return なし | |
5396 | + */ | |
5378 | 5397 | static bool do_cmd_histpref(void) |
5379 | 5398 | { |
5380 | 5399 | char buf[80]; |
@@ -5480,8 +5499,9 @@ static bool do_cmd_histpref(void) | ||
5480 | 5499 | return TRUE; |
5481 | 5500 | } |
5482 | 5501 | |
5483 | -/* | |
5484 | - * Character background edit-mode | |
5502 | +/*! | |
5503 | + * @brief 生い立ちメッセージを編集する。/Character background edit-mode | |
5504 | + * @return なし | |
5485 | 5505 | */ |
5486 | 5506 | static void edit_history(void) |
5487 | 5507 | { |
@@ -5684,12 +5704,13 @@ static void edit_history(void) | ||
5684 | 5704 | } |
5685 | 5705 | |
5686 | 5706 | |
5687 | -/* | |
5688 | - * Helper function for 'player_birth()' | |
5689 | - * | |
5707 | +/*! | |
5708 | + * @brief player_birth()関数のサブセット/Helper function for 'player_birth()' | |
5709 | + * @details | |
5690 | 5710 | * The delay may be reduced, but is recommended to keep players |
5691 | 5711 | * from continuously rolling up characters, which can be VERY |
5692 | 5712 | * expensive CPU wise. And it cuts down on player stupidity. |
5713 | + * @return なし | |
5693 | 5714 | */ |
5694 | 5715 | static bool player_birth_aux(void) |
5695 | 5716 | { |
@@ -6413,9 +6434,9 @@ static bool player_birth_aux(void) | ||
6413 | 6434 | return (TRUE); |
6414 | 6435 | } |
6415 | 6436 | |
6416 | - | |
6417 | -/* | |
6418 | - * Ask whether the player use Quick Start or not. | |
6437 | +/*! | |
6438 | + * @brief クイックスタート処理の問い合わせと実行を行う。/Ask whether the player use Quick Start or not. | |
6439 | + * @return なし | |
6419 | 6440 | */ |
6420 | 6441 | static bool ask_quick_start(void) |
6421 | 6442 | { |
@@ -6499,11 +6520,12 @@ static bool ask_quick_start(void) | ||
6499 | 6520 | } |
6500 | 6521 | |
6501 | 6522 | |
6502 | -/* | |
6503 | - * Create a new character. | |
6504 | - * | |
6523 | +/*! | |
6524 | + * @brief プレイヤー作成処理のメインルーチン/ Create a new character. | |
6525 | + * @details | |
6505 | 6526 | * Note that we may be called with "junk" leftover in the various |
6506 | 6527 | * fields, so we must be sure to clear them first. |
6528 | + * @return なし | |
6507 | 6529 | */ |
6508 | 6530 | void player_birth(void) |
6509 | 6531 | { |
@@ -6615,7 +6637,11 @@ void player_birth(void) | ||
6615 | 6637 | window_flag[2] |= PW_INVEN; |
6616 | 6638 | } |
6617 | 6639 | |
6618 | - | |
6640 | +/*! | |
6641 | + * @brief プレイヤー作成処理中のステータス表示処理 | |
6642 | + * @params fff ファイルポインタ | |
6643 | + * @return なし | |
6644 | + */ | |
6619 | 6645 | void dump_yourself(FILE *fff) |
6620 | 6646 | { |
6621 | 6647 | char temp[80*10]; |