Re: [Doxygen-users] Presumed brief?

2013-10-07 Thread Greg Aldridge
Without knowing what "various document control settings" you've experimented with it's difficult to make suggestions or guess how well you've read the manual (or even the comments in the default config file). If you have read the manual (or comments) you'll already know about these:

Re: [Doxygen-users] Presumed brief?

2013-10-07 Thread John Yates
Greg, Thanks for the reply. (And thanks for correcting those typos in my final paragraph :-). Yes, I am familiar with all three of those settings. And today I actually get vaguely useful output from doxygen. The problems seem to be: - handling of C++ /// (to my mind the least obtrusive markup)

Re: [Doxygen-users] Presumed brief?

2013-10-07 Thread Dimitri van Heesch
Hi John, You can use MULTILINE_CPP_IS_BRIEF=YES and JAVADOC_AUTOBRIEF=NO /// A brief description that /// spans multiple lines. /// /// More details follow. or you can use MULTILINE_CPP_IS_BRIEF=NO and JAVADOC_AUTOBRIEF=YES /// A brief description that /// spans multiple lines. /// More deta

Re: [Doxygen-users] Using \todo in a similar way to \page

2013-10-07 Thread Ron Wilson
On Mon, Oct 7, 2013 at 9:01 AM, wrote: > Date: Sun, 6 Oct 2013 19:09:00 +0800 > From: Andrew Stoeckley > > I like how you can put a \page tag anywhere, even an empty header file with > nothing but doxygen comments, and use this to generate documentation. > > Unlike the \page tag, some other usef

Re: [Doxygen-users] Presumed brief?

2013-10-07 Thread Ron Wilson
On Mon, Oct 7, 2013 at 9:01 AM, wrote: > Date: Mon, 7 Oct 2013 09:01:21 -0400 > From: John Yates > Subject: Re: [Doxygen-users] Presumed brief? > > The problems seem to be: > - handling of C++ /// (to my mind the least obtrusive markup) seems > inconsistent with other comment syntaxes. > While