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

**デフォルトの名無しさん** · 2008/05/30(金) 19:50:27

無いので建てた

公式
http://www.doxygen.jp/

**282** · 2009/08/23(日) 11:47:44

>>283
ありがとうございます。
私は＠ではなく＼で書いているので問題ないですかね。

**283** · 2009/08/23(日) 19:42:34

>>284
それは試してないのでわかりません。

以前のバージョンから、「@」は利かなくて「\」なら利く局面もありましたから、
(例えば @dot 内の URL パラメータに \ref を使うとか)
もしかすると問題ないかもしれません。

なお、「"」の代わりに「"」を使えば、「@a」も機能しました。
ソースコメントでの視認性を考えるとやりたくないですが。

**283** · 2009/08/23(日) 19:45:40

>>285
あ、「”」の代わりに「＆ｑｕｏｔ；」です。
(今度はちゃんと表示されるかな)

**282** · 2009/08/23(日) 20:21:51

>>285-286
なるほど。
詳細誠にありがとうございます。

今のdoxygenで問題がないので、
念のためdoxygenバージョンアップするのは
控えておこうかと思います。

**283** · 2009/08/24(月) 02:03:19

補足です。

>>283 のような状況になっているということはつまり、
二重引用符で囲まれている部分が区別されるようになったということで、
いままで単純に1文字として「"」を使ってた部分や、
うっかり片方の引用符を忘れていた部分でエラーが出ます。

**どｘｙげん** · 2009/08/24(月) 10:56:52

doxygenで生成される、
左側の目次（ツリービュー）を自分が好きに
並べる方法している方いらっしゃいませんか？

誰か教えてください。

**デフォルトの名無しさん** · 2009/08/25(火) 22:33:39

Doxygen 1.6.1 age

**デフォルトの名無しさん** · 2009/08/29(土) 14:36:45

Windows XP SP2, doxygen 1.6.1です。
ttp://loda.jp/uploader_nrnrnr/?id=10

このhoge.hを同じくこのDoxyfileで
HTMLドキュメント化したのですが、
クラスの構成のところで説明の最初の文字が
　http://imagepot.net/view/125152409985.gif
の様に大文字になってしまいます。

自動的に大文字にしてくれるこの仕様を回避したいのですが、
どうすればよろしいでしょうか？
よろしくお願い申し上げます。

なお、doxygen 1.5.9でも同様の現象でした。

**デフォルトの名無しさん** · 2009/09/01(火) 09:31:19

>>291
lodaの方にコメントついてる。

**291** · 2009/09/01(火) 18:05:12

2chの方ばかり見ておりました。
ありがとうございます。

**291** · 2009/09/01(火) 20:42:47

と思いましたら解決しませんでした。
\ mynamesp::hogeクラスです。とすると、不要な半角の＼が入ってしまいます。
! mynamesp::hogeクラスです。とすると、不要な半角の！が入ってしまいます。
　mynamesp::hogeクラスです。とすると、doxygenの抱えるバグ（＊）により、mynamesphogeとなってしまいます。
（＊）全角文字に半角英数が続き、スコープ解決演算子である::がその後ろに来たとき、::が無視されるというバグです。
どうしたらいいでしょうか？

http://loda.jp/uploader_nrnrnr/?id=10&dsq=15701579#comment-15701579
で質問させていただいている者です。

**デフォルトの名無しさん** · 2009/09/02(水) 01:21:01

>>294
lodaのコメントは、行頭に「\」や「!」を入れるのが
大文字化されないための書き方という意味じゃなくて、
文の先頭にクラス名がこない書き方を工夫すればという意味だと思う。

# 一覧表以外のところでは大文字化してないから、個人的にはバグじゃないかと思うけど。

「::」が消える件は >>211-213 を参照。

**291** · 2009/09/02(水) 06:54:56

>>295
私もバグではなく仕様だとは思っています。

::が無視されるのはバグですが。
最速で>>187さんが触れてますね。

どうもありがとうございました。

**デフォルトの名無しさん** · 2009/09/04(金) 08:46:55

プログラミング言語によっては全角文字も識別子に使えることを考えると、
文中に空白で区切られずに書かれてる識別子を正しく認識して欲しいというのは、
日本語の構文を理解する必要のある無茶な要求じゃないかな。

**デフォルトの名無しさん** · 2009/09/04(金) 12:51:33

そうか？
別に煽りたい訳じゃ無いけど、消えてしまうのは文字コードの問題だと
考えるのが普通では？
だって構文解析いらないでしょ。

**297** · 2009/09/05(土) 01:43:17

>>298
消えてしまうのはバグだと思うけど、
クラスメンバを認識して自動的にリンクを張る機能があるんだから、
その過程で「::」を特別扱いしてると思うのよ。

ていうかごめん、言葉が足りなかったわ。
言いたかったのは、バグが起きにくい書き方をするように
歩み寄ってもいいんじゃないかということなんで。

**デフォルトの名無しさん** · 2009/09/10(木) 14:47:25

1.6.1を入れたのだけど、doxywizardで項目名が赤くなるのはどういう意味？

**デフォルトの名無しさん** · 2009/09/10(木) 19:41:01

>>300
1.6.1前からでも赤くなかった？
おそらくデフォルト値から変更された物が赤いんじゃないかと思われる。

**300** · 2009/09/10(木) 20:03:13

>>301
どうもありがとう。確かに入力すると赤くなり、消すと黒くなるから変更されたところだ。
前は1.5.6を使っていただけど赤くはならなかったので、最初はエラーかと思った。

**デフォルトの名無しさん** · 2009/09/14(月) 00:04:39

Javaで使っているのですが、クラス階層図や関数の呼び出し図などで、
クラス名がパッケージ名を含む長い名前になるのを避ける方法はあるでしょうか？
例えば、以下のサンプルですと、図からorg.byteml.の部分を取り除きたいです。
http://byteml.sourceforge.net/html/classorg_1_1byteml_1_1serialize_1_1ByteMLBuilder.html

**デフォルトの名無しさん** · 2009/09/16(水) 00:28:43

doxygenで、C++でhtmlドキュメントを作りたい時、
　ここからここまでの範囲のソースはドキュメントしないでね
あるいは
　このクラスはドキュメント化しないでね（ドキュメントに載せないでね）
といった指示はできるのでしょうか？

よろしくお願いいたします。

**デフォルトの名無しさん** · 2009/09/16(水) 03:34:57

>>304
素直な方法は、ドキュメント化したい部分に一通りdoxygen用のコメントをつけて、
EXTRACT_ALL は NO にして、
HIDE_UNDOC_MEMBERS と HIDE_UNDOC_CLASSES を YES にすることでしょうか。

そうすれば、コメントの付いている部分だけがドキュメント化されます。

**デフォルトの名無しさん** · 2009/09/16(水) 07:05:22

>>305
ありがとうございます。
私は
> EXTRACT_ALL は NO にして、
> HIDE_UNDOC_MEMBERS を YES に
まではしているのですが、
HIDE_UNDOC_CLASSES
はNOにしています。
というのも、YESにするとドキュメント化したいクラスが
標準ライブラリや他人のライブラリ(doxygenコメント化されていない)
の中のあるクラスを継承しているクラスであった場合、
継承関係がグラフ化されなくなってしまうからです。

かといってこのままでは実装用のクラスまでも
HTMLドキュメントに出て来てしまうのが
ちょっと気持ち悪いので、悩んでおります。

**デフォルトの名無しさん** · 2009/09/17(木) 01:10:31

>>306

doxyfile で
PREDEFINED = NO_DOXYGEN
としておいて、ヘッダの方で

#ifndef NO_DOXYGEN
実装用クラス
#endif

とか私はやってます。

**306** · 2009/09/17(木) 06:59:25

>>307
ありがとうございます。
そんな方法があったんですね。

**307** · 2009/09/17(木) 16:45:15

>>308

後で見返してよく考えたら「NO_DOXYGEN」だと意味逆でしたね。
まあそれはともかく、この方法を使うと、
たとえば利用者マニュアル用 doxyfile と
内部開発者用 doxyfile とかを使い分けて
(それぞれ別々の PREDEFINED を設定しておく)、
コード内では #ifndef を使ってマニュアルに出したいものを制御
なんてこともできます。

**306** · 2009/09/17(木) 21:03:18

>>309
なるほど、深いですね。
面白そうです。
ありがとうございます。

**306** · 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のバージョンはいくらでしょうか？

**306** · 2009/09/18(金) 00:20:56

ちなみにちゃんと
#ifndef DOXYGEN
になっています。
#ifdef DOXYGEN
だったりはしません。
よろしくお願いいたします。

**307** · 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 の時につくったものでした。

**デフォルトの名無しさん** · 2009/09/18(金) 09:44:38

>>312
お前、馬鹿だろw
>307を読めば判ることで何とち狂ってるんだか。

**306** · 2009/09/18(金) 11:12:07

>>313
申し訳ございません。
ご指摘の通り大変みっともない間違いをしでかしており、
恥ずかしいかぎりです。

うまく動きました。
ありがとうございました。

**デフォルトの名無しさん** · 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
と表示させたいのですが、何か方法はありますでしょうか？

よろしくお願いいたします。

**307** · 2009/09/18(金) 12:08:01

>>314

まあまあ。
マニュアル読むと、PREDEFINED と EXPAND_AS_DEFINED の説明は
確かにかなり紛らわしいのよ。試行錯誤の過程で勘違いしても仕方がない。
私もかつては戸惑った口。

>>315

お役に立てて何よりです。

**デフォルトの名無しさん** · 2009/09/18(金) 12:25:36

doxygen 1.5.8を使っているんだけど、例えばstd::vector<std::vector<int>>が通らないのね。
きちんと> >にしないといけないらしい。

**デフォルトの名無しさん** · 2009/09/18(金) 12:55:10

>>318
C++はC++0xになるまではそうでしょ？
コメント文でもそうだってことかい？

**デフォルトの名無しさん** · 2009/09/18(金) 12:57:05

>>319
いやいや、会社でほたえちょる阿呆がおったからソースを見たら、>>で書いていたってことで。
それで気づいたんだが、VC++はエラーにしてくれないんだね。

**デフォルトの名無しさん** · 2009/09/18(金) 13:47:50

>>320
そうなのか。
まあどうせC++0xでは認められるんだから
VC++もエラーじゃなくていいんじゃね。

**デフォルトの名無しさん** · 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にしても起こると思うのですが、皆様はどうでしょうか？

**デフォルトの名無しさん** · 2009/09/19(土) 12:08:12

>>322
私の方でも同じ現象が出てます。
自分の書き方が悪いのかもと思いつつ、
ほとんど追求してませんでしたけど。

**322** · 2009/09/19(土) 13:07:25

>>323
ありがとうございます。
私は同じsourceで
Doxygen1.5.9→1.6.1のアップグレードで症状が発生したため、おそらく仕様変更に伴う不具合だと思っています。
じき直ると期待しています。

**デフォルトの名無しさん** · 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にしてしまえば良いわけでしょうか？
それとも何がデメリットがあるのでしょうか？

**デフォルトの名無しさん** · 2009/09/23(水) 01:46:24

>>325
Doxywizard で、 BUILTIN_STL_SUPPORT にカーソルを持っていったときに
表示される説明は、もう少し分かりやすいです。
STL のクラスを使ってるけど STL のソースをインクルードしたくない場合に
YESにするようにと書いてます。

ファイルの読み込みを抑えたいような場合でしょうか。

逆に処理系付属のヘッダも読み込む設定にしていて、 BUILTIN_STL_SUPPORT も
YES にすると、二重定義のような状況になるんじゃないかと思います。

**325** · 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にしているようです。

**316** · 2009/09/26(土) 18:13:55

どなたか>>316の解決策をご教示いただける有識者はいらっしゃいませんでしょうか？

どうかよろしくお願い申し上げます。

**デフォルトの名無しさん** · 2009/09/26(土) 19:33:05

>>316
その参照してるだけで定義の無いexceptionをエントリとして出せるオプションがあるの？

**316** · 2009/09/27(日) 01:04:43

>>329
HIDEUNDOCMEMBERSをNoにして、出力させるとこうなりました。

**316** · 2009/09/27(日) 10:43:25

>>329
EXTRACT_ALL は NO
HIDE_UNDOC_MEMBERS は YES
HIDE_UNDOC_CLASSES は NO
でした。

**デフォルトの名無しさん** · 2009/09/27(日) 13:24:58

/** \page hojodocs 補助ドキュメント
*/
としますと
ttp://uploader.rgr.jp/src/up1067.gif
の様に
「メインページ」「クラス」「ファイル」というタブと並んで「関連ページ」というタブが出来て
その中に補助ドキュメントというページが出来ます。

これを
「メインページ」「クラス」「ファイル」というタブと並んで「補助ドキュメント」というタブが
出来るようにする方法はありませんでしょうか？

単純に/pageを何か適当な物に変えれば良いのではないかと探ってみたのですが
どうしても分かりませんでした。

よろしくお願いします。

**デフォルトの名無しさん** · 2009/09/27(日) 21:39:45

>>331 うちではexceptionクラスそのものが出なかった。

**316** · 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
です。
お手数おかけ致しますが、こちらでいかがでしょうか？

**デフォルトの名無しさん** · 2009/10/01(木) 01:53:57

>>304-315
今更だけど、別の方法があったので。
@cond と @endcond で囲んだ範囲は、
@cond につけたラベルを ENABLED_SECTIONS に含めるかどうかで、
ドキュメント化するかどうかを設定できるようです。

**デフォルトの名無しさん** · 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なので念の為。

**304** · 2009/10/01(木) 10:51:57

ありがとうございます。
プリプロセッサを使った方法はエディタで対応する最初と最後をすぐ見つけらられるという利点がありますが、
@condと@endcondを使った方法はコメントだけで解決する->ソースに手を加えてはいないという点が利点ですね。

**デフォルトの名無しさん** · 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 がドキュメント化されるところまでは
良かったのですが，行末に ///> で異なる説明を書いても両方の説明に同じものが（マージされて）
出てきてしまいます。

良い方法があったら教えてください。

**338** · 2009/10/06(火) 16:59:07

>>338
ちょっと間違い。上の例で #else のところが #elif になってしまっているので
修正したら，_MSC_VER と !MSC_VER を両方 PREDEFINED に書いておく
という手は使えませんでした。結局 PREDEFINED にどう書くかで，
片方のドキュメントしか作成されません。

**304** · 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 */

**339** · 2009/10/06(火) 18:54:46

>>340
さすがに両方の説明を個別に表示することは出来ませんが，それで事足りますね。
ありがとうございました。

この方法使うと，Doxygenがスキップしない部分には，

#define __FASTCALL "" or __fastcall

とかメチャクチャ書けますねｗ

**デフォルトの名無しさん** · 2009/10/07(水) 04:18:00

>>338
/// @def __FASTCALL
/// ここに両方の場合の説明を書けばいいんじゃないの？

**デフォルトの名無しさん** · 2009/10/07(水) 04:18:44

__FASTCALL は C++ では予約識別子だな。やめといたほうがいいぞ。

**デフォルトの名無しさん** · 2009/10/07(水) 06:37:33

確かに。
予約されているから規格的に言えば未定義の動作になるな。

**339** · 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
大文字の方も予約されてるとは知らなかった。ありがと～。

**デフォルトの名無しさん** · 2009/10/07(水) 10:48:29

>>345
メチャクチャな説明がわかりやすいとか、おかしなことを言うね。
実用上問題なければ奇怪な書き方しないほうがいいだろうと思うし。

**340** · 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).
と言っているぐらいですし
多少の奇怪な書き方は許容範囲では？
タダの宗教論争になってしまいますが。

**デフォルトの名無しさん** · 2009/10/07(水) 18:58:23

>>347
それを指摘するのは無粋。つーか、間抜け。

**デフォルトの名無しさん** · 2009/10/08(木) 01:46:49

>>347
許容範囲なんだろうけど、ここでは奇怪な書き方をする必要がない、という話。

**デフォルトの名無しさん** · 2009/10/10(土) 07:47:27

>3
ttp://stackoverflow.com/questions/165451/suggest-a-good-doxygen-stylesheet
なさそうだね

**デフォルトの名無しさん** · 2009/10/13(火) 10:41:56

寧ろ、doxygen.cssをカスタマイズしている人には紹介してほしいなぁ。
ソースを公開しろとまでは言わないから。
後は、こんなのが欲しいなんてリクエストでもあれば創造意欲が沸くかも知れない。

**デフォルトの名無しさん** · 2009/10/13(火) 21:08:49

しかしデフォルトのにしておかないと
将来のバージョンアップに毎回追随するのが
結構つらくなるのではと予感。

**デフォルトの名無しさん** · 2009/10/17(土) 13:41:17

バージョンアップでかっこよくなったりするし

**デフォルトの名無しさん** · 2009/10/18(日) 10:45:33

ttp://www.doxygen.jp/manual.html
このサイト死んだね。

**デフォルトの名無しさん** · 2009/10/18(日) 11:55:33

う、うん……(´・ω・｀)

**デフォルトの名無しさん** · 2009/10/18(日) 22:36:09

>>354
生き返った。
良かった良かった。

**デフォルトの名無しさん** · 2009/10/28(水) 15:51:53

privateなメンバのうち、(純粋)仮想関数だけをドキュメントに出力する方法ってないものでしょうか
EXTRACT_PRIVATE = YESとすると、見せたくないprivate変数や非仮想関数まで出てきてしまうのがイヤで・・・

**デフォルトの名無しさん** · 2009/10/28(水) 23:24:18

>>357
そんな状況いままで無かったからな。
初めて考えてみる。

>>340が書いた方式を駆使して
どうにかできそうな気もするが良いアイディアが浮かばない。

**デフォルトの名無しさん** · 2009/11/10(火) 14:57:36

Doxygen 1.6.1 をソースパッケージから VC8 でビルドしようとしたのですが src/translator_*.h
が言語毎にいろいろなエンコーディングで保存されていて文字列リテラルの部分でエラーが大量発生する
(おそらく多バイト文字に '\' や '"' が含まれる) のですが、Windows でビルドするときは特別な
手続きがいるのでしょうか？

**デフォルトの名無しさん** · 2009/12/05(土) 01:55:28

クラスメソッドの詳細の、“コンストラクタ・デストラクタ”のセクションに
デストラクタが入らないのはdoxygenのバグだよね？
あと、@nameコマンドで１つのクラスに同じ名前のメンバグループを
複数作った場合、それぞれが別のグループとして吐き出されるのは仕様？

あ、どっちも1.6.1の話ね

**デフォルトの名無しさん** · 2009/12/05(土) 12:30:58

>>360
> クラスメソッドの詳細の、“コンストラクタ・デストラクタ”のセクションに
> デストラクタが入らないのはdoxygenのバグだよね？
マジで？
試してくる。

**361** · 2009/12/05(土) 12:35:42

>>360
Version 1.6.1 にて出力されたぞ。

出力されないソースないしヘッダの例をうｐしてくれれば確かめるけど？

**360** · 2009/12/07(月) 16:44:48

>>362
ソースはマニュアル内のこのページ(ttp://www.doxygen.jp/docblocks.html)の
サンプルをそのまま使用
本体のバグでないならヘッダの問題かと思い、いろいろ試してみた結果、
INPUT_ENCODING=Shift_JISにした時に問題が起きた(CP932なら問題無し)
ちなみに、出力されないわけじゃなくて、通常の関数と同じセクションに
デストラクタが入ってる

デストラクタ名がチルダでなくオーバーバーで表示されてたので、
doxygenがデストラクタと認識してくれないのが原因か？

**デフォルトの名無しさん** · 2009/12/07(月) 23:10:54

>>363
CP932
にしろってオフィシャルでどっかに書いてあったような気がする。
> デストラクタ名がチルダでなくオーバーバーで表示されてたので、
> doxygenがデストラクタと認識してくれないのが原因か？
その可能性が高そうだ。

**デフォルトの名無しさん** · 2009/12/14(月) 10:46:24

このQtのマニュアルみたいなのを作りたいのですがdoxygenで作れますか。
http://www.kde.gr.jp/~ichi/qt-2.3.2/annotated.html

**デフォルトの名無しさん** · 2009/12/14(月) 14:13:25

>>365
似たようなことはできると思いますが、一致度は保証できません。
TradeMarkとやらで作ったようなことが書かれているので、それでは如何ですか?

**デフォルトの名無しさん** · 2009/12/17(木) 02:23:51

>>365-366
Qtのマニュアルは開発元内製の非公開のツールで作られているそうです。
doxygenが作られたのもそれが理由だそうで。
ttp://lists.trolltech.com/qt-interest/2007-07/thread00457-0.html

**デフォルトの名無しさん** · 2009/12/18(金) 13:27:05

素敵なcssがほしい。

**デフォルトの名無しさん** · 2009/12/24(木) 13:46:58

EXTRACT_PRIVATE = NO の設定で一部の private 関数を文書化する方法はあるでしょうか？
やりたいことは、ある基底クラスに private の仮想関数を定義して (派生クラスでその仮想関数
をオーバーライドするユーザーのために) その関数の仕様を Doxygen で出力することです。

**デフォルトの名無しさん** · 2009/12/24(木) 21:33:52

>>369
ちょっと汚いソースになる気もするが、
>>340と同じようにして
Doxygen上にだけprivateをpublicにしちゃえば？

**デフォルトの名無しさん** · 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を出力させると
上述の画像のようになります。

**デフォルトの名無しさん** · 2009/12/29(火) 09:40:19

html4ではなくxml1の読めるブラウザを使えばいいんでない?
# 根本は解決していないけど。
例えば、IE6がこれに該当するからIE8を入れるとか。
どうしても根本的に解決したいなら、ソースを修正するとか出力を加工するとか。

つーか、手元のソースとDoxygenでは再現しないしzipをダウンロードするのは嫌なんだけど、
再現できる状態でここに貼れる程度に短くできない? それと、Doxygenのバージョンも宜しく。

**デフォルトの名無しさん** · 2009/12/29(火) 12:07:45

>>372
確かにIE6で見ていたらだめでしたが、
Firefoxなら正しく表示されました。

ソースは
ttp://codepad.org/7giB9nil
で、Doxygenは1.6.1です。
設定は
DOXYFILE_ENCODING = CP932
OUTPUT_LANGUAGE = Japanese
このぐらいです。

**デフォルトの名無しさん** · 2009/12/29(火) 13:06:29

手元の1.5.9じゃ再現できないや。1.6.1持ちか詳しい人待ちだな。

**デフォルトの名無しさん** · 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ともに問題無く表示出来る様です。

・・・ってこんな対策でいいのでしょうか？
'を単純に'に置換してしまってまずい場合とかありますでしょうか？

**デフォルトの名無しさん** · 2009/12/29(火) 16:51:13

html4.01にはaposがないんだからしょうがないんじゃない?

**デフォルトの名無しさん** · 2009/12/29(火) 17:23:37

>>376
俺のところのIE6ってそんな準拠性の悪いクソブラウザだったんですか。
噂には聞いていたんですがねぇ。

ありがとうございました。

**デフォルトの名無しさん** · 2010/01/03(日) 02:55:32

Doxygen 1.6.2 age

**デフォルトの名無しさん** · 2010/01/03(日) 21:21:40

>>378
まぢすか
入れてきます！

**379** · 2010/01/03(日) 23:52:47

仕様変わりすぎだよチクショー！！！！！

**デフォルトの名無しさん** · 2010/01/04(月) 00:08:12

doxygen.css
の仕様が変わりすぎでございますorz

バージョンが0.01違いなのに、こんなに変わるものだとは。

Doxygenって後方互換性という言葉には興味ないの？

**>>379-381** · 2010/01/04(月) 21:42:35

俺以外に
Doxygen 1.6.2
を使ってる人居ないの？
なんだか、
　1. C++0xが公式仕様策定されて
　2. ちゃんと各種コンパイラで実装されて
　3. 現実的にC++0xを使っても大丈夫だと思うくらいになって
　4. Doxygen がC++0xに対応完了
このくらいの条件を満たさないかぎり、別にアップデートしなくてもいい気がしてきた。
ブラウザとか中核ソフトとは違ってセキュリティもクソもない・・・しね？

**デフォルトの名無しさん** · 2010/01/06(水) 14:43:02

>>382
まだ正月休み明けでみなさん忙しいのでは。
私も先ほどようやく試してみたところ。

ざっと見た感じだと、1.6.1 と比べると
>>322 で指摘されていた不具合とか、
friend関数のマニュアルを無視するバグが直ってたりして、
概ね好印象ですね。