【コメント】doxygen【コンソメ】

1 名前：デフォルトの名無しさん mailto:sage [2008/05/30(金) 19:50:27 ] 無いので建てた 公式 www.doxygen.jp/ 152 名前：デフォルトの名無しさん mailto:sage [2009/03/03(火) 10:33:16 ] DoxyfileもGPLに該当しないのかな。 それとも、コメント部分は削除しておいた方が無難? 153 名前：デフォルトの名無しさん mailto:sage [2009/03/03(火) 22:08:28 ] ソフトのドキュメントを作るのにDoxygenを利用してもGPLにする必要なし。 ソフトの機能としてDoxygenを利用する場合はGPL。 154 名前：デフォルトの名無しさん mailto:sage [2009/04/06(月) 21:16:11 ] @a と @p ってどう使い分けてる？ どっちも文中の引数のフォントを変えるために使うものみたいだけど。 155 名前：デフォルトの名無しさん mailto:sage [2009/04/08(水) 12:32:53 ] \aは「特殊なフォント」ということで一般的にはItalicかな。 \pは\cと等価で「タイプライタフォント」ということで等幅フォントが使われる。 後は、実際の出力を見て検討したら? 156 名前：154 mailto:sage [2009/04/09(木) 00:04:14 ] 普通はどうする、ということは特になくて、見た目の好みで使えばいいのですか。 ヘルプを見ると、@aは "refer to member arguments" 、 @pは "refer to member function parameters" と書かれてて、 微妙に使い分けがあるようなないような、よく分からなかったもので。 157 名前：デフォルトの名無しさん mailto:sage [2009/04/09(木) 07:14:32 ] 意味で使い分ければいいと思う。 フォントとかの体裁はCSSで変えられるんじゃなかったかな？やったこと無いけど。 158 名前：デフォルトの名無しさん mailto:sage [2009/04/09(木) 08:11:53 ] @a の argument が実引数で @p の parameter が仮引数なわけだけど、 コメント中では仮引数しか現れない気がする。実引数が現れることなんてあるか？ 159 名前：デフォルトの名無しさん mailto:sage [2009/04/09(木) 09:06:56 ] 恣意的に使い分ければいいんじゃね? >>157 出力するものによって指定するスタイルシートや指定方法は違うけど、htmlならcss,だね。 やったことないけどw 160 名前：デフォルトの名無しさん mailto:sage [2009/04/10(金) 04:10:58 ] member argumentがクラスのメンバー変数ってことはないかな。 161 名前：デフォルトの名無しさん mailto:sage [2009/04/10(金) 23:50:56 ] >>158 @p param1 の値が @a xxx だったら〜 みたいな説明を書くのに使うとか? 162 名前：デフォルトの名無しさん mailto:sage [2009/04/25(土) 21:37:10 ] メソッドのコメントは、戻り値がなくても「@return なし」と明示的に書くべきでしょうか？ 引数がない場合も同様に「@param なし」と書くでしょうか？ 163 名前：デフォルトの名無しさん mailto:sage [2009/04/25(土) 21:38:20 ] 前者はお好きにどうぞ。 後者は「なし」なんて引き数はないぞって警告が出るんじゃないかな? 164 名前：162 mailto:sage [2009/04/25(土) 21:45:11 ] >>163 レスありがとうございました。 確認したら「@param なし」ではwarning argumentと出ましたのでこれは書かないようにします。 165 名前：デフォルトの名無しさん mailto:sage [2009/04/30(木) 13:43:57 ] 今の大会は、開発環境の違いによる面白さもあると思う。 共通スペックでやるなら別に大会をおこせばよいと思う。 166 名前：デフォルトの名無しさん mailto:sage [2009/04/30(木) 13:45:15 ] >>165 誤爆しました。すみません。 167 名前：デフォルトの名無しさん [2009/04/30(木) 23:56:10 ] Doxygen 1.5.9 age 168 名前：デフォルトの名無しさん mailto:sage [2009/05/01(金) 00:16:08 ] さっきまでは1.5.8だったのに。早速試すぜ。 169 名前：デフォルトの名無しさん [2009/05/12(火) 10:55:11 ] ソースの先頭のコメントの 理想的なサンプル を教えて。 言語は問わないけど、出来ればCで。 170 名前：デフォルトの名無しさん mailto:sage [2009/05/12(火) 18:22:26 ] 理想的かどうか知らんが、私の典型。 -- //////////////////////////////////////////////////////////////// /// \file foo.c /// \brief あーたらこーたら /// /// あーたらこーたらをあーたらこーたらするとかなんとか。 /// \date 2009/3-4 /// \author bar\@site /// \attention なんだかんだ /// \version hage.hige.hoge // -- 171 名前：デフォルトの名無しさん mailto:sage [2009/05/13(水) 04:06:28 ] >>169 とりあえず最小限はこうだろ。 JAVADOC_AUTO_BRIEF オンで。 /** @file * 簡単な説明. * 詳細な説明 */ 170 のやつだと、ファイル名はどうせ名前変更したときに更新し忘れるし、 日付や作者やバージョンはバージョン管理ソフトに任せればいい。 詳細な説明も attention も必要に応じて、だな。とにかく書かないで済むものは 書かないのが一番。 172 名前：デフォルトの名無しさん mailto:sage [2009/05/13(水) 09:19:41 ] >>170 ありがとうございます。 >>171 そのバージョン管理ソフトに書かせるので心配ゴム用です。 173 名前：デフォルトの名無しさん mailto:sage [2009/05/13(水) 16:20:47 ] 表書くのってtableタグ使うしかないんでしたっけ？ それだとソース上で見づらいんで、 リストみたいに簡易記法があればいいんですけど。 174 名前：デフォルトの名無しさん mailto:sage [2009/05/13(水) 22:00:48 ] doxygenって使ったこと無いんだけど、 ぶっちゃけて言うと、オススメですかい？ 175 名前：デフォルトの名無しさん mailto:sage [2009/05/13(水) 23:26:06 ] >>174 おすすめとは言えない でも面白い使い道がある事は確か 実際に走らせてみて「おー」とか言って楽しむものだと思う 176 名前：デフォルトの名無しさん mailto:sage [2009/05/14(木) 09:55:19 ] >>174 クラス関連図とか、煩いクライアント向けのコーリングツリーを作るのに便利。 # 余程酷いソフトハウスに当たった経験があるのか、関数の依存関係を知りたがるクライアントがいるのよ。 177 名前：174 mailto:sage [2009/05/14(木) 22:16:15 ] >>175-176 ほっほー。 ありがとう。 「ある程度習熟するために勉強を要してめんどくさそうだ」 と思っていたが、試してみようかなあ。 178 名前：デフォルトの名無しさん mailto:sage [2009/05/14(木) 23:43:40 ] >>177 コメント付いてないのも全部出力する設定で、 とりあえず手持ちのソースそのまま掛けてみたらいいよ。 それで出来上がるものが気に入れば、それから書き方に慣れていったらいいし。 179 名前：デフォルトの名無しさん mailto:sage [2009/05/14(木) 23:50:13 ] Graphvizの使い方が秀逸だと思う これは出力結果を印刷してじっくり眺めたい 180 名前：177 mailto:sage [2009/05/15(金) 06:46:11 ] >>178 ありがとう。分かった、そうしてみるわ。 181 名前：デフォルトの名無しさん mailto:sage [2009/05/15(金) 09:37:18 ] 客先から小汚いソースを受け取ったら、取り敢えずDoxygenに掛けて 静的解析するのは基本だな。 182 名前：デフォルトの名無しさん mailto:sage [2009/05/15(金) 10:09:23 ] >>171 subversionとかの置き換えキーワードもdoxygenは認識してドキュメント化してくれる。 183 名前：デフォルトの名無しさん mailto:sage [2009/05/21(木) 13:35:09 ] ちょっと詳しい説明を箇条書きで入れたいんだけど、 空白行が入るとパラグラフが終わってしまうので、空白行を一切入れないで 長い文章を書かなきゃいけなくなり、なんていうか ソースコードのコメントが非常に見づらい。本末転倒な気がするんだけど、 空白行を無視してくれる方法とか、ない？ 184 名前：デフォルトの名無しさん mailto:sage [2009/05/23(土) 02:32:07 ] >>183 ソースコード上でだけ行間が空いてればいいのなら、 全角スペースを入れておけばどうでしょう？ ドキュメント上で行が連結されたときに、余分な空白が入りますが。 ドキュメントでも行間が空くようにしたいのなら、 行頭の邪魔にならないところにでも「@n」を入れておくぐらいしか思いつきません。 185 名前：デフォルトの名無しさん mailto:sage [2009/05/24(日) 13:15:10 ] doxygenの文字化け対策 ttp://d.hatena.ne.jp/kmt-t2/20090403/1238718375 ここに救われた俺がいる。 186 名前：デフォルトの名無しさん mailto:sage [2009/05/24(日) 14:01:52 ] doxygenであるライブラリのドキュメントを作った時、 そのライセンスってどこにどうやって記載すればいいの？ ドキュメント内に表示されるようにしたいんだけど。 187 名前：174 mailto:sage [2009/05/24(日) 16:39:03 ] doxygen気に入ってきた。 C++とdoxygen最新版にて。 ドキュメント作ると名前解決に使う::がドキュメントにもりこまれたり盛り込まれなかったりする。 例えばNameS::MyClassが、 ドキュメントの100行目ではNameS::MyClassになっているのに 101行目ではNameSMyClassになっていたりする。 これはどう解決すればいい？ 188 名前：デフォルトの名無しさん mailto:sage [2009/05/25(月) 10:31:42 ] >>187 このレスの流れを見ても分かるように、Doxygenは文字コードの扱いが未だ未だ不安定だったりする。 あんたの言う、「ドキュメント」がrtf出力ならこのスレにある対策版を使ってみた方がいいかもしれないし、 chm出力なら>185を参考にするといいかもしれない。 189 名前：デフォルトの名無しさん mailto:sage [2009/05/25(月) 20:01:17 ] >>186 @mainpageコマンドでメインページに入れるか、 @pageコマンドで独立したページにすればどう？ 190 名前：174 mailto:sage [2009/05/25(月) 23:27:45 ] >>188 ありがとう。 説明不足だったね。 ドキュメントはフツーのHTMLなんだよね〜。chmじゃなくて。 >185をやってみたら文字化けは解消したんだけど >> ドキュメントの100行目ではNameS::MyClassになっているのに >> 101行目ではNameSMyClassになっていたりする。 この現象は解決しないのだ。。。 191 名前：186 mailto:sage [2009/05/25(月) 23:41:59 ] >>189 @pageコマンド なんて初めて知ったわ。 どこかいい解説サイトとか紹介してくれる お方、いらしたらお願い！ 192 名前：デフォルトの名無しさん mailto:sage [2009/05/27(水) 12:59:53 ] >>191 doxygenに付いてくるサンプルも参考になるよ。 当然全部英語だけど、記述例のソースと それを使って出力されたドキュメントがある。 コマンドの説明が知りたかったら、 >>1 のサイトの日本語版マニュアルを見ればいいし。 193 名前：186 mailto:sage [2009/05/27(水) 19:11:01 ] >>192 そうか、ありがとう。 見てみるよ。 194 名前：デフォルトの名無しさん mailto:sage [2009/05/28(木) 03:59:47 ] いつの間にかDoxywizardもだいぶ使いやすくなったんだな 195 名前：186 mailto:sage [2009/05/28(木) 06:28:18 ] 俺は最近doxygenを使い始めて、 最初に Doxywizard を使ってかなり直感的に操作できたから知らなかったが、 そうなのか。前は使いづらかったのか。 grach 196 名前：デフォルトの名無しさん mailto:sage [2009/05/30(土) 12:54:18 ] #defineマクロ定義をドキュメント(html)に出力させたくて ttp://www.doxygen.jp/commands.html#cmddef ここを見て C++ code - 19 lines - codepad ttp://codepad.org/mUM77yZO こんなの書いてみたんですが、 全然#defineマクロ定義が出力されません。 どうすれば良いでしょうか？ 197 名前：デフォルトの名無しさん mailto:sage [2009/05/30(土) 17:17:56 ] >>196 define_test.h のファイルのページ自体は出来てる？ 実際のファイル名と @file の後ろに書いたファイル名が合ってないとかはないかな、と思ったもので。 198 名前：196 mailto:sage [2009/05/30(土) 23:13:55 ] >>197 ttp://loda.jp/uploader_nrnrnr/?id=2 こんなHTMLが生成されました。 どうなんでしょう。。。？ 199 名前：197 mailto:sage [2009/05/31(日) 00:25:04 ] >>198 define_test.h ファイルのドキュメントのページができてないね。 >>196 のソースをコピペして同じ名前で保存してみたけど、 こっちじゃちゃんと出力されてるよ。 Doxyfile 晒してもらえるなら、何が違うか比べてみるけど。 200 名前：197 mailto:sage [2009/05/31(日) 00:31:38 ] >>198 もしかして、SHOW_FILESがOFFになってない？ Doxywizard使ってるなら、ExpartのBuildの下の方。 201 名前：196 mailto:sage [2009/05/31(日) 04:59:33 ] >>200 丁寧にありがとうございます。 Doxyfileは以下です。 C++ code - 1503 lines - codepad ttp://codepad.org/aNCHcRW3 お願いします。 202 名前：196 mailto:sage [2009/05/31(日) 05:04:41 ] 追記： 　　SHOW_FILES=NOになっていましたが、 　　YESにしても変わりませんでした。 　　私の環境は 　　windows xp sp2 　　doxygen 1.5.9です。 203 名前：197 mailto:sage [2009/05/31(日) 05:45:10 ] >>201 WARN_IF_DOC_ERROR を ON にしたら判明した。 ENABLE_PREPROCESSING が OFF だとマクロは見てくれないらしい。 204 名前：197 mailto:sage [2009/05/31(日) 05:51:37 ] 補足 WARN_IF_DOC_ERROR を ON にしたら、 「マクロにコメント書いてるけど、ENABLE_PREPROCESSINGがOFFだからスキップしたよ」 というようなメッセージが表示された。 205 名前：196 mailto:sage [2009/05/31(日) 14:59:44 ] >>204 ありがとうございます。 WARN_IF_DOC_ERRORとENABLE_PREPROCESSINGをYESにしてみましたが、 結果は代わりありませんでした。 Doxyfileはこちらです。 ttp://codepad.org/rsH3deU0 設定を読み込み直していないなどということはなく。 doxygenのウィンドウに表示される情報は ttp://codepad.org/bqYOU7ug の通りです。 すみませんがよろしくお願い申し上げます。 206 名前：196 mailto:sage [2009/05/31(日) 22:27:30 ] 追記： 　　テキストエディタでDoxyfileを開き、 　　= NO 　　を検索して全て 　　= YES 　　に置換してみました。 　　それでdoxygenを走らせたところ、見事#defineは出力されました。 　　やはり設定が問題な様です。 207 名前：196 mailto:sage [2009/05/31(日) 22:43:14 ] どこの設定が問題なのか探るために Doxyfileにて二分木法的にNOをYESに置換してみました。 ファイルのど真ん中の行を基準に上だけないし下だけを 全部NO→YES置換を行いました。 しかし、このどちらも#defineが出力されません。 やはり複数の設定項目が関わっているようです。 208 名前：196 mailto:sage [2009/05/31(日) 22:56:12 ] 解決しました。 正解は ・ENABLE_PREPROCESSINGをYESにする。 ・SHOW_FILESをYESにする。 でした。両方が同時に満たされていないとだめなようです。 お手数をおかけ致しました！ 209 名前：197 mailto:sage [2009/06/01(月) 01:23:37 ] >>205-208 解決したようなのでもういいかもしれないけど、 WARN〜系の設定は、出力状態を変更させるためのものではなくて、 コメント付けてるのに出力されない設定になってるとか、 記述漏れがあるとか、そういうエラーメッセージを表示するためのもの。 今後何かうまくいかないときに参考になるかもしれないので念のため。 210 名前：196 mailto:sage [2009/06/01(月) 05:54:55 ] >>209 はい、WARN〜系の設定に関して、よく頭に入れておきます。 ありがとうございました。 211 名前：デフォルトの名無しさん mailto:sage [2009/06/01(月) 23:20:24 ] Windows XP SP2, doxygen 1.5.9です。 htmlドキュメントを生成すると、 本文中のstd::coutのようなスコープ解決演算子が消えてしまい、 stdcoutになってしまうことが多々あります。 再現するソースやその結果のhtml, Doxyfileは以下の様です。 ttp://loda.jp/uploader_nrnrnr/?id=3 具体的にはこのソースにて 　Test::foo()は 　numをstd::coutに出力します。 になるはずが 　Test::foo()は 　numをstdcoutに出力します。 になってしまいます。 再現条件は絞れておりません。 どうかお知恵をおかしください。 よろしくお願い申し上げます。 212 名前：デフォルトの名無しさん mailto:sage [2009/06/02(火) 02:54:51 ] >>211 理由はよく分からないけど、std::coutの前後に空白を入れたら正しくなりました。 識別子っぽいものに非ASCII文字がくっついてたらおかしくなるってことじゃないかと思うんですが。 213 名前：211 mailto:sage [2009/06/02(火) 06:08:56 ] >>212 たしかに、前後に空白で正しく表示されます。 本当に適用したいソース(再現用ソースでない)でもうまく表示されます。 ありがとうございました。 214 名前：デフォルトの名無しさん mailto:sage [2009/06/02(火) 23:53:16 ] >>195 今のdoxywizardはver.1.5.8(去年の暮れ頃)からですね。 基本的な設定項目だけのwizardモードと、 設定可能な項目が全部表示されるexpertモードの２本立てというのは 昔も今も変わりませんが、 設定を変えたら保存しないと実行できなかったとか、 設定項目のセクション切り替えがタブで、expertモードだと たくさん並んでるのをぐるぐるスクロールさせる必要があったとか、 細かいところで少し不便でした。 マニュアルに載ってるスクリーンショットは旧バージョンのような気がします。 215 名前：デフォルトの名無しさん mailto:sage [2009/06/02(火) 23:58:29 ] doxygenで、1カ所に書いたコメントを複数箇所で参照する方法はありますか？ 例えば、 hoge.h内で@version 1.1.1 という記述が同じhoge.h内で他にも複数箇所に登場する場合、 全部に@version 1.1.1と書いてしまうとバージョンを上げる時に 全箇所を手動で修正する羽目になってしまいます。 どうにかする手段はありますか？ 216 名前：デフォルトの名無しさん mailto:sage [2009/06/03(水) 02:07:50 ] >>215 設定ファイルのALIASESで@version 1.1.1に別名をつければ、 バージョンを上げるときはそこだけ変えればOK というのはどうでしょう？ 217 名前：デフォルトの名無しさん [2009/06/03(水) 03:43:33 ] 質問です。 いままでのプログラムは以下のようにコメントしていたのですが、 doxygenでは/** */の形式にしないとドキュメント作成はできないのでしょうか？ コメント部分を目立たせたいので、できれば今までのコメント形式を維持したいのですが・・ 今までのコメント例 //******************************************************** // Test.cpp // 2009.09 by Tester // テスト用のクラス //******************************************************** これを /** * * * */ 形式にするのは少し抵抗があります 218 名前：デフォルトの名無しさん mailto:sage [2009/06/03(水) 08:40:05 ] >>217 特定の形式にしないと、ドキュメントにしないコメントと区別できないですからね…… 使えるコメント形式はマニュアルの「Documenting the code」にいろいろ例があります。 (日本語マニュアルは古くて少し情報が少ないです) 今までのに比較的近いのは /*****************************************************//** * Test.cpp * 2009.09 by Tester * テスト用のクラス *********************************************************/ でしょうか。 219 名前：デフォルトの名無しさん mailto:sage [2009/06/03(水) 10:41:33 ] >>217 最初と最後の //****** はそのままで、途中の行だけ先頭の//を3文字にすればいい 220 名前：デフォルトの名無しさん mailto:sage [2009/06/03(水) 10:48:32 ] つまり、こうだな。 //******************************************************** /// \file Test.cpp /// \date 2009.09 /// \author Tester /// \brief テスト用のクラス //******************************************************** 221 名前：デフォルトの名無しさん mailto:sage [2009/06/03(水) 16:06:28 ] >>217 俺も抵抗があったけど、 変えてみたら意外と平気だったよ。 要は見慣れるかどうか。 222 名前：デフォルトの名無しさん mailto:sage [2009/06/03(水) 16:09:51 ] >>216 ALIASES なんてものがあるのですね。 ありがとうございます、試してみます。 223 名前：デフォルトの名無しさん [2009/06/03(水) 22:23:44 ] >>218-221 thanks ですが、ファイルの最初のコメントを //******************************************************** /// \file Test.cpp /// @file TEST.cpp //******************************************************** と色々やってみたのですがうまくいきませんでした・・ ファイルの最初だと///ではドキュメント化されないのでしょうか クラス宣言前や関数前では///で書いたコメントはちゃんとドキュメント のコメントとなっておりました。 ちなみに、ファイル一覧からコードを見るとなぜか明朝体？で表示されてしまいます。 以下のドキュメントのようにゴシック表示をしたいのですが、Font設定はどのようにすればよいでしょうか？ www.ee.t-kougei.ac.jp/tuushin/lecture/technicalWriting/euclid/html/euclid_8c-source.html 224 名前：デフォルトの名無しさん [2009/06/03(水) 22:57:41 ] 追加で質問失礼。 Player.hの内容↓ /** @brief クラスの簡易説明 　*　このクラスの使用目的・使用方法など詳しい情報を書く。 　*　@todo 必要であれば記述 　*　@bug バグがあれば記述 */ #if !defined (__PLAYER_H__) #define __PLAYER_H__ class CPlayer { ... } というプログラムだと、インクルードガードのほうに マクロ定義 #define __PLAYER_INFO_BASE_H__ クラスの簡易説明 　*　このクラスの使用目的・使用方法など詳しい情報を書く。 というドキュメントが付いてしまうのですが、 インクルードガードは一番上に書かなければいけないのでしょうか？ できればファイルに関するコメントを一番上に記述したいのですが・・・ 225 名前：デフォルトの名無しさん [2009/06/03(水) 23:10:52 ] さらに追加質問ですいませんorz 出力されたドキュメントは任意の名前のフォルダに作成されますが、 index.htmlが他の細かいファイルと一緒のフォルダにあるため探しづらいです。 そのため、index.htmlだけ残して他のファイルを別のフォルダに押し込む というようなフォルダ構成を構築したいのですが、そういったことは可能でしょうか？ 226 名前：デフォルトの名無しさん mailto:sage [2009/06/03(水) 23:33:53 ] >>223 ファイルの最初のコメント: ファイル名の大文字・小文字の問題かもしれません。 ファイル名無しで @file だけにしてみてはどうでしょうか。 フォント: フォントはデフォルトのスタイルシートで、 font-family: Lucida Grande, Verdana, Geneva, Arial, sans-serif; と設定されてるので、 特にカスタマイズしてなければゴシックで表示されるはずなんですが。 >>224 対象を指定しないドキュメントは、直後にあるものに関連づけられます。 ファイルに関するコメントにしたいなら、@file が必須です。 227 名前：デフォルトの名無しさん mailto:sage [2009/06/04(木) 08:53:01 ] >>224 本題とは直接関係ないと思いますが、ドキュメントに「 * 」が入ってるのが気になりました。 コメント行頭の「 * 」のところ、全角スペース使ってませんか？ 228 名前：デフォルトの名無しさん [2009/06/04(木) 23:00:02 ] >>226-227 thanks. 一度doxygenを全削除して再インストールしたら なんとかファイル要約関連のコメントはでるようにできました。 229 名前：デフォルトの名無しさん [2009/06/05(金) 00:21:06 ] また質問なのですが、 以下のような複数行について同じコメントをつけたい場合は 何かうまい記述法はありますか？ 例： /// 3D座標を示す値. int nX; int nY; int nZ; このままですと、nXだけにコメントがついてしまうため、 ３つの変数全てに同じコメントを出すようにしたいのですが・・・ int nX;///< 3D座標を示す値x. int nY;///< 3D座標を示す値y. int nZ;///< 3D座標を示す値z. これだと冗長な感じでちょっと抵抗があります 230 名前：デフォルトの名無しさん mailto:sage [2009/06/05(金) 02:50:49 ] っ　nameタグ 231 名前：デフォルトの名無しさん mailto:sage [2009/06/05(金) 09:01:35 ] >>229 普通は、一つのコメントで括られるような変数は構造体に入れるもんじゃね? 232 名前：デフォルトの名無しさん mailto:sage [2009/06/05(金) 19:33:13 ] >>231 おお、良いこと言った！ 233 名前：デフォルトの名無しさん mailto:sage [2009/06/05(金) 22:02:00 ] >>231 座標とかだと、配列の方が扱いやすいかも 構造体の方が見やすいけどね 234 名前：デフォルトの名無しさん mailto:sage [2009/06/06(土) 08:55:20 ] C++ code - 50 lines - codepad ttp://codepad.org/imFgWQsK これからdoxygenでhtmlドキュメントを生成させると、 メンバ一覧のページの上にある目次の部分は すべてのメンバ一覧 Public メソッド void foo (bool) void foo (short) void foo (int) void foo (long) void foo (double) void bar (bool) void bar (short) void bar (int) void bar (long) void bar (double) となります。このように並ぶと微妙に見づらいので すべてのメンバ一覧 Public メソッド foo系のメンバは 　void foo (bool) 　void foo (short) 　void foo (int) 　void foo (long) 　void foo (double) bar系のメンバは 　void bar (bool) 　void bar (short) 　void bar (int) 　void bar (long) 　void bar (double) の様にコメントをこの場所に入れたいしたいのですが、可能でしょうか？ 235 名前：デフォルトの名無しさん mailto:sage [2009/06/06(土) 09:13:44 ] >>234 マニュアルの「Grouping」(日本語版マニュアルだと「グループ化」)のページを見てください 236 名前：デフォルトの名無しさん mailto:sage [2009/06/06(土) 09:55:14 ] >>235 それで出来るのですね。 ありがとうございます。見てきます。 237 名前：デフォルトの名無しさん mailto:sage [2009/06/06(土) 11:53:22 ] doxygenで作ったthtmlドキュメントの 若干ながらフォントサイズが小さすぎると感じます。 このフォントサイズを大きくすることはできますか？ 238 名前：234 mailto:sage [2009/06/06(土) 20:44:39 ] C++ code - 17 lines - codepad ttp://codepad.org/vf7DFqYq とりあえずこの様にしてみました。 /** document former */ がメンバ関数全部について、 /** document latter */ がメンバ関数void func_1_InGroup1()だけにつくかと期待したのですが、 結果は void Test::func_1_InGroup1に document former document latter と付いただけでした。 どこが誤っているでしょうか？ よろしくお願いいたします。 239 名前：234・238 mailto:sage [2009/06/06(土) 20:56:51 ] C++ code - 26 lines - codepad ttp://codepad.org/wOT4IAlv とりあえずこれで行けそうです。 ・・・法則性がわからない。 240 名前：デフォルトの名無しさん mailto:sage [2009/06/06(土) 22:29:27 ] 法則性はその>>238と>>239の違いの@nameの有無の部分ですよ。 マニュアルより： ブロックの開標識の前に、独立したコメント・ブロックを置くこともできます。 このブロックは、@name (または、\name) コマンドを含む必要があり、 グループのヘッダーを指定します。 そうしたければ、グループに関するより詳しい情報をコメント・ブロックに 含めることもできます。 241 名前：239 mailto:sage [2009/06/06(土) 22:36:14 ] >>240 doxygen用語の理解が今ひとつ足りなかったようです。 親切にありがとうございました。 242 名前：デフォルトの名無しさん mailto:sage [2009/06/07(日) 12:54:49 ] Use built-in class diagram generator だと継承に関するクラス階層図がうまく表示されますが、 Use dot tool from the GraphViz package だとうまく表示されません。 このようなHTMLになってしまいます。 ttp://loda.jp/uploader_nrnrnr/?id=4 （これには再現する簡単なソースとDoxyfile、出来上がったHTMLが含まれています。） 環境はWindows XP SP2で、 doxygenはdoxygen-1.5.9-setup.exeを使ってインストールしました。 GraphVizはgraphviz-2.22.2.msiを使ってインストールしました。 GraphVizの問題だとしたら若干スレ違いかもしれませんが、 よろしくお願いいたします。 243 名前：242 mailto:sage [2009/06/07(日) 13:43:31 ] C++ code - 25 lines - codepad サンプルソースが腐ってたので ttp://codepad.org/AwsZMCHk これでお願いします。 244 名前：デフォルトの名無しさん mailto:sage [2009/06/07(日) 23:01:58 ] >>242-243 DOT_FONTSIZEが小さい(デフォルト値は10)のが気になりますが、 正直なところデフォルト設定と余りに違いすぎて、それだけなのかどうかは何とも。 もしこだわって作りこんだ設定でないのなら、一度デフォルト設定に戻して、 最低限必要なところだけ変えるようにしてみてはどうでしょう？ デフォルト設定にはメニューから[Settings]→[Reset to factory defaults]で戻せます。 245 名前：デフォルトの名無しさん mailto:sage [2009/06/08(月) 00:35:20 ] >>242 どこを問題視したいのか判らんが、HAVE_DOTがNOだからクラス階層図が出ないのは当たり前なんだが。 つーか、>>244も含めて Doxyfile位真面目に読んでくれ。 246 名前：242 mailto:sage [2009/06/08(月) 06:55:17 ] >>244-245 ありがとうございます。 教えを頼りに読んできます。 247 名前：244 mailto:sage [2009/06/08(月) 08:39:21 ] >>242, >>245 >>242のドキュメントではdotファイルが吐かれてるし、 クラス階層図はdotファイルの内容どおりに生成されてます。 文字が読めないのはフォントサイズが4のためです。 コラボレーション図はdotにノードがなぜか出力されてませんが、 画像ファイル自体は真っ白なのが存在していて、 dotファイルの内容どおりには生成されているといえます。 なので、これらはHAVE_DOT=YESの状態で生成されたはずです。 DoxyfileはHAVE_DOT=YESにする前に保存したものと思われます。 dotの中身が異常なので、ほかに問題があると思います。 248 名前：デフォルトの名無しさん mailto:sage [2009/06/08(月) 15:59:54 ] Doxygenて __declspec(dllexport) int WINAPI MyFunc(int arg); とか、それを簡略化して #define API(type) __declspec(dllexport) type WINAPI とした場合に API(int) MyFunc(int arg); みたいな宣言もちゃんと処理してくれる？ 249 名前：242 mailto:sage [2009/06/08(月) 16:17:43 ] >>247 ありがとうございます。 全然こだわって作りこんだ設定ではありませんので、 デフォルトに戻すことに抵抗はありません。 いろいろ教えの通り試してみます！ 250 名前：デフォルトの名無しさん [2009/06/08(月) 22:09:14 ] appleloader.bbsnow.net/pic_loader/nomal/html/1_11.html Exportタブに何も表示されないのですがバグですか・・・？ ノートPCでは表示されました 両方　WinXP 32bit　ＳＰ３　です 251 名前：デフォルトの名無しさん mailto:sage [2009/06/08(月) 22:48:53 ] >>248 __declspec()は関数と誤認識されるので、 PREDEFINED で __declspec(x)= を定義するなどして、 プリプロセス時に取り除いてやる必要があります。 (マニュアルの「Preprocessing」に書かれてます) 252 名前：デフォルトの名無しさん mailto:sage [2009/06/08(月) 23:24:43 ] >>250 eeepc + winxp でやってるけど、ウチも全く同じ現象になるよ。

---

---

[ 続きを読む ] / [ 携帯版 ]

read.cgi ver5.27 [feat.BBS2 +1.6] / e.0.2 (02/09/03) / eucaly.net products.
担当:undef