[CMake] Improvements for cross-referencing in the documentation?

[Alexander Neundorf]

On Thursday 27 January 2011, SF Markus Elfring wrote:
> Am 26.01.2011 17:44, schrieb Alexander Neundorf:
> > On Wednesday 26 January 2011, SF Markus Elfring wrote:
> >>> E.g. cmake --help-full<filename>.docbook
> >>> gives you a docbook file, which can then be processed further.
> >>> The interesting thing is how to get the links into these files
> >>> initially.
> >>
> >> Do you need any intermediate format(s) for the desired data exchange?
> >
> > Sorry, which desired data exchange ?
>
> A source format will be converted to a different file format and the
> conversion result will be distributed to the users, won't it?

Hmm. The doc source is embedded in the code, i.e. the docs for the modules are 
at the top of the modules, the docs for the commands is in the commands C++ 
implementation.

> > I thought this discussion is about adding more markup tags to the cmake
> > documentation ?
>
> I'm sorry. - Have I overlooked in the CMake module documentation that tags
> are already supported?

Well, you can have "normal" text and you can have monospaced font (line 
indented).
That's it currently.
I think adding something like wiki markup for bold, italic and maybe links 
would be nice and sounds doable.

Alex