Like Jakob says, looking at the doxygen source code to try and understand problems with your configuration is the wrong thing to do. Instead check the settings in your own doxygen configuration file against the manual. This might be a good place to start: http://www.stack.nl/~dimitri/doxygen/config.html#cfg_hide_in_body_docs
And make sure your source files are correctly tagged with the http://www.stack.nl/~dimitri/doxygen/commands.html#cmdfile command so they are actually included. A simple example of where your configuration file differs from the default, telling us what version of doxygen you're using and providing brief example code showing your problem are all basic things you should provide if you want help. Greg. -----Original Message----- From: Peng Yu [mailto:pengyu...@gmail.com] Sent: 17 August 2012 11:44 To: Jakob van Bethlehem Cc: doxygen-users@lists.sourceforge.net Subject: Re: [Doxygen-users] Why duplicated document are in both .h and .cpp? On Fri, Aug 17, 2012 at 3:22 AM, Jakob van Bethlehem <j.s.van.bethle...@astro.rug.nl> wrote: > On 08/17/2012 04:47 AM, Peng Yu wrote: >> Hi, >> >> In doxygen source code, I see the following. >> >> In filedef.h >> 95 /*! Returns the name of the verbatim copy of this file (if any). */ >> 96 QCString includeName() const; >> >> In filedef.cpp >> >> 1555 /*! Returns the name of the verbatim copy of this file (if any). >> */ 1556 QCString FileDef::includeName() const >> >> The document are the same. I'm wondering which one is redundant. >> >> I try to keep only the document in the cpp file (in my package). But >> it does not appear in the generated document. Is there a way to keep >> the document of member function in the cpp file and still have the >> generated document? >> > > Hej Peng, > > I don't think you should be looking at the source code if you want to > control output. First you really should be having a good look at all > the possible configuration options that Doxygen provides. For you > particular problem, I personally don't really understand what you're > trying to do. Maybe you can give a short example, and explain what you > would like Doxygen to generate for that. When you are at it, please > also mention the version you're using and what of output you're trying > to create. Hi Jakob, I merely want to look for some examples on how to put the document in *.cpp file but not in *.h file as I am not able to let doxygen to show comment from *.cpp files. I have tried many options, but I still don't find which option should be used in Doxyfile. To look for possible solutions to the above question, I went ahead to check the comments in doxygen source code. I surprisingly find the same comment appear in both *.cpp and *.h files which seems weird to me. So my second question is why duplicated comments need to put in both *.cpp and *.h files. Are my questions clear to you now? -- Regards, Peng ------------------------------------------------------------------------ ------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users **************************************************** Visit our website at http://www.domino-printing.com **************************************************** This Email and any files transmitted with it are intended only for the person or entity to which it is addressed and may contain confidential and/or privileged material. Any reading, redistribution, disclosure or other use of, or taking of any action in reliance upon, this information by persons or entities other than the intended recipient is prohibited. If you are not the intended recipient please contact the sender immediately and delete the material from your computer. E-mail may be susceptible to data corruption, interception, viruses and unauthorised amendment and Domino UK Limited does not accept liability for any such corruption, interception, viruses or amendment or their consequences. **************************************************** Domino UK Limited. Registered in England. Registered Number:1750201. Registered Office Address: Trafalgar Way, Bar Hill, Cambridge, CB23 8TU. ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users
