BugTrack/149 の履歴ソース(No.8)

*ソース内ドキュメント、PHPDoc対応にしませんか? [#v5b4791e]

-ページ: BugTrack
-投稿者: [[myr]]
-優先順位: 低
-状態: 保留
-カテゴリー: その他
-投稿日: 2002-09-15 (日) 13:43:15
-バージョン: 

**メッセージ [#nd4b452c]
http://www.stack.nl/~dimitri/doxygen/index.html 仕事でC++のソースとかには使ってます。~
PHPも対応してるみたいなので、、、どうでしょうか?
----
** ちょっと確認: PHP向けのソースコードドキュメンテーションシステム [#rcf94db6]

- phpDocumentor: The complete documentation solution for PHP
-- http://phpdoc.org/
-- http://sourceforge.net/projects/phpdocu/
-- NARUNIA: phpDocumentor
--- http://narunia.ddo.jp/~toxin/pukiwiki/?phpDocumentor

- PHPDoc - an adoption of Javadoc to the PHP world
-- http://www.phpdoc.de/
-- PHPDoc - APIドキュメントの自動生成
--- http://www.pat.hi-ho.ne.jp/dimension/tips/tips_phpdoc.shtml

----
** コメント [#w4419b88]
-プログラムのドキュメンテーションはやらないとダメですよね。でもdoxygenはやはり日本語マニュアルがないのでちょっと敷居が高いですね。 -- [[ゆう]] SIZE(10){2002-09-15 (日) 15:14:17}
--書き方自体はJavaDocと同じなので大丈夫ですよ..[[myr]]  http://www.pat.hi-ho.ne.jp/dimension/tips/tips_phpdoc.shtml
-すみません。doxygen対応してなかったみたいです(笑)。 PHPDoc http://www.pat.hi-ho.ne.jp/dimension/tips/tips_phpdoc.shtml ってのがあるみたいでした -- [[myr]] SIZE(10){2002-09-15 (日) 16:44:53}
-私はPukiWikiによる[[文芸的プログラミング]]のほうに興味がありますね～。無茶かなぁ。PukiWikiのプレインテキスト部分にソースを入れて、ページ名でソースかどうかという部分を決めて、ソースだけを切り出すスクリプトを作っておいてってな感じ。 -- [[kawara]] SIZE(10){2002-09-15 (日) 23:55:54}
-PukiWikiでソースの管理ってことですか?ちょっと心ひかれますね -- [[ゆう]] SIZE(10){2002-09-16 (月) 00:37:55}
-Doxygenって中間言語みたいなの吐けたと思うんですが、、、もしPHPDocでそれ可能なら、[[文芸的プログラミング]]も十分可能では? って的外れな事言ってます? -- [[myr]] SIZE(10){2002-09-16 (月) 18:18:13}
-PukiWikiでソース管理というか、PukiWikiでドキュメントとソースを含めたページを作ることによって、ドキュメントとソースを同時に管理というイメージですね。 -- [[kawara]] SIZE(10){2002-09-16 (月) 20:40:43}
-あ、でも、ソースに含まれたコメントからドキュメントを自動生成してくれるPHPDocなどのツールのほうがやっぱり一日の長はあるだろうから、そっちのほうがいいのかなぁ。 -- [[kawara]] SIZE(10){2002-09-16 (月) 20:45:09}
-実際にphpDoc形式のコメントを入れたソースを通してみました。下の方を見てください。短いコードなので割とわかりやすいと思います。[[okkez:memo/改造/UTF-8化/code - okkezのPukiWiki>http://fullmetal.dip.jp/pukiwiki/index.php?memo%2F%B2%FE%C2%A4%2FUTF-8%B2%BD%2Fcode]] -- [[okkez]] &new{2005-03-07 (月) 15:51:07};
-PEAR ライブラリでは phpDocumentor を採用していますよね。こちらを採用するメリットは、サポートされる出力形式が多いこと、処理が高速なこと、あたりですが、実際みなさまどの程度採用されているかは良く知りません。私は phpDocumentor を使っています。phpDocumentor のページには「PHPDoc とも呼ばれている」と書いてありますが、通常 PHPDoc と呼ばれるものとは別ものだと思います……。 :p こちらを採用されてはいかがでしょうか。 -- [[kawai]] &new{2005-03-08 (火) 02:16:39};
-ツッコミありがとうございます。双方の情報を上に追記しておきました。 -- [[henoheno]] &new{2005-03-08 (火) 22:06:51};
-- [[okkez]]さんが試しているのもphpDocumentorの方みたいですね。 -- [[henoheno]] &new{2005-03-08 (火) 22:07:29};
--はい&sad;その通りです。 -- [[okkez]] &new{2005-03-09 (水) 02:35:29};
- http://fullmetal.dip.jp/doc/でちょこちょこコメント付けてドキュメント化してます。まだ途中ですが、無いよりマシなレベルにはなってきたと思います。手伝ってくれる人募集します。((勝手に募集してもいいですか？)) -- [[okkez]] &new{2005-09-27 (火) 01:46:18};
-- 美しいですねぇ～ :) -- [[teanan]] &new{2005-09-29 (木) 08:33:13};
-- もちろん募集は自由です :) この中で一番の経験者は [[okkez]] さんなので、今までの経験を踏まえたポイントなど教えていただけると、検証する側として助かります :) コンセプトに沿ったコメントをさらに追加できるならば追加したいし、より効果的なドキュメントを生成できるいけてる工夫があればそれを検討したいです :) -- [[henoheno]] &new{2005-09-29 (木) 21:58:40};

#comment