無いので建てた
公式
http://www.doxygen.jp/
【コメント】doxygen【コンソメ】
■ このスレッドは過去ログ倉庫に格納されています
2008/05/30(金) 19:50:27
2008/10/25(土) 17:40:51
そもそもC言語にメンバ関数は無いんだからdoxygenのバグとも言えるだろ
想定外の構文には警告なりエラーなり出して欲しいよな
想定外の構文には警告なりエラーなり出して欲しいよな
2008/10/26(日) 00:08:33
例えば@paramとかって変えられないの?
97デフォルトの名無しさん
2008/11/08(土) 17:25:21 mac osx 10.5.5
doxygen 1.5.7.1
で実行しようとすると、Failed to run doxygen と言われて一切実行できません。
対処法知っている方、教えて下さい。
doxygen 1.5.7.1
で実行しようとすると、Failed to run doxygen と言われて一切実行できません。
対処法知っている方、教えて下さい。
2008/11/19(水) 23:51:11
クラス関連図って作れますか?
1クラスの構造を図にはできるみたいですが・・・
C++です。
1クラスの構造を図にはできるみたいですが・・・
C++です。
2008/11/20(木) 00:02:36
graphvizがあればできるよ。
100デフォルトの名無しさん
2008/12/17(水) 20:18:15 @dateの後ろに付ける日付をsubversionが自動更新してくれるように
$Date$にしたら、出来たhtmlで日付の見出しが2重になってました。
もしかしてバージョン管理システムのキーワードをdoxygenが認識して
適当に見出し付きで整形してくれるんでしょうか。
マニュアルにそれらしい説明を見た覚え無いんですが。
$Date$にしたら、出来たhtmlで日付の見出しが2重になってました。
もしかしてバージョン管理システムのキーワードをdoxygenが認識して
適当に見出し付きで整形してくれるんでしょうか。
マニュアルにそれらしい説明を見た覚え無いんですが。
101デフォルトの名無しさん
2008/12/21(日) 21:45:55 公式とかで、きちんとした例が*.hしかないと思うのは気のせい?
102デフォルトの名無しさん
2008/12/23(火) 01:27:13 ちょっとメモ。
doxygenで出力したRTFがどうも文字化けするので調べてみたら、\\'を\\\'に変換することで解消することが判った。
要は\を表すのにそれ自身をエスケープして\\とする必要があると言うことなのだろうか。もうちょい調べる必要はありそう。
doxygenで出力したRTFがどうも文字化けするので調べてみたら、\\'を\\\'に変換することで解消することが判った。
要は\を表すのにそれ自身をエスケープして\\とする必要があると言うことなのだろうか。もうちょい調べる必要はありそう。
103デフォルトの名無しさん
2008/12/27(土) 23:00:37 日本語がうまく通らない原因ってどこにあるの?
104デフォルトの名無しさん
2008/12/28(日) 00:28:11105デフォルトの名無しさん
2008/12/28(日) 04:51:23 Doxygen 1.5.8 age
106デフォルトの名無しさん
2008/12/28(日) 05:06:03 アップデートコネーから自分で作るか…
107デフォルトの名無しさん
2008/12/28(日) 09:17:52 >>101
ヘッダーに書けば十分だからじゃないかな。
でも、詳細をヘッダーに長々と書いてヘッダーが読みにくくなりそうなときは、詳細だけcppに分けて書くことはあるよ。それでもdoxygenはちゃんとまとめてくれる
ヘッダーに書けば十分だからじゃないかな。
でも、詳細をヘッダーに長々と書いてヘッダーが読みにくくなりそうなときは、詳細だけcppに分けて書くことはあるよ。それでもdoxygenはちゃんとまとめてくれる
108101
2008/12/28(日) 15:47:03109デフォルトの名無しさん
2008/12/28(日) 19:40:09110102
2008/12/29(月) 14:53:28 更に追加。他にも、エスケープすべき文字をエスケープしていない箇所を発見。
xyzzyの場合の正規表現置換でこれを行なうとかなり改善する。
(query-replace-regexp "\\(\\\\'..\\)\\([{}][^
][^t]\\)" "\\1\\\\\\2")
# 場当たり的だなぁ……
xyzzyの場合の正規表現置換でこれを行なうとかなり改善する。
(query-replace-regexp "\\(\\\\'..\\)\\([{}][^
][^t]\\)" "\\1\\\\\\2")
# 場当たり的だなぁ……
111102
2008/12/29(月) 14:56:31 あー、済まない、補足。
文字列中に出てくる「{」も「}」も、どちらもエスケープしなければならないと言うのが>110の対応。
但し、文字列中かどうかの判断を厳密に行ないたくないので手元のファイルで場当たり的に対応してある。
誰か、ソース拾ってきて対策してくれる奇特な人はいないもんかのぉ。
文字列中に出てくる「{」も「}」も、どちらもエスケープしなければならないと言うのが>110の対応。
但し、文字列中かどうかの判断を厳密に行ないたくないので手元のファイルで場当たり的に対応してある。
誰か、ソース拾ってきて対策してくれる奇特な人はいないもんかのぉ。
112デフォルトの名無しさん
2008/12/29(月) 16:04:40 >>111
文字列として表示されるべき「{」や「}」がエスケープされてないってこと?
いつもHTMLしか出してなかったんだけど、試しに手元にあるソースでRTF出してみたら、
こちらではリストをネストさせてるところで、上の階層の行末の書式文字の「{」が
普通の文字として扱われたりして、「{」と「}」の対応が崩れてエラーになってるっぽいです。
(いや、ネストされて表示はされてるから、書式文字以外に余分に「{」が付いてる?)
行末が特定の文字(「定」とか「得」とか)の場合になるみたいだけど、
条件がよくわかりません…
文字列として表示されるべき「{」や「}」がエスケープされてないってこと?
いつもHTMLしか出してなかったんだけど、試しに手元にあるソースでRTF出してみたら、
こちらではリストをネストさせてるところで、上の階層の行末の書式文字の「{」が
普通の文字として扱われたりして、「{」と「}」の対応が崩れてエラーになってるっぽいです。
(いや、ネストされて表示はされてるから、書式文字以外に余分に「{」が付いてる?)
行末が特定の文字(「定」とか「得」とか)の場合になるみたいだけど、
条件がよくわかりません…
113102
2008/12/29(月) 16:16:27 >>112
2バイト文字の2バイト目に{}\のいずれかが来るケースで、エスケープされないようです。
# 「定」「得」どちらも該当しないようですが……
処が文字列を明示的に区切らないのがRTFの仕様らしくて、キーワードとしての{や}と区別が難しいのですよ。
実は>102の対策だけだと{}の対応が崩れてしまってrtfの一部だけしか読み込まれないことが判って気づいたんですが。
# 客先に実態の1/3程度しか分量がない資料を提出しちゃったのは内緒w
念のため確認したら、手元のDoxygenはCygwin同梱の1.5.5でした。
# さて、rtfを変換するツールを真面目に作るのとdoxygenそのものを修正するのとどっちが楽だろかw
2バイト文字の2バイト目に{}\のいずれかが来るケースで、エスケープされないようです。
# 「定」「得」どちらも該当しないようですが……
処が文字列を明示的に区切らないのがRTFの仕様らしくて、キーワードとしての{や}と区別が難しいのですよ。
実は>102の対策だけだと{}の対応が崩れてしまってrtfの一部だけしか読み込まれないことが判って気づいたんですが。
# 客先に実態の1/3程度しか分量がない資料を提出しちゃったのは内緒w
念のため確認したら、手元のDoxygenはCygwin同梱の1.5.5でした。
# さて、rtfを変換するツールを真面目に作るのとdoxygenそのものを修正するのとどっちが楽だろかw
114デフォルトの名無しさん
2008/12/29(月) 16:26:38115デフォルトの名無しさん
2008/12/29(月) 17:54:50 cygwinの最新は1.5.5-1だね。
つまり、解決済みではないらしい。
つまり、解決済みではないらしい。
116デフォルトの名無しさん
2008/12/29(月) 18:19:03 cygwinは使ってないので、それが理由かどうかは知りませんが、
1.5.6から1.5.7.1まではフレーム付きHTMLのツリービューで
英数字以外が文字化けするという問題がありました。
2日前に出たばかりの1.5.8でやっと解決されました。
1.5.6から1.5.7.1まではフレーム付きHTMLのツリービューで
英数字以外が文字化けするという問題がありました。
2日前に出たばかりの1.5.8でやっと解決されました。
117デフォルトの名無しさん
2008/12/29(月) 19:13:27 >>115
Windows ネイティブ版を使えない理由があるの?
Windows ネイティブ版を使えない理由があるの?
118デフォルトの名無しさん
2008/12/29(月) 20:15:40119デフォルトの名無しさん
2008/12/29(月) 20:53:32 HTML だと問題ないってことかな? HTML しか使ってないからよくわかんないや。
120118
2008/12/29(月) 22:31:08 昔、1.4.6でRTFを作ったことのあるソースを、設定をほとんど変えずに1.5.8に掛けても駄目でした。
1.4.6で作ったRTFの半分ぐらいしかファイルサイズがありません。
むしろ内部処理が UTF-8 になってから、おかしくなったんじゃないかという気がしてきました。
1.4.6で作ったRTFの半分ぐらいしかファイルサイズがありません。
むしろ内部処理が UTF-8 になってから、おかしくなったんじゃないかという気がしてきました。
121デフォルトの名無しさん
2008/12/29(月) 23:06:51 折角色々対応してあったのを、UTF-8にしたのを機に捨ててしまったような感じだな。
この正月休みの間に暇があるようならソースでも見てみるか。
この正月休みの間に暇があるようならソースでも見てみるか。
122デフォルトの名無しさん
2008/12/30(火) 01:23:34 過去のバージョンを取ってきて順に試してみました。
1.5.0までは日本語の RTF が生成できて
(おかしなところが無いかまではチェックしてませんが)、
1.5.1で、
"Warning: Output language Japanese not supported! Using English instead."
と表示され、日本語が表示できませんでした。
ここで一旦無かったことにされたようです。
1.5.0までは日本語の RTF が生成できて
(おかしなところが無いかまではチェックしてませんが)、
1.5.1で、
"Warning: Output language Japanese not supported! Using English instead."
と表示され、日本語が表示できませんでした。
ここで一旦無かったことにされたようです。
123デフォルトの名無しさん
2008/12/30(火) 03:40:46 問題分かったかも。
id 437346 のバグレポートで日本語対応の議論がされてるんだけど、
報告者の人が提案した、
x080より大きいバイトが来たらマルチバイト判別フラグON、
次のバイトでフラグOFF、というのをそのまま採用してくれたらよかったのに、
0x80より大きいかの判断をそのままフラグに入れちゃってるから、
2バイト目が0x80より大きい場合に、その次のバイトまでエスケープされて、
それがエスケープされたら困るものの場合に不幸になってるということかと。
id 437346 のバグレポートで日本語対応の議論がされてるんだけど、
報告者の人が提案した、
x080より大きいバイトが来たらマルチバイト判別フラグON、
次のバイトでフラグOFF、というのをそのまま採用してくれたらよかったのに、
0x80より大きいかの判断をそのままフラグに入れちゃってるから、
2バイト目が0x80より大きい場合に、その次のバイトまでエスケープされて、
それがエスケープされたら困るものの場合に不幸になってるということかと。
124デフォルトの名無しさん
2008/12/30(火) 03:58:34 repopかければいいのに。
rtfって何で読めるんだろう。AbiWord?ooo?
rtfって何で読めるんだろう。AbiWord?ooo?
125デフォルトの名無しさん
2008/12/30(火) 08:55:13 >>123
事はそう単純じゃない。というか、もっと単純。
内部UTF-8をcp932に変換して、必要ならエスケープすべきなのにそれをしていないと言うのが>102=113の観測だろ。
例えば「ソソ」が「\'83\\\'83\\」にならないといけないのに「\'83\\'83\」になると。
それとも、二種類の問題が独立して存在しているのか?
事はそう単純じゃない。というか、もっと単純。
内部UTF-8をcp932に変換して、必要ならエスケープすべきなのにそれをしていないと言うのが>102=113の観測だろ。
例えば「ソソ」が「\'83\\\'83\\」にならないといけないのに「\'83\\'83\」になると。
それとも、二種類の問題が独立して存在しているのか?
126123
2008/12/30(火) 10:22:07127デフォルトの名無しさん
2008/12/30(火) 11:17:38 >>78
1.5.8で直った
1.5.8で直った
128デフォルトの名無しさん
2009/01/08(木) 07:49:37 とりあえず保守ですが、あけおめ。
日本語rtf使えるようになるといいですね
自分はまだ皆様のようにハックに参加できるほど技術がないので、精進したいと思います。
日本語rtf使えるようになるといいですね
自分はまだ皆様のようにハックに参加できるほど技術がないので、精進したいと思います。
129102
2009/01/08(木) 09:55:41 又更につまらない問題に遭遇。
折角修正したrtfがWordだと読めるのにOpenOfficeだと文字化けする。
例えば、「\'83\\」のような>125が指摘した例だと、「\'83\'5c」のようにしないといけないらしい。
あーもう、rtfを解析するしかないのかなぁ。
# doxygen1.5.8で変わっているらしいからそっちに手を出すのは避けたいし。
折角修正したrtfがWordだと読めるのにOpenOfficeだと文字化けする。
例えば、「\'83\\」のような>125が指摘した例だと、「\'83\'5c」のようにしないといけないらしい。
あーもう、rtfを解析するしかないのかなぁ。
# doxygen1.5.8で変わっているらしいからそっちに手を出すのは避けたいし。
130デフォルトの名無しさん
2009/01/08(木) 22:19:22 解決しました。ありがとうございました。
131デフォルトの名無しさん
2009/01/10(土) 14:59:07 1.5.8 のrtfのエスケープバグのソースって
どのファイルなのかな?
どのファイルなのかな?
132102
2009/01/10(土) 15:17:25 ちょっとLinuxに1.5.8をインストールしたので出力してみたが、これは酷いw
2バイト文字を全てコード出力しているのはいいが、>123のように無関係なコマンド文字まで巻き添えにしてしまっている。
おまけに、コマンド文字列を何故か\commentで括ってしまっているので収拾がつかない状態。
そうそう、html出力のツリービューも、(UTF-8)指定なのにも関わらずプロジェクト名がEUCで出力されるので化け化け。
誰かなんとかして〜w
# ってことで、>131に期待♪
2バイト文字を全てコード出力しているのはいいが、>123のように無関係なコマンド文字まで巻き添えにしてしまっている。
おまけに、コマンド文字列を何故か\commentで括ってしまっているので収拾がつかない状態。
そうそう、html出力のツリービューも、(UTF-8)指定なのにも関わらずプロジェクト名がEUCで出力されるので化け化け。
誰かなんとかして〜w
# ってことで、>131に期待♪
133デフォルトの名無しさん
2009/01/11(日) 01:06:49 うはw ぼくとしては>102さんに期待してるんだけどっw
134デフォルトの名無しさん
2009/01/12(月) 00:56:25135デフォルトの名無しさん
2009/01/12(月) 02:36:31 >>134 ソース位置ありがとう。
これって、よくわかってないけど、postProcess()で、ファイル全体を
エスケープしてるのかな。
もしそうなら、rtfでの表示される文字列以外も全部エスケープされて
しまい、上のバグが症状がでてるんじゃないかな?
rtf表示文字列だけをエスケープするようにするには、postProcess()
の中でやってちゃだめで、rtfgen.cpp(にあるか知らないけど)
で表示文字列をrtfタグ中に埋め込む時コード当たりでやらないといけなそう?
とりあえず、doxygenをWindowsでコンパイル出来る環境作り
からやらないといけないのが辛いorz
これって、よくわかってないけど、postProcess()で、ファイル全体を
エスケープしてるのかな。
もしそうなら、rtfでの表示される文字列以外も全部エスケープされて
しまい、上のバグが症状がでてるんじゃないかな?
rtf表示文字列だけをエスケープするようにするには、postProcess()
の中でやってちゃだめで、rtfgen.cpp(にあるか知らないけど)
で表示文字列をrtfタグ中に埋め込む時コード当たりでやらないといけなそう?
とりあえず、doxygenをWindowsでコンパイル出来る環境作り
からやらないといけないのが辛いorz
136デフォルトの名無しさん
2009/01/12(月) 08:13:44137134
2009/01/12(月) 21:40:12 >>135
0x80より大きい値とmb_flagが1のときだけエスケープされるはずです。
1.5.7.1以前のバージョンではmb_flagが無くて、0x80より大きい値という条件しかなかったので、
マルチバイト文字の2バイト目が「{」や「\」などの場合におかしくなってました。
mb_flagをマルチバイト文字の1バイト目で1にすれば、
次のバイトが0x80以下でもエスケープされるという仕組みのはずですが、
mb_flagの設定方法がまずくて、2バイト目でクリアされなくて
さらに次のバイトまでエスケープされる場合がある、という状況です。
ttp://bugzilla.gnome.org/show_bug.cgi?id=437346
で、T.Matsuyama氏が提示したコードが正しく動くはずです。
#そこまで分かってるな自分でやれ、と言われそうだ……
すいません、環境作りが荷が重いですorz
0x80より大きい値とmb_flagが1のときだけエスケープされるはずです。
1.5.7.1以前のバージョンではmb_flagが無くて、0x80より大きい値という条件しかなかったので、
マルチバイト文字の2バイト目が「{」や「\」などの場合におかしくなってました。
mb_flagをマルチバイト文字の1バイト目で1にすれば、
次のバイトが0x80以下でもエスケープされるという仕組みのはずですが、
mb_flagの設定方法がまずくて、2バイト目でクリアされなくて
さらに次のバイトまでエスケープされる場合がある、という状況です。
ttp://bugzilla.gnome.org/show_bug.cgi?id=437346
で、T.Matsuyama氏が提示したコードが正しく動くはずです。
#そこまで分かってるな自分でやれ、と言われそうだ……
すいません、環境作りが荷が重いですorz
138デフォルトの名無しさん
2009/01/14(水) 22:11:56 バグ修正版バイナリ出来たよん。
http://www1.axfc.net/uploader/He/so/182473&key=doxygen
T.Matsuyama氏パッチそのままです。
ばっちりっぽいです。
102さん、134さんありがとw
http://www1.axfc.net/uploader/He/so/182473&key=doxygen
T.Matsuyama氏パッチそのままです。
ばっちりっぽいです。
102さん、134さんありがとw
139デフォルトの名無しさん
2009/01/14(水) 22:17:06 おー、これは凄い。後で試してみるか。
140デフォルトの名無しさん
2009/01/27(火) 01:28:30 てか、>>137のURLが示すバグをreopenして開発者に教えてあげればいいんじゃないの?
アカウント持ってないから誰でもreopenできる設定なのかはわからないけど
アカウント持ってないから誰でもreopenできる設定なのかはわからないけど
141デフォルトの名無しさん
2009/01/27(火) 07:49:20 いかん、未だ試せてない……
142デフォルトの名無しさん
2009/01/30(金) 01:55:55 コメントが一切ついてないソースに
関数の定義部分だけ自動的に
タグを生成してくれるツールないですか?
関数の定義部分だけ自動的に
タグを生成してくれるツールないですか?
143デフォルトの名無しさん
2009/01/30(金) 02:14:58 >>142 ctags?
144デフォルトの名無しさん
2009/01/30(金) 07:39:05 >>142
このスレ的には、タグというとDoxyfileのタグのことになるのだがそれでいいのかい?
このスレ的には、タグというとDoxyfileのタグのことになるのだがそれでいいのかい?
145デフォルトの名無しさん
2009/01/30(金) 07:42:20 @が付くやつがいい
146デフォルトの名無しさん
2009/01/30(金) 08:23:53 ドキュメントつけしてない関数も出力するオプション?
147139
2009/02/15(日) 17:55:27 やっと>138を試せた。取り敢えず、cygwinからでも使えることと日本語が化けないことは確認した。
但し、OpenOffice(3.0)では{comment[^{}]}を取り除く必要があったこととTITLEなどのフィールドは
巧く変換できなかったけれど、これは元からそうなのかもしれない。
今度機会があれば、素直にMSwordに食わせてみるとしよう。
但し、OpenOffice(3.0)では{comment[^{}]}を取り除く必要があったこととTITLEなどのフィールドは
巧く変換できなかったけれど、これは元からそうなのかもしれない。
今度機会があれば、素直にMSwordに食わせてみるとしよう。
148139
2009/02/17(火) 18:58:43 cygwinで>138を動かし、できたRTFをWORD2000に食わせた。
全選択してフィールドの更新、画像アンリンクのマクロを動かして、
docに名前を変えて保存。一応、スタンダロンで使える資料になるようだ。
で、画像アンリンクのマクロって需要あるかな。あるようならどっかで公開するけど。
全選択してフィールドの更新、画像アンリンクのマクロを動かして、
docに名前を変えて保存。一応、スタンダロンで使える資料になるようだ。
で、画像アンリンクのマクロって需要あるかな。あるようならどっかで公開するけど。
149デフォルトの名無しさん
2009/02/28(土) 05:29:11 doxygenのライセンスってGPLですよね。
doxygenのコメントを書いたソースって公開しないと駄目ですか?
doxygenのコメントを書いたソースって公開しないと駄目ですか?
150デフォルトの名無しさん
2009/02/28(土) 05:39:00 ならないよ
GPLのお絵かきソフトで絵を描いたようなもん
GPLのお絵かきソフトで絵を描いたようなもん
152デフォルトの名無しさん
2009/03/03(火) 10:33:16 DoxyfileもGPLに該当しないのかな。
それとも、コメント部分は削除しておいた方が無難?
それとも、コメント部分は削除しておいた方が無難?
153デフォルトの名無しさん
2009/03/03(火) 22:08:28 ソフトのドキュメントを作るのにDoxygenを利用してもGPLにする必要なし。
ソフトの機能としてDoxygenを利用する場合はGPL。
ソフトの機能としてDoxygenを利用する場合はGPL。
154デフォルトの名無しさん
2009/04/06(月) 21:16:11 @a と @p ってどう使い分けてる?
どっちも文中の引数のフォントを変えるために使うものみたいだけど。
どっちも文中の引数のフォントを変えるために使うものみたいだけど。
155デフォルトの名無しさん
2009/04/08(水) 12:32:53 \aは「特殊なフォント」ということで一般的にはItalicかな。
\pは\cと等価で「タイプライタフォント」ということで等幅フォントが使われる。
後は、実際の出力を見て検討したら?
\pは\cと等価で「タイプライタフォント」ということで等幅フォントが使われる。
後は、実際の出力を見て検討したら?
156154
2009/04/09(木) 00:04:14 普通はどうする、ということは特になくて、見た目の好みで使えばいいのですか。
ヘルプを見ると、@aは "refer to member arguments" 、
@pは "refer to member function parameters" と書かれてて、
微妙に使い分けがあるようなないような、よく分からなかったもので。
ヘルプを見ると、@aは "refer to member arguments" 、
@pは "refer to member function parameters" と書かれてて、
微妙に使い分けがあるようなないような、よく分からなかったもので。
157デフォルトの名無しさん
2009/04/09(木) 07:14:32 意味で使い分ければいいと思う。
フォントとかの体裁はCSSで変えられるんじゃなかったかな?やったこと無いけど。
フォントとかの体裁はCSSで変えられるんじゃなかったかな?やったこと無いけど。
158デフォルトの名無しさん
2009/04/09(木) 08:11:53 @a の argument が実引数で @p の parameter が仮引数なわけだけど、
コメント中では仮引数しか現れない気がする。実引数が現れることなんてあるか?
コメント中では仮引数しか現れない気がする。実引数が現れることなんてあるか?
159デフォルトの名無しさん
2009/04/09(木) 09:06:56160デフォルトの名無しさん
2009/04/10(金) 04:10:58 member argumentがクラスのメンバー変数ってことはないかな。
161デフォルトの名無しさん
2009/04/10(金) 23:50:56162デフォルトの名無しさん
2009/04/25(土) 21:37:10 メソッドのコメントは、戻り値がなくても「@return なし」と明示的に書くべきでしょうか?
引数がない場合も同様に「@param なし」と書くでしょうか?
引数がない場合も同様に「@param なし」と書くでしょうか?
163デフォルトの名無しさん
2009/04/25(土) 21:38:20 前者はお好きにどうぞ。
後者は「なし」なんて引き数はないぞって警告が出るんじゃないかな?
後者は「なし」なんて引き数はないぞって警告が出るんじゃないかな?
164162
2009/04/25(土) 21:45:11165デフォルトの名無しさん
2009/04/30(木) 13:43:57 今の大会は、開発環境の違いによる面白さもあると思う。
共通スペックでやるなら別に大会をおこせばよいと思う。
共通スペックでやるなら別に大会をおこせばよいと思う。
166デフォルトの名無しさん
2009/04/30(木) 13:45:15 >>165
誤爆しました。すみません。
誤爆しました。すみません。
167デフォルトの名無しさん
2009/04/30(木) 23:56:10 Doxygen 1.5.9 age
168デフォルトの名無しさん
2009/05/01(金) 00:16:08 さっきまでは1.5.8だったのに。早速試すぜ。
169デフォルトの名無しさん
2009/05/12(火) 10:55:11 ソースの先頭のコメントの 理想的なサンプル を教えて。
言語は問わないけど、出来ればCで。
言語は問わないけど、出来ればCで。
170デフォルトの名無しさん
2009/05/12(火) 18:22:26 理想的かどうか知らんが、私の典型。
--
////////////////////////////////////////////////////////////////
/// \file foo.c
/// \brief あーたらこーたら
///
/// あーたらこーたらをあーたらこーたらするとかなんとか。
/// \date 2009/3-4
/// \author bar\@site
/// \attention なんだかんだ
/// \version hage.hige.hoge
//
--
--
////////////////////////////////////////////////////////////////
/// \file foo.c
/// \brief あーたらこーたら
///
/// あーたらこーたらをあーたらこーたらするとかなんとか。
/// \date 2009/3-4
/// \author bar\@site
/// \attention なんだかんだ
/// \version hage.hige.hoge
//
--
171デフォルトの名無しさん
2009/05/13(水) 04:06:28 >>169
とりあえず最小限はこうだろ。 JAVADOC_AUTO_BRIEF オンで。
/** @file
* 簡単な説明.
* 詳細な説明
*/
170 のやつだと、ファイル名はどうせ名前変更したときに更新し忘れるし、
日付や作者やバージョンはバージョン管理ソフトに任せればいい。
詳細な説明も attention も必要に応じて、だな。とにかく書かないで済むものは
書かないのが一番。
とりあえず最小限はこうだろ。 JAVADOC_AUTO_BRIEF オンで。
/** @file
* 簡単な説明.
* 詳細な説明
*/
170 のやつだと、ファイル名はどうせ名前変更したときに更新し忘れるし、
日付や作者やバージョンはバージョン管理ソフトに任せればいい。
詳細な説明も attention も必要に応じて、だな。とにかく書かないで済むものは
書かないのが一番。
172デフォルトの名無しさん
2009/05/13(水) 09:19:41173デフォルトの名無しさん
2009/05/13(水) 16:20:47 表書くのってtableタグ使うしかないんでしたっけ?
それだとソース上で見づらいんで、
リストみたいに簡易記法があればいいんですけど。
それだとソース上で見づらいんで、
リストみたいに簡易記法があればいいんですけど。
174デフォルトの名無しさん
2009/05/13(水) 22:00:48 doxygenって使ったこと無いんだけど、
ぶっちゃけて言うと、オススメですかい?
ぶっちゃけて言うと、オススメですかい?
175デフォルトの名無しさん
2009/05/13(水) 23:26:06176デフォルトの名無しさん
2009/05/14(木) 09:55:19178デフォルトの名無しさん
2009/05/14(木) 23:43:40179デフォルトの名無しさん
2009/05/14(木) 23:50:13 Graphvizの使い方が秀逸だと思う
これは出力結果を印刷してじっくり眺めたい
これは出力結果を印刷してじっくり眺めたい
181デフォルトの名無しさん
2009/05/15(金) 09:37:18 客先から小汚いソースを受け取ったら、取り敢えずDoxygenに掛けて
静的解析するのは基本だな。
静的解析するのは基本だな。
182デフォルトの名無しさん
2009/05/15(金) 10:09:23 >>171
subversionとかの置き換えキーワードもdoxygenは認識してドキュメント化してくれる。
subversionとかの置き換えキーワードもdoxygenは認識してドキュメント化してくれる。
183デフォルトの名無しさん
2009/05/21(木) 13:35:09 ちょっと詳しい説明を箇条書きで入れたいんだけど、
空白行が入るとパラグラフが終わってしまうので、空白行を一切入れないで
長い文章を書かなきゃいけなくなり、なんていうか
ソースコードのコメントが非常に見づらい。本末転倒な気がするんだけど、
空白行を無視してくれる方法とか、ない?
空白行が入るとパラグラフが終わってしまうので、空白行を一切入れないで
長い文章を書かなきゃいけなくなり、なんていうか
ソースコードのコメントが非常に見づらい。本末転倒な気がするんだけど、
空白行を無視してくれる方法とか、ない?
184デフォルトの名無しさん
2009/05/23(土) 02:32:07 >>183
ソースコード上でだけ行間が空いてればいいのなら、
全角スペースを入れておけばどうでしょう?
ドキュメント上で行が連結されたときに、余分な空白が入りますが。
ドキュメントでも行間が空くようにしたいのなら、
行頭の邪魔にならないところにでも「@n」を入れておくぐらいしか思いつきません。
ソースコード上でだけ行間が空いてればいいのなら、
全角スペースを入れておけばどうでしょう?
ドキュメント上で行が連結されたときに、余分な空白が入りますが。
ドキュメントでも行間が空くようにしたいのなら、
行頭の邪魔にならないところにでも「@n」を入れておくぐらいしか思いつきません。
185デフォルトの名無しさん
2009/05/24(日) 13:15:10 doxygenの文字化け対策
ttp://d.hatena.ne.jp/kmt-t2/20090403/1238718375
ここに救われた俺がいる。
ttp://d.hatena.ne.jp/kmt-t2/20090403/1238718375
ここに救われた俺がいる。
186デフォルトの名無しさん
2009/05/24(日) 14:01:52 doxygenであるライブラリのドキュメントを作った時、
そのライセンスってどこにどうやって記載すればいいの?
ドキュメント内に表示されるようにしたいんだけど。
そのライセンスってどこにどうやって記載すればいいの?
ドキュメント内に表示されるようにしたいんだけど。
187174
2009/05/24(日) 16:39:03 doxygen気に入ってきた。
C++とdoxygen最新版にて。
ドキュメント作ると名前解決に使う::がドキュメントにもりこまれたり盛り込まれなかったりする。
例えばNameS::MyClassが、
ドキュメントの100行目ではNameS::MyClassになっているのに
101行目ではNameSMyClassになっていたりする。
これはどう解決すればいい?
C++とdoxygen最新版にて。
ドキュメント作ると名前解決に使う::がドキュメントにもりこまれたり盛り込まれなかったりする。
例えばNameS::MyClassが、
ドキュメントの100行目ではNameS::MyClassになっているのに
101行目ではNameSMyClassになっていたりする。
これはどう解決すればいい?
188デフォルトの名無しさん
2009/05/25(月) 10:31:42 >>187
このレスの流れを見ても分かるように、Doxygenは文字コードの扱いが未だ未だ不安定だったりする。
あんたの言う、「ドキュメント」がrtf出力ならこのスレにある対策版を使ってみた方がいいかもしれないし、
chm出力なら>185を参考にするといいかもしれない。
このレスの流れを見ても分かるように、Doxygenは文字コードの扱いが未だ未だ不安定だったりする。
あんたの言う、「ドキュメント」がrtf出力ならこのスレにある対策版を使ってみた方がいいかもしれないし、
chm出力なら>185を参考にするといいかもしれない。
189デフォルトの名無しさん
2009/05/25(月) 20:01:17190174
2009/05/25(月) 23:27:45 >>188
ありがとう。
説明不足だったね。
ドキュメントはフツーのHTMLなんだよね〜。chmじゃなくて。
>185をやってみたら文字化けは解消したんだけど
>> ドキュメントの100行目ではNameS::MyClassになっているのに
>> 101行目ではNameSMyClassになっていたりする。
この現象は解決しないのだ。。。
ありがとう。
説明不足だったね。
ドキュメントはフツーのHTMLなんだよね〜。chmじゃなくて。
>185をやってみたら文字化けは解消したんだけど
>> ドキュメントの100行目ではNameS::MyClassになっているのに
>> 101行目ではNameSMyClassになっていたりする。
この現象は解決しないのだ。。。
192デフォルトの名無しさん
2009/05/27(水) 12:59:53194デフォルトの名無しさん
2009/05/28(木) 03:59:47 いつの間にかDoxywizardもだいぶ使いやすくなったんだな
■ このスレッドは過去ログ倉庫に格納されています
ニュース
- サナエノミクスについて力説 積極的な財政出動で「所得増える 消費マインド上がる 税収増える」片山さつき財務大臣 ★3 [少考さん★]
- 中国軍機のレーダー照射1週間 駆け引き続く 中国、米のレッドライン模索 日本、米以外の同志国とも連携探る 米は対立から距離置く★2 [ぐれ★]
- 鈴木農相「おこめ券はお米しか買えないわけではない。例えば卵、味噌、しょうゆ、こうした購入に利用可能」 ★4 [Hitzeschleier★]
- 【芸能】粗品、日本テレビに苦言 客のレベルが「かなり低い。あいつら分かってない」「拍手したいだけやねん」 [冬月記者★]
- 【静岡】伊東市長選、前市議の杉本氏初当選 学歴詐称疑惑の田久保氏は及ばず 市長選3700万円、市議選6300万円の計1億円費やされる [ぐれ★]
- 【静岡】伊東市長選、田久保氏の敗北確実 元市議と元職が激戦 [ぐれ★]
- 国内生産制限・輸入制限(関税)頭おかしい。 [929852992]
- 助けて!!地元でテレビ番組の超絶美人のアナウンサーさんが退社した。゚(゚´Д`゚)゚。
- 生音はもちろん最高だけど、こういう打ち込みのブレイクビーツも最高ですよね
- 中国との関係に不安を感じる「66%」高市の中国への対応を評価する「57%」 [931948549]
- 地震
- 🖐( -᷄ὢ)今日は早めに寝るんで……
