跳到主要内容

2. 澄清关键词的大写形式

对 [RFC2119] 作出以下变更:

=== 旧文本 ===​

在许多标准轨道文档中, 会使用若干词语来表示规范中的要求. 这些词语通常采用大写形式. 本文档定义了这些词语在 IETF 文档中应如何解释. 遵循这些准则的作者应在其文档开头附近加入以下语句:

本文档中的关键词 "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" 和 "OPTIONAL" 应按 RFC 2119 中的说明进行解释.

=== 新文本 ===​

在许多 IETF 文档中, 当若干词语以下文所示的全大写形式出现时, 它们用于表示规范中的要求. 这些大写词语的含义已有明确定义, 因而能显著提升文档的清晰度和一致性. 本文档定义了这些词语以全大写形式出现在 IETF 文档中时应如何解释.

  • 这些词语可以按本文定义使用, 但并非必须使用. 具体来说, 规范性文本并不要求使用这些关键词. 在需要清晰性和一致性时可以使用它们, 但许多规范性文本并未使用这些词语, 仍然具有规范性.

  • 只有当这些词语以全大写形式出现时, 才具有本文指定的含义.

  • 当这些词语不是大写形式时, 它们具有普通英语含义, 不受本文档影响.

遵循这些准则的作者应在其文档开头附近加入以下语句:

本文档中的关键词 "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY" 和 "OPTIONAL" 只有在以此处所示的全大写形式出现时, 才应按 BCP 14 [RFC2119] [RFC8174] 中的说明进行解释.

=== 结束 ===​

关键词速查​

关键词含义要求级别
MUST绝对要求强制
MUST NOT绝对禁止强制禁止
REQUIRED绝对要求强制
SHALL强制性要求强制
SHALL NOT强制性禁止强制禁止
SHOULD强烈建议建议
SHOULD NOT强烈不建议不建议
RECOMMENDED建议的做法建议
NOT RECOMMENDED不建议的做法不建议
MAY可选可选
OPTIONAL完全可选可选

重要说明: 只有大写形式才具有上文定义的特殊含义. 小写形式 (例如 must, should, may) 是普通英语词语, 不具有 RFC 2119 中定义的规范性含义.

最后于 更新