Ground Sunlight

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

ユーザ用ツール

サイト用ツール


psr:psr19

差分

このページの2つのバージョン間の差分を表示します。

この比較画面にリンクする

両方とも前のリビジョン 前のリビジョン
次のリビジョン
前のリビジョン
psr:psr19 [2020/09/17 11:35]
y2sunlight [5.18. @version]
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'' )。
  
 === 例 ==== === 例 ====
行 970: 行 968:
 [[https://semver.org/|Semantic Versioning Standard version 2.0]] で説明されているように、バージョン番号がセマンティックバージョン番号と一致することが推奨されます( ''RECOMMENDED'' )。 [[https://semver.org/|Semantic Versioning Standard version 2.0]] で説明されているように、バージョン番号がセマンティックバージョン番号と一致することが推奨されます( ''RECOMMENDED'' )。
  
-Version vectors from Version Control Systems are also supported, though they MUST follow the form:+バージョン管理システムのバージョンベクトルもサポートされていますが、次の形式に従う必要があります( ''MUST'' )。
  
-バージョン管理システムのバージョンベクターもサポートされていますが、次の形式に従う必要があります( ''MUST'' )。 +<code>
- +
-<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.1600310130.txt.gz · 最終更新: 2020/09/17 11:35 by y2sunlight