doxygen-users

[Doxygen-users] Going to make changes to doxygen

[Carlo W. <ca...@al...>]

Hiya,

I just decided to spend some of my time on doxygen,
and therefore subscribed to doxygen-develop.

Normally I first ask what is the chance that a patch
will be added, but in this case I need the patch
hard enough to make it worthwhile if only I would
be one who'd use it, so I'll write it anyway ;).

The first thing I plan to write is a better support
for namespaces:

Instead of searching global namespace only, I want
doxygen to search the _current_ namespace first,
and then the global namespace.  Thus:

class FOOBAR;

namespace n {
  class FOOBAR;

  /**
   * A pointer to class FOOBAR.
   */
  FOOBAR* p;
}

Should generate documentation with a link
to n::p and not ::p.

My plans so far are:

0) subscribe to this list and introduce myself.
1) checkout the latest CVS, configure and compile it
   and create a test environment that I can work with.
2) read the documentation on www.doxygen.org for
   developers.

I am afraid I am not very good at introducing myself
so you might want to read the 1116 pages that show up on
http://www.altavista.com/sites/search/web?q=%22Carlo+Wood%22+AND+NOT+Vendors&kl=XX&r=&d2=0&d0=&d1=&nbq=20&pg=aq&search=Search
or perhaps just the links of my introduction at the bottom
of http://www.gnu.org/people/people.html

-- 
Carlo Wood <ca...@al...>

[Doxygen-users] Not going to make changes to doxygen

[Carlo W. <ca...@al...>]

On Tue, Nov 27, 2001 at 02:33:49AM +0100, Carlo Wood wrote:
> 1) checkout the latest CVS, configure and compile it
>    and create a test environment that I can work with.

After a closer investigation of my problem, I finally found
out that in most cases doxygen is doing the right thing.
It was very unclear WHEN doxygen will lookup variables/functions/classes
etc. and where it would look etc.  Because I ran often into
cases that it did not work I concluded that it was broken in
general :/.

Fortunately, it seems that doxygen mostly is doing an excellent
job in finding the right classes when referenced in the
documentation (without using the namespace they are in).

It doesn't work inside a @addtogroup inside a namespace;
apparently the fact that this happens inside a namespace is ignored.
But now I know that, I can't afford to put time into that.

I still don't understand when doxygen needs a '\ref'
command to do a lookup (in some cases it seems to make a link
to simple words (like the 'A' in the example my previous post)
while in other cases I need to add an explicit '\ref'... weird.

Back to his own project,

-- 
Carlo Wood <ca...@al...>