[cmake-developers] Adding some generic section to the docs ?

[David Cole]

On Jan 27, 2013, at 11:19 AM, Alexander Neundorf <neundorf at kde.org> wrote:

> On Sunday 27 January 2013, Eric Noulard wrote:
>> 2013/1/27 David Cole <dlrdave at aol.com>:
>>> On Jan 27, 2013, at 6:03 AM, Alexander Neundorf <neundorf at kde.org> wrote:
>>>> Hi,
>>>> 
>>>> I'm about to start adding "Generic" sections to the generated
>>>> documentation. This could contain
>>>> * a section about the regeexps supported by cmake, so it doesn't have to
>>>> be documented in the string() and/or if() command
>>>> 
>>>> * a section about generator expressions, this appars currently multiple
>>>> times in the docs
>>>> 
>>>> * a section about the search order of find_xxx(), which appears
>>>> currently under find_library(), _file(), _path(), _program() and
>>>> _package()
>>>> 
>>>> Comments, objections ?
>>>> 
>>>> Alex
>> 
>> [...]
>> 
>>> It would be nice to be able to cross reference the generic docs from the
>>> multiple places you are thinking of replacing... What's your plan for
>>> "see over here" type links?
>> 
>> +1
> 
> 
> +1 :-)
> 
> But I think this is an independent feature.
> 
> Alex

Sure, it's independent, but the lack of that feature is a very strong reason why documentation HAS to be duplicated as things stand.

Attacking that problem first, and THEN de-duplicating documentation seems more logical to me.

D