Re: Documentation about C++ Concepts

[Jonathan Wakely <jwakely dot gcc at gmail dot com>]

On 21 December 2015 at 07:57, Akim Demaille wrote:
>>> Also, the documentation about concepts seems to be about the previous attempts at concepts.
>>>
>>> https://gcc.gnu.org/onlinedocs/gcc/C_002b_002b-Concepts.html#C_002b_002b-Concepts
>>>
>>> And actually, I did not find the documentation for c++1z, nor even -std=c++14.
>>
>> https://gcc.gnu.org/onlinedocs/gcc/C-Dialect-Options.html
>
> Ah!  Thanks.  But then, I would suggest that this is misleading: the sections "Options Controlling C Dialect  and "Options Controlling C++ Dialect" are not as symmetrical as their names would imply.  Maybe the C++ section could at least have an item about -std that points to the C documentation.

Yes, that would make sense.

>> Also
>> https://gcc.gnu.org/projects/cxx1y.html
>> https://gcc.gnu.org/projects/cxx1z.html
>>
>>
>>> https://gcc.gnu.org/onlinedocs/gcc/Standards.html#index-std-60
>
> My point here was that this page documents C++ up to C++11, and points to "Options Controlling C++ Dialect" for more information about C++ standards, whereas you just showed that itâs the page about C dialects that should be pointed to, and that there are many more options that what this section reports.

I'll update that section to refer to later C++ standards, I'd
forgotten it existed.


>>>
>>> Finally, one would expect to see documentation about -std in "Options Controlling C++ Dialect", since the corresponding about C documents -std for C.
>>>
>>> https://gcc.gnu.org/onlinedocs/gcc/C_002b_002b-Dialect-Options.html#C_002b_002b-Dialect-Options
>>
>> That's the documentation about -std in general, not -std for C. It
>> says "The following options control the dialect of C (or languages
>> derived from C, such as C++, â)"
>
> Yes, thanks for pointing this out.  But I think that this is unfortunate.  Maybe -std deserves a section on its own.  I guess that gccgo, gnat and other also use this -std option, so even if the main documentation for GCC does not cover these languages, it would make sense to detach it from C.  Say next to -x.

I think only the C-family of languages use that option.