C++标准的核心语言规范中的注释和示例是非规范性的吗?

And*_*owl 21 c++ iso language-lawyer c++11 c++14

通常在SO(以及其他地方),我已经看到C++标准中的注释和示例不是规范性的说法 - 我可能已经多次提出这个主张.

但是,我在C++标准的核心语言规范中找不到这个事实的证据(目前我在查看n3979 C++ 14工作草案).

我能找到的最接近的报价见第17.5.1.2/2段:

标有"注释:"或"示例:"的段落是提供信息的,其他段落是规范性的.

但是,除非我错误地认为该段只适用于图书馆部分(即第18至30条和附件D).

因此,问题是:C++标准中的所有注释和示例都是非规范性的吗?脚注怎么样?

Jos*_*eld 27

参见ISO/IEC指令第2部分的第 6.5节.注释,示例和脚注都被视为"信息性",而不是"规范性".

有关说明和示例:

集成在文档文本中的注释和示例仅用于提供有助于理解或使用文档的其他信息.它们不应包含要求("应";见3.3.1和表H.1)或任何被认为对文件使用必不可少的信息,例如说明(必要;见表H.1),建议("应";见3.3.2和表H.2)或许可("可";见表H.3).注释可以写成事实陈述.

对于脚注:

文字脚注提供了更多信息; 它们的使用应保持在最低限度.与案文中的说明和示例(见6.5.1)的情况一样,脚注不应包含对文件使用必不可少的要求或任何信息.

但请注意,图表和表格的脚注可以包含要求.


Tem*_*Rex 11

这适用于所有ISO标准文档:

集成在文档文本中的示例,用于提供有助于理解或使用文档的其他信息.在ISO标准中,示例无一例外是非规范性的.

一个类似的条款适用于笔记:

集成在文档文本中的注释,用于提供有助于理解或使用文档的其他信息.在ISO标准中,注释无一例外是非规范性的.