X-Git-Url: http://j8takagi.net/cgi-bin/gitweb.cgi?p=YACASL2.git;a=blobdiff_plain;f=include%2Fcerr.h;h=810bf3c442cd881fc261bae02829d8b39e3b6be7;hp=db9adbecdc2005b80bf046fd381d5613dc6d60b5;hb=7fbde1700bbe9d8f779033ad3b842d3dceb3e1c6;hpb=d1f82970bf7d41db2fea11b08cd8e308f6cb8138

diff --git a/include/cerr.h b/include/cerr.h
index db9adbe..810bf3c 100644
--- a/include/cerr.h
+++ b/include/cerr.h
@@ -5,28 +5,28 @@
 #include "cmem.h"
 
 /**
- * エラーの構造体
+ * @brief エラーを表すデータ型
  */
-typedef struct {
-    int num;        /* エラー番号 */
-    char *msg;      /* エラーメッセージ */
+typedef struct _CERR {
+    int num;        /**<エラー番号 */
+    char *msg;      /**<エラーメッセージ */
 } CERR;
 
 /**
- * 現在のエラー
+ * @brief 現在のエラー
  */
 extern CERR *cerr;
 
 /**
- * エラーリスト型
+ * @brief エラーリストのデータ型
  */
 typedef struct _CERRLIST {
-    struct _CERRLIST *next;
-    CERR *cerr;
+    struct _CERRLIST *next;     /**<リスト次項目へのポインタ */
+    CERR *cerr;                 /**<エラーの構造体 */
 } CERRLIST;
 
 /**
- * エラーリスト
+ * @brief エラーリスト
  */
 extern CERRLIST *cerrlist;
 
@@ -36,27 +36,52 @@ enum {
 };
 
 /**
- * エラーの初期化
+ * @brief エラーを初期化する
+ *
+ * @return なし
  */
 void cerr_init();
 
 /**
- * エラーリストを作成・追加する
+ * @brief エラーリストを作成・追加する
+ *
+ * @return なし
+ *
+ * @param cerrc 作成または追加するエラーの数
+ * @param cerrv 作成または追加するエラーの配列
  */
-bool addcerrlist(int cerrc, CERR cerrv[]);
+void addcerrlist(int cerrc, CERR cerrv[]);
 
 /**
- * 現在のエラーを設定する
+ * @brief エラーリストを表示する
+ *
+ * @return なし
+ */
+void printcerrlist();
+
+/**
+ * @brief 現在のエラーを設定する
+ *
+ * @return なし
+ *
+ * @param num エラー番号
+ * @param *str エラーメッセージに含まれる文字列
  */
 void setcerr(int num, const char *str);
 
 /**
- * エラーリストから、エラー番号に対応するメッセージを返す
+ * @brief エラー番号に対応するエラーメッセージを返す
+ *
+ * @return エラーメッセージ
+ *
+ * @param num エラー番号
  */
 char *getcerrmsg(int num);
 
 /**
- * エラーリストと現在のエラーを解放する
+ * @brief エラーリストと現在のエラーを解放する
+ *
+ * @return なし
  */
 void freecerr();
 #endif