このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン | ||
psr:psr19 [2020/09/17 11:34] y2sunlight [5.17. @var] |
psr:psr19 [2020/09/17 11:43] (現在) y2sunlight |
||
---|---|---|---|
行 1: | 行 1: | ||
- | > 編集中 | ||
- | |||
====== PSR-19: PHPDoc tags(Draft) ====== | ====== PSR-19: PHPDoc tags(Draft) ====== | ||
行 700: | 行 698: | ||
この情報を使用して、特定の要素に対して必要なアプリケーションバージョンをコンシューマに通知する一連のAPIドキュメントを生成できます。 | この情報を使用して、特定の要素に対して必要なアプリケーションバージョンをコンシューマに通知する一連のAPIドキュメントを生成できます。 | ||
- | 要素の現在のバージョンを表示するために @since タグを使用すべきではありません( '' | + | 要素の現在のバージョンを表示するために @since タグを使用すべきではありません( '' |
=== 例 ==== | === 例 ==== | ||
行 954: | 行 952: | ||
==== 5.18. @version ===== | ==== 5.18. @version ===== | ||
- | The @version tag is used to denote some description of " | + | @version タグは、要素に対する「バージョニング」の説明を示すために使用されます。 |
- | + | ||
- | @versionタグは、要素に対する「バージョニング」の説明を示すために使用されます。 | + | |
=== 構文 ==== | === 構文 ==== | ||
行 965: | 行 961: | ||
=== 説明 ==== | === 説明 ==== | ||
- | |||
- | Documents the current " | ||
要素の現在の「バージョン」を文書化します。 | 要素の現在の「バージョン」を文書化します。 | ||
- | |||
- | This information can be used to generate a set of API Documentation where the consumer is informed about elements at a particular version. | ||
この情報を使用して、特定のバージョンの要素についてコンシューマに通知するAPIドキュメントのセットを生成できます。 | この情報を使用して、特定のバージョンの要素についてコンシューマに通知するAPIドキュメントのセットを生成できます。 | ||
- | It is RECOMMENDED that the version number matches a semantic version number as described in the Semantic Versioning Standard version 2.0. | + | [[https:// |
- | [[https:// | + | バージョン管理システムのバージョンベクトルもサポートされていますが、次の形式に従う必要があります( '' |
- | Version vectors from Version Control Systems are also supported, though they MUST follow the form: | + | < |
- | + | ||
- | バージョン管理システムのバージョンベクターもサポートされていますが、次の形式に従う必要があります( '' | + | |
- | + | ||
- | < | + | |
name-of-vcs: | name-of-vcs: | ||
</ | </ | ||
- | |||
- | A description MAY be provided, for the purpose of communicating any additional version-specific information. | ||
バージョン固有の追加情報を伝える目的で、説明が提供される場合があります( '' | バージョン固有の追加情報を伝える目的で、説明が提供される場合があります( '' | ||
- | The @version tag MAY NOT be used to show the last modified or introduction version of an element, the @since tag SHOULD be used for that purpose. | + | @version タグは、要素の最終変更バージョンまたは導入バージョンを示すために使用することはできません( '' |
- | + | ||
- | @versionタグは、要素の最終変更バージョンまたは導入バージョンを示すために使用することはできません( '' | + | |
=== 例 ==== | === 例 ==== |