説明専用(exposition-only)エンティティを明確化する

[yohhoy]

C++標準ライブラリには説明専用(exposition-only)として規定されるクラス／関数／コンセプト等が存在します。複数箇所から参照される場合は独立したページを持ち、現時点ではページ冒頭の概略でのみ説明専用である旨が明記されています。

概要

●●は〜を表す、説明専用のコンセプトである。

C++標準ライブラリの説明専用エンティティは、所属する名前空間が定義されていなかったり（名前空間に属するケースもある）、その識別子名に本来は利用できないハイフン(-)を含んでいたり（1単語の場合は含まない）という特徴はあるものの、初見では実体をもつ利用可能なエンティティと勘違いされる可能性もありそうです。

[yohhoy]

HTML生成エンジン側を機能拡張するのであれば、下記案とかはいかがでしょう。

• 記述：ページ冒頭のメタ情報タグを指定。案：[meta exposition-only]（ちょっと長い...）
• 表示：ページ冒頭のエンティティ識別子名を斜体(italic)化する。
  • 同じく実体提供されない named requirement もあわせて斜体して良いかもしれません。
• 表示：エンティティ識別子名の後ろに "説明専用" ／ "exposition-ony" のようなマークを表示する。

[faithandbrave]

exposition-onlyはtypoしやすそうなので、別な名前を考えたい気はしますね…。
機能としてはそんな感じでいいと思います。

[akinomyoga]

[meta 説明専用] で良いのではと思いました。

[faithandbrave]

* named requirement[meta id-type]にも説明専用マークをつけることになる気がしてます。named requirementへの斜体適用はそれによって行われるのでいい気がします。

[meta 説明専用]でも悪くないと思いますが、ほかにもなにか案があれば…。[meta spec-only]とかでもいいかも

[yohhoy]

参考までに：C++ SpecificaitonのTeXソースでは \expos マクロを定義して "exposition only" へと展開しているようです。

[faithandbrave]

あまりこだわるポイントでもない気がしてきたので [meta exposition-only] で進めましょうか…

[faithandbrave]

https://cpprefjp.github.io/reference/concepts/boolean-testable.html

対応できました！
あとは編集者向けドキュメントを書きます

[faithandbrave]

ドキュメントも書きました。確認お願いします

[yohhoy]

サイト生成側の対応ありがとうございます！
cpprefjpサイトの表示、編集者向けドキュメントともに問題ないと思います。