TOP カテ一覧 スレ一覧 100〜終まで 2ch元 削除依頼
Go language part 2
【Delphi】Embarcaderoオッチャ その34【C++ビルダ】
表計算ソフトは人類の生産性を大きく下げている
VB.NET質問スレ(Part44)
【会津】パソコン甲子園2004【若松】
C++によるDICOMファイル解析
Deep learning
Mathematicaプログラミング 質問箱 その1
C++11が動的言語よりも開発効率が良くなってる…
ソースコード ホスティング総合【GitHub,GitLab,Bitbucket等】
【コメント】doxygen【コンソメ】
- 1 :2008/05/30 〜 最終レス :2019/02/07
- 無いので建てた
公式
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
R
- 31 :
- まだ30レスにしか達していないのかよ!!
- 32 :
- >>7
今まで単独スレが無かっただけで、話すら無かったわけではないぞ。
良いドキュメント・マニュアル・仕様書を書くスレ
http://pc11.2ch.sc/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行ずつパターンマッチングされて、
関数の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があればできるよ。
- 100 :
- @dateの後ろに付ける日付をsubversionが自動更新してくれるように
$Date$にしたら、出来たhtmlで日付の見出しが2重になってました。
もしかしてバージョン管理システムのキーワードをdoxygenが認識して
適当に見出し付きで整形してくれるんでしょうか。
マニュアルにそれらしい説明を見た覚え無いんですが。
100〜のスレッドの続きを読む
新言語を開発したい
インデントを強制しても綺麗なコードにはなりません
次世代言語18 V Julia 他
Cygwin + MinGW + GCC 相談室 Part 8
C#で仕事ある?
【統計分析】機械学習・データマイニング25
ExcelVBAで勤務表を作ろう
Pythonについて(アンチ専用)
アルゴリズム考えるのムズすぎワロタwwww
【関数】Erlang Part 2【エリクソン】
--------------------
【PSO2】PHANTASY STAR ONLINE2 4鯖晒しスレPart35
【サボテン】ロフォフォラ好き集まれ!!4【癒し】
【月刊大学への数学】 学力コンテスト・宿題35
(__)
ぬるぽして1時間以内にガッされなければ神@FFDQ板510
【話題】N国・丸山穂高、東国原に反撃「竹島は『そのまんま』でいいんでしょうかね?」[9/17]
【SNSD】ユリ応援スレ☆7【YuRi】
ジェイムズ・ラブリエ
【ASD自閉症スペクトラム】親子で発達障害&グレーゾーンその13【LD/ADHD】
インドネシアの鉄道総合スレ Part2
糞 監 督 13
大好きなあなたでオナニー
★平成の極悪非道リフォーム詐欺師、山本拓也12施工目
ライブハウスへの不満・愚痴を吐き出すスレ 1軒目
フジテレビ 堤アナ(あざと可愛い系)
Alienware Laptop 宇宙最強のノートPC その33
【フェアプレー】 福田礼佳 【純真】
実際キャンセル料を払うヤツなんざいない
【お手頃価格】 昔のfigmaを懐かしむ 【バブル】1
顔に謎の絆創膏…赤城農相「何でもありません」
TOP カテ一覧 スレ一覧 100〜終まで 2ch元 削除依頼