BugTrack/149 の履歴の現在との差分(No.8)

追加された行はこの色です。
削除された行はこの色です。
*ソース内ドキュメント、PHPDoc対応にしませんか? [#v5b4791e]
* APIドキュメントの自動生成について [#v5b4791e]

- 元タイトル: ソース内ドキュメント、PHPDoc対応にしませんか?

-ページ: 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};
-実際にphpDoc形式のコメントを入れたソースを通してみました。下の方を見てください。短いコードなので割とわかりやすいと思います。[[okkez:memo/改造/UTF-8化/code - okkezのPukiWiki>okkez:memo/改造/UTF-8化/code]] -- [[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};
- http&#x3a;//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};
--コメント付けのコンセプトは、
++プラグイン作者がどの関数を使えるのかわかるようにすること
++また、クラスや関数の使い方が簡単にわかるようになること
++これから開発に参加する人が、全てのソースコードを読まなくても概略がわかるようにすること
~ですね。

今、どうしようかと思っているのは、
++プラグインのパッケージ名((無いとドキュメント生成したときに見栄えがよろしくない))
++関数のアクセス権限((publicなのかprivateなのか))
++クラス変数/インスタンス変数の役割
~です。 -- [[okkez]] &new{2005-09-30 (金) 21:40:43};
- この件に関して、okkezさんから、phpDocumentorのコメント入りのソースを受け取りました。今後teananさんと順次適用して行くと思います。 -- [[henoheno]] &new{2006-08-25 (金) 01:04:22};
-- phpDocumentorは現在ではZendStudioとも連携するようになっています((厳密には ZendStudio ''が'' phpDocumentorと連携する))。今までのokkezさんの行動も考慮するに、phpDocumentorを採用するのが自然な流れでしょう。 -- [[henoheno]] &new{2006-08-25 (金) 01:05:58};
-- 利点について。(1) 利用者にとって、PukiWikiソースの内部で定義されている関数を探しやすくなるかもしれない (2)少なくとも関数ヘッダーの様式が統一され、読み易くなるかもしれない -- [[henoheno]] &new{2006-09-02 (土) 16:09:28};
-- 欠点について。導入当初、ソースの差分が膨大に発生するので、コードのチェックが大変になる。そのため、できればこの件に関する修正はリリース作業の終盤にまとめて行うのが理想です。しかし前に進めるためならそれ以外のタイミングでも問題ありません。 -- [[henoheno]] &new{2006-09-02 (土) 16:11:04};

#comment