Re: How to add documentation to Entry

Dimitri Van Heesch <[email protected]>
Newsgroups gmane.text.doxygen.devel
Message-ID <[email protected]>
Hi Rene,

On Dec 9, 2010, at 8:58 , Rene Zaumseil wrote:

> Hi all,
> 
> I try to implement doxygen for a new language. I have parsed the language
> and got the documentation in Entries. (entry.h)
> 
> I have one Entry with documentation and declaration (like declaration in C++ 
> *.h file). The other Entry contains documentation and definition (like 
> definition in C++ *.cpp files). 
> 
> I can find the first Entry. But how can I bring these two together?

That is currently only needed and done for C/C++/ObjC (other languages
don't have a declaration and definition that needs to be matched). 

This is currently hardcoded for these languages in doxygen.cpp.
- Building a list of function/methods from Entry objects is done by 
  buildFunctionList().
- Matching documentation blocks with function/methods is done by 
  findMemberDocumentation()
- copying documentation from declaration to definition and vise-versa is done by
  transferFunctionDocumentation()
These are not the easiest and cleanest functions in doxygen I'm afraid.

I hope this helps,
  Dimitri
------------------------------------------------------------------------------
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.