OSDN Git Service

クエスト実装に関するDoxygenコメントを追加。 / Add Doxygen comments for quest implementation.
[hengbandforosx/hengbandosx.git] / src / defines.h
index 12992c7..64bf19e 100644 (file)
@@ -68,7 +68,7 @@
  * Upper compatibility is always guaranteed.
  * </pre>
  */
-#define H_VER_MAJOR 2
+#define H_VER_MAJOR 2 /*!< セーブファイル上のバージョン定義(メジャー番号) */
 #define H_VER_MINOR 1 /*!< セーブファイル上のバージョン定義(マイナー番号) */
 #define H_VER_PATCH 2 /*!< セーブファイル上のバージョン定義(パッチ番号) */
 #define H_VER_EXTRA 4 /*!< セーブファイル上のバージョン定義(エクストラ番号) */
 /*
  * Arena constants
  */
-#define MAX_ARENA_MONS         41      /* -KMW- */
-#define ARENA_DEFEATED_OLD_VER (-(MAX_SHORT))
+#define MAX_ARENA_MONS         41      /*<! 闘技場のイベント件数 -KMW- */
+#define ARENA_DEFEATED_OLD_VER (-(MAX_SHORT)) /*<! 旧バージョンの闘技場敗北定義 */
 
 
 #define MAX_STORES      10 /*!< store.c用の店舗の種類最大数 / Total number of stores (see "store.c", etc) */
 /*
  * Follow distances
  */
-#define PET_CLOSE_DIST                         1
-#define PET_FOLLOW_DIST                                6
-#define PET_SEEK_DIST                          10
-#define PET_DESTROY_DIST                       255
-#define PET_SPACE_DIST                         (-10)
-#define PET_AWAY_DIST                          (-25)
+#define PET_CLOSE_DIST                         1               /*!<ペットの行動範囲…近くにいろ */
+#define PET_FOLLOW_DIST                                6               /*!<ペットの行動範囲…ついて来い */
+#define PET_SEEK_DIST                          10              /*!<ペットの行動範囲…特になし? */
+#define PET_DESTROY_DIST                       255             /*!<ペットの行動範囲…敵を見つけて倒せ */
+#define PET_SPACE_DIST                         (-10)   /*!<ペットの行動範囲…少し離れていろ */
+#define PET_AWAY_DIST                          (-25)   /*!<ペットの行動範囲…離れていろ */
 
-#define PF_OPEN_DOORS   0x0001
-#define PF_PICKUP_ITEMS 0x0002
-#define PF_TELEPORT     0x0004
-#define PF_ATTACK_SPELL 0x0008
-#define PF_SUMMON_SPELL 0x0010
-#define PF_BALL_SPELL   0x0020
-#define PF_RYOUTE       0x0040
+#define PF_OPEN_DOORS   0x0001 /*!< ペットの行動許可…ドアを開けてよい */
+#define PF_PICKUP_ITEMS 0x0002 /*!< ペットの行動許可…アイテムを拾ってよい */
+#define PF_TELEPORT     0x0004 /*!< ペットの行動許可…テレポート魔法を使ってよい */
+#define PF_ATTACK_SPELL 0x0008 /*!< ペットの行動許可…攻撃魔法を使ってよい */
+#define PF_SUMMON_SPELL 0x0010 /*!< ペットの行動許可…召喚魔法を使ってよい */
+#define PF_BALL_SPELL   0x0020 /*!< ペットの行動許可…ボール魔法でプレイヤーを巻き込んでよい */
+#define PF_RYOUTE       0x0040 /*!< プレイヤーの騎乗フラグ…武器を片手で持つ */
 
 
 #define CAN_TWO_HANDS_WIELDING() (!p_ptr->riding || (p_ptr->pet_extra_flags & PF_RYOUTE))
 
 
-/*
- * There is a 1/20 (5%) chance of inflating the requested object_level
+/*!
+ * @brief ベースアイテム生成階層が加算される確率
+ * @details
+ * There is a 1/10 (10%) chance of inflating the requested object_level
  * during the creation of an object (see "get_obj_num()" in "object.c").
  * Lower values yield better objects more often.
  */
 #define GREAT_OBJ       10
 
-/*
+/*!
+ * @brief 深層モンスターが生成される基本確率(1/x)
+ * @details
  * There is a 1/25 (4%) chance of inflating the requested monster_level
  * during the creation of a monsters (see "get_mon_num()" in "monster.c").
  * Lower values yield harder monsters more often.
  */
 #define NASTY_MON_BASE     25
-#define NASTY_MON_MAX      3
-#define NASTY_MON_PLUS_MAX 25
+#define NASTY_MON_MAX      3   /*! 深層モンスターが1フロアに生成される最大数  */
+#define NASTY_MON_PLUS_MAX 25  /*! 深層モンスターの階層加算最大量 */
 
 #define PENETRATE_INVULNERABILITY 13 /*! 無敵化が破られる確率(1/x) / 1/x chance of hurting even if invulnerable! */
 
 #define MIN_M_ALLOC_TD          4 /*!< 街(昼間)の最低住人配置数 / The town starts out with 4 residents during the day */
 #define MIN_M_ALLOC_TN          8 /*!< 街(夜間)の最低住人配置数 / The town starts out with 8 residents during the night */
 
-
 /*!
  * @brief モンスター増殖の最大数
  * @details
  */
 #define MAX_REPRO       100
 
-
 /*
  * Player constants
  */
 
 
 /*
- * Bit flags for the "get_item" function
+ * get_item()関数でアイテムの選択を行うフラグ / Bit flags for the "get_item" function
  */
-#define USE_EQUIP      0x01    /* Allow equip items */
-#define USE_INVEN      0x02    /* Allow inven items */
-#define USE_FLOOR      0x04    /* Allow floor items */
+#define USE_EQUIP      0x01    /*!< アイテム選択範囲: 装備品からの選択を許可する / Allow equip items */
+#define USE_INVEN      0x02    /*!< アイテム選択範囲: 所持品からの選択を許可する /  Allow inven items */
+#define USE_FLOOR      0x04    /*!< アイテム選択範囲: 床下のアイテムからの選択を許可する /  Allow floor items */
 
 
 /*
- * Bit flags for the "p_ptr->notice" variable
+ * p_ptr->noticeに充てるアイテム更新処理要求 / Bit flags for the "p_ptr->notice" variable
  */
-#define PN_COMBINE      0x00000001L     /* Combine the pack */
-#define PN_REORDER      0x00000002L     /* Reorder the pack */
-#define PN_AUTODESTROY  0x00000004L     /* Auto-destroy marked item */
+#define PN_COMBINE      0x00000001L     /*!< アイテム処理フラグ: アイテムの結合を要する / Combine the pack */
+#define PN_REORDER      0x00000002L     /*!< アイテム処理フラグ: アイテムの並び替えを要する / Reorder the pack */
+#define PN_AUTODESTROY  0x00000004L     /*!< アイテム処理フラグ: アイテムの自動破壊を要する / Auto-destroy marked item */
 /* xxx (many) */
 
 
 /*
- * Bit flags for the "p_ptr->update" variable
+ * p_ptr->updateに充てるプレイヤーステータス更新処理要求 / Bit flags for the "p_ptr->update" variable
  */
-#define PU_BONUS        0x00000001L     /* Calculate bonuses */
-#define PU_TORCH        0x00000002L     /* Calculate torch radius */
+#define PU_BONUS        0x00000001L     /*!< ステータス更新フラグ: 能力値修正 / Calculate bonuses */
+#define PU_TORCH        0x00000002L     /*!< ステータス更新フラグ: 光源半径 / Calculate torch radius */
 /* xxx (many) */
-#define PU_HP           0x00000010L     /* Calculate chp and mhp */
-#define PU_MANA         0x00000020L     /* Calculate csp and msp */
-#define PU_SPELLS       0x00000040L     /* Calculate spells */
+#define PU_HP           0x00000010L     /*!< ステータス更新フラグ: HP / Calculate chp and mhp */
+#define PU_MANA         0x00000020L     /*!< ステータス更新フラグ: MP / Calculate csp and msp */
+#define PU_SPELLS       0x00000040L     /*!< ステータス更新フラグ: 魔法学習数 / Calculate spells */
 /* xxx (many) */
 /* xxx (many) */
-#define PU_UN_VIEW      0x00010000L     /* Forget view */
-#define PU_UN_LITE      0x00020000L     /* Forget lite */
+#define PU_UN_VIEW      0x00010000L     /*!< ステータス更新フラグ: 地形の視界外化 / Forget view */
+#define PU_UN_LITE      0x00020000L     /*!< ステータス更新フラグ: 明暗範囲の視界外化 / Forget lite */
 /* xxx (many) */
-#define PU_VIEW         0x00100000L     /* Update view */
-#define PU_LITE         0x00200000L     /* Update lite */
-#define PU_MON_LITE     0x00400000L     /* Monster illumination */
-#define PU_DELAY_VIS    0x00800000L     /* Mega-Hack -- Delayed visual update */
-#define PU_MONSTERS     0x01000000L     /* Update monsters */
-#define PU_DISTANCE     0x02000000L     /* Update distances */
+#define PU_VIEW         0x00100000L     /*!< ステータス更新フラグ: 視界 / Update view */
+#define PU_LITE         0x00200000L     /*!< ステータス更新フラグ: 明暗範囲 / Update lite */
+#define PU_MON_LITE     0x00400000L     /*!< ステータス更新フラグ: モンスターの光源範囲 / Monster illumination */
+#define PU_DELAY_VIS    0x00800000L     /*!< ステータス更新フラグ: 視界の追加更新 / Mega-Hack -- Delayed visual update */
+#define PU_MONSTERS     0x01000000L     /*!< ステータス更新フラグ: モンスターのステータス / Update monsters */
+#define PU_DISTANCE     0x02000000L     /*!< ステータス更新フラグ: プレイヤーとモンスターの距離 / Update distances */
 /* xxx */
-#define PU_FLOW         0x10000000L     /* Update flow */
+#define PU_FLOW         0x10000000L     /*!< ステータス更新フラグ: プレイヤーから各マスへの到達距離 / Update flow */
 /* xxx (many) */
 
 
 /*
  * Bit flags for the "p_ptr->redraw" variable
  */
-#define PR_MISC         0x00000001L     /* Display Race/Class */
-#define PR_TITLE        0x00000002L     /* Display Title */
-#define PR_LEV          0x00000004L     /* Display Level */
-#define PR_EXP          0x00000008L     /* Display Experience */
-#define PR_STATS        0x00000010L     /* Display Stats */
-#define PR_ARMOR        0x00000020L     /* Display Armor */
-#define PR_HP           0x00000040L     /* Display Hitpoints */
-#define PR_MANA         0x00000080L     /* Display Mana */
-#define PR_GOLD         0x00000100L     /* Display Gold */
-#define PR_DEPTH        0x00000200L     /* Display Depth */
-#define PR_EQUIPPY      0x00000400L     /* Display equippy chars */
-#define PR_HEALTH       0x00000800L     /* Display Health Bar */
-#define PR_CUT          0x00001000L     /* Display Extra (Cut) */
-#define PR_STUN         0x00002000L     /* Display Extra (Stun) */
-#define PR_HUNGER       0x00004000L     /* Display Extra (Hunger) */
-#define PR_STATUS       0x00008000L     /* Display Status Bar */
-#define PR_XXX0         0x00010000L     /* (unused) */
-#define PR_UHEALTH      0x00020000L     /* Display Uma Health Bar */
-#define PR_XXX1         0x00040000L     /* (unused) */
-#define PR_XXX2         0x00080000L     /* (unused) */
-#define PR_STATE        0x00100000L     /* Display Extra (State) */
-#define PR_SPEED        0x00200000L     /* Display Extra (Speed) */
-#define PR_STUDY        0x00400000L     /* Display Extra (Study) */
-#define PR_IMITATION    0x00800000L     /* Display Extra (Imitation) */
-#define PR_EXTRA        0x01000000L     /* Display Extra Info */
-#define PR_BASIC        0x02000000L     /* Display Basic Info */
-#define PR_MAP          0x04000000L     /* Display Map */
-#define PR_WIPE         0x08000000L     /* Hack -- Total Redraw */
+#define PR_MISC         0x00000001L     /*!< 再描画フラグ: 種族と職業 / Display Race/Class */
+#define PR_TITLE        0x00000002L     /*!< 再描画フラグ: 称号 / Display Title */
+#define PR_LEV          0x00000004L     /*!< 再描画フラグ: レベル / Display Level */
+#define PR_EXP          0x00000008L     /*!< 再描画フラグ: 経験値 / Display Experience */
+#define PR_STATS        0x00000010L     /*!< 再描画フラグ: ステータス /  Display Stats */
+#define PR_ARMOR        0x00000020L     /*!< 再描画フラグ: AC / Display Armor */
+#define PR_HP           0x00000040L     /*!< 再描画フラグ: HP / Display Hitpoints */
+#define PR_MANA         0x00000080L     /*!< 再描画フラグ: MP / Display Mana */
+#define PR_GOLD         0x00000100L     /*!< 再描画フラグ: 所持金 / Display Gold */
+#define PR_DEPTH        0x00000200L     /*!< 再描画フラグ: ダンジョンの階 / Display Depth */
+#define PR_EQUIPPY      0x00000400L     /*!< 再描画フラグ: 装備シンボル / Display equippy chars */
+#define PR_HEALTH       0x00000800L     /*!< 再描画フラグ: モンスターのステータス / Display Health Bar */
+#define PR_CUT          0x00001000L     /*!< 再描画フラグ: 負傷度 / Display Extra (Cut) */
+#define PR_STUN         0x00002000L     /*!< 再描画フラグ: 朦朧度 / Display Extra (Stun) */
+#define PR_HUNGER       0x00004000L     /*!< 再描画フラグ: 空腹度 / Display Extra (Hunger) */
+#define PR_STATUS       0x00008000L     /*!< 再描画フラグ: プレイヤーの付与状態 /  Display Status Bar */
+#define PR_XXX0         0x00010000L     /*!< (unused) */
+#define PR_UHEALTH      0x00020000L     /*!< 再描画フラグ: ペットのステータス / Display Uma Health Bar */
+#define PR_XXX1         0x00040000L     /*!< (unused) */
+#define PR_XXX2         0x00080000L     /*!< (unused) */
+#define PR_STATE        0x00100000L     /*!< 再描画フラグ: プレイヤーの行動状態 / Display Extra (State) */
+#define PR_SPEED        0x00200000L     /*!< 再描画フラグ: 加速 / Display Extra (Speed) */
+#define PR_STUDY        0x00400000L     /*!< 再描画フラグ: 学習 / Display Extra (Study) */
+#define PR_IMITATION    0x00800000L     /*!< 再描画フラグ: ものまね / Display Extra (Imitation) */
+#define PR_EXTRA        0x01000000L     /*!< 再描画フラグ: 拡張ステータス全体 / Display Extra Info */
+#define PR_BASIC        0x02000000L     /*!< 再描画フラグ: 基本ステータス全体 / Display Basic Info */
+#define PR_MAP          0x04000000L     /*!< 再描画フラグ: ゲームマップ / Display Map */
+#define PR_WIPE         0x08000000L     /*!< 再描画フラグ: 画面消去 / Hack -- Total Redraw */
 /* xxx */
 /* xxx */
 /* xxx */
 /*
  * Bit flags for the "p_ptr->window" variable (etc)
  */
-#define PW_INVEN        0x00000001L     /* Display inven/equip */
-#define PW_EQUIP        0x00000002L     /* Display equip/inven */
-#define PW_SPELL        0x00000004L     /* Display spell list */
-#define PW_PLAYER       0x00000008L     /* Display character */
-#define PW_MONSTER_LIST 0x00000010L     /* Display monster list */
+#define PW_INVEN        0x00000001L     /*!<サブウィンドウ描画フラグ: 所持品-装備品 / Display inven/equip */
+#define PW_EQUIP        0x00000002L     /*!<サブウィンドウ描画フラグ: 装備品-所持品 / Display equip/inven */
+#define PW_SPELL        0x00000004L     /*!<サブウィンドウ描画フラグ: 魔法一覧 / Display spell list */
+#define PW_PLAYER       0x00000008L     /*!<サブウィンドウ描画フラグ: プレイヤーのステータス / Display character */
+#define PW_MONSTER_LIST 0x00000010L     /*!<サブウィンドウ描画フラグ: 視界内モンスターの一覧 / Display monster list */
 /* xxx */
 /* xxx */
-#define PW_MESSAGE      0x00000040L     /* Display messages */
-#define PW_OVERHEAD     0x00000080L     /* Display overhead view */
-#define PW_MONSTER      0x00000100L     /* Display monster recall */
-#define PW_OBJECT       0x00000200L     /* Display object recall */
-#define PW_DUNGEON      0x00000400L     /* Display dungeon view */
-#define PW_SNAPSHOT     0x00000800L     /* Display snap-shot */
+#define PW_MESSAGE      0x00000040L     /*!<サブウィンドウ描画フラグ: メッセージログ / Display messages */
+#define PW_OVERHEAD     0x00000080L     /*!<サブウィンドウ描画フラグ: 周辺の光景 / Display overhead view */
+#define PW_MONSTER      0x00000100L     /*!<サブウィンドウ描画フラグ: モンスターの思い出 / Display monster recall */
+#define PW_OBJECT       0x00000200L     /*!<サブウィンドウ描画フラグ: アイテムの知識 / Display object recall */
+#define PW_DUNGEON      0x00000400L     /*!<サブウィンドウ描画フラグ: ダンジョンの地形 / Display dungeon view */
+#define PW_SNAPSHOT     0x00000800L     /*!<サブウィンドウ描画フラグ: 記念写真 / Display snap-shot */
 /* xxx */
 /* xxx */
-#define PW_BORG_1       0x00004000L     /* Display borg messages */
-#define PW_BORG_2       0x00008000L     /* Display borg status */
+#define PW_BORG_1       0x00004000L     /*!<サブウィンドウ描画フラグ: ボーグメッセージ / Display borg messages */
+#define PW_BORG_2       0x00008000L     /*!<サブウィンドウ描画フラグ: ボーグステータス / Display borg status */
 
 /*
  * Bit flags for the place_monster_???() (etc)
 #define NINJA_KAWARIMI  0x00002000 /*!< プレイヤーのステータス:変わり身 */
 #define NINJA_S_STEALTH 0x00004000 /*!< プレイヤーのステータス:超隠密 */
 
-#define MAX_KAMAE 4
-#define KAMAE_MASK (KAMAE_GENBU | KAMAE_BYAKKO | KAMAE_SEIRYU | KAMAE_SUZAKU)
+#define MAX_KAMAE 4 /*!< 修行僧の構え最大数 */
+#define KAMAE_MASK (KAMAE_GENBU | KAMAE_BYAKKO | KAMAE_SEIRYU | KAMAE_SUZAKU) /*!< 修行僧の構えビット配列 */
 
-#define MAX_KATA 4
-#define KATA_MASK (KATA_IAI | KATA_FUUJIN | KATA_KOUKIJIN | KATA_MUSOU)
+#define MAX_KATA 4 /*!< 修行僧の型最大数 */
+#define KATA_MASK (KATA_IAI | KATA_FUUJIN | KATA_KOUKIJIN | KATA_MUSOU) /*!< 修行僧の型ビット配列 */
 
 
-#define ACTION_NONE     0
-#define ACTION_SEARCH   1
-#define ACTION_REST     2
-#define ACTION_LEARN    3
-#define ACTION_FISH     4
-#define ACTION_KAMAE    5
-#define ACTION_KATA     6
-#define ACTION_SING     7
-#define ACTION_HAYAGAKE 8
-#define ACTION_SPELL    9
+#define ACTION_NONE     0 /*!< 持続行動: なし */
+#define ACTION_SEARCH   1 /*!< 持続行動: 探索 */
+#define ACTION_REST     2 /*!< 持続行動: 休憩 */
+#define ACTION_LEARN    3 /*!< 持続行動: 青魔法ラーニング */
+#define ACTION_FISH     4 /*!< 持続行動: 釣り */
+#define ACTION_KAMAE    5 /*!< 持続行動: 修行僧の構え */
+#define ACTION_KATA     6 /*!< 持続行動: 剣術家の型 */
+#define ACTION_SING     7 /*!< 持続行動: 歌 */
+#define ACTION_HAYAGAKE 8 /*!< 持続行動: 早駆け */
+#define ACTION_SPELL    9 /*!< 持続行動: 呪術 */
 
 
 /* Empty hand status */
 #define GF_SOUND        21
 #define GF_CONFUSION    22
 #define GF_FORCE        23
-#define GF_INERTIA      24
+#define GF_INERTIAL      24
 #define GF_MANA         26
 #define GF_METEOR       27
 #define GF_ICE          28
  */
 #define is_seen(A) \
        ((bool)((A)->ml && (!ignore_unview || p_ptr->inside_battle || \
-        (player_can_see_bold((A)->fy, (A)->fx) && projectable(py, px, (A)->fy, (A)->fx)))))
+        (player_can_see_bold((A)->fy, (A)->fx) && projectable(p_ptr->y, p_ptr->x, (A)->fy, (A)->fx)))))
 
 
 /*** Option Definitions ***/
  * Determine if player is on this grid
  */
 #define player_bold(Y,X) \
-       (((Y) == py) && ((X) == px))
+       (((Y) == p_ptr->y) && ((X) == p_ptr->x))
 
 
 /*
  * Grid based version of "player_bold()"
  */
 #define player_grid(C) \
-       ((C) == &cave[py][px])
+       ((C) == &cave[p_ptr->y][p_ptr->x])
 
 
 #define cave_have_flag_bold(Y,X,INDEX) \
@@ -4408,22 +4410,22 @@ extern int PlayerUID;
  * The "(R,G,B)" codes are given in "fourths" of the "maximal" value,
  * and should "gamma corrected" on most (non-Macintosh) machines.
  */
-#define TERM_DARK                0  /* 'd' */   /* 0,0,0 */
-#define TERM_WHITE               1  /* 'w' */   /* 4,4,4 */
-#define TERM_SLATE               2  /* 's' */   /* 2,2,2 */
-#define TERM_ORANGE              3  /* 'o' */   /* 4,2,0 */
-#define TERM_RED                 4  /* 'r' */   /* 3,0,0 */
-#define TERM_GREEN               5  /* 'g' */   /* 0,2,1 */
-#define TERM_BLUE                6  /* 'b' */   /* 0,0,4 */
-#define TERM_UMBER               7  /* 'u' */   /* 2,1,0 */
-#define TERM_L_DARK              8  /* 'D' */   /* 1,1,1 */
-#define TERM_L_WHITE             9  /* 'W' */   /* 3,3,3 */
-#define TERM_VIOLET             10  /* 'v' */   /* 4,0,4 */
-#define TERM_YELLOW             11  /* 'y' */   /* 4,4,0 */
-#define TERM_L_RED              12  /* 'R' */   /* 4,0,0 */
-#define TERM_L_GREEN            13  /* 'G' */   /* 0,4,0 */
-#define TERM_L_BLUE             14  /* 'B' */   /* 0,4,4 */
-#define TERM_L_UMBER            15  /* 'U' */   /* 3,2,1 */
+#define TERM_DARK                0  /*!< 'd' - 黒 0,0,0 */
+#define TERM_WHITE               1  /*!< 'w' - 白 4,4,4 */
+#define TERM_SLATE               2  /*!< 's' - 灰 2,2,2 */
+#define TERM_ORANGE              3  /*!< 'o' - 橙 4,2,0 */
+#define TERM_RED                 4  /*!< 'r' - 赤 3,0,0 */
+#define TERM_GREEN               5  /*!< 'g' - 緑 0,2,1 */
+#define TERM_BLUE                6  /*!< 'b' - 青 0,0,4 */
+#define TERM_UMBER               7  /*!< 'u' - 琥珀 2,1,0 */
+#define TERM_L_DARK              8  /*!< 'D' - 暗い灰 1,1,1 */
+#define TERM_L_WHITE             9  /*!< 'W' - 明るい灰 3,3,3 */
+#define TERM_VIOLET             10  /*!< 'v' - 紫 4,0,4 */
+#define TERM_YELLOW             11  /*!< 'y' - 黄 4,4,0 */
+#define TERM_L_RED              12  /*!< 'R' - 明るい赤 4,0,0 */
+#define TERM_L_GREEN            13  /*!< 'G' - 明るい緑 0,4,0 */
+#define TERM_L_BLUE             14  /*!< 'B' - 明るい青 0,4,4 */
+#define TERM_L_UMBER            15  /*!< 'U' - 明るい琥珀 3,2,1 */
 
 
 /*
@@ -4488,43 +4490,43 @@ extern int PlayerUID;
 #define SOUND_BUY          26
 #define SOUND_SELL         27
 #define SOUND_WARN         28
-#define SOUND_ROCKET    29 /* Somebody's shooting rockets */
-#define SOUND_N_KILL    30 /* The player kills a non-living/undead monster */
-#define SOUND_U_KILL    31 /* The player kills a unique */
-#define SOUND_QUEST     32 /* The player has just completed a quest */
-#define SOUND_HEAL      33 /* The player was healed a little bit */
-#define SOUND_X_HEAL    34 /* The player was healed full health */
-#define SOUND_BITE      35 /* A monster bites you */
-#define SOUND_CLAW      36 /* A monster claws you */
-#define SOUND_M_SPELL   37 /* A monster casts a miscellaneous spell */
-#define SOUND_SUMMON    38 /* A monster casts a summoning spell  */
-#define SOUND_BREATH    39 /* A monster breathes */
-#define SOUND_BALL      40 /* A monster casts a ball / bolt spell */
-#define SOUND_M_HEAL    41 /* A monster heals itself somehow */
-#define SOUND_ATK_SPELL 42 /* A monster casts a misc. offensive spell */
-#define SOUND_EVIL      43 /* Something nasty has just happened! */
-#define SOUND_TOUCH     44 /* A monster touches you */
-#define SOUND_STING     45 /* A monster stings you */
-#define SOUND_CRUSH     46 /* A monster crushes / envelopes you */
-#define SOUND_SLIME     47 /* A monster drools/spits/etc on you */
-#define SOUND_WAIL      48 /* A monster wails */
-#define SOUND_WINNER    49 /* Just won the game! */
-#define SOUND_FIRE      50 /* An item was burned  */
-#define SOUND_ACID      51 /* An item was destroyed by acid */
-#define SOUND_ELEC      52 /* An item was destroyed by electricity */
-#define SOUND_COLD      53 /* An item was shattered */
-#define SOUND_ILLEGAL   54 /* Illegal command attempted */
-#define SOUND_FAIL      55 /* Fail to get a spell off / activate an item */
-#define SOUND_WAKEUP    56 /* A monster wakes up */
-#define SOUND_INVULN    57 /* Invulnerability! */
-#define SOUND_FALL      58 /* Falling through a trapdoor... */
-#define SOUND_PAIN      59 /* A monster is in pain! */
-#define SOUND_DESTITEM  60 /* An item was destroyed by misc. means */
-#define SOUND_MOAN      61 /* A monster makes a moan/beg/insult attack */
-#define SOUND_SHOW      62 /* A monster makes a "show" attack */
-#define SOUND_UNUSED    63 /* (no sound for gaze attacks) */
-#define SOUND_EXPLODE   64 /* Something (or somebody) explodes */
-#define SOUND_GLASS     65 /* A glass feature was crashed */
+#define SOUND_ROCKET    29 /*!< Somebody's shooting rockets */
+#define SOUND_N_KILL    30 /*!< The player kills a non-living/undead monster */
+#define SOUND_U_KILL    31 /*!< The player kills a unique */
+#define SOUND_QUEST     32 /*!< The player has just completed a quest */
+#define SOUND_HEAL      33 /*!< The player was healed a little bit */
+#define SOUND_X_HEAL    34 /*!< The player was healed full health */
+#define SOUND_BITE      35 /*!< A monster bites you */
+#define SOUND_CLAW      36 /*!< A monster claws you */
+#define SOUND_M_SPELL   37 /*!< A monster casts a miscellaneous spell */
+#define SOUND_SUMMON    38 /*!< A monster casts a summoning spell  */
+#define SOUND_BREATH    39 /*!< A monster breathes */
+#define SOUND_BALL      40 /*!< A monster casts a ball / bolt spell */
+#define SOUND_M_HEAL    41 /*!< A monster heals itself somehow */
+#define SOUND_ATK_SPELL 42 /*!< A monster casts a misc. offensive spell */
+#define SOUND_EVIL      43 /*!< Something nasty has just happened! */
+#define SOUND_TOUCH     44 /*!< A monster touches you */
+#define SOUND_STING     45 /*!< A monster stings you */
+#define SOUND_CRUSH     46 /*!< A monster crushes / envelopes you */
+#define SOUND_SLIME     47 /*!< A monster drools/spits/etc on you */
+#define SOUND_WAIL      48 /*!< A monster wails */
+#define SOUND_WINNER    49 /*!< Just won the game! */
+#define SOUND_FIRE      50 /*!< An item was burned  */
+#define SOUND_ACID      51 /*!< An item was destroyed by acid */
+#define SOUND_ELEC      52 /*!< An item was destroyed by electricity */
+#define SOUND_COLD      53 /*!< An item was shattered */
+#define SOUND_ILLEGAL   54 /*!< Illegal command attempted */
+#define SOUND_FAIL      55 /*!< Fail to get a spell off / activate an item */
+#define SOUND_WAKEUP    56 /*!< A monster wakes up */
+#define SOUND_INVULN    57 /*!< Invulnerability! */
+#define SOUND_FALL      58 /*!< Falling through a trapdoor... */
+#define SOUND_PAIN      59 /*!< A monster is in pain! */
+#define SOUND_DESTITEM  60 /*!< An item was destroyed by misc. means */
+#define SOUND_MOAN      61 /*!< A monster makes a moan/beg/insult attack */
+#define SOUND_SHOW      62 /*!< A monster makes a "show" attack */
+#define SOUND_UNUSED    63 /*!< (no sound for gaze attacks) */
+#define SOUND_EXPLODE   64 /*!< Something (or somebody) explodes */
+#define SOUND_GLASS     65 /*!< A glass feature was crashed */
 
 /*
  * Mega-Hack -- maximum known sounds
@@ -4627,26 +4629,26 @@ extern int PlayerUID;
 /*
  * Quest status
  */
-#define QUEST_STATUS_UNTAKEN              0
-#define QUEST_STATUS_TAKEN                1
-#define QUEST_STATUS_COMPLETED            2
-#define QUEST_STATUS_REWARDED             3
-#define QUEST_STATUS_FINISHED             4
-#define QUEST_STATUS_FAILED               5
-#define QUEST_STATUS_FAILED_DONE          6
-#define QUEST_STATUS_STAGE_COMPLETED      7
+#define QUEST_STATUS_UNTAKEN              0 /*!< クエストステータス状態:未発生*/
+#define QUEST_STATUS_TAKEN                1 /*!< クエストステータス状態:発生中*/
+#define QUEST_STATUS_COMPLETED            2 /*!< クエストステータス状態:達成*/
+#define QUEST_STATUS_REWARDED             3 /*!< クエストステータス状態:報酬受け取り前*/
+#define QUEST_STATUS_FINISHED             4 /*!< クエストステータス状態:完了*/
+#define QUEST_STATUS_FAILED               5 /*!< クエストステータス状態:失敗*/
+#define QUEST_STATUS_FAILED_DONE          6 /*!< クエストステータス状態:失敗完了*/
+#define QUEST_STATUS_STAGE_COMPLETED      7 /*!< クエストステータス状態:ステージ毎達成*/
 
 /*
  * Quest type
  */
-#define QUEST_TYPE_KILL_LEVEL                1
-#define QUEST_TYPE_KILL_ANY_LEVEL            2
-#define QUEST_TYPE_FIND_ARTIFACT             3
-#define QUEST_TYPE_FIND_EXIT                 4
-#define QUEST_TYPE_KILL_NUMBER               5
-#define QUEST_TYPE_KILL_ALL                  6
-#define QUEST_TYPE_RANDOM                    7
-#define QUEST_TYPE_TOWER                     8
+#define QUEST_TYPE_KILL_LEVEL                1 /*!< クエスト目的: 特定のユニークモンスターを倒す */
+#define QUEST_TYPE_KILL_ANY_LEVEL            2 /*!< クエスト目的: イベント受託時点でランダムで選ばれた特定のユニークモンスターを倒す */
+#define QUEST_TYPE_FIND_ARTIFACT             3 /*!< クエスト目的: 特定のアーティファクトを発見する */
+#define QUEST_TYPE_FIND_EXIT                 4 /*!< クエスト目的: 脱出する */
+#define QUEST_TYPE_KILL_NUMBER               5 /*!< クエスト目的: モンスターを無差別に特定数倒す */
+#define QUEST_TYPE_KILL_ALL                  6 /*!< クエスト目的: エリア中のすべてのモンスターを全て倒す */
+#define QUEST_TYPE_RANDOM                    7 /*!< クエスト目的: ランダムクエストとして選ばれたユニーク1体を倒す */
+#define QUEST_TYPE_TOWER                     8 /*!< クエスト目的: 複数のエリアの全てのモンスターを倒す */
 
 /*
  * Initialization flags
@@ -4661,10 +4663,10 @@ extern int PlayerUID;
 /*
  * Quest flags
  */
-#define QUEST_FLAG_SILENT  0x01 /* no messages fro completion */
-#define QUEST_FLAG_PRESET  0x02 /* quest is outside the main dungeon */
-#define QUEST_FLAG_ONCE    0x04 /* quest is marked finished after leaving */
-#define QUEST_FLAG_TOWER   0x08 /* Tower quest is special */
+#define QUEST_FLAG_SILENT  0x01 /*!< クエストフラグ: クエスト進行に関する情報表示を抑止する / no messages from completion */
+#define QUEST_FLAG_PRESET  0x02 /*!< クエストフラグ: クエストがダンジョン外で発生する / quest is outside the main dungeon */
+#define QUEST_FLAG_ONCE    0x04 /*!< クエストフラグ: クエストがフロアを出た時点で完了する / quest is marked finished after leaving */
+#define QUEST_FLAG_TOWER   0x08 /*!< クエストフラグ: クエスト:塔の形式で進行する / Tower quest is special */
 
 /*
  * Available graphic modes