[cmake-developers] cmake --help-concept

Alexander Neundorf neundorf at kde.org
Sat Sep 14 04:48:39 EDT 2013


On Saturday 14 September 2013, Stephen Kelly wrote:
> Brad King wrote:
> > On 08/28/2013 03:28 PM, Stephen Kelly wrote:
> >> 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.
> > 
> > The --help-concept proposal is for a specific new section rather than
> > general infrastructure for adding sections.  It can be one man page
> > that has an item for each concept, just like the command help has an
> > item for each command.  This can be done independent of other changes
> > discussed in the thread Alex linked.
> 
> I've pushed the concept-help branch to next for review, along with one
> documentation item on policies. Once the details are worked out and merged,
> I can write some more, and Alex may want to too.

Would e.g. the list of supported languages or toolchains be a candidate for 
that "concepts" section ?
Or should the languages be documented in the enable_language() documentation ?

Alex



More information about the cmake-developers mailing list