apidocs problem
Adriaan de Groot
groot at kde.org
Wed Aug 17 21:12:15 BST 2005
On Wednesday 17 August 2005 20:15, Alexander Dymo wrote:
> On Friday 12 August 2005 00:16, Adriaan de Groot wrote:
> > tag files in the subdirectories. Now, if KDevelop assumes that tag files
> > can only be one deep (ie. in kio/ but not in kio/kio/) then the code has
> > bad assumptions, but isn't broken. Subtle.
>
> Hmm, right. Andras, you can take a look at
> kdevelop/parts/documentation/plugins/doxygen/docdoxygenplugin.cpp #250
> There you will see that the code looks only one level deep into
> subdirectories. It doesn't create index for nested subdirs with .tag files.
So, what to do? Conceivably, I could munge the tag files to contain the tags
of their subdirectories, but I wouldn't like it since it would add a lot of
XML processing to the dox generation process. Can we call this KDevelop's
fault this time around and fix it there?
> Our dox generation stuff looks and works similar to kdelibs one
> (using Doxyfile.am) but with one improvement. It can generate docs
> for nested library directories into separate dox dirs. For example,
> in kdevelop/lib nothing is built because DOXYGEN_EMPTY=yes is set
> in Makefile.am but from kdevelop/lib/interfaces separate dox dir is
> generated with separate prefix with separate title. Same is done for
> ldevelop/lib/util.
Right, and because of that improvement I copied the feature into the main KDE
dox generation tools, so DOXYGEN_EMPTY now works across the entire source
tree. It's useful here and there.
I ought to go back and try to port the KDevelop dox to the main framework, but
I don't want to step on toes (nor, indeed, do I have much time to try it).
--
These are your friends - Adem
GPG: FEA2 A3FE Adriaan de Groot
More information about the kde-core-devel
mailing list