Ground Sunlight

Windowsで作る - PHPプログラミングの開発環境

ユーザ用ツール

サイト用ツール


psr:psr19

差分

このページの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 タグを使用すべきではありません( ''SHOULD NOT'' )。その目的では、@version タグが使用できます( ''MAY'' )。+要素の現在のバージョンを表示するために @since タグを使用すべきではありません( ''SHOULD NOT'' )。@version タグを、その目的で使用できます( ''MAY'' )。
  
 === 例 ==== === 例 ====
行 954: 行 952:
 ==== 5.18. @version ===== ==== 5.18. @version =====
  
-The @version tag is used to denote some description of "versioning" to an element. +@version タグは、要素に対する「バージョニング」の説明を示すために使用されます。
- +
-@versionタグは、要素に対する「バージョニング」の説明を示すために使用されます。+
  
 === 構文 ==== === 構文 ====
行 965: 行 961:
  
 === 説明 ==== === 説明 ====
- 
-Documents the current "version" of any element. 
  
 要素の現在の「バージョン」を文書化します。 要素の現在の「バージョン」を文書化します。
- 
-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://semver.org/|Semantic Versioning Standard version 2.0]] で説明されているように、バージョン番号がセマンティックバージョン番号と一致することが推奨されます( ''RECOMMENDED'' )。
  
-[[https://semver.org/|Semantic Versioning Standard version 2.0]]で説明されているように、バージョン番号がセマンィックバージョン番号と一致ること推奨されます( ''RECOMMENDED'' )。+バージョン管理シスムのバージョンベクトルもサポートされていますが、次の形式に従う必要があります( ''MUST'' )。
  
-Version vectors from Version Control Systems are also supported, though they MUST follow the form: +<code>
- +
-バージョン管理システムのバージョンベクターもサポートされていますが、次の形式に従う必要があります( ''MUST'' )。 +
- +
-<code php>+
 name-of-vcs: $vector$ name-of-vcs: $vector$
 </code> </code>
- 
-A description MAY be provided, for the purpose of communicating any additional version-specific information. 
  
 バージョン固有の追加情報を伝える目的で、説明が提供される場合があります( ''MAY'' )。 バージョン固有の追加情報を伝える目的で、説明が提供される場合があります( ''MAY'' )。
  
-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 タグは、要素の最終変更バージョンまたは導入バージョンを示すために使用することはできません( ''MAY NOT'' )。@sinceタグを、その目的で使用すべきです( ''SHOULD'' )。
- +
-@versionタグは、要素の最終変更バージョンまたは導入バージョンを示すために使用することはできません( ''MAY NOT'' )。@sinceタグを、その目的で使用すべきです( ''SHOULD'' )。+
  
 === 例 ==== === 例 ====
psr/psr19.1600310044.txt.gz · 最終更新: 2020/09/17 11:34 by y2sunlight