5ちゃんねる ★スマホ版★ ■掲示板に戻る■ 全部 1- 最新50  

■ このスレッドは過去ログ倉庫に格納されています

doxygen およびドキュメント自動生成ツール総合スレ

1 :デフォルトの名無しさん:02/04/15 17:06
doxygen のスレがなかったので立てました
面倒臭いがしないと後で困るドキュメンテーションに便利
備忘録としても威力のある doxygen について語りましょう
もちろんその他ドキュメント自動生成ツールもOK


2 :デフォルトの名無しさん:02/04/15 17:07
リンクと概要くらい書いてよ...


3 :デフォルトの名無しさん:02/04/15 17:08
2ちゃんねるで評判いいみたいね。

何ができるの?

4 :デフォルトの名無しさん:02/04/15 17:18
>>2
すんません

取り合えず公式サイト
http://www.stack.nl/~dimitri/doxygen/

日本語訳してくれている人がここにいます
http://www.fides.dti.ne.jp/~oka-t/doxygen.html


5 :デフォルトの名無しさん:02/04/15 17:23
>>3
コメントにある規則で書き付けると
http://www.fides.dti.ne.jp/~oka-t/doxygen-sample/html/
みたいな物を生成してくれるツールです。
日本語化もよくできています。


6 :2:02/04/15 18:30
>1 ご苦労さん

7 :3:02/04/15 18:53
ちらりと拝見しました。

ソース書いてドキュメント書く立場からは便利だと思いますし、
JavaDocよりも、パッケージ内のクラス間のつながりを記述しやすそーですね。

JavaDocみたいな、フレーム対応はないの?
#JavaDocの方が、Smalltalkのクラス階層ブラウザのHTML版って位置付け
#に徹していて、情報提示のやり方が上手いと思いますが。


8 :デフォルトの名無しさん:02/04/15 20:32
ミカカ向けのドキュソメントは、このソフトで自動生成してる。
http://www.vector.co.jp/soft/dos/amuse/se007728.html


9 :デフォルトの名無しさん:02/04/15 21:26
富士通の仕様J?
くそ!すぐ固まる。こんなの買う奴いるのか。

10 :デフォルトの名無しさん:02/04/15 21:34
graphvizとかいうツールと併用すると良いのかも?
http://moso.borogrammers.net/moso/diary/?200203a&to=200203051S1#200203051S1


11 :デフォルトの名無しさん:02/04/15 21:48
ミカカ向けドキュソメントならこっちも併用したほうが親切。
http://www.vector.co.jp/soft/win95/amuse/se205078.html?site=n

12 :デフォルトの名無しさん:02/04/15 21:52
>>9
Fへの納品で使わされましたがなにか?
せこい教授みたいな真似やめれ>F

13 :デフォルトの名無しさん:02/04/16 13:30
小河童 http://sourceforge.jp/projects/cuppa/



14 :デフォルトの名無しさん:02/04/16 13:35
PHP用のJavaDocモドキの評価ってどうなの?


15 :13:02/04/16 14:10
>>13
誤爆


16 :デフォルトの名無しさん:02/04/16 15:17
doxygenの吐くHTMLはあまりに腐っててウェブデザイナでもある漏れ的に我慢ならないんだが、誰かもうちっとましなものに作り変えてくれる神はおらんか?
ソースは見たことないんだが、あの腐れHTMLじゃぁソースも予想できてしまう(;´Д`)

17 :デフォルトの名無しさん:02/04/16 15:30
>>16
どのように駄目なのか、どう直すべきなのかを具体的に作者に伝えればきっと直るだろう。
がんばってくれ(笑)

18 :デフォルトの名無しさん:02/04/16 15:38
>>17
直すべき点があまりに多すぎて(全部書き直したほうがまし)伝えるだけで作者の心象を悪くしそうだ(;´Д`)

19 :デフォルトの名無しさん:02/04/16 16:40
画面の使い勝手が悪いという主張?
使い勝手は問題にしておらずHTMLのソースコードが汚いという主張?

どっち?


20 :デフォルトの名無しさん:02/04/16 16:44
どっちも。
見た目が(当然結果的に使い勝手も)いまいちなのでカスタマイズしようとしたが
HTMLの使い方がなってないのでカスタマイズ不能だった。
作者にHTMLとスタイルシートについて小一時間問い詰めたい。

左のツリービューがスクリプトで読み込み時に生成されてるのも遅くて嫌。
それくらいdoxygen側であらかじめ生成しておくべき。

21 :19:02/04/16 16:48
GENERATE_XML = YES
でXMLで吐かせてXSLTでどうにかすれば? これなら>>16も開発しやすいでしょう。
まー、どの程度奇麗なXMLを吐くかにもよるが。


22 :デフォルトの名無しさん:02/04/16 16:54
試してみるのもいいかもしれない。
速度が気になるけど。

23 :19:02/04/16 17:01
速度? ブラウザ側にXSLT解釈させる必要はないでしょう。


24 :デフォルトの名無しさん:02/04/16 17:15
>>23
そうですた!

25 :デフォルトの名無しさん:02/04/16 17:41
graphvizって結構デカいね
rpm --rebuild おわらん。

26 :デフォルトの名無しさん:02/04/17 11:58
doxygen で生成するドキュメントのメインページをカスタマイズしたいんですけど
やり方わかる方いらっしゃいますか?


27 :デフォルトの名無しさん:02/04/17 14:58
graphvis の手っ取りばやい使い方がわかる人、教えて。

28 :デフォルトの名無しさん:02/04/17 15:39
>>26
適当なファイル (たとえば、foo.doc) を作り、そこにコメントの形で
ドキュメントを書けばよい。形式は次のとおり。

/*! \mainpage [タイトル]

ドキュメント

*/

もちろん、Doxyfile の INPUT あるいは FILE_PATTERNS で、上のファイルを
指定しておく。\mainpage は、\page index としてもいいみたい。

29 :デフォルトの名無しさん:02/04/17 21:44
ソースがたくさんあってそのうちの一つ直すと
(あるいはまったく直さなくても)
毎回全部生成しなおしているんだけど
何とかならないの?


30 :デフォルトの名無しさん:02/04/17 23:02
nkfすると異常に遅くなるんだけど、設定が悪いのかなあ。
速くする方法ある?

31 :デフォルトの名無しさん:02/04/18 02:02
>30
いま出てるやつってShift JISでも平気じゃない?
そう云う問題ではないのだろうか……

32 :30:02/04/18 07:49
ほんと?
前の設定ファイルそのまま使ってたから、nkfはずしてつかってみる。
ありがとう。

33 :デフォルトの名無しさん:02/04/21 22:58
>>28
どうも有難うございます、助かりました。


34 :デフォルトの名無しさん:02/04/29 20:40
perlだと元から付いてたりする。

7 KB
■ このスレッドは過去ログ倉庫に格納されています

★スマホ版★ 掲示板に戻る 全部 前100 次100 最新50

read.cgi ver 05.04.02 2018/11/22 Walang Kapalit ★
FOX ★ DSO(Dynamic Shared Object)