1read 100read
2012年6月プログラム246: 【コメント】doxygen【コンソメ】 (492) TOP カテ一覧 スレ一覧 2ch元 削除依頼
【License】ライセンス総合【利用許諾】 (415)
学んで損したプログラミング言語 (862)
3Dアルゴリズム全般 (427)
Garbage Collection (GC)について語るスレ (334)
EAを語るスレ (227)
スレを勃てるまでもないC/C++の質問はここで 20 (965)

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


1 :08/05/30 〜 最終レス :12/06/14
無いので建てた
公式
http://www.doxygen.jp/

2 :
このスレはアイちゃんがうんたらかんたら

3 :
標準のスタイルシートも見飽きてきたんだけどなんか格好いいdoxygen用のスタイルシート
配布してるサイトってないの?

4 :
          ,r-、 l l l /:/
         ,.ノ-'、,!l ,! ,!:/"
  ..-''''~`'ーy'⌒`;'"ヾ,.`,r''"`:,
  '"`'ー-,,r____i';';';';';';';';';'; -j. ゙;
  --....i',.tノ;';';';':'..:::::..':';';';'(.λ
  -_.=/t-';';';';'..::::::. .:::::..';';';  ,!-ー''
  " _!_..>;';';';';'; ::::::::: ;';';';';r'〈ー--
  ,r'",>,i、'r;';';';';';';';';';';';';';' ,!イヽt-''
   ,r'" `t-,ッヽ、;';';';'.'.' i" ヽ ヽ,
  /    `''j   ーπ-'゙`'ー'r'~
        `ー、,__/ ':,

5 :
>>3
そういえば見ないな
Java風とかw

6 :
このスレは大器晩成型

7 :
これだけ使われていてなんで今まで無かったんだろう。

8 :
>>7
>>2-6見てわかんないの?

9 :
Doxygenってやたらデグレ多くない?
やっとバグが直ったと思ったら今まで動いていた部分がおかしくなったり。
いつまでたっても満足のいく出力ができない。

10 :
最新版はツリーが文字化けしたりしないか?

11 :
output japaneseでやってるけど、左のツリーが化けてる
検証はしてない

12 :
おまいら Javadoc 風と Qt 風のどっちでコメント書いてる?

13 :
///

14 :
ようやくスレが出来たから聞ける
「doxygen」って何て読むの?読んでる?

15 :
>>14
doxygenの公式ページのFAQに書いてある

16 :
うは。こんな過疎スレで即レスサンキュー
でも、英語読めませーん
---------------------------------
doxygenはどのように名前を持っていましたか?
Doxygenは単語ドキュメンテーションとジェネレータで遊ぶのから名前を得ました。
ドキュメンテーション - 医者 - dox
発電機 - 情報を得てください。
当時、私が法とyaccを調べていたので、事態は、「y」で、発音可能につけ加えて、なりました(適切な宣告はDocs-ee情報を得ています、長い「e」があるそう)。(そこでは、多くのものが"yy"から始まります)。
---------------------------------
翻訳したけど意味わかりませーん
「ドキシゲン」でいいのかな?

17 :
ドキシジェンだろ
オキシジェンデストロイヤーから連想して

18 :
documentation-generator → docs-ee-gen だから
カタカナ表記ならドキシジェンかドクシジェンじゃないかな
俺もドキシジェンって言ってる

19 :
どくしげんって脳内発音してた

20 :
げんしけん

21 :
やっぱ読み方わからない奴結構いるんだな

22 :
d + oxygen に見えるからドキシジェンだろ。

23 :
ドキシゲンって読んでたお
HTMLでは、文字化けしないのに
chm作ると、左側の一覧文字化けする
どうしたらいいんだ

24 :
Goo辞書でoxygenの発音
http://dictionary.goo.ne.jp/voice/o/00060383.wav
これにdをつけて読むだろ条項

25 :
doxygenうまいこと使ってる
日本語の人って
Seleneの人以外に居る?
http://selene-lue.halfmoon.jp/

26 :
>>25
「うまいこと」の意味がわからんな。
何か変わった使い方してるの?

27 :
>>25
日本語の使い方が(ry

28 :
チョンでごめんなさい
>うまいこと
俺と比べて、丁寧に利用している意味。
というか、普通に活用してるって意味。

29 :
>>28
じゃぁ、居るよ、ってことで。

30 :
>>29

31 :
まだ30レスにしか達していないのかよ!!

32 :
>>7
今まで単独スレが無かっただけで、話すら無かったわけではないぞ。
良いドキュメント・マニュアル・仕様書を書くスレ
http://pc11.2ch.net/test/read.cgi/tech/1065364445/l50

33 :
Doxygen が吐き出す XML のフォーマットってどっかに仕様書ある?

34 :
XMLなら名前空間のところにURLがあるんじゃないの?

35 :
名前空間のURLのところにスキーマがあるとは限らない

36 :
スキーマって意味まで定義しているんだったっけ。

37 :
隙間って何ですか

38 :
C 言語のソースから HTML 文書を生成するときにモジュールのページに
1つの関数に対して func() と Struct::func() のような2つの名前が表示
されてしまうのですが func() だけにできないでしょうか?

39 :
>>38
OPTIMIZE_OUTPUT_FOR_C はどうしてる?

40 :
もちろん YES です。

41 :
doxygenのlicenseの以下の文章の意味がよく分かりません。
Documents produced by doxygen are derivative works derived from the input used in their production; they are not affected by this license.

42 :
>>41
doxygen で生成した文書は生成に使われた入力の派生物、つまり、この( doxygen の)ライセンスに影響されない。

43 :
>>42
どうもありがとうございます。

44 :
C++ のクラスの中の using 宣言は文書化されないのでしょうか?

45 :
インハウスのCライブラリにコメントつけてDoxygenしたら、
100ページ超のrefman.pdfが出来上がってたまげた。
調子に乗ってデベロッパーズマニュアルまでDoxygenで書いてる。
細かいところでアレな事はあるけど、まだ後悔はしていない。
リファレンスマニュアルやサンプル実装と相互参照できていい感じ。
こういうのは、Docbookとかだとめんどくさくて。

46 :
グラフ中のフォントサイズが変更できないんですが、cssを直接弄るしかないんでしょうか

47 :
doxygen使えるな

48 :
VBのコードvbfilter.pyでをdoxygenで出力するとき、一部の宣言の説明が出力されません。
下の例だと、「関数の説明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

49 :
>>48
vbfilter.pyの出力を晒してみそ

50 :
>>48
vbfilter.py は、空行を捨ててしまうんですが、
cTest のドキュメントブロックと fncTest のドキュメントブロックがくっついててもいいんでしたっけ?
私も自信ないので…
自分で使う分は空行を通すようにしたりとか、色々と手を加えて使ってます。
なお、 vbfilter.py の説明に、クラスの説明用のコメントは「'*」じゃなくて「'!」で始めるとあります。
それと、doxygen のマニュアルに書いてますが、説明する対象の直前に置くなら、 @fn コマンドはいりませんよ。

51 :
>>48
もうひとつ思い出した。
vbfilter.py は分割行には対応してないので、
実際の fncTest の1行目の宣言が複数の行に分割されてたら認識してくれません。

52 :
>>50
ありがとうございます!
おかげで正常に出力できました。
ちなみに、関数の前に@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

53 :
クラス名は、ファイル名やフォーム名から vbfilter.py が勝手に付けるので、
@class コマンドもいりませんよ。
@fn コマンドをつけないと出力されないのは、
1行目の @class コマンドの行頭が「'*」になっているために、
fncTest のドキュメントブロックとくっついてしまって
おかしな事になっているのではないでしょうか。
「'*」で始まる行と「'!」で始まる行は違うタイミングで処理されます。
最初に「'!」で始まる行が検出されて、クラス用のドキュメントブロックが出力され、
対応するc++形式のクラス定義が開始されます。
次にファイルの先頭から1行ずつパターンマッOされて、
関数の1行目や変数定義や「'*」で始まるコメントがc++の書式に変換されます。
この段階では「'!」で始まる行は飛ばされます。
最後に「}」が出力されて、最初のクラス定義が閉じられます。
なお、関数の中身は全部捨てられてます。
中身の変換の機能追加も一時考えたんですが、挫折しました……。

54 :
ツリー部分の日本語が文字化けしてしまうんですが、どうやったら解決できるでしょう?
今のところ手動で変更してますが、Doxygenの設定でどうにかしたいです。

55 :
doxygenのバージョンと動かしているOS、食わせているファイルのエンコードとDoxyfileの設定などの情報をどうぞ。
私のところでは文字化けしていないので。
# 尤も、日本語のファイル名なんて使ってないからファイル名が化けない保証はないが。

56 :
>>54
バージョン1.5.6 なら、Doxygen自体のバグっぽいです。
公式のバグレポートには、ポーランドの人からも
ポーランド語特有の文字が化けると報告されてます。
1.5.5と1.5.6でツリービューの処理が変わってるので、
そこでエンコーディングの処理をミスしたまま、
作者様はラテン1な国の人なので気付いてないってとこではないかと。

57 :
>>54
1.5.5を使う

58 :
お、私が使っているのはCygwinのインストーラで入れた1.5.5だ。

59 :
>>56
thx! (54じゃないけど)

60 :
ありがとうございます!バージョンの違いってのは気づきませんでした・・・・
これでキー一つでビルド&ビルド後処理ができるようになりました。

61 :
今までdoxygenの事を全く考えずにC++で開発していたんですが、
突然思い立ってdoxygenで出力することにしました。
当然、対応形式のコメントでないので一切出力されません。
一から書き直そうと思うんですが、せめてソースを静的に解析して
関数やファイルの頭に定型のテンプレートを追記してくれるようなツールがあればと
探してるんですが、何かないですかね?

62 :
>>61
そんなことしなくても、コメントの付いてない関数も含めて無理矢理出力させるオプションがあったはず。
DoxyfileのEXTRACT_ALLの項目をNOからYESに変えてみたら?

63 :
はい。その設定で関数は出るんですが、クラスとメンバが
何をしているかの簡単な説明も表示したいと思っています。
既に大量のソースが存在する為、少しでも手間をかけずに実現したいと試行錯誤中です。
自分の様にプロジェクトの途中からdoxygenの使用を考える人間が、
どのようにこの問題を解決しているのか知りたいところです。

64 :
努力と根性じゃね?

65 :
>>63
とりあえず、説明文を付けるのは名前だけで中身を判断できないようなクラスやメンバだけに限定しようぜ。

66 :
>>64 >>65
先ほどgccxmlを使用して自宅の環境で関数の位置と引数の情報を取得することができました。
ここからコメントを挿入していけばよさそうです。
お二人はdoxygen以外に勉強しなきゃいけないことがあるように思いますよ。
本当にありがとうございました。

67 :
>>66
四行目が蛇足すぐるwww
でもまあ、健闘を祈る。
あと、無理するなよ。形だけのドキュメント作業なら特に。

68 :
>>67
大丈夫ですよ、あなたみたいにひ弱じゃありませんから。

69 :
名無しに戻ろうと思ったのですが偽者が湧いたので。
>>66は私本人ですが、>>68はどこぞの馬の骨です。
>>67
ありがとうございます。
"努力と根性"という言葉に何故かカチンときてしまい棘のある文章になってしまいました。
プログラマやその上司が気軽に使っていい言葉ではないと考えます。
たかが2chの戯言なのに、と自分でも驚いていますが。
ドキュメントはネット上で一般公開予定なので、なるべく解りやすいものを心がけます。
これ以降、私が>>61で書き込むことはありません。
書き込みがあったとしたら、それは私以外の誰かです。

70 :
いいえ、>69こそがどこぞの馬の骨です。
そもそも、まともな神経をしていたらレスをつけてくれた人に馬の骨なんて使うわけないじゃないですか。

71 :
ワロタw

72 :
>>61もその程度で躓くレベルでしかもきもいときた

73 :
word出力したら途中までしかクラスが出てこないのは何故?

74 :
>>73
htmlでも出ない?
なんか変な記述があるとそれ以降が出ないことがあった。なんだかは忘れた。

75 :
>>74
htmlだと全部出てるだけど、途切れてる部分見直してみる
ありがと

76 :
>>74
確認してみたけど、特に変な記述は見当たらなかった
でも、たまに出力先のwordでカタカナ部分が文字化けしているとこがあった
OUTPUT_LANGUAGEがJapaneseだと全く表示されず、Japanese-enだと途中まで表示されて
今Englishに変えたら文字化けだらけだけど全部出てきた
INPUTもOUTPUTもcp932でしてるんだけど、どうすりゃ文字化けせずに日本語だせるかな…

77 :
追加報告です。
doxygenのVer1.54使っていましたが、1.47でword出力すると問題なくできました
ご迷惑おかけしました

78 :
doxyはバージョンあげると劣化することもあるからなあ
最新版のツリー表示の日本語化け直らないかなあ

79 :
1.5.7 age

80 :
v1.5.7.1 age

81 :
>>78
1.5.6でchm形式でインデックスのエンコーディングを選べるようになって文字化けが解消されたから、それで我慢すれ

82 :
C言語の構造体で、gccのattributeがメンバ「関数」扱いされてしまう
これどうにかならないかな?
OPTIMIZE_OUTPUT_FOR_CはYESになってる
struct Foo
{
    int Bar __attribute__((aligned(32)));

83 :
>>82
Cにない構文は、INPUT_FILTERにsedかなにかのスクリプトを指定して事前に取り除くしか。

84 :
>>82 http://www.google.co.jp/search?q=doxygen+%5f%5fattribute%5f%5f

85 :
>83-84
ありがとう、ただそれだとattributeが消えちゃうよね
なんとか残したまま正しく動作させたいんですよ

86 :
1.5.x で enum EnumName に対して @relatesalso StructName を書くと StructName のページに
EnumName が出るようになるのですが、enum のメンバーのリストが表示されなってしまいました。
1.4.x ではできていた記憶があるのですが、1.5.x で正常にする方法はあるでしょうか?
OPTIMIZE_OUTPUT_FOR_C は YES です。

87 :
>>85 情報後出しキター

88 :
>>85
あんたの言う正しい動作って何なの?

89 :
正しく=attributeを残したまま、メンバ変数はメンバ変数として認識だろjk

90 :
正しくって……
そんな拡張に一一対応しろってのか?
ソースあるんだろうから自分でやれよと思うのだが。

91 :
いちいちソース書き換えとかコスト見合わないでしょ
だからそれ以外でなんとかする方法を探してるんじゃないか?
まあattributeは確かに独自拡張だが、gccだし割とよく使われてるんで対応してても良いと思う

92 :
汎用的に
構文解析時だけ指定キーワードを無視するオプションがあればいい
つか、ないのかな?

93 :
>>91
あなた流に言うと、コストに見合わないので対応しません

94 :
作者かよww

95 :
そもそもC言語にメンバ関数は無いんだからdoxygenのバグとも言えるだろ
想定外の構文には警告なりエラーなり出して欲しいよな

96 :
例えば@paramとかって変えられないの?

97 :
mac osx 10.5.5
doxygen 1.5.7.1
で実行しようとすると、Failed to run doxygen と言われて一切実行できません。
対処法知っている方、教えて下さい。

98 :
クラス関連図って作れますか?
1クラスの構造を図にはできるみたいですが・・・
C++です。

99 :
graphvizがあればできるよ。

100read 1read
1read 100read
TOP カテ一覧 スレ一覧 2ch元 削除依頼
<XML総合 part="3"/> (731)
MVVMについて語ろう (277)
0から始める2chブラウザfor超漢字 "2ch de BTRON" (357)
純粋関数型言語Concurent Clean (309)
【ねらーの】HSPで人工知能を作るスレ【意地】 (653)
ソースのコメントを英語で書くスレ (979)
--log9.info------------------
ボキャブラ天国 (256)
【上級者】3語以上の駄洒落を書くスレ【達人】 (224)
(´w`井端は良いバッター @野球板´駄`) (394)
(゚∀゚) < さいたまさいたまダ埼玉! (240)
ぼった栗 お布施どう? うそくさぁ〜い (205)
お菓子でダジャレ (391)
(ノД^、)σ ほっかいどうはでっかいどう (227)
小林製薬の新商品を開発しよう (391)
ドイツ語っぽく便意を伝える (360)
;゚д゚)<駄洒落板らしいよ  Σ(゚Д゚;エーッ!! (584)
素晴らしい落語家の名前を考えるスレ (468)
○○やと思ったら、◎◎やった。 (371)
♪♪♪ カキコすると絶好調になるスレ ♪♪♪ (365)
レモンのいれもん (217)
ぽまえが考えたとっておきの駄洒落を聞かせてくれ! (354)
Rが立川 (225)
--log55.com------------------
【オルガル】オワガル日記4【初心者御断り】
【痛い】コストコ関連ヲチスレ【晒し】 Part.15
【毒者】小説家になろうヲチスレ【錯者】51
十七ヲタヲチ14
【pixiv】HACHIMAN信者を見守るスレ21【ハーメルン】
【Twitch】LoL配信者ウォッチスレ Part27【ニコ生】
【GREE】アバター・AvaMee・コミュ晒しヲチ総合51
しょうがいぢをやヲチスレ94