無いので建てた
公式
http://www.doxygen.jp/
【コメント】doxygen【コンソメ】
■ このスレッドは過去ログ倉庫に格納されています
2008/05/30(金) 19:50:27
309307
2009/09/17(木) 16:45:15 >>308
後で見返してよく考えたら「NO_DOXYGEN」だと意味逆でしたね。
まあそれはともかく、この方法を使うと、
たとえば利用者マニュアル用 doxyfile と
内部開発者用 doxyfile とかを使い分けて
(それぞれ別々の PREDEFINED を設定しておく)、
コード内では #ifndef を使ってマニュアルに出したいものを制御
なんてこともできます。
後で見返してよく考えたら「NO_DOXYGEN」だと意味逆でしたね。
まあそれはともかく、この方法を使うと、
たとえば利用者マニュアル用 doxyfile と
内部開発者用 doxyfile とかを使い分けて
(それぞれ別々の PREDEFINED を設定しておく)、
コード内では #ifndef を使ってマニュアルに出したいものを制御
なんてこともできます。
311306
2009/09/18(金) 00:20:10 #ifndef DOXYGEN
実装用クラス
#endif
としてみましたが、
クラス一覧に相変わらず実装用クラスが出力されます。
doxygen 1.6.1, Windows XP SP2
Doxyfileは
ttp://loda.jp/uploader_nrnrnr/?id=11
です。
恐れ入りますが、>>307さんのdoxygenのバージョンはいくらでしょうか?
実装用クラス
#endif
としてみましたが、
クラス一覧に相変わらず実装用クラスが出力されます。
doxygen 1.6.1, Windows XP SP2
Doxyfileは
ttp://loda.jp/uploader_nrnrnr/?id=11
です。
恐れ入りますが、>>307さんのdoxygenのバージョンはいくらでしょうか?
312306
2009/09/18(金) 00:20:56 ちなみにちゃんと
#ifndef DOXYGEN
になっています。
#ifdef DOXYGEN
だったりはしません。
よろしくお願いいたします。
#ifndef DOXYGEN
になっています。
#ifdef DOXYGEN
だったりはしません。
よろしくお願いいたします。
313307
2009/09/18(金) 01:26:34 >>311-312
doxyfile 拝見しました。
1312 行目の EXPAND_AS_DEFINED の方にマクロ名が記述されて
いるようなんですが、これを 1305 行目の PREDEFINED の方に
記述して試してもらえますか?
ちなみに、私が使用している環境は 1.6.1 で
OS は主に Mac OS X と FreeBSD です。
(一昨日くらいまで 1.5.9 使ってましたけど。)
あ、でも doxyfile は 1.5.8 の時につくったものでした。
doxyfile 拝見しました。
1312 行目の EXPAND_AS_DEFINED の方にマクロ名が記述されて
いるようなんですが、これを 1305 行目の PREDEFINED の方に
記述して試してもらえますか?
ちなみに、私が使用している環境は 1.6.1 で
OS は主に Mac OS X と FreeBSD です。
(一昨日くらいまで 1.5.9 使ってましたけど。)
あ、でも doxyfile は 1.5.8 の時につくったものでした。
314デフォルトの名無しさん
2009/09/18(金) 09:44:38315306
2009/09/18(金) 11:12:07316デフォルトの名無しさん
2009/09/18(金) 12:01:39 ttp://codepad.org/ACEXhsw8
これをdoxygenに食わせると、
クラス->構成のところで
exception
NS::hoge
となります。
画像:ttp://imagepot.net/image/125324281122.jpg
つまり何故かstd::が出力されません。
(解説本文にはstd::が出力されるのですが。)
これを
std::exception
NS::hoge
と表示させたいのですが、何か方法はありますでしょうか?
よろしくお願いいたします。
これをdoxygenに食わせると、
クラス->構成のところで
exception
NS::hoge
となります。
画像:ttp://imagepot.net/image/125324281122.jpg
つまり何故かstd::が出力されません。
(解説本文にはstd::が出力されるのですが。)
これを
std::exception
NS::hoge
と表示させたいのですが、何か方法はありますでしょうか?
よろしくお願いいたします。
317307
2009/09/18(金) 12:08:01318デフォルトの名無しさん
2009/09/18(金) 12:25:36 doxygen 1.5.8を使っているんだけど、例えばstd::vector<std::vector<int>>が通らないのね。
きちんと> >にしないといけないらしい。
きちんと> >にしないといけないらしい。
319デフォルトの名無しさん
2009/09/18(金) 12:55:10320デフォルトの名無しさん
2009/09/18(金) 12:57:05321デフォルトの名無しさん
2009/09/18(金) 13:47:50322デフォルトの名無しさん
2009/09/18(金) 17:00:22 ttp://www.doxygen.jp/grouping.html#memgroup
これで生成した
ttp://www.stack.nl/~dimitri/doxygen/examples/memgrp/html/class_test.html
ですが、
今のdoxygen 1.6.1で実行しますと
Public Member Functions
や
Group2
等のグループ名が改行の余白無く上にくっついて表示されませんか?
ttp://www.doxygen.jp/grouping.html#memgroupに限らず任意のファイルを
htmlにしても起こると思うのですが、皆様はどうでしょうか?
これで生成した
ttp://www.stack.nl/~dimitri/doxygen/examples/memgrp/html/class_test.html
ですが、
今のdoxygen 1.6.1で実行しますと
Public Member Functions
や
Group2
等のグループ名が改行の余白無く上にくっついて表示されませんか?
ttp://www.doxygen.jp/grouping.html#memgroupに限らず任意のファイルを
htmlにしても起こると思うのですが、皆様はどうでしょうか?
323デフォルトの名無しさん
2009/09/19(土) 12:08:12324322
2009/09/19(土) 13:07:25 >>323
ありがとうございます。
私は同じsourceで
Doxygen1.5.9→1.6.1のアップグレードで症状が発生したため、おそらく仕様変更に伴う不具合だと思っています。
じき直ると期待しています。
ありがとうございます。
私は同じsourceで
Doxygen1.5.9→1.6.1のアップグレードで症状が発生したため、おそらく仕様変更に伴う不具合だと思っています。
じき直ると期待しています。
325デフォルトの名無しさん
2009/09/20(日) 11:44:49 > BUILTIN_STL_SUPPORTオプションをオンにしない限り、doxygen は STL クラス
を認識しません。
> STLクラス (std::string, std::vector など) を使っていても、STLソース (そ
のタグファイル) を入力としてインクルードしたくない場合は、このタグを YES
にしてください。 するとdoxygenは、STLクラスを引数に含む関数宣言と定義 (た
とえば、func(std::string); と func(std::string) {}) をマッチングします。
また、STLクラスを含む継承・コラボレーション図をより完璧で正確にすることも
できます。
といった説明がDoxygen日本語マニュアルにあるのですが、いまひとつ意味がわか
りません。
要するにBUILTIN_STL_SUPPORTはデフォルトでYESにしてしまえば良いわけでしょうか?
それとも何がデメリットがあるのでしょうか?
を認識しません。
> STLクラス (std::string, std::vector など) を使っていても、STLソース (そ
のタグファイル) を入力としてインクルードしたくない場合は、このタグを YES
にしてください。 するとdoxygenは、STLクラスを引数に含む関数宣言と定義 (た
とえば、func(std::string); と func(std::string) {}) をマッチングします。
また、STLクラスを含む継承・コラボレーション図をより完璧で正確にすることも
できます。
といった説明がDoxygen日本語マニュアルにあるのですが、いまひとつ意味がわか
りません。
要するにBUILTIN_STL_SUPPORTはデフォルトでYESにしてしまえば良いわけでしょうか?
それとも何がデメリットがあるのでしょうか?
326デフォルトの名無しさん
2009/09/23(水) 01:46:24 >>325
Doxywizard で、 BUILTIN_STL_SUPPORT にカーソルを持っていったときに
表示される説明は、もう少し分かりやすいです。
STL のクラスを使ってるけど STL のソースをインクルードしたくない場合に
YESにするようにと書いてます。
ファイルの読み込みを抑えたいような場合でしょうか。
逆に処理系付属のヘッダも読み込む設定にしていて、 BUILTIN_STL_SUPPORT も
YES にすると、二重定義のような状況になるんじゃないかと思います。
Doxywizard で、 BUILTIN_STL_SUPPORT にカーソルを持っていったときに
表示される説明は、もう少し分かりやすいです。
STL のクラスを使ってるけど STL のソースをインクルードしたくない場合に
YESにするようにと書いてます。
ファイルの読み込みを抑えたいような場合でしょうか。
逆に処理系付属のヘッダも読み込む設定にしていて、 BUILTIN_STL_SUPPORT も
YES にすると、二重定義のような状況になるんじゃないかと思います。
327325
2009/09/23(水) 11:39:21 >>326
ありがとうございます。
ちなみに
Yahoo!検索 - BUILTIN_STL_SUPPORT
ttp://search.yahoo.co.jp/search?p=BUILTIN_STL_SUPPORT&search_x=1&tid=top_ga1_sa&ei=UTF-8&pstart=1&fr=top_ga1_sa&b=11&qrw=0
こんな感じになりました。
どうやら大半の方がデフォルト値のNOにしているようです。
ありがとうございます。
ちなみに
Yahoo!検索 - BUILTIN_STL_SUPPORT
ttp://search.yahoo.co.jp/search?p=BUILTIN_STL_SUPPORT&search_x=1&tid=top_ga1_sa&ei=UTF-8&pstart=1&fr=top_ga1_sa&b=11&qrw=0
こんな感じになりました。
どうやら大半の方がデフォルト値のNOにしているようです。
329デフォルトの名無しさん
2009/09/26(土) 19:33:05331316
2009/09/27(日) 10:43:25332デフォルトの名無しさん
2009/09/27(日) 13:24:58 /** \page hojodocs 補助ドキュメント
*/
としますと
ttp://uploader.rgr.jp/src/up1067.gif
の様に
「メインページ」「クラス」「ファイル」というタブと並んで「関連ページ」というタブが出来て
その中に補助ドキュメントというページが出来ます。
これを
「メインページ」「クラス」「ファイル」というタブと並んで「補助ドキュメント」というタブが
出来るようにする方法はありませんでしょうか?
単純に/pageを何か適当な物に変えれば良いのではないかと探ってみたのですが
どうしても分かりませんでした。
よろしくお願いします。
*/
としますと
ttp://uploader.rgr.jp/src/up1067.gif
の様に
「メインページ」「クラス」「ファイル」というタブと並んで「関連ページ」というタブが出来て
その中に補助ドキュメントというページが出来ます。
これを
「メインページ」「クラス」「ファイル」というタブと並んで「補助ドキュメント」というタブが
出来るようにする方法はありませんでしょうか?
単純に/pageを何か適当な物に変えれば良いのではないかと探ってみたのですが
どうしても分かりませんでした。
よろしくお願いします。
333デフォルトの名無しさん
2009/09/27(日) 21:39:45 >>331 うちではexceptionクラスそのものが出なかった。
334316
2009/09/27(日) 22:56:11 >>333
左様でございましたか。失礼いたしました。
私の環境は
doxygen 1.6.1, Windows XP SP2
で, Doxyfile, hoge.h, 成果物htmlは
ttp://loda.jp/uploader_nrnrnr/?id=15
です。
お手数おかけ致しますが、こちらでいかがでしょうか?
左様でございましたか。失礼いたしました。
私の環境は
doxygen 1.6.1, Windows XP SP2
で, Doxyfile, hoge.h, 成果物htmlは
ttp://loda.jp/uploader_nrnrnr/?id=15
です。
お手数おかけ致しますが、こちらでいかがでしょうか?
335デフォルトの名無しさん
2009/10/01(木) 01:53:57 >>304-315
今更だけど、別の方法があったので。
@cond と @endcond で囲んだ範囲は、
@cond につけたラベルを ENABLED_SECTIONS に含めるかどうかで、
ドキュメント化するかどうかを設定できるようです。
今更だけど、別の方法があったので。
@cond と @endcond で囲んだ範囲は、
@cond につけたラベルを ENABLED_SECTIONS に含めるかどうかで、
ドキュメント化するかどうかを設定できるようです。
336デフォルトの名無しさん
2009/10/01(木) 10:49:27 >>335
こりゃいいやと試してみた。
@condと@endcondは独立したコメントブロックにないと巧く認識しないみたいで、ちょっと悩んだ。
# つまり、前後の空行を詰めるとダメっぽい。
それと、処理させないだけならセクションラベルは要らないのだけれどundocumentedにしたのは深謀遠慮。
--
/// \file foo.h
///
/// \cond undocumented
/// \brief Dummy.
/// あーだこーだ
class dummy {
public:
dummy() {}
};
/// \endcond
/// \brief Foo.
/// どーでこーで
class foo {
public:
foo() {}
};
--
# どうでもいいけど、JAVADOC_AUTOBRIEFはyesなので念の為。
こりゃいいやと試してみた。
@condと@endcondは独立したコメントブロックにないと巧く認識しないみたいで、ちょっと悩んだ。
# つまり、前後の空行を詰めるとダメっぽい。
それと、処理させないだけならセクションラベルは要らないのだけれどundocumentedにしたのは深謀遠慮。
--
/// \file foo.h
///
/// \cond undocumented
/// \brief Dummy.
/// あーだこーだ
class dummy {
public:
dummy() {}
};
/// \endcond
/// \brief Foo.
/// どーでこーで
class foo {
public:
foo() {}
};
--
# どうでもいいけど、JAVADOC_AUTOBRIEFはyesなので念の為。
337304
2009/10/01(木) 10:51:57 ありがとうございます。
プリプロセッサを使った方法はエディタで対応する最初と最後をすぐ見つけらられるという利点がありますが、
@condと@endcondを使った方法はコメントだけで解決する->ソースに手を加えてはいないという点が利点ですね。
プリプロセッサを使った方法はエディタで対応する最初と最後をすぐ見つけらられるという利点がありますが、
@condと@endcondを使った方法はコメントだけで解決する->ソースに手を加えてはいないという点が利点ですね。
338デフォルトの名無しさん
2009/10/06(火) 16:41:43 Windowsでいろんなコンパイラに対応できるライブラリを書いてるんだけど,VC++だと
クラスのコンストラクタには呼び出し規約 __fastcall が使えないので,ヘッダファイルに
以下のような定義を書きました(コンストラクタの先頭に書いておくために)。
#if defined(_MSC_VER) //VC++の場合空文字
#define __FASTCALL
#elif //その他のコンパイラの場合は__fastcall
#define __FASTCALL __fastcall
#endif
これをDoxygen(1.6.1)でドキュメント化するとき,_MSC_VERが定義されている時と定義されていない
時の説明が両方出るようにしようと思って,いろいろやってみたけどうまく行きません。
上の例はDoxygen用のコメント付けはしていませんが,Doxyfileで PREDEFINEDに_MSC_VER と
!_MSC_VER の両方を書いておくと,両方の #define__FASTCALL がドキュメント化されるところまでは
良かったのですが,行末に ///> で異なる説明を書いても両方の説明に同じものが(マージされて)
出てきてしまいます。
良い方法があったら教えてください。
クラスのコンストラクタには呼び出し規約 __fastcall が使えないので,ヘッダファイルに
以下のような定義を書きました(コンストラクタの先頭に書いておくために)。
#if defined(_MSC_VER) //VC++の場合空文字
#define __FASTCALL
#elif //その他のコンパイラの場合は__fastcall
#define __FASTCALL __fastcall
#endif
これをDoxygen(1.6.1)でドキュメント化するとき,_MSC_VERが定義されている時と定義されていない
時の説明が両方出るようにしようと思って,いろいろやってみたけどうまく行きません。
上の例はDoxygen用のコメント付けはしていませんが,Doxyfileで PREDEFINEDに_MSC_VER と
!_MSC_VER の両方を書いておくと,両方の #define__FASTCALL がドキュメント化されるところまでは
良かったのですが,行末に ///> で異なる説明を書いても両方の説明に同じものが(マージされて)
出てきてしまいます。
良い方法があったら教えてください。
339338
2009/10/06(火) 16:59:07 >>338
ちょっと間違い。上の例で #else のところが #elif になってしまっているので
修正したら,_MSC_VER と !MSC_VER を両方 PREDEFINED に書いておく
という手は使えませんでした。結局 PREDEFINED にどう書くかで,
片方のドキュメントしか作成されません。
ちょっと間違い。上の例で #else のところが #elif になってしまっているので
修正したら,_MSC_VER と !MSC_VER を両方 PREDEFINED に書いておく
という手は使えませんでした。結局 PREDEFINED にどう書くかで,
片方のドキュメントしか作成されません。
340304
2009/10/06(火) 18:24:02 >>339
PREDEFINEDでできませんか?
つまり
PREDEFINED = DOXYGEN_SHOULD_SKIP_THIS
とすれば
#ifndef DOXYGEN_SHOULD_SKIP_THIS
#if defined(_MSC_VER) //VC++の場合空文字
#define __FASTCALL
#elif //その他のコンパイラの場合は__fastcall
#define __FASTCALL __fastcall
#endif
#elif /* DOXYGEN_SHOULD_SKIP_THIS */
/*! 説明を入れる。
*/
#define __FASTCALL
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
PREDEFINEDでできませんか?
つまり
PREDEFINED = DOXYGEN_SHOULD_SKIP_THIS
とすれば
#ifndef DOXYGEN_SHOULD_SKIP_THIS
#if defined(_MSC_VER) //VC++の場合空文字
#define __FASTCALL
#elif //その他のコンパイラの場合は__fastcall
#define __FASTCALL __fastcall
#endif
#elif /* DOXYGEN_SHOULD_SKIP_THIS */
/*! 説明を入れる。
*/
#define __FASTCALL
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
341339
2009/10/06(火) 18:54:46 >>340
さすがに両方の説明を個別に表示することは出来ませんが,それで事足りますね。
ありがとうございました。
この方法使うと,Doxygenがスキップしない部分には,
#define __FASTCALL "" or __fastcall
とかメチャクチャ書けますねw
さすがに両方の説明を個別に表示することは出来ませんが,それで事足りますね。
ありがとうございました。
この方法使うと,Doxygenがスキップしない部分には,
#define __FASTCALL "" or __fastcall
とかメチャクチャ書けますねw
342デフォルトの名無しさん
2009/10/07(水) 04:18:00343デフォルトの名無しさん
2009/10/07(水) 04:18:44 __FASTCALL は C++ では予約識別子だな。やめといたほうがいいぞ。
344デフォルトの名無しさん
2009/10/07(水) 06:37:33 確かに。
予約されているから規格的に言えば未定義の動作になるな。
予約されているから規格的に言えば未定義の動作になるな。
345339
2009/10/07(水) 10:26:51 >>342
それだけだと,#define __FASTCALL あるいは #define __FASTCALL __fastcall のどちらかしか
ドキュメント化されないので...>>340の方法だと,>>341のようにコンパイラでコンパイルされると
困るようなメチャクチャな説明をドキュメント化できるのでわかりやすい。
理想的には,
#define __FASTCALL
VC++ではコンストラクタに__fastcallが使えないので空文字として定義される
#define __FASTCALL __fastcall
VC++以外では__fastcallとして定義される
みたいにドキュメント化されるといいんだけど,難しそうなので>>341に書いたように
#define __FASTCALL (null string) or __fastcall
VC++ではコンストラクタに__fastcallが使えないので空文字として定義される。VC++以外では__fastcallとして定義される。
のようにドキュメント化されれば実用上は問題ないと思う。
>>343
大文字の方も予約されてるとは知らなかった。ありがと〜。
それだけだと,#define __FASTCALL あるいは #define __FASTCALL __fastcall のどちらかしか
ドキュメント化されないので...>>340の方法だと,>>341のようにコンパイラでコンパイルされると
困るようなメチャクチャな説明をドキュメント化できるのでわかりやすい。
理想的には,
#define __FASTCALL
VC++ではコンストラクタに__fastcallが使えないので空文字として定義される
#define __FASTCALL __fastcall
VC++以外では__fastcallとして定義される
みたいにドキュメント化されるといいんだけど,難しそうなので>>341に書いたように
#define __FASTCALL (null string) or __fastcall
VC++ではコンストラクタに__fastcallが使えないので空文字として定義される。VC++以外では__fastcallとして定義される。
のようにドキュメント化されれば実用上は問題ないと思う。
>>343
大文字の方も予約されてるとは知らなかった。ありがと〜。
346デフォルトの名無しさん
2009/10/07(水) 10:48:29347340
2009/10/07(水) 18:07:29 >>346
別にメチャクチャはまあ言葉のあやなんじゃないですかね。
オフィシャルでも
ttp://www.stack.nl/~dimitri/doxygen/
> You can even `abuse' doxygen for creating normal documentation (as I did for this manual).
と言っているぐらいですし
多少の奇怪な書き方は許容範囲では?
タダの宗教論争になってしまいますが。
別にメチャクチャはまあ言葉のあやなんじゃないですかね。
オフィシャルでも
ttp://www.stack.nl/~dimitri/doxygen/
> You can even `abuse' doxygen for creating normal documentation (as I did for this manual).
と言っているぐらいですし
多少の奇怪な書き方は許容範囲では?
タダの宗教論争になってしまいますが。
348デフォルトの名無しさん
2009/10/07(水) 18:58:23 >>347
それを指摘するのは無粋。つーか、間抜け。
それを指摘するのは無粋。つーか、間抜け。
349デフォルトの名無しさん
2009/10/08(木) 01:46:49 >>347
許容範囲なんだろうけど、ここでは奇怪な書き方をする必要がない、という話。
許容範囲なんだろうけど、ここでは奇怪な書き方をする必要がない、という話。
350デフォルトの名無しさん
2009/10/10(土) 07:47:27 >3
ttp://stackoverflow.com/questions/165451/suggest-a-good-doxygen-stylesheet
なさそうだね
ttp://stackoverflow.com/questions/165451/suggest-a-good-doxygen-stylesheet
なさそうだね
351デフォルトの名無しさん
2009/10/13(火) 10:41:56 寧ろ、doxygen.cssをカスタマイズしている人には紹介してほしいなぁ。
ソースを公開しろとまでは言わないから。
後は、こんなのが欲しいなんてリクエストでもあれば創造意欲が沸くかも知れない。
ソースを公開しろとまでは言わないから。
後は、こんなのが欲しいなんてリクエストでもあれば創造意欲が沸くかも知れない。
352デフォルトの名無しさん
2009/10/13(火) 21:08:49 しかしデフォルトのにしておかないと
将来のバージョンアップに毎回追随するのが
結構つらくなるのではと予感。
将来のバージョンアップに毎回追随するのが
結構つらくなるのではと予感。
353デフォルトの名無しさん
2009/10/17(土) 13:41:17 バージョンアップでかっこよくなったりするし
354デフォルトの名無しさん
2009/10/18(日) 10:45:33 ttp://www.doxygen.jp/manual.html
このサイト死んだね。
このサイト死んだね。
355デフォルトの名無しさん
2009/10/18(日) 11:55:33 う、うん……(´・ω・`)
356デフォルトの名無しさん
2009/10/18(日) 22:36:09357デフォルトの名無しさん
2009/10/28(水) 15:51:53 privateなメンバのうち、(純粋)仮想関数だけをドキュメントに出力する方法ってないものでしょうか
EXTRACT_PRIVATE = YESとすると、見せたくないprivate変数や非仮想関数まで出てきてしまうのがイヤで・・・
EXTRACT_PRIVATE = YESとすると、見せたくないprivate変数や非仮想関数まで出てきてしまうのがイヤで・・・
358デフォルトの名無しさん
2009/10/28(水) 23:24:18359デフォルトの名無しさん
2009/11/10(火) 14:57:36 Doxygen 1.6.1 をソースパッケージから VC8 でビルドしようとしたのですが src/translator_*.h
が言語毎にいろいろなエンコーディングで保存されていて文字列リテラルの部分でエラーが大量発生する
(おそらく多バイト文字に '\' や '"' が含まれる) のですが、Windows でビルドするときは特別な
手続きがいるのでしょうか?
が言語毎にいろいろなエンコーディングで保存されていて文字列リテラルの部分でエラーが大量発生する
(おそらく多バイト文字に '\' や '"' が含まれる) のですが、Windows でビルドするときは特別な
手続きがいるのでしょうか?
360デフォルトの名無しさん
2009/12/05(土) 01:55:28 クラスメソッドの詳細の、“コンストラクタ・デストラクタ”のセクションに
デストラクタが入らないのはdoxygenのバグだよね?
あと、@nameコマンドで1つのクラスに同じ名前のメンバグループを
複数作った場合、それぞれが別のグループとして吐き出されるのは仕様?
あ、どっちも1.6.1の話ね
デストラクタが入らないのはdoxygenのバグだよね?
あと、@nameコマンドで1つのクラスに同じ名前のメンバグループを
複数作った場合、それぞれが別のグループとして吐き出されるのは仕様?
あ、どっちも1.6.1の話ね
361デフォルトの名無しさん
2009/12/05(土) 12:30:58363360
2009/12/07(月) 16:44:48 >>362
ソースはマニュアル内のこのページ(ttp://www.doxygen.jp/docblocks.html)の
サンプルをそのまま使用
本体のバグでないならヘッダの問題かと思い、いろいろ試してみた結果、
INPUT_ENCODING=Shift_JISにした時に問題が起きた(CP932なら問題無し)
ちなみに、出力されないわけじゃなくて、通常の関数と同じセクションに
デストラクタが入ってる
デストラクタ名がチルダでなくオーバーバーで表示されてたので、
doxygenがデストラクタと認識してくれないのが原因か?
ソースはマニュアル内のこのページ(ttp://www.doxygen.jp/docblocks.html)の
サンプルをそのまま使用
本体のバグでないならヘッダの問題かと思い、いろいろ試してみた結果、
INPUT_ENCODING=Shift_JISにした時に問題が起きた(CP932なら問題無し)
ちなみに、出力されないわけじゃなくて、通常の関数と同じセクションに
デストラクタが入ってる
デストラクタ名がチルダでなくオーバーバーで表示されてたので、
doxygenがデストラクタと認識してくれないのが原因か?
364デフォルトの名無しさん
2009/12/07(月) 23:10:54 >>363
CP932
にしろってオフィシャルでどっかに書いてあったような気がする。
> デストラクタ名がチルダでなくオーバーバーで表示されてたので、
> doxygenがデストラクタと認識してくれないのが原因か?
その可能性が高そうだ。
CP932
にしろってオフィシャルでどっかに書いてあったような気がする。
> デストラクタ名がチルダでなくオーバーバーで表示されてたので、
> doxygenがデストラクタと認識してくれないのが原因か?
その可能性が高そうだ。
365デフォルトの名無しさん
2009/12/14(月) 10:46:24366デフォルトの名無しさん
2009/12/14(月) 14:13:25367デフォルトの名無しさん
2009/12/17(木) 02:23:51 >>365-366
Qtのマニュアルは開発元内製の非公開のツールで作られているそうです。
doxygenが作られたのもそれが理由だそうで。
ttp://lists.trolltech.com/qt-interest/2007-07/thread00457-0.html
Qtのマニュアルは開発元内製の非公開のツールで作られているそうです。
doxygenが作られたのもそれが理由だそうで。
ttp://lists.trolltech.com/qt-interest/2007-07/thread00457-0.html
368デフォルトの名無しさん
2009/12/18(金) 13:27:05 素敵なcssがほしい。
369デフォルトの名無しさん
2009/12/24(木) 13:46:58 EXTRACT_PRIVATE = NO の設定で一部の private 関数を文書化する方法はあるでしょうか?
やりたいことは、ある基底クラスに private の仮想関数を定義して (派生クラスでその仮想関数
をオーバーライドするユーザーのために) その関数の仕様を Doxygen で出力することです。
やりたいことは、ある基底クラスに private の仮想関数を定義して (派生クラスでその仮想関数
をオーバーライドするユーザーのために) その関数の仕様を Doxygen で出力することです。
370デフォルトの名無しさん
2009/12/24(木) 21:33:52371デフォルトの名無しさん
2009/12/29(火) 09:09:16 ttp://uploader.rgr.jp/src/up1598.png
このように、ソース中の'が'と表示されてしまうんですが、
対策をご存じの方いらっしゃいますか?
また、他の方がたはこの問題が再現しますか?
サンプルソースは
ttp://uproda.2ch-library.com/lib200801.zip.shtml
DLキーはdoxygen
です。
ここのget_widechar.hをDoxygenにかけてhtmlを出力させると
上述の画像のようになります。
このように、ソース中の'が'と表示されてしまうんですが、
対策をご存じの方いらっしゃいますか?
また、他の方がたはこの問題が再現しますか?
サンプルソースは
ttp://uproda.2ch-library.com/lib200801.zip.shtml
DLキーはdoxygen
です。
ここのget_widechar.hをDoxygenにかけてhtmlを出力させると
上述の画像のようになります。
372デフォルトの名無しさん
2009/12/29(火) 09:40:19 html4ではなくxml1の読めるブラウザを使えばいいんでない?
# 根本は解決していないけど。
例えば、IE6がこれに該当するからIE8を入れるとか。
どうしても根本的に解決したいなら、ソースを修正するとか出力を加工するとか。
つーか、手元のソースとDoxygenでは再現しないしzipをダウンロードするのは嫌なんだけど、
再現できる状態でここに貼れる程度に短くできない? それと、Doxygenのバージョンも宜しく。
# 根本は解決していないけど。
例えば、IE6がこれに該当するからIE8を入れるとか。
どうしても根本的に解決したいなら、ソースを修正するとか出力を加工するとか。
つーか、手元のソースとDoxygenでは再現しないしzipをダウンロードするのは嫌なんだけど、
再現できる状態でここに貼れる程度に短くできない? それと、Doxygenのバージョンも宜しく。
373デフォルトの名無しさん
2009/12/29(火) 12:07:45 >>372
確かにIE6で見ていたらだめでしたが、
Firefoxなら正しく表示されました。
ソースは
ttp://codepad.org/7giB9nil
で、Doxygenは1.6.1です。
設定は
DOXYFILE_ENCODING = CP932
OUTPUT_LANGUAGE = Japanese
このぐらいです。
確かにIE6で見ていたらだめでしたが、
Firefoxなら正しく表示されました。
ソースは
ttp://codepad.org/7giB9nil
で、Doxygenは1.6.1です。
設定は
DOXYFILE_ENCODING = CP932
OUTPUT_LANGUAGE = Japanese
このぐらいです。
374デフォルトの名無しさん
2009/12/29(火) 13:06:29 手元の1.5.9じゃ再現できないや。1.6.1持ちか詳しい人待ちだな。
375デフォルトの名無しさん
2009/12/29(火) 16:06:24 >>374
意外に1.5.9って1.6.1より動作安定してたりしますよね。
ちなみに画像
ttp://uploader.rgr.jp/src/up1598.png
を出力したhtmlファイル(の一部)は
ttp://codepad.org/OijY25xj
こんな感じで、この中にある
'
となっている部分を単純に
'
に置換してしまえば
IE6, Firefoxともに問題無く表示出来る様です。
・・・ってこんな対策でいいのでしょうか?
'を単純に'に置換してしまってまずい場合とかありますでしょうか?
意外に1.5.9って1.6.1より動作安定してたりしますよね。
ちなみに画像
ttp://uploader.rgr.jp/src/up1598.png
を出力したhtmlファイル(の一部)は
ttp://codepad.org/OijY25xj
こんな感じで、この中にある
'
となっている部分を単純に
'
に置換してしまえば
IE6, Firefoxともに問題無く表示出来る様です。
・・・ってこんな対策でいいのでしょうか?
'を単純に'に置換してしまってまずい場合とかありますでしょうか?
376デフォルトの名無しさん
2009/12/29(火) 16:51:13 html4.01にはaposがないんだからしょうがないんじゃない?
377デフォルトの名無しさん
2009/12/29(火) 17:23:37378デフォルトの名無しさん
2010/01/03(日) 02:55:32 Doxygen 1.6.2 age
379デフォルトの名無しさん
2010/01/03(日) 21:21:40380379
2010/01/03(日) 23:52:47 仕様 変わりすぎだよチクショー!!!!!
381デフォルトの名無しさん
2010/01/04(月) 00:08:12 doxygen.css
の仕様が変わりすぎでございますorz
バージョンが0.01違いなのに、こんなに変わるものだとは。
Doxygenって後方互換性という言葉には興味ないの?
の仕様が変わりすぎでございますorz
バージョンが0.01違いなのに、こんなに変わるものだとは。
Doxygenって後方互換性という言葉には興味ないの?
382>>379-381
2010/01/04(月) 21:42:35 俺以外に
Doxygen 1.6.2
を使ってる人 居ないの?
なんだか、
1. C++0xが公式仕様策定されて
2. ちゃんと各種コンパイラで実装されて
3. 現実的にC++0xを使っても大丈夫だと思うくらいになって
4. Doxygen がC++0xに対応完了
このくらいの条件を満たさないかぎり、別にアップデートしなくてもいい気がしてきた。
ブラウザとか中核ソフトとは違ってセキュリティもクソもない・・・しね?
Doxygen 1.6.2
を使ってる人 居ないの?
なんだか、
1. C++0xが公式仕様策定されて
2. ちゃんと各種コンパイラで実装されて
3. 現実的にC++0xを使っても大丈夫だと思うくらいになって
4. Doxygen がC++0xに対応完了
このくらいの条件を満たさないかぎり、別にアップデートしなくてもいい気がしてきた。
ブラウザとか中核ソフトとは違ってセキュリティもクソもない・・・しね?
383デフォルトの名無しさん
2010/01/06(水) 14:43:02384>382
2010/01/06(水) 20:01:55385>382
2010/01/06(水) 20:19:19 ちなみに
Doxyfile 1.6.1 デフォルト
ttp://codepad.org/olhvPmWM
Doxyfile 1.6.2 デフォルト
ttp://codepad.org/wA3SWMYO
Doxyfile 1.6.1 デフォルト
ttp://codepad.org/olhvPmWM
Doxyfile 1.6.2 デフォルト
ttp://codepad.org/wA3SWMYO
386デフォルトの名無しさん
2010/01/23(土) 09:24:51 1.6.2に更新したら、pageコマンドから作られたhtmlにタイトルが出力されなくなった…
似たような症状の人いる?
似たような症状の人いる?
388デフォルトの名無しさん
2010/01/26(火) 07:47:54390デフォルトの名無しさん
2010/01/29(金) 04:03:10 >>388
トンクス!表示されたぜ!
ML見てきたんだが、
>ドキュメントにアンダーバー不許可と明示されてはいないけど、
>名前は英文字と数字の組み合わせからなる、とは書かれていて、
>そこにアンダーバーは含まれていないでしょ。
みたいな返答だった。
でも以前は使えてたわけだし、@page以外のタグは問題ないし、
ドキュメントが更新された形跡もないし、やっぱなんかバグっぽいよね。
トンクス!表示されたぜ!
ML見てきたんだが、
>ドキュメントにアンダーバー不許可と明示されてはいないけど、
>名前は英文字と数字の組み合わせからなる、とは書かれていて、
>そこにアンダーバーは含まれていないでしょ。
みたいな返答だった。
でも以前は使えてたわけだし、@page以外のタグは問題ないし、
ドキュメントが更新された形跡もないし、やっぱなんかバグっぽいよね。
391デフォルトの名無しさん
2010/01/29(金) 06:34:03392デフォルトの名無しさん
2010/01/30(土) 15:04:22393デフォルトの名無しさん
2010/01/30(土) 15:52:25 Doxygen Release 1.6.2 (release date 30-12-2009)
Doxygen Release 1.6.1 (release date 25-08-2009)
Doxygen Release 1.6.0 (release date 20-08-2009)
Doxygen Release 1.5.9 (release date 30-04-2009)
Doxygen Release 1.5.8 (release date 27-12-2008)
Doxygen Release 1.5.7.1 (release date 5-10-2008)
Doxygen Release 1.5.7 (release date 28-9-2008)
Doxygen Release 1.5.6 (release date 18-5-2008)
Doxygen Release 1.5.5 (release date 10-2-2008)
Doxygen Release 1.5.4 (release date 27-10-2007)
Doxygen Release 1.5.3 (release date 27-7-2007)
Doxygen Release 1.5.2 (release date 4-4-2007)
Doxygen Release 1.5.1 (release date 29-10-2006)
Doxygen Release 1.5.0 (release date 16-10-2006)
Doxygen Release 1.4.7 (release date 11-06-2006)
Doxygen Release 1.6.1 (release date 25-08-2009)
Doxygen Release 1.6.0 (release date 20-08-2009)
Doxygen Release 1.5.9 (release date 30-04-2009)
Doxygen Release 1.5.8 (release date 27-12-2008)
Doxygen Release 1.5.7.1 (release date 5-10-2008)
Doxygen Release 1.5.7 (release date 28-9-2008)
Doxygen Release 1.5.6 (release date 18-5-2008)
Doxygen Release 1.5.5 (release date 10-2-2008)
Doxygen Release 1.5.4 (release date 27-10-2007)
Doxygen Release 1.5.3 (release date 27-7-2007)
Doxygen Release 1.5.2 (release date 4-4-2007)
Doxygen Release 1.5.1 (release date 29-10-2006)
Doxygen Release 1.5.0 (release date 16-10-2006)
Doxygen Release 1.4.7 (release date 11-06-2006)
394>387 >393
2010/01/30(土) 15:57:14 ということで、次にリリースされるのは
4月終わりごろと推測されます。
うわぁ、待ってられないよ。
・・・
> Doxygen Release 1.6.1 (release date 25-08-2009)
> Doxygen Release 1.6.0 (release date 20-08-2009)
見たいに短い間隔のリリースもあるっちゃあるんだが、
すでにDoxygen Release 1.6.2リリースから1ヶ月たっても
新しい版がでていないしなぁ。
>>388氏の解決策に乗っかろうかなぁ。。。
4月終わりごろと推測されます。
うわぁ、待ってられないよ。
・・・
> Doxygen Release 1.6.1 (release date 25-08-2009)
> Doxygen Release 1.6.0 (release date 20-08-2009)
見たいに短い間隔のリリースもあるっちゃあるんだが、
すでにDoxygen Release 1.6.2リリースから1ヶ月たっても
新しい版がでていないしなぁ。
>>388氏の解決策に乗っかろうかなぁ。。。
395394
2010/01/30(土) 23:27:05 <報告>
英数字どころか、小文字じゃないとダメみたいです。
AbCdE
とかはだめで、
abcde
ならOKのようです。
英数字どころか、小文字じゃないとダメみたいです。
AbCdE
とかはだめで、
abcde
ならOKのようです。
396デフォルトの名無しさん
2010/02/06(土) 23:10:09 死亡回避age
397デフォルトの名無しさん
2010/02/09(火) 21:40:07 Doxygen Release 1.6.2 + WinXPです。
ttp://codepad.org/UOnh6aUc
これを出力させると
ttp://uploader.rgr.jp/src/up1961.jpg
このように、inlineでもないのに勝手にinlineになります。
なお、
ttp://codepad.org/iT6VHAtw
のように、テンプレートでなければ勝手にinlineにはならないようです。
ttp://uploader.rgr.jp/src/up1962.jpg
同じ症状の方いらっしゃいますか?
ttp://codepad.org/UOnh6aUc
これを出力させると
ttp://uploader.rgr.jp/src/up1961.jpg
このように、inlineでもないのに勝手にinlineになります。
なお、
ttp://codepad.org/iT6VHAtw
のように、テンプレートでなければ勝手にinlineにはならないようです。
ttp://uploader.rgr.jp/src/up1962.jpg
同じ症状の方いらっしゃいますか?
398397
2010/02/09(火) 21:40:49 あと、もし古いバージョンで試してくださる方がいらっしゃったら
是非結果を教えてください。
よろしくお願い申し上げます。
是非結果を教えてください。
よろしくお願い申し上げます。
399397
2010/02/11(木) 20:12:03 Graphviz - Graph Visualization Software
が最新版でました!version 2.26.3 になりました。
・・・そしてインストールしたらエラーになったので、
同じ症状で悩んでいる方がもしいらしたら参考にしてください。
解決策のリンク
ttp://old.nabble.com/Dot-problems-td15185555.html
************************************************************************
Oren Almog wrote:
I am using the windows version. Doxygen seems to work fine but I repeatedly
get errors when it calls dot to generate call graphs (or any other graphs).
c0f5d09662a9af0a3f709cb57d6841_cgraph.dot" -Tpng -o
"ex__cmds_8c_abc0f5d09662a9af0a3f709cb57d6841_cgraph.png"'
Problems running dot: exit code=-1, command='dot',
Dot is in my PATH. To be sure I tried to create the graph manually my going
to the directory and calling dot with the same parameters, I get a message
about a missing font and that file will look ugly but the png is generated
with no further input required from me.
Any ideas?
************************************************************************
biljana wrote:
You have to install Graphviz and set the DOT_PATH to the Graphviz/bin folder. Also you should set HAVE_DOT to YES.
が最新版でました!version 2.26.3 になりました。
・・・そしてインストールしたらエラーになったので、
同じ症状で悩んでいる方がもしいらしたら参考にしてください。
解決策のリンク
ttp://old.nabble.com/Dot-problems-td15185555.html
************************************************************************
Oren Almog wrote:
I am using the windows version. Doxygen seems to work fine but I repeatedly
get errors when it calls dot to generate call graphs (or any other graphs).
c0f5d09662a9af0a3f709cb57d6841_cgraph.dot" -Tpng -o
"ex__cmds_8c_abc0f5d09662a9af0a3f709cb57d6841_cgraph.png"'
Problems running dot: exit code=-1, command='dot',
Dot is in my PATH. To be sure I tried to create the graph manually my going
to the directory and calling dot with the same parameters, I get a message
about a missing font and that file will look ugly but the png is generated
with no further input required from me.
Any ideas?
************************************************************************
biljana wrote:
You have to install Graphviz and set the DOT_PATH to the Graphviz/bin folder. Also you should set HAVE_DOT to YES.
400デフォルトの名無しさん
2010/02/21(日) 22:45:41 Doxygen 1.6.3 age
401デフォルトの名無しさん
2010/02/21(日) 23:26:54402397
2010/02/26(金) 06:35:09403デフォルトの名無しさん
2010/02/27(土) 21:06:19 Doxygen 1.6.3 で
@pageで生成したページのタイトルが付かないバグ
は、解決しているようですね。
@pageで生成したページのタイトルが付かないバグ
は、解決しているようですね。
404デフォルトの名無しさん
2010/03/08(月) 15:44:01 WinXP version1.6.3で、S-JISのファイルを変換したいのですが、設定ファイルを
INPUT_ENCODING = CP932
と設定した場合は、
Error: failed to translate characters from CP932 to UTF-8: check INPUT_ENCODING
とエラーがでます。
INPUT_ENCODING = SHIFT_JIS
とした場合は
Error: failed to translate characters from SHIFT_JIS to UTF-8: check INPUT_ENCODING
とエラーがでます。
DOXYFILE_ENCODING = SHIFT_JIS
として、
PROJECT_NAMEに日本語を設定したら反映されます。
何か他に設定する必要があるのでしょうか?
INPUT_ENCODING = CP932
と設定した場合は、
Error: failed to translate characters from CP932 to UTF-8: check INPUT_ENCODING
とエラーがでます。
INPUT_ENCODING = SHIFT_JIS
とした場合は
Error: failed to translate characters from SHIFT_JIS to UTF-8: check INPUT_ENCODING
とエラーがでます。
DOXYFILE_ENCODING = SHIFT_JIS
として、
PROJECT_NAMEに日本語を設定したら反映されます。
何か他に設定する必要があるのでしょうか?
405デフォルトの名無しさん
2010/03/09(火) 00:33:11 >>404
INPUT_ENCODING はソースファイルのエンコーディングの設定で、
DOXYFILE_ENCODING は設定ファイル自身のエンコーディングの設定です。
> WinXP version1.6.3で、S-JISのファイルを変換したいのですが、
のS-JISのファイルというのは設定ファイルじゃなくソースファイルのことですか?
だったら、 INPUT_ENCODING = CP932 で合ってるはずなんですが。
S-JISのつもりで実はUnicodeだったなんてことはないですか?
> DOXYFILE_ENCODING = SHIFT_JIS
> として、
> PROJECT_NAMEに日本語を設定したら反映されます。
設定ファイルはDoxywizardを使わないで、テキストエディタで書き換えてるんですか?
Doxywizardだと DOXYFILE_ENCODING は UTF-8 にしないと正しく動作しないはずなので。
INPUT_ENCODING はソースファイルのエンコーディングの設定で、
DOXYFILE_ENCODING は設定ファイル自身のエンコーディングの設定です。
> WinXP version1.6.3で、S-JISのファイルを変換したいのですが、
のS-JISのファイルというのは設定ファイルじゃなくソースファイルのことですか?
だったら、 INPUT_ENCODING = CP932 で合ってるはずなんですが。
S-JISのつもりで実はUnicodeだったなんてことはないですか?
> DOXYFILE_ENCODING = SHIFT_JIS
> として、
> PROJECT_NAMEに日本語を設定したら反映されます。
設定ファイルはDoxywizardを使わないで、テキストエディタで書き換えてるんですか?
Doxywizardだと DOXYFILE_ENCODING は UTF-8 にしないと正しく動作しないはずなので。
406デフォルトの名無しさん
2010/03/10(水) 16:41:23 >>405
ソースファイルを確認したところ、
新規に追加したものはSHIFT_JISだったのですが、
もともとあったソースは中国語のソースで、文字コードが"繁体字中国語"というもののようで、
このファイルを解析する時に、SHIFT_JISでないということで、エラーになるようです。
ありがとうございました。
ソースファイルを確認したところ、
新規に追加したものはSHIFT_JISだったのですが、
もともとあったソースは中国語のソースで、文字コードが"繁体字中国語"というもののようで、
このファイルを解析する時に、SHIFT_JISでないということで、エラーになるようです。
ありがとうございました。
407デフォルトの名無しさん
2010/03/10(水) 20:58:58 中国語か。
最近ちらほら見かける。
最近ちらほら見かける。
408デフォルトの名無しさん
2010/03/18(木) 09:48:49 こんなの作ってみた。良かったら使ってみて。
つ ttp://sourceforge.jp/projects/sfnet_doxygemplate/
ttp://sourceforge.net/projects/doxygemplate/
今のところWindows専用だけど,Qtで作ってるのでLinuxでもビルドできるはず。
俺はWindowsオンリーなので,誰か手伝ってくれると助かるんだけど...
つ ttp://sourceforge.jp/projects/sfnet_doxygemplate/
ttp://sourceforge.net/projects/doxygemplate/
今のところWindows専用だけど,Qtで作ってるのでLinuxでもビルドできるはず。
俺はWindowsオンリーなので,誰か手伝ってくれると助かるんだけど...
■ このスレッドは過去ログ倉庫に格納されています
ニュース
- 「おこめ券は米以外の食品も買える。効果的な活用を」 地元で農水相 [山形県] [少考さん★]
- 【速報】「女芸人No.1決定戦 THE W」9代目女王にニッチェ! 7年ぶり3度目で悲願の優勝 [牛丼★]
- 【芸能】『女芸人No.1決定戦THE W』 粗品が最後にバッサリ「優勝賞金1000万円にしてはレベル低い大会」 [冬月記者★]
- 高市首相の答弁書に「台湾有事答えない」と明記 存立危機発言当時 ★11 [蚤の市★]
- 今年の流行語大賞 『働いて働いて働いてまいります』が受賞で不快感… 過労自殺の遺族らが会見「家族にむち打つような行為だ」 [冬月記者★]
- 【沖縄】開業4ヵ月でこれは…“国民の税金”投入の『ジャングリア沖縄』で見た衝撃的な光景と、モチベーションが低い一部スタッフの現状 [ぐれ★]
- クズ「勉強頑張らなかった奴は一生DQNと一緒に肉体労働しろ」☚勉強頑張れるのも環境と巡り合わせなんだが? [783475554]
- 【正論】検察「山上よ、どんな事情があろうと暴力が許されない」 [442080748]
- 🖐( ・᷇ὢ・᷆ )おはよう
- 若いころパパカツしてカリカリ女になって適当な男と結婚したほうが大体は幸せになるというじじつ
- 年末年始にしか会わない親戚
- 【高市悲報】トランプ「喧嘩してねぇで日中は仲良くしろ」 [931948549]
