I would agree that you'd want both cases to produce the exact same documentation. I also noticed different results with and without the trailing period with JAVA_AUTOBRIEF set to YES, with respect to methods (I never tried to document data members). However, I actually noticed the opposite behavior from what you describe. With the period, you basically get what you'd expect: only the brief doc in the summary list of methods. Without the period, you get in addition a "detailed" description of the method, but that detailed description contains the same information.
In my opinion, this is a Doxygen bug, but it is minor with an easy workaround (just add the period). You can always file a bug in bugzilla against Doxygen to hopefully get it fixed. -John -----Original Message----- From: janez.paternos...@siol.net [mailto:janez.paternos...@siol.net] Sent: Thursday, February 28, 2013 12:33 AM To: doxygen-users@lists.sourceforge.net Subject: [Doxygen-users] Period after sentence in brief description I'm using Doxygen 1.8.3.1 with JAVADOC_AUTOBRIEF = YES. Other settings are default. typedef struct{ int8_t member1; /**< Brief description of the member */ int8_t member2; /**< Brief description of the member. */ }object1_t Doxygen produces different (HTML) output, if there is a period after the single sentence in brief description. In first case additional documentation for the menber1 is not generated. In second case there is a period after the sentence. Doxygen generates a link "more..." and additional documentation for the member1. Although there is no detailed description. Is this behavior intended? ------------------------------------------------------------------------------ Everyone hates slow websites. So do we. Make your web apps faster with AppDynamics Download AppDynamics Lite for free today: http://p.sf.net/sfu/appdyn_d2d_feb _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users ----------------------------------------------------------------------------------- This email message is for the sole use of the intended recipient(s) and may contain confidential information. Any unauthorized review, use, disclosure or distribution is prohibited. If you are not the intended recipient, please contact the sender by reply email and destroy all copies of the original message. ----------------------------------------------------------------------------------- ------------------------------------------------------------------------------ Everyone hates slow websites. So do we. Make your web apps faster with AppDynamics Download AppDynamics Lite for free today: http://p.sf.net/sfu/appdyn_d2d_feb _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users
