change comments

git-svn-id: svn+ssh://svn.sourceforge.jp/svnroot/kita/kita/trunk@1712 56b19765-1e22-0410-a548-a0f45d66c51a

diff --git a/kita/src/libkita/datinfo.cpp b/kita/src/libkita/datinfo.cpp
index 7e7a574..ebf5c37 100644 (file)
--- a/kita/src/libkita/datinfo.cpp
+++ b/kita/src/libkita/datinfo.cpp
@@ -477,7 +477,19 @@ int DatInfo::getHTML( int num, bool checkAbone, QString& titleHTML, QString& bod
     return getHTMLPrivate( num, checkAbone, titleHTML, bodyHTML );
 }
 
-/* private */
+/**
+ * @param[in] num
+ * @param[in] checkAbone
+ *
+ * @param[out] titleHTML
+ * @param[out] bodyHTML
+ *
+ * @retval KITA_HTML_NOTPARSED The dat is not parsed.
+ * @retval KITA_HTML_ABONE The res dat is marked as abone.
+ * @retval KITA_HTML_BROKEN The res dat is marked as broken.
+ * @retval KITA_HTML_NORMAL The res dat is normal.
+ *
+ */
 int DatInfo::getHTMLPrivate( int num, bool checkAbone, QString& titleHTML, QString& bodyHTML )
 {
     if ( !parseDat( num ) ) return KITA_HTML_NOTPARSED;
@@ -557,8 +569,16 @@ QString DatInfo::getHtmlByID( const QString& strid, int &count )
     return retHTML;
 }
 
-
-/* private */
+/**
+ *
+ * convert res dat to html.
+ *
+ * @param[in] num
+ * @param[in] checkAbone
+ *
+ * @param[out] html
+ *
+ */
 void DatInfo::getHTMLofOneRes( int num, bool checkAbone, QString& html )
 {
     html = QString::null;