[CMake] Documentation suggestion
Benjamin Eikel
cmake at eikel.org
Mon May 2 10:55:08 EDT 2011
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:
- If the grammar of X is close to C or C++, then it is probably not too hard
to tweak src/scanner.l a bit so the language is supported. This is done for
all other languages directly supported by doxygen (i.e. Java, IDL, C#, PHP).
- If the grammar of X is somewhat different than you can write an input filter
that translates X into something similar enough to C/C++ for doxygen to
understand (this approach is taken for VB, Object Pascal, and Javascript, see
http://www.stack.nl/~dimitri/doxygen/download.html#helpers).
- If the grammar is completely different one could write a parser for X and
write a backend that produces a similar syntax tree as is done by
src/scanner.l (and also by src/tagreader.cpp while reading tag files).
[1] http://www.stack.nl/~dimitri/doxygen/faq.html
Am Montag, 2. Mai 2011, 16:41:52 schrieb 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?
>
> what about Doxyen[1]?
>
> Kind regards,
> Benjamin
>
> [1] http://www.stack.nl/~dimitri/doxygen/autolink.html
>
> > If it was easy, we would have done it already...
> >
> > If you do have a suggested technology to use, we're all ears.
> >
> > :-)
> >
> > David C.
> >
> > On Sun, May 1, 2011 at 4:28 PM, David Doria <daviddoria at gmail.com> wrote:
> > > 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 the [if] command.
> > >
> > > David
> > > _______________________________________________
> > > 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://www.cmake.org/mailman/listinfo/cmake
>
> _______________________________________________
> 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://www.cmake.org/mailman/listinfo/cmake
More information about the CMake
mailing list