logo       

Weird behavior of detailed description placement?: msg#00061

text.doxygen.general

Subject: Weird behavior of detailed description placement?

Hi all,

Consider the following foo.c and foo.h

foo.h:
---
/** \file */

void bar1();
void bar2();
---

foo.c:
---
/** \file */

/** \defgroup my_group My Group */

/** \fn void bar1()
* Short description for bar1.
* \ingroup my_group
*/


/** Short description for bar2.
* \ingroup my_group
*/
void bar2()
{
}

void bar1()
{
}
---

If I build documentation from this with the default Doxyfile and doxygen 1.3-rc3 I get two problems:
1) I get a warning about a missing description for bar1() for foo.h and the function in the foo.h documentation does indeed neither have a detailed description on the page itself nor a link to the detailed description in my_group.
2) The detailed description for bar2 seems to appear in both the documentation for foo.h and my_group, while I would only expect it to appear in the documentation for my_group.

Are these two issues intended behavior or have I stumbled on a bug in doxygen?

Regards,
Sander



-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf


<Prev in Thread] Current Thread [Next in Thread>
Google Custom Search

News | FAQ | advertise