Re: [CMake] Documentation suggestion

2011-05-02 Thread Michael Wild
How about extending the markup language with anchors and references, e.g. like in AsciiDoc, restructuredText or MarkDown? E.g. using AsciiDoc syntax: [[if_cmd]] Here goes the documentation for the IF() command. [[else_cmd]] See documentation of the <>. When producing HTML, you simply transform t

Re: [CMake] Documentation suggestion

2011-05-02 Thread David Cole
On Mon, May 2, 2011 at 10:51 AM, David Doria wrote: > > what about Doxyen[1]? > > > > Kind regards, > > Benjamin > > What do you think Dave C? As a side-effect it would then "look like" > other Kitware based projects (ITK, VTK etc) which all use Doxygen. > > David > I think that would be a lovel

Re: [CMake] Documentation suggestion

2011-05-02 Thread Benjamin Eikel
To answer myself: The problem could be that one has to write a parser. From [1]: 12. My favorite programming language is X. Can I still use doxygen? No, not as such; doxygen needs to understand the structure of what it reads. If you don't mind spending some time on it, there are several options:

Re: [CMake] Documentation suggestion

2011-05-02 Thread David Doria
> what about Doxyen[1]? > > Kind regards, > Benjamin What do you think Dave C? As a side-effect it would then "look like" other Kitware based projects (ITK, VTK etc) which all use Doxygen. David ___ Powered by www.kitware.com Visit other Kitware open-s

Re: [CMake] Documentation suggestion

2011-05-02 Thread Benjamin Eikel
Hello, Am Montag, 2. Mai 2011, 16:37:45 schrieb David Cole: > Good suggestion. > > We've also thought of that idea... > > Here's what we need to implement it: > > Do you have a good suggestion for how to represent links in the source code > such that we can generated such linked documentation?

Re: [CMake] Documentation suggestion

2011-05-02 Thread David Cole
Good suggestion. We've also thought of that idea... Here's what we need to implement it: Do you have a good suggestion for how to represent links in the source code such that we can generated such linked documentation? If it was easy, we would have done it already... If you do have a suggested

[CMake] Documentation suggestion

2011-05-01 Thread David Doria
On this page: http://www.cmake.org/cmake/help/cmake-2-8-docs.html there are many "See XYZ" statements. E.g. - else: Starts the else portion of an if block. else(expression) See the if command. - It would be very helpful if these were linked to the anchor of that command, e.g.: See t