*ソース内ドキュメント、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};

#comment

トップ   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS
Site admin: PukiWiki Development Team

PukiWiki 1.5.4+ © 2001-2022 PukiWiki Development Team. Powered by PHP 5.6.40-0+deb8u12. HTML convert time: 0.069 sec.

OSDN