where should C++ options be documented?

[Nathan Sidwell]

On 04/03/2018 07:05 PM, Martin Sebor wrote:
@@ -3914,6 +3916,7 @@ Options} and @ref{Objective-C and Objective-C++ Di
  -Wc++11-compat  -Wc++14-compat  @gol
  -Wcatch-value @r{(C++ and Objective-C++ only)}  @gol
  -Wchar-subscripts  @gol
+-Wclass-memaccess @r{(C++ and Objective-C++ only)}  @gol
  -Wcomment  @gol
  -Wduplicate-decl-specifier @r{(C and Objective-C only)} @gol
  -Wenum-compare @r{(in C/ObjC; this is on by default in C++)} @gol

The verbose '(C++ and Objective-C++ only)' and similar repeated 
annotations are annoying.  Even in the diff snippet there's no 
consistency -- Why is -Wc++11-compat not annotated, why does 
enum-compare contain what looks like documentation; 'on by default ...'.

Either don't note at this point, or use some contraction such as simply 
'(C)' or '(C++)' with the understanding that unless otherwise specified 
that includes the objective dialect.

Is it possible to use two different footnote markers such as 
<super>{C,C++}</super> and explain in the so-noted footnote?

nathan
-- 
Nathan Sidwell