Полный русский перевод · RFC8174

RFC8174 · Неоднозначность прописных и строчных нормативных слов RFC 2119

Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words

Карточка документа · Архив принятого перевода · Официальный источник

Internet Engineering Task Force (IETF)                          B. Leiba
Request for Comments: 8174                           Huawei Technologies
BCP: 14                                                         Май 2017
Обновляет: 2119
Категория: Лучшая современная практика
ISSN: 2070-1721

       Неоднозначность прописных и строчных нормативных слов RFC 2119

RFC 2119 определяет общепринятые ключевые слова, которые могут
   использоваться в спецификациях протоколов. Настоящий документ призван
   уменьшить неоднозначность, разъясняя, что определённые особые значения
   имеют только ключевые слова, используемые ПРОПИСНЫМИ БУКВАМИ.

Этот меморандум документирует Лучшую современную практику Интернета.

   Этот документ является продуктом Internet Engineering Task Force
   (IETF). Он отражает консенсус сообщества IETF. Он прошёл публичное
   рассмотрение и был одобрен для публикации Internet Engineering
   Steering Group (IESG). Дополнительная информация о BCP доступна в
   разделе 2 RFC 7841.

   Информацию о текущем статусе данного документа, любых исправлениях
   и о том, как предоставить отзыв о нём, можно получить по адресу
   http://www.rfc-editor.org/info/rfc8174.

Авторское право (c) 2017 принадлежит IETF Trust и лицам, указанным
   в качестве авторов документа. Все права защищены.

   Настоящий документ подпадает под действие BCP 78 и Правовых положений
   IETF Trust, относящихся к документам IETF
   (IETF Trust's Legal Provisions Relating to IETF Documents)
   (http://trustee.ietf.org/license-info), действующих на дату публикации
   настоящего документа. Внимательно ознакомьтесь с этими документами,
   поскольку они описывают ваши права и ограничения в отношении
   настоящего документа. Компоненты кода, извлечённые из настоящего
   документа, должны включать текст лицензии Simplified BSD License, как
   описано в разделе 4.e Trust Legal Provisions, и предоставляются без
   гарантии, как описано в Simplified BSD License.

RFC 2119 определяет общепринятые ключевые слова, такие как "MUST",
   "SHOULD" и "MAY", которые могут использоваться в спецификациях
   протоколов. В нём сказано, что ключевые слова «часто пишутся
   прописными буквами», что вызвало путаницу в отношении того, как
   интерпретировать слова, написанные не полностью прописными буквами,
   такие как «must» и «should».

   Настоящий документ обновляет RFC 2119, разъясняя, что определённые
   особые значения имеют только ключевые слова, используемые ПРОПИСНЫМИ
   БУКВАМИ. Настоящий документ является частью BCP 14.

В [RFC2119] вносится следующее изменение:

   === СТАРОЕ ===
   Во многих документах уровня стандартов несколько слов используются
   для обозначения требований в спецификации. Эти слова часто пишутся
   прописными буквами. Этот документ определяет, как следует
   интерпретировать эти слова в документах IETF. Авторам, следующим этим
   рекомендациям, следует включать следующую фразу ближе к началу своего
   документа:

   Ключевые слова "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" и "OPTIONAL" в этом
   документе должны толковаться так, как описано в RFC 2119.

   === НОВОЕ ===
   Во многих документах IETF несколько слов, когда они написаны всеми
   прописными буквами, как показано ниже, используются для обозначения
   требований в спецификации. Эти слова, написанные прописными буквами,
   могут вносить в документы существенную ясность и согласованность,
   поскольку их значения чётко определены. Этот документ определяет,
   как толкуются эти слова в документах IETF, когда слова написаны всеми
   прописными буквами.

   o  Эти слова могут использоваться в определённом здесь значении, но
      их использование не требуется. В частности, нормативный текст не
      требует использования этих ключевых слов. Они используются для
      ясности и согласованности, когда это желательно, однако большой
      объём нормативного текста не использует их и всё равно является
      нормативным.

   o  Эти слова имеют указанные в настоящем документе значения только
      тогда, когда они написаны всеми прописными буквами.

   o  Когда эти слова не написаны всеми прописными буквами, они имеют
      свои обычные значения в английском языке и не подпадают под
      действие настоящего документа.

   Авторам, следующим этим рекомендациям, следует включать следующую
   фразу ближе к началу своего документа:

      Ключевые слова "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
      NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED",
      "MAY" и "OPTIONAL" в этом документе должны толковаться так, как
      описано в BCP 14 [RFC2119] [RFC8174], тогда и только тогда, когда
      они написаны всеми прописными буквами, как показано здесь.

   === КОНЕЦ ===

Настоящий документ не требует каких-либо действий IANA.

Настоящий документ носит исключительно процедурный характер;
   связанных с ним соображений безопасности нет.

[RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119,
              DOI 10.17487/RFC2119, March 1997,
              <http://www.rfc-editor.org/info/rfc2119>.

Barry Leiba
   Huawei Technologies

   Телефон: +1 646 827 0648
   Электронная почта: barryleiba@computer.org
   URI:   http://internetmessagingtechnology.org/