公式
http://www.doxygen.jp/
配布してるサイトってないの？
,.ﾉ-'､,!l ,! ,!:/"
..-''''~`'ｰy'⌒`;'"ヾ,.`,r''"`:,
'"`'ｰ-,,r____i';';';';';';';';';'; -j. ﾞ;
--....i',.tノ;';';';':'..:::::..':';';';'（.λ
-_.=/ｔ-';';';';'..::::::. .:::::..';';'; ,!-ｰ''
" _!_..>;';';';';'; ::::::::: ;';';';';r'〈ー--
,r'",>,i､'r;';';';';';';';';';';';';';' ,!ｲヽt-''
,r'" `t-,ｯヽ､;';';';'.'.' i" ヽ ヽ,
/ `''j ｰπ-'ﾞ`'ｰ'r'~
`ｰ､,__/ ':,
そういえば見ないな
Java風とかw
>>2-6見てわかんないの？
やっとバグが直ったと思ったら今まで動いていた部分がおかしくなったり。
いつまでたっても満足のいく出力ができない。
検証はしてない
「doxygen」って何て読むの？読んでる？
doxygenの公式ページのFAQに書いてある
でも、英語読めませーん
---------------------------------
doxygenはどのように名前を持っていましたか？
Doxygenは単語ドキュメンテーションとジェネレータで遊ぶのから名前を得ました。
ドキュメンテーション - 医者 - dox
発電機 - 情報を得てください。
当時、私が法とyaccを調べていたので、事態は、「y」で、発音可能につけ加えて、なりました（適切な宣告はDocs-ee情報を得ています、長い「e」があるそう）。（そこでは、多くのものが"yy"から始まります）。
---------------------------------
翻訳したけど意味わかりませーん
「ドキシゲン」でいいのかな？
オキシジェンデストロイヤーから連想して
カタカナ表記ならドキシジェンかドクシジェンじゃないかな
俺もドキシジェンって言ってる
HTMLでは、文字化けしないのに
chm作ると、左側の一覧文字化けする
どうしたらいいんだ
http://dictionary.goo.ne.jp/voice/o/00060383.wav
これにdをつけて読むだろ条項
日本語の人って
Seleneの人以外に居る？
http://selene-lue.halfmoon.jp/
「うまいこと」の意味がわからんな。
何か変わった使い方してるの？
日本語の使い方が(ry
>うまいこと
俺と比べて、丁寧に利用している意味。
というか、普通に活用してるって意味。
じゃぁ、居るよ、ってことで。
氏ね
今まで単独スレが無かっただけで、話すら無かったわけではないぞ。
良いドキュメント・マニュアル・仕様書を書くスレ
http://pc11.2ch.net/test/read.cgi/tech/1065364445/l50
1つの関数に対して func() と Struct::func() のような2つの名前が表示
されてしまうのですが func() だけにできないでしょうか?
OPTIMIZE_OUTPUT_FOR_C はどうしてる？
Documents produced by doxygen are derivative works derived from the input used in their production; they are not affected by this license.
doxygen で生成した文書は生成に使われた入力の派生物、つまり、この（ doxygen の）ライセンスに影響されない。
どうもありがとうございます。
100ページ超のrefman.pdfが出来上がってたまげた。
調子に乗ってデベロッパーズマニュアルまでDoxygenで書いてる。
細かいところでアレな事はあるけど、まだ後悔はしていない。
リファレンスマニュアルやサンプル実装と相互参照できていい感じ。
こういうのは、Docbookとかだとめんどくさくて。
下の例だと、「関数の説明1」が出力されません。
どなたかVBでdoxygenしてる人助言下さい。お願いします。
'*
'*@class cTest
'*@brief テストクラス
'*@author me
'*@version 1.0
'*
'*@fn Function fncTest(obj as Variant)
'*関数の説明1
Public Function fncTest(obj as Variant) As Variant
fncTest = Nullpo
End Function
'*@fn Function fncTest2(obj as Variant)
'*関数の説明2
Public Function fncTest2(obj as Variant) As Variant
fncTest2 = obj.Nullpo
End Function
vbfilter.pyの出力を晒してみそ
vbfilter.py は、空行を捨ててしまうんですが、
cTest のドキュメントブロックと fncTest のドキュメントブロックがくっついててもいいんでしたっけ?
私も自信ないので…
自分で使う分は空行を通すようにしたりとか、色々と手を加えて使ってます。
なお、 vbfilter.py の説明に、クラスの説明用のコメントは「'*」じゃなくて「'!」で始めるとあります。
それと、doxygen のマニュアルに書いてますが、説明する対象の直前に置くなら、 @fn コマンドはいりませんよ。
もうひとつ思い出した。
vbfilter.py は分割行には対応してないので、
実際の fncTest の1行目の宣言が複数の行に分割されてたら認識してくれません。
ありがとうございます！
おかげで正常に出力できました。
ちなみに、関数の前に@fnをつけないとやはり出力されませんでした。
仕方なくつけることにします。
'*@class cTest
'!@brief テストクラス
'!@author me
'!@version 1.0
'*@fn fncTest(obj as Variant)
'*@brief 関数の説明1
Public Function fncTest(obj as Variant) As Variant
fncTest = Nullpo
End Function
'*@fn fncTest2(obj as Variant)
'*@brief 関数の説明2
Public Function fncTest2(obj as Variant) As Variant
fncTest2 = obj.Nullpo
End Function
@class コマンドもいりませんよ。
@fn コマンドをつけないと出力されないのは、
1行目の @class コマンドの行頭が「'*」になっているために、
fncTest のドキュメントブロックとくっついてしまって
おかしな事になっているのではないでしょうか。
「'*」で始まる行と「'!」で始まる行は違うタイミングで処理されます。
最初に「'!」で始まる行が検出されて、クラス用のドキュメントブロックが出力され、
対応するc++形式のクラス定義が開始されます。
次にファイルの先頭から1行ずつパターンマッOされて、
関数の1行目や変数定義や「'*」で始まるコメントがc++の書式に変換されます。
この段階では「'!」で始まる行は飛ばされます。
最後に「}」が出力されて、最初のクラス定義が閉じられます。
なお、関数の中身は全部捨てられてます。
中身の変換の機能追加も一時考えたんですが、挫折しました……。
今のところ手動で変更してますが、Doxygenの設定でどうにかしたいです。
私のところでは文字化けしていないので。
# 尤も、日本語のファイル名なんて使ってないからファイル名が化けない保証はないが。
バージョン1.5.6 なら、Doxygen自体のバグっぽいです。
公式のバグレポートには、ポーランドの人からも
ポーランド語特有の文字が化けると報告されてます。
1.5.5と1.5.6でツリービューの処理が変わってるので、
そこでエンコーディングの処理をミスしたまま、
作者様はラテン1な国の人なので気付いてないってとこではないかと。
1.5.5を使う
thx! (54じゃないけど)
これでキー一つでビルド&ビルド後処理ができるようになりました。
突然思い立ってdoxygenで出力することにしました。
当然、対応形式のコメントでないので一切出力されません。
一から書き直そうと思うんですが、せめてソースを静的に解析して
関数やファイルの頭に定型のテンプレートを追記してくれるようなツールがあればと
探してるんですが、何かないですかね？
そんなことしなくても、コメントの付いてない関数も含めて無理矢理出力させるオプションがあったはず。
DoxyfileのEXTRACT_ALLの項目をNOからYESに変えてみたら？
何をしているかの簡単な説明も表示したいと思っています。
既に大量のソースが存在する為、少しでも手間をかけずに実現したいと試行錯誤中です。
自分の様にプロジェクトの途中からdoxygenの使用を考える人間が、
どのようにこの問題を解決しているのか知りたいところです。
とりあえず、説明文を付けるのは名前だけで中身を判断できないようなクラスやメンバだけに限定しようぜ。
先ほどgccxmlを使用して自宅の環境で関数の位置と引数の情報を取得することができました。
ここからコメントを挿入していけばよさそうです。
お二人はdoxygen以外に勉強しなきゃいけないことがあるように思いますよ。
本当にありがとうございました。
四行目が蛇足すぐるwww
でもまあ、健闘を祈る。
あと、無理するなよ。形だけのドキュメント作業なら特に。
大丈夫ですよ、あなたみたいにひ弱じゃありませんから。
>>66は私本人ですが、>>68はどこぞの馬の骨です。
>>67
ありがとうございます。
"努力と根性"という言葉に何故かカチンときてしまい棘のある文章になってしまいました。
プログラマやその上司が気軽に使っていい言葉ではないと考えます。
たかが2chの戯言なのに、と自分でも驚いていますが。
ドキュメントはネット上で一般公開予定なので、なるべく解りやすいものを心がけます。
これ以降、私が>>61で書き込むことはありません。
書き込みがあったとしたら、それは私以外の誰かです。
そもそも、まともな神経をしていたらレスをつけてくれた人に馬の骨なんて使うわけないじゃないですか。
htmlでも出ない？
なんか変な記述があるとそれ以降が出ないことがあった。なんだかは忘れた。
htmlだと全部出てるだけど、途切れてる部分見直してみる
ありがと
確認してみたけど、特に変な記述は見当たらなかった
でも、たまに出力先のwordでカタカナ部分が文字化けしているとこがあった
OUTPUT_LANGUAGEがJapaneseだと全く表示されず、Japanese-enだと途中まで表示されて
今Englishに変えたら文字化けだらけだけど全部出てきた
INPUTもOUTPUTもcp932でしてるんだけど、どうすりゃ文字化けせずに日本語だせるかな…
doxygenのVer1.54使っていましたが、1.47でword出力すると問題なくできました
ご迷惑おかけしました
最新版のツリー表示の日本語化け直らないかなあ
1.5.6でchm形式でインデックスのエンコーディングを選べるようになって文字化けが解消されたから、それで我慢すれ
これどうにかならないかな？
OPTIMIZE_OUTPUT_FOR_CはYESになってる
struct Foo
{
int Bar __attribute__((aligned(32)));
Cにない構文は、INPUT_FILTERにsedかなにかのスクリプトを指定して事前に取り除くしか。
ありがとう、ただそれだとattributeが消えちゃうよね
なんとか残したまま正しく動作させたいんですよ
EnumName が出るようになるのですが、enum のメンバーのリストが表示されなってしまいました。
1.4.x ではできていた記憶があるのですが、1.5.x で正常にする方法はあるでしょうか？
OPTIMIZE_OUTPUT_FOR_C は YES です。
あんたの言う正しい動作って何なの？
そんな拡張に一一対応しろってのか?
ソースあるんだろうから自分でやれよと思うのだが。
だからそれ以外でなんとかする方法を探してるんじゃないか？
まあattributeは確かに独自拡張だが、gccだし割とよく使われてるんで対応してても良いと思う
構文解析時だけ指定キーワードを無視するオプションがあればいい
つか、ないのかな？
あなた流に言うと、コストに見合わないので対応しません
想定外の構文には警告なりエラーなり出して欲しいよな
doxygen 1.5.7.1
で実行しようとすると、Failed to run doxygen と言われて一切実行できません。
対処法知っている方、教えて下さい。
1クラスの構造を図にはできるみたいですが・・・
C++です。
TOP カテ一覧 スレ一覧 2ch元 削除依頼 ▲
日本語プログラミング言語『なでしこ』スレ5 (736)
【.cmd】 バッチファイルスクリプト %8 【.bat】 (950)
【独学】一人で勉強する奴らのスレ【自習】 (376)
【RAD統合環境】 Qt 総合スレ 13 【Win/Mac/Linux】 (199)
Cygwin + MinGW + GCC 相談室 Part 6 (598)
強いAI(人工知能)ver0.0.1 (665)
--log9.info------------------
【地上波】MADMEN マッドメン part3【フジ】 (559)
海外ドラマのエロい回を教え合うスレ (224)
福岡の地上波の海外ドラマ総合スレ (373)
刑事マードックの捜査ファイル File No.001 (162)
【地上波】ゴースト〜天国からのささやき Part2 (601)
宇宙船レッドドワーフ号16 (613)
欧米ドラマ総合雑談スレ 4 (240)
【FOX】NCIS:LA〜極秘潜入捜査 4 (608)
【FOX JAPAN】キャッスル【CASTLE】3 (548)
【AXN】コールドケース Part9【Cold Case】 (405)
★韓ドラベストワーースト＆ランキングスレ★ (635)
【地上波】近日放送開始の海外ドラマ情報3【ＢＳ】 (517)
■iTSCOM■（旧東急CATV）その14 (379)
JCN関東<旧テプコケーブルテレビ> 10 (394)
【キー局】山梨県のケーブルテレビ7【関東U局】 (300)
いかがわしいＪ:ＣＯＭ ＪＣＮの「地デジ有料化」 (804)
--log55.com------------------
コナミスポーツ福岡天神33 神々の降臨
【福岡】ルネサンス香椎part４だっけ??【東区】
【朝霞台】ルネサンス北朝霞part2【RENAISSANCE】
【TIPNESS】ティップネス総合15
【赤塚】まんまんきつこのブログ【降臨】
【JOY FIT】ジョイフィット札幌圏 その2 【フリーイントラの乱】
ルネサンス総合スレ2
【文句言わずに】ホリデイスポーツクラブ熊本北・長嶺店その6【体をうごかせ】
