On Jan 27, 2013, at 11:19 AM, Alexander Neundorf <[email protected]> wrote:
> On Sunday 27 January 2013, Eric Noulard wrote: >> 2013/1/27 David Cole <[email protected]>: >>> On Jan 27, 2013, at 6:03 AM, Alexander Neundorf <[email protected]> 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 -- Powered by www.kitware.com Visit other Kitware open-source projects at http://www.kitware.com/opensource/opensource.html Please keep messages on-topic and check the CMake FAQ at: http://www.cmake.org/Wiki/CMake_FAQ Follow this link to subscribe/unsubscribe: http://public.kitware.com/cgi-bin/mailman/listinfo/cmake-developers
