問題タブ [phpdoc]

ご存じのように、NetBeans IDE は phpDocumentor 構文に基づいて PHP ソースにインライン ドキュメントを表示します。

私が見つけたのは、phpDocumentor ドキュメントで特別な HTML 文字を使用すると、NetBeans では HTML として扱われますが、phpDocumentor によって生成された HTMl ドキュメントではテキストとして扱われるということです。

例えば：

phpDocumentor によって生成された HTML では、次のように表示されます。

ただし、NetBeans IDE では次のように表示されます。

どちらが正しいですか？phpDocumentor コメントに特殊な HTML 文字を埋め込む正しい方法は何ですか?

名前空間や無名関数など、PHP 5.3 の新しい機能の一部は、最新のリリースであっても、PHPDocumentor と互換性がありません。たとえば、「名前のない関数」、つまりクロージャーに遭遇したときにエラーを発生させます。では、PHP 5.3 コードの Javadoc スタイルのコメントから API ドキュメント (できれば HTML) を生成するオープンソース ツールは他にありますか?

コメントタグ@versionにEclipseのSubclipseまたはSubversionを入力したいと思います。CVSはこれを自動的に実行しましたが、Subversionは実行しません。これは非常に役立ちます。

「@version」をググってみましたが、無理そうです。

CVSが行ったことの例：

SVNの例：

助けてください.....

私たちは現在、新しいプロジェクトを開始しており、将来の開発を支援するために、最初から可能な限りコメントしたいと思います.

私は、Eclipse で phpDoc を使用する際のベスト プラクティスを見つけようとしましたが、結果はごくわずかでした。

Eclipse で phpDoc を使用してコメントする際のベスト プラクティスとコツを教えてください。

Zend Framework でこれを見つけました:

これらは「開く」タグと「閉じる」タグですか？それらは phpdoc でサポートされていますか? それに関するドキュメントが見つかりません（そして、グーグルすることはできません）

ありがとうございました。

私は Magento テンプレートに取り組んでいますが、この問題はどのテンプレート ロード システムにも当てはまります。

これらのテンプレートはテンプレート エンジンによって読み込まれるため、IDE (この場合は Aptana) が $this のオブジェクト タイプを認識する方法はありません。

単一のテンプレートが複数のオブジェクトによってロードされる可能性があるため、複数のオブジェクトが読み込まれる可能性がありますが、これを無視すると、$this オブジェクトの特定のクラスを指定するための正しい phpdoc 構文は何でしょうか?

ウェブサイトで入手できるものは、初心者にとって非常に圧倒されると思います。3 つの長い php ソース ファイルを投げる代わりに、少し時間がかかる、より良いチュートリアルはありますか?

編集：

マニュアル以外に本当に何もないのですか？D:

私が文書化しているコードベース内のすべてのファイルは、常に同じバージョンの「文字列」を使用します。指定されているかどうかに関係なく、PhpDocumentorがすべてのファイルに同じバージョンを使用するように1か所で指定できる方法はありますか（自動継承する必要があります）

...そして、これは頭のてっぺんから外れるのに役立つ他のタグは何ですか？

編集：

親子関係を回避できるものはありますか？バージョン、作成者、著作権を読み取るための.iniまたは構成ファイルのようなものですか？

PHPDocのようにテキストを解析して分離する必要があるこのデータの例を分離するのに、どんな体でも助けてくれますか。PHPのソースコードです。

例の文字列:

「関数」単語と作成および配列に基づいて上記の文字列を区切る方法を誰か助けてもらえますか。ありがとうございました

メソッドを持つPHPクラスがあります。基本クラス (プロトタイプに似ていますが、下位互換性が必要なのでプロトタイプは使用していません) では、パラメーターとメソッドの説明を文書化します。

今、私はそのクラスを拡張します。この新しいメソッド (実装) では、パラメーターと説明を再文書化する必要がありますか、空白のままにする必要がありますか、それともその特定の実装に適用される関連するメモのみを残す必要がありますか?

私の目標は、PhpDoc によって作成された読み取り可能な API ドキュメントを作成し、規則に従うことです。