[cmake-developers] cmake --help-concept

[Stephen Kelly]

Alexander Neundorf wrote:

> The consensus was that it's a good idea, but it needs better linking
> within the documentation:
> http://thread.gmane.org/gmane.comp.programming.tools.cmake.devel/5924
> 

Too bad about the bikeshedding.

The point is not about de-duplication (though that can also be solved with 
this) or getting caught up in markup or how to reference other sections. The 
point is to have 'entry point' docs for the essential concepts in cmake.

We should add these concept sections to the docs and we can add 'See the 
documentation of the generator_expression concept' where it makes sense. We 
should not change or extend the markup or make adding these concept sections 
dependent on choosing and implementing a new markup for docs.

Thanks,

Steve.