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

【コメント】doxygen� ..

266:デフォルトの名無しさん
09/06/20 21:38:29 .net
Windows XP SP2, doxygen 1.5.9です。
Sample.h
URLﾘﾝｸ(codepad.org)
これでhtmlドキュメントを生成させますと、
クラス階層図（継承関係）
が表示されません。
class Sample は std::runtime_error をpublic継承しているので
この継承の様子をGraphVizでグラフ表示させたいと思っているのですが、
どうすればよろしいでしょうか？

ソースとDoxyfile、出来上がったHTMLは
URLﾘﾝｸ(loda.jp)
です。
同じDoxyfileを使っても、関数の呼び出し関係は
うまくGraphVizでグラフ化されて表示されています。

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

267:デフォルトの名無しさん
09/06/20 22:08:18 .net
>>266
HIDE_UNDOC_RELATIONS が YES だからじゃないかと思いますが、
NO にしてもライブラリからの継承まで図に含めてくれるかどうか。
INCLUDE_PATH にコンパイラのヘッダファイルのパスの設定もして試してみてください。

268:266
09/06/20 23:31:56 .net
>>267
HIDE_UNDOC_RELATIONS
をNOにしたところ、
> INCLUDE_PATH にコンパイラのヘッダファイルのパスの設定
これをしなくても希望通りになりました。

URLﾘﾝｸ(imagepot.net)

感謝感激です。
どうもありがとうございました。

269:デフォルトの名無しさん
09/06/26 21:24:59 .net
保守

270:デフォルトの名無しさん
09/07/02 07:40:28 .net
>>250
どうもパネル作成時のミス？のようです。
Exportタブの中身はWizardタブと同じように左右分割されているらしく、
「左側の何も無いパネル」「右側の設定パネル」という風になっています。
それで「左側の何も無いパネル」の幅が最大になっているため、
何も表示されていないように見えるようです。

マウスを右端に移動させるとカーソル形状が変化しますので、
そのまま左にドラッグすると設定内容のパネルが見えるようになりました。

271:270
09/07/03 02:55:10 .net
少し訂正
左右分割だけではなく左側が上下に分割された３ペイン方式でした。
「左側の何も無いパネル」のように見えるますが下のほうに移動してるだけでした。
270と同じように下から上にドラッグすると表示物が見えるようになります。

272:デフォルトの名無しさん
09/08/08 18:05:25 .net
保守

273:デフォルトの名無しさん
09/08/08 18:32:18 .net
Windows XP SP2, doxygen 1.5.9です。

URLﾘﾝｸ(loda.jp)
このSample.hを同じくこのDoxyfileで
HTMLドキュメント化したのですが、
文字サイズが小さくて困っております。
DOT_FONTSIZE = 100
FORMULA_FONTSIZE = 100
の様にしてみても、フォントサイズが変わりません。

sakura-editor: クラス CDlgCancel
URLﾘﾝｸ(sakura-editor.sourceforge.net)
ここにあるような
文字サイズにしたいのですが、どうすればよろしいでしょうか？
よろしくお願い申し上げます。

274:デフォルトの名無しさん
09/08/08 20:32:24 .net
>>273
ドキュメント見てみたけど普通の文字サイズだと思うけど。
そういえば最近のバージョンはちょっと前のより文字サイズ小さいかも。

DOT_FONTSIZE はグラフの文字サイズ、FORMULA_FONTSIZE は式の文字サイズです。

文字サイズを変えるにはスタイルシートをカスタマイズすることになると思う。
やったことないけど、マニュアルによると、

doxygen -w html header.html footer.html stylesheet.css
でデフォルトのファイルを出力して、それを書き換えて

Doxyfile の HTML_STYLESHEET でそのファイルを指定するらしいです。

275:273
09/08/08 21:27:14 .net
>>274
その方法で解決できました。
文字サイズは見る人によって好みがあると思っていましたので、
stylesheet.cssのフォントサイズ指定の部分を削除しました。
これにより人によって好みの文字サイズにブラウザ側で変更できるようになりました。
（前はブラウザ側でも文字サイズの変更が（通常操作の範囲では）できませんでした。）

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

276:デフォルトの名無しさん
09/08/12 12:31:12 .net
Doxygen
で表を表示する方法を教えてください。

URLﾘﾝｸ(www.doxygen.jp)
ここの<table>タグ以外にはありますか？

277:デフォルトの名無しさん
09/08/12 12:45:02 .net
Doxygenはドキュメント生成ツールであってドキュメント記述言語ではないから
適宜表は表示されるよ。例えば関数一覧とかファイル一覧とか。

任意の表を記述したいと言うことなら話は別で。
元々html自体に表を記述するタグはtable以外にはないに等しいからねぇ。
横方向に高々2カラムしかないなら<ul>などで代用できなくもないけれど。

278:276
09/08/12 13:14:58 .net
>>277
ありがとうございます。
良さそうなのでもうすこしマニュアルを読み込んできます。

279:デフォルトの名無しさん
09/08/14 02:53:06 .net
>>276-278
私も任意の表をお手軽に作る方法はないかなと思ってました。

今ふと思いついたんですが、関連のタグの組み合わせをALIASESで簡略化したらちょっとはマシかも。

280:デフォルトの名無しさん
09/08/21 00:30:09 .net
保守

281:デフォルトの名無しさん
09/08/22 01:18:19 .net
Doxygen 1.6.0 age

282:デフォルトの名無しさん
09/08/22 16:54:46 .net
Doxygen 1.6.0で何か変わったことある？
設定とかは変わってないよね？
また設定しなおしとか嫌よ。

283:デフォルトの名無しさん
09/08/23 04:04:54 .net
>>282
二重引用符で囲っていた中で @a とか使ってたのが利かなくなってましたorz
まんま " @a hogehoge "な具合に表示されてます。

バグなのか仕様変更なのかは知りません。

284:282
09/08/23 11:47:44 .net
>>283
ありがとうございます。
私は＠ではなく＼で書いているので問題ないですかね。

285:283
09/08/23 19:42:34 .net
>>284
それは試してないのでわかりません。

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

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

286:283
09/08/23 19:45:40 .net
>>285
あ、「”」の代わりに「＆ｑｕｏｔ；」です。
(今度はちゃんと表示されるかな)

287:282
09/08/23 20:21:51 .net
>>285-286
なるほど。
詳細誠にありがとうございます。

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

288:283
09/08/24 02:03:19 .net
補足です。

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

289:どｘｙげん
09/08/24 10:56:52 .net
doxygenで生成される、
左側の目次（ツリービュー）を自分が好きに
並べる方法している方いらっしゃいませんか？

誰か教えてください。

290:デフォルトの名無しさん
09/08/25 22:33:39 .net
Doxygen 1.6.1 age

291:デフォルトの名無しさん
09/08/29 14:36:45 .net
Windows XP SP2, doxygen 1.6.1です。
URLﾘﾝｸ(loda.jp)

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

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

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

292:デフォルトの名無しさん
09/09/01 09:31:19 .net
>>291
lodaの方にコメントついてる。

293:291
09/09/01 18:05:12 .net
2chの方ばかり見ておりました。
ありがとうございます。

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

URLﾘﾝｸ(loda.jp)
で質問させていただいている者です。

295:デフォルトの名無しさん
09/09/02 01:21:01 .net
>>294
lodaのコメントは、行頭に「\」や「!」を入れるのが
大文字化されないための書き方という意味じゃなくて、
文の先頭にクラス名がこない書き方を工夫すればという意味だと思う。

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

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

296:291
09/09/02 06:54:56 .net
>>295
私もバグではなく仕様だとは思っています。

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

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

297:デフォルトの名無しさん
09/09/04 08:46:55 .net
プログラミング言語によっては全角文字も識別子に使えることを考えると、
文中に空白で区切られずに書かれてる識別子を正しく認識して欲しいというのは、
日本語の構文を理解する必要のある無茶な要求じゃないかな。

298:デフォルトの名無しさん
09/09/04 12:51:33 .net
そうか？
別に煽りたい訳じゃ無いけど、消えてしまうのは文字コードの問題だと
考えるのが普通では？
だって構文解析いらないでしょ。

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

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

300:デフォルトの名無しさん
09/09/10 14:47:25 .net
1.6.1を入れたのだけど、doxywizardで項目名が赤くなるのはどういう意味？

301:デフォルトの名無しさん
09/09/10 19:41:01 .net
>>300
1.6.1前からでも赤くなかった？
おそらくデフォルト値から変更された物が赤いんじゃないかと思われる。

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

303:デフォルトの名無しさん
09/09/14 00:04:39 .net
Javaで使っているのですが、クラス階層図や関数の呼び出し図などで、
クラス名がパッケージ名を含む長い名前になるのを避ける方法はあるでしょうか？
例えば、以下のサンプルですと、図からorg.byteml.の部分を取り除きたいです。
URLﾘﾝｸ(byteml.sourceforge.net)

304:デフォルトの名無しさん
09/09/16 00:28:43 .net
doxygenで、C++でhtmlドキュメントを作りたい時、
　ここからここまでの範囲のソースはドキュメントしないでね
あるいは
　このクラスはドキュメント化しないでね（ドキュメントに載せないでね）
といった指示はできるのでしょうか？

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

305:デフォルトの名無しさん
09/09/16 03:34:57 .net
>>304
素直な方法は、ドキュメント化したい部分に一通りdoxygen用のコメントをつけて、
EXTRACT_ALL は NO にして、
HIDE_UNDOC_MEMBERS と HIDE_UNDOC_CLASSES を YES にすることでしょうか。

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

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

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

307:デフォルトの名無しさん
09/09/17 01:10:31 .net
>>306

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

#ifndef NO_DOXYGEN
実装用クラス
#endif

とか私はやってます。

308:306
09/09/17 06:59:25 .net
>>307
ありがとうございます。
そんな方法があったんですね。

309:307
09/09/17 16:45:15 .net
>>308

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

310:306
09/09/17 21:03:18 .net
>>309
なるほど、深いですね。
面白そうです。
ありがとうございます。

311:306
09/09/18 00:20:10 .net
#ifndef DOXYGEN
実装用クラス
#endif
としてみましたが、
クラス一覧に相変わらず実装用クラスが出力されます。

　doxygen 1.6.1, Windows XP SP2
Doxyfileは
　URLﾘﾝｸ(loda.jp)
です。

恐れ入りますが、>>307さんのdoxygenのバージョンはいくらでしょうか？

312:306
09/09/18 00:20:56 .net
ちなみにちゃんと
#ifndef DOXYGEN
になっています。
#ifdef DOXYGEN
だったりはしません。
よろしくお願いいたします。

313:307
09/09/18 01:26:34 .net
>>311-312

doxyfile 拝見しました。
1312 行目の EXPAND_AS_DEFINED の方にマクロ名が記述されて
いるようなんですが、これを 1305 行目の PREDEFINED の方に
記述して試してもらえますか？

ちなみに、私が使用している環境は 1.6.1 で
OS は主に Mac OS X と FreeBSD です。
(一昨日くらいまで 1.5.9 使ってましたけど。)
あ、でも doxyfile は 1.5.8 の時につくったものでした。

314:デフォルトの名無しさん
09/09/18 09:44:38 .net
>>312
お前、馬鹿だろw
>307を読めば判ることで何とち狂ってるんだか。

315:306
09/09/18 11:12:07 .net
>>313
申し訳ございません。
ご指摘の通り大変みっともない間違いをしでかしており、
恥ずかしいかぎりです。

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

316:デフォルトの名無しさん
09/09/18 12:01:39 .net
URLﾘﾝｸ(codepad.org)
これをdoxygenに食わせると、
クラス->構成のところで
　exception
　NS::hoge
となります。
　画像：URLﾘﾝｸ(imagepot.net)
つまり何故かstd::が出力されません。
（解説本文にはstd::が出力されるのですが。）

これを
　std::exception
　NS::hoge
と表示させたいのですが、何か方法はありますでしょうか？

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

317:307
09/09/18 12:08:01 .net
>>314

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

>>315

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

318:デフォルトの名無しさん
09/09/18 12:25:36 .net
doxygen 1.5.8を使っているんだけど、例えばstd::vector<std::vector<int>>が通らないのね。
きちんと> >にしないといけないらしい。

319:デフォルトの名無しさん
09/09/18 12:55:10 .net
>>318
C++はC++0xになるまではそうでしょ？
コメント文でもそうだってことかい？

320:デフォルトの名無しさん
09/09/18 12:57:05 .net
>>319
いやいや、会社でほたえちょる阿呆がおったからソースを見たら、>>で書いていたってことで。
それで気づいたんだが、VC++はエラーにしてくれないんだね。

321:デフォルトの名無しさん
09/09/18 13:47:50 .net
>>320
そうなのか。
まあどうせC++0xでは認められるんだから
VC++もエラーじゃなくていいんじゃね。

322:デフォルトの名無しさん
09/09/18 17:00:22 .net
URLﾘﾝｸ(www.doxygen.jp)
これで生成した
URLﾘﾝｸ(www.stack.nl)
ですが、
今のdoxygen 1.6.1で実行しますと
　Public Member Functions
や
　Group2
等のグループ名が改行の余白無く上にくっついて表示されませんか？
URLﾘﾝｸ(www.doxygen.jp)に限らず任意のファイルを
htmlにしても起こると思うのですが、皆様はどうでしょうか？

323:デフォルトの名無しさん
09/09/19 12:08:12 .net
>>322
私の方でも同じ現象が出てます。
自分の書き方が悪いのかもと思いつつ、
ほとんど追求してませんでしたけど。

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

325:デフォルトの名無しさん
09/09/20 11:44:49 .net
> 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にしてしまえば良いわけでしょうか？
それとも何がデメリットがあるのでしょうか？

326:デフォルトの名無しさん
09/09/23 01:46:24 .net
>>325
Doxywizard で、 BUILTIN_STL_SUPPORT にカーソルを持っていったときに
表示される説明は、もう少し分かりやすいです。
STL のクラスを使ってるけど STL のソースをインクルードしたくない場合に
YESにするようにと書いてます。

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

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

327:325
09/09/23 11:39:21 .net
>>326
ありがとうございます。

ちなみに
Yahoo!検索 - BUILTIN_STL_SUPPORT
URLﾘﾝｸ(search.yahoo.co.jp)
こんな感じになりました。
どうやら大半の方がデフォルト値のNOにしているようです。

328:316
09/09/26 18:13:55 .net
どなたか>>316の解決策をご教示いただける有識者はいらっしゃいませんでしょうか？

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

329:デフォルトの名無しさん
09/09/26 19:33:05 .net
>>316
その参照してるだけで定義の無いexceptionをエントリとして出せるオプションがあるの？

330:316
09/09/27 01:04:43 .net
>>329
HIDEUNDOCMEMBERSをNoにして、出力させるとこうなりました。

331:316
09/09/27 10:43:25 .net
>>329
EXTRACT_ALL は NO
HIDE_UNDOC_MEMBERS は YES
HIDE_UNDOC_CLASSES は NO
でした。

332:デフォルトの名無しさん
09/09/27 13:24:58 .net
/** \page hojodocs 補助ドキュメント
*/
としますと
URLﾘﾝｸ(uploader.rgr.jp)
の様に
「メインページ」「クラス」「ファイル」というタブと並んで「関連ページ」というタブが出来て
その中に補助ドキュメントというページが出来ます。

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

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

よろしくお願いします。

333:デフォルトの名無しさん
09/09/27 21:39:45 .net
>>331 うちではexceptionクラスそのものが出なかった。

334:316
09/09/27 22:56:11 .net
>>333
左様でございましたか。失礼いたしました。

私の環境は
　doxygen 1.6.1, Windows XP SP2
で, Doxyfile, hoge.h, 成果物htmlは
　URLﾘﾝｸ(loda.jp)
です。
お手数おかけ致しますが、こちらでいかがでしょうか？

335:デフォルトの名無しさん
09/10/01 01:53:57 .net
>>304-315
今更だけど、別の方法があったので。
@cond と @endcond で囲んだ範囲は、
@cond につけたラベルを ENABLED_SECTIONS に含めるかどうかで、
ドキュメント化するかどうかを設定できるようです。

336:デフォルトの名無しさん
09/10/01 10:49:27 .net
>>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なので念の為。

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

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

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

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

340:304
09/10/06 18:24:02 .net
>>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 */

341:339
09/10/06 18:54:46 .net
>>340
さすがに両方の説明を個別に表示することは出来ませんが，それで事足りますね。
ありがとうございました。

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

#define __FASTCALL "" or __fastcall

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

342:デフォルトの名無しさん
09/10/07 04:18:00 .net
>>338
/// @def __FASTCALL
/// ここに両方の場合の説明を書けばいいんじゃないの？

343:デフォルトの名無しさん
09/10/07 04:18:44 .net
__FASTCALL は C++ では予約識別子だな。やめといたほうがいいぞ。

344:デフォルトの名無しさん
09/10/07 06:37:33 .net
確かに。
予約されているから規格的に言えば未定義の動作になるな。

345:339
09/10/07 10:26:51 .net
>>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
大文字の方も予約されてるとは知らなかった。ありがと～。

346:デフォルトの名無しさん
09/10/07 10:48:29 .net
>>345
メチャクチャな説明がわかりやすいとか、おかしなことを言うね。
実用上問題なければ奇怪な書き方しないほうがいいだろうと思うし。

347:340
09/10/07 18:07:29 .net
>>346
別にメチャクチャはまあ言葉のあやなんじゃないですかね。

オフィシャルでも
URLﾘﾝｸ(www.stack.nl)
> You can even `abuse' doxygen for creating normal documentation (as I did for this manual).
と言っているぐらいですし
多少の奇怪な書き方は許容範囲では？
タダの宗教論争になってしまいますが。

348:デフォルトの名無しさん
09/10/07 18:58:23 .net
>>347
それを指摘するのは無粋。つーか、間抜け。

349:デフォルトの名無しさん
09/10/08 01:46:49 .net
>>347
許容範囲なんだろうけど、ここでは奇怪な書き方をする必要がない、という話。

350:デフォルトの名無しさん
09/10/10 07:47:27 .net
>3
URLﾘﾝｸ(stackoverflow.com)
なさそうだね

351:デフォルトの名無しさん
09/10/13 10:41:56 .net
寧ろ、doxygen.cssをカスタマイズしている人には紹介してほしいなぁ。
ソースを公開しろとまでは言わないから。
後は、こんなのが欲しいなんてリクエストでもあれば創造意欲が沸くかも知れない。

352:デフォルトの名無しさん
09/10/13 21:08:49 .net
しかしデフォルトのにしておかないと
将来のバージョンアップに毎回追随するのが
結構つらくなるのではと予感。

353:デフォルトの名無しさん
09/10/17 13:41:17 .net
バージョンアップでかっこよくなったりするし

354:デフォルトの名無しさん
09/10/18 10:45:33 .net
URLﾘﾝｸ(www.doxygen.jp)
このサイト死んだね。

355:デフォルトの名無しさん
09/10/18 11:55:33 .net
う、うん……(´・ω・｀)

356:デフォルトの名無しさん
09/10/18 22:36:09 .net
>>354
生き返った。
良かった良かった。

357:デフォルトの名無しさん
09/10/28 15:51:53 .net
privateなメンバのうち、(純粋)仮想関数だけをドキュメントに出力する方法ってないものでしょうか
EXTRACT_PRIVATE = YESとすると、見せたくないprivate変数や非仮想関数まで出てきてしまうのがイヤで・・・

358:デフォルトの名無しさん
09/10/28 23:24:18 .net
>>357
そんな状況いままで無かったからな。
初めて考えてみる。

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

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

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

あ、どっちも1.6.1の話ね

361:デフォルトの名無しさん
09/12/05 12:30:58 .net
>>360
> クラスメソッドの詳細の、“コンストラクタ・デストラクタ”のセクションに
> デストラクタが入らないのはdoxygenのバグだよね？
マジで？
試してくる。

362:361
09/12/05 12:35:42 .net
>>360
Version 1.6.1 にて出力されたぞ。

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

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

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

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

365:デフォルトの名無しさん
09/12/14 10:46:24 .net
このQtのマニュアルみたいなのを作りたいのですがdoxygenで作れますか。
URLﾘﾝｸ(www.kde.gr.jp)

366:デフォルトの名無しさん
09/12/14 14:13:25 .net
>>365
似たようなことはできると思いますが、一致度は保証できません。
TradeMarkとやらで作ったようなことが書かれているので、それでは如何ですか?

367:デフォルトの名無しさん
09/12/17 02:23:51 .net
>>365-366
Qtのマニュアルは開発元内製の非公開のツールで作られているそうです。
doxygenが作られたのもそれが理由だそうで。
URLﾘﾝｸ(lists.trolltech.com)

368:デフォルトの名無しさん
09/12/18 13:27:05 .net
素敵なcssがほしい。

369:デフォルトの名無しさん
09/12/24 13:46:58 .net
EXTRACT_PRIVATE = NO の設定で一部の private 関数を文書化する方法はあるでしょうか？
やりたいことは、ある基底クラスに private の仮想関数を定義して (派生クラスでその仮想関数
をオーバーライドするユーザーのために) その関数の仕様を Doxygen で出力することです。

370:デフォルトの名無しさん
09/12/24 21:33:52 .net
>>369
ちょっと汚いソースになる気もするが、
>>340と同じようにして
Doxygen上にだけprivateをpublicにしちゃえば？

371:デフォルトの名無しさん
09/12/29 09:09:16 .net
URLﾘﾝｸ(uploader.rgr.jp)
このように、ソース中の'が'と表示されてしまうんですが、
対策をご存じの方いらっしゃいますか？
また、他の方がたはこの問題が再現しますか？

サンプルソースは
　URLﾘﾝｸ(uproda.2ch-library.com)
　DLキーはdoxygen
です。
ここのget_widechar.hをDoxygenにかけてhtmlを出力させると
上述の画像のようになります。

372:デフォルトの名無しさん
09/12/29 09:40:19 .net
html4ではなくxml1の読めるブラウザを使えばいいんでない?
# 根本は解決していないけど。
例えば、IE6がこれに該当するからIE8を入れるとか。
どうしても根本的に解決したいなら、ソースを修正するとか出力を加工するとか。

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

373:デフォルトの名無しさん
09/12/29 12:07:45 .net
>>372
確かにIE6で見ていたらだめでしたが、
Firefoxなら正しく表示されました。

ソースは
URLﾘﾝｸ(codepad.org)
で、Doxygenは1.6.1です。
設定は
DOXYFILE_ENCODING = CP932
OUTPUT_LANGUAGE = Japanese
このぐらいです。

374:デフォルトの名無しさん
09/12/29 13:06:29 .net
手元の1.5.9じゃ再現できないや。1.6.1持ちか詳しい人待ちだな。

375:デフォルトの名無しさん
09/12/29 16:06:24 .net
>>374
意外に1.5.9って1.6.1より動作安定してたりしますよね。

ちなみに画像
URLﾘﾝｸ(uploader.rgr.jp)
を出力したhtmlファイル（の一部）は
　URLﾘﾝｸ(codepad.org)
こんな感じで、この中にある
　'
となっている部分を単純に
　'
に置換してしまえば
IE6, Firefoxともに問題無く表示出来る様です。

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

376:デフォルトの名無しさん
09/12/29 16:51:13 .net
html4.01にはaposがないんだからしょうがないんじゃない?

377:デフォルトの名無しさん
09/12/29 17:23:37 .net
>>376
俺のところのIE6ってそんな準拠性の悪いクソブラウザだったんですか。
噂には聞いていたんですがねぇ。

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

378:デフォルトの名無しさん
10/01/03 02:55:32 .net
Doxygen 1.6.2 age

379:デフォルトの名無しさん
10/01/03 21:21:40 .net
>>378
まぢすか
入れてきます！

380:379
10/01/03 23:52:47 .net
仕様変わりすぎだよチクショー！！！！！

381:デフォルトの名無しさん
10/01/04 00:08:12 .net
doxygen.css
の仕様が変わりすぎでございますorz

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

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

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

383:デフォルトの名無しさん
10/01/06 14:43:02 .net
>>382
まだ正月休み明けでみなさん忙しいのでは。
私も先ほどようやく試してみたところ。

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

384:>382
10/01/06 20:01:55 .net
>>383
ありがとうございます。

そうですか。
>>324->>324は気付きませんでした。
じゃあやっぱ1.6.2で同じように作れるように自分でどうにか工夫するのが良い
って感じですかね。（私の主体性０）

385:>382
10/01/06 20:19:19 .net
ちなみに
　Doxyfile 1.6.1 デフォルト
　URLﾘﾝｸ(codepad.org)
　Doxyfile 1.6.2 デフォルト
　URLﾘﾝｸ(codepad.org)

386:デフォルトの名無しさん
10/01/23 09:24:51 .net
1.6.2に更新したら、pageコマンドから作られたhtmlにタイトルが出力されなくなった…
似たような症状の人いる？

387:382
10/01/23 20:33:41 .net
>>386
おお！
俺も！俺も！
どうすりゃいいんだろうorz

388:デフォルトの名無しさん
10/01/26 07:47:54 .net
>>386-387
pageに付ける名前に英数字以外(下線とか)を含まないように、
というようなことがMLに書かれてました。

389:387
10/01/29 00:03:56 .net
まじか！
>>388
ありがとうございます。
感謝です。。。

390:デフォルトの名無しさん
10/01/29 04:03:10 .net
>>388
トンクス！表示されたぜ！

ML見てきたんだが、
>ドキュメントにアンダーバー不許可と明示されてはいないけど、
>名前は英文字と数字の組み合わせからなる、とは書かれていて、
>そこにアンダーバーは含まれていないでしょ。
みたいな返答だった。

でも以前は使えてたわけだし、@page以外のタグは問題ないし、
ドキュメントが更新された形跡もないし、やっぱなんかバグっぽいよね。

391:デフォルトの名無しさん
10/01/29 06:34:03 .net
>>390
このまま待機で、いつの間にか
(次のverで)修正されるんじゃないかなぁ？

次のverっていつでるんだ。。。

392:デフォルトの名無しさん
10/01/30 15:04:22 .net
>>391
Bugzilla 見たら、次のバージョンで修正されることになってました。
私も別のバグで次のバージョン待ちです…

393:デフォルトの名無しさん
10/01/30 15:52:25 .net
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)

394:>387 >393
10/01/30 15:57:14 .net
ということで、次にリリースされるのは
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氏の解決策に乗っかろうかなぁ。。。

395:394
10/01/30 23:27:05 .net
＜報告＞
英数字どころか、小文字じゃないとダメみたいです。
AbCdE
とかはだめで、
abcde
ならOKのようです。

396:デフォルトの名無しさん
10/02/06 23:10:09 .net
死亡回避age

397:デフォルトの名無しさん
10/02/09 21:40:07 .net
Doxygen Release 1.6.2 + WinXPです。

URLﾘﾝｸ(codepad.org)
これを出力させると
URLﾘﾝｸ(uploader.rgr.jp)
このように、inlineでもないのに勝手にinlineになります。
なお、
URLﾘﾝｸ(codepad.org)
のように、テンプレートでなければ勝手にinlineにはならないようです。
URLﾘﾝｸ(uploader.rgr.jp)

同じ症状の方いらっしゃいますか？

398:397
10/02/09 21:40:49 .net
あと、もし古いバージョンで試してくださる方がいらっしゃったら
是非結果を教えてください。
よろしくお願い申し上げます。

399:397
10/02/11 20:12:03 .net
Graphviz - Graph Visualization Software
が最新版でました！version 2.26.3 になりました。

・・・そしてインストールしたらエラーになったので、
同じ症状で悩んでいる方がもしいらしたら参考にしてください。
解決策のリンク
URLﾘﾝｸ(old.nabble.com)

************************************************************************
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:デフォルトの名無しさん
10/02/21 22:45:41 .net
Doxygen 1.6.3 age

401:デフォルトの名無しさん
10/02/21 23:26:54 .net
>>400
ktkr
使います

402:397
10/02/26 06:35:09 .net
>>397のバグですが、
Doxygen 1.6.3 で直っていないようです。

バグ報告しないと直らないんですかねぇ。
どこからバグ報告すればいいやら。

403:デフォルトの名無しさん
10/02/27 21:06:19 .net
Doxygen 1.6.3 で
@pageで生成したページのタイトルが付かないバグ
は、解決しているようですね。

404:デフォルトの名無しさん
10/03/08 15:44:01 .net
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に日本語を設定したら反映されます。

何か他に設定する必要があるのでしょうか？

405:デフォルトの名無しさん
10/03/09 00:33:11 .net
>>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 にしないと正しく動作しないはずなので。

406:デフォルトの名無しさん
10/03/10 16:41:23 .net
>>405

ソースファイルを確認したところ、
新規に追加したものはSHIFT_JISだったのですが、
もともとあったソースは中国語のソースで、文字コードが"繁体字中国語"というもののようで、
このファイルを解析する時に、SHIFT_JISでないということで、エラーになるようです。

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

407:デフォルトの名無しさん
10/03/10 20:58:58 .net
中国語か。
最近ちらほら見かける。

408:デフォルトの名無しさん
10/03/18 09:48:49 .net
こんなの作ってみた。良かったら使ってみて。

つ URLﾘﾝｸ(sourceforge.jp)
　 URLﾘﾝｸ(sourceforge.net)

今のところWindows専用だけど，Qtで作ってるのでLinuxでもビルドできるはず。
俺はWindowsオンリーなので，誰か手伝ってくれると助かるんだけど．．．

409:デフォルトの名無しさん
10/03/18 10:17:11 .net
>>408
ほー。そういう着眼点か。

そのdoxygemplateなら、
WindowsビルドしかなくてもLinuxでもWineを使えば普通に動きそうだ。

410:デフォルトの名無しさん
10/03/19 02:55:22 .net
どげなもんなのか、簡単に解説頼む。

411:408
10/03/19 07:27:50 .net
>>409
レスサンクス。

> WindowsビルドしかなくてもLinuxでもWineを使えば普通に動きそうだ。

Linuxのことは知らないのでググってみｔけど面白そう。
タスクトレイもちゃんと使えるの？

>>410
使い方を簡単に言うと、

・起動するとタスクトレイに常駐する。

・エディタで編集中のC/C++のソースの関数宣言（.hでの定義部でも.cや.cppの実装部
　でもOK）をクリップボードにコピーする。宣言の頭から、引数リストの閉じカッコまでが
　入ってればOK。それ以降は入っていても構わないが無視される。

・タスクトレイのアイコンを右クリックして「テンプレート編集」を選ぶと、編集画面が
　現れる。この段階で既に関数の引数やリターン値を解析して、retval コマンド
　とリターン値の型や、param コマンドと引数名が作成されている。
　この画面で param コマンドの[in]⇔[out]⇔[in,out]を切り替えたり、
　行の削除／追加や、details など幾つかのコマンドの追加が出来る。

・編集が終わったら「クリップボード保存」を押すと編集した内容が
　クリップボードにコピーされ、編集画面が閉じる。

・テキストエディタで関数宣言の上にクリップボードから作成されたテンプレートを
　ペーストする。

こんな感じ。

次ページ