Merge pull request #934 from sikabane-works/feature/add-doxygen-artifact

[Add] artifact ディレクトリ以下のファイルに Doxygen コメントを追加.　/ Add Doxygen comments…

diff --cc src/artifact/artifact-info.cpp
Simple merge

diff --cc src/artifact/artifact-info.h
index d2c91ce,6fa7fac..b04825e
--- 1/src/artifact/artifact-info.h
--- 2/src/artifact/artifact-info.h
+++ b/src/artifact/artifact-info.h
@@@ -1,7 -1,11 +1,11 @@@
  #pragma once
+ /*!
+  * @file artifact-info.h
+  * @brief アーティファクトの発動効果取得関数ヘッダ
+  */
  
 -#include "object-enchant/activation-info-table.h"
 -#include "system/angband.h"
 -
 +typedef struct activation_type activation_type;
 +typedef struct object_type object_type;
 +typedef struct player_type player_type;
  int activation_index(player_type *player_ptr, object_type *o_ptr);
  const activation_type *find_activation_info(player_type *player_ptr, object_type *o_ptr);

diff --cc src/artifact/fixed-art-generator.cpp
Simple merge

diff --cc src/artifact/fixed-art-generator.h
Simple merge

diff --cc src/artifact/random-art-activation.h
index 1b252a2,38bbca7..3cde11e
--- 1/src/artifact/random-art-activation.h
--- 2/src/artifact/random-art-activation.h
+++ b/src/artifact/random-art-activation.h
@@@ -1,4 -1,9 +1,8 @@@
  #pragma once
+ /*!
+  * @file random-art-activation.h
+  * @brief ランダムアーティファクトの発動実装ヘッダ
+  */
  
 -#include "system/angband.h"
 -
 +typedef struct object_type object_type;
  void give_activation_power(object_type *o_ptr);

diff --cc src/artifact/random-art-characteristics.cpp
Simple merge

diff --cc src/artifact/random-art-characteristics.h
index ad8f754,39af6be..8d92adb
--- 1/src/artifact/random-art-characteristics.h
--- 2/src/artifact/random-art-characteristics.h
+++ b/src/artifact/random-art-characteristics.h
@@@ -1,7 -1,11 +1,11 @@@
  #pragma once
+ /*!
+  * @file random-art-characteristics.h
+  * @brief ランダムアーティファクトのバイアス付加処理ヘッダ
+  */
  
 -#include "system/angband.h"
 -
 +typedef struct object_type object_type;
 +typedef struct player_type player_type;
  void curse_artifact(player_type *player_ptr, object_type *o_ptr);
  void get_random_name(object_type *o_ptr, char *return_name, bool armour, int power);
  bool has_extreme_damage_rate(player_type *player_ptr, object_type *o_ptr);

diff --cc src/artifact/random-art-generator.cpp
Simple merge

diff --cc src/artifact/random-art-generator.h
index 48b0140,e3825e0..04be173
--- 1/src/artifact/random-art-generator.h
--- 2/src/artifact/random-art-generator.h
+++ b/src/artifact/random-art-generator.h
@@@ -1,5 -1,9 +1,9 @@@
  #pragma once
+ /*!
+  * @file random-art-generator.h
+  * @brief ランダムアーティファクトの生成メインヘッダ / Artifact code
+  */
  
 -#include "system/angband.h"
 -
 +typedef struct object_type object_type;
 +typedef struct player_type player_type;
  bool become_random_artifact(player_type *player_ptr, object_type *o_ptr, bool a_scroll);

diff --cc src/artifact/random-art-misc.cpp
Simple merge

diff --cc src/artifact/random-art-misc.h
index e5568a3,6e292d9..5d49a71
--- 1/src/artifact/random-art-misc.h
--- 2/src/artifact/random-art-misc.h
+++ b/src/artifact/random-art-misc.h
@@@ -1,5 -1,9 +1,9 @@@
  #pragma once
+ /*!
+  * @file random-art-misc.h
+  * @brief ランダムアーティファクト生成のその他特性バイアス付けヘッダ / Artifact code
+  */
  
 -#include "system/angband.h"
 -
 +typedef struct object_type object_type;
 +typedef struct player_type player_type;
  void random_misc(player_type *player_ptr, object_type *o_ptr);

diff --cc src/artifact/random-art-pval-investor.h
index ee62a0f,d9e8b87..eff5237
--- 1/src/artifact/random-art-pval-investor.h
--- 2/src/artifact/random-art-pval-investor.h
+++ b/src/artifact/random-art-pval-investor.h
@@@ -1,4 -1,10 +1,8 @@@
  #pragma once
+ /*!
+  * @file random-art-pval-investor.h
+  * @brief ランダムアーティファクトのpval付加処理ヘッダ
+  */
  
 -#include "system/angband.h"
 -
  typedef struct object_type object_type;
  void random_plus(object_type *o_ptr);

diff --cc src/artifact/random-art-resistance.h
index 06c40a3,8f59cf7..d5165e8
--- 1/src/artifact/random-art-resistance.h
--- 2/src/artifact/random-art-resistance.h
+++ b/src/artifact/random-art-resistance.h
@@@ -1,4 -1,9 +1,8 @@@
  #pragma once
+ /*!
+  * @file random-art-resistance.h
+  * @brief ランダムアーティファクトの耐性付加処理ヘッダ
+  */
  
 -#include "system/angband.h"
 -
 +typedef struct object_type object_type;
  void random_resistance(object_type *o_ptr);

diff --cc src/artifact/random-art-slay.h
index 099fe42,4ca5cf9..e9ce80d
--- 1/src/artifact/random-art-slay.h
--- 2/src/artifact/random-art-slay.h
+++ b/src/artifact/random-art-slay.h
@@@ -1,4 -1,9 +1,8 @@@
  #pragma once
+ /*!
+  * @file random-art-slay.h
+  * @brief ランダムアーティファクトのスレイ付加処理ヘッダ
+  */
  
 -#include "system/angband.h"
 -
 +typedef struct object_type object_type;
  void random_slay(object_type *o_ptr);