Re: [Doxygen-users] documenting C structure

2016-07-08 Thread Brian Henning
I have an anecdote related to this. In my experience, a comment block delineated by /**… */with more than two asterisks at the start is ignored by Doxygen. When I adopted doxygen markup into our project at work, we then had two competing comment block styles, and I ended up having to put a spa

Re: [Doxygen-users] A hash character inside a markdown table

2016-05-10 Thread Brian Henning
Aha! I don’t know why I didn’t think to try that. That works correctly. Thanks! From: Albert [mailto:albert.te...@gmail.com] Sent: Tuesday, May 10, 2016 1:42 PM To: Brian Henning Cc: doxygen-users@lists.sourceforge.net Subject: Re: [Doxygen-users] A hash character inside a markdown table

[Doxygen-users] A hash character inside a markdown table

2016-05-10 Thread Brian Henning
Hi, I'm trying to display a hash inside a string inside a markdown table. Here is the source: -0.5 | P#B2 | -2-1 This results in the following HTML for the center column: P::B2 If I try HTML entity such as this: -0.5 | P#B2 | -2-1 Then the entity ends up escaped in the HTML

Re: [Doxygen-users] Multiple indents inside paragraphs?

2016-05-04 Thread Brian Henning
ring It seems to be connected to the interior underscores. I can work around it of course by using … Cheers, -Brian From: Albert [mailto:albert.te...@gmail.com] Sent: Wednesday, May 04, 2016 5:36 AM To: Brian Henning Cc: doxygen-users@lists.sourceforge.net Subject: Re: [Doxygen-users] Mult

[Doxygen-users] Multiple indents inside paragraphs?

2016-05-03 Thread Brian Henning
Hello, I'm hoping to create some documentation that looks like this: Blah blah blah Blah blah blah Blah blah blah Blah blah blah Blah blah blah ... I don't want blank lines between, and I want multiple layers of indenting. I tried using HTML tags with inline style attri

Re: [Doxygen-users] more odd behavior

2015-09-04 Thread Brian Henning
Woody, Doxygen does not write documentation for you; it formats and cross-references documentation you have written. Doxygen generating a cross-reference to "control::V2" (which is a common convention to referring to a struct type member[1]) for the expression table_pointer->V2 is exactly what

Re: [Doxygen-users] Another question....

2015-09-04 Thread Brian Henning
>From the peanut gallery: Seems to me a reasonable thing to have as an option >in the doxygen configuration, the option for parameter names to be taken from >the definition rather than the prototype. With that said, the \param special >command's first argument is the parameter name. I haven't

[Doxygen-users] Formatting inside section title?

2014-01-10 Thread Brian Henning
oth simply appear as part of the rendered text. Example: \section static_members \c static \c const members Ideally, "static const" would be rendered in monospace in the final HTML. Thanks, ~Brian ------ Brian Henning, Software Engi

[Doxygen-users] "...terminate it in an unusual way."

2013-06-10 Thread Brian Henning
Hi, Sadly I am not sure which config change led to the start of the problem, but I am now seeing Doxygen 1.8.3.1 bail like so: [...] Computing class relations... Add enum values to enums... This application has requested the Runtime to terminate it in an unusual way. Please contact t

Re: [Doxygen-users] Strange problems with EXPAND_AS_DEFINED

2013-06-05 Thread Brian Henning
I'd just like to chime in and say I see this kind of behavior too, and it's worse in 1.8.3.1 than it was in 1.6.3 (the version I was using prior to grabbing 1.8.3.1). I haven't chased it as carefully as Geoff here, but I can definitely say that I've seen both macros not getting expanded and appare

Re: [Doxygen-users] Doxygen 1.8.3.1 not expanding macros?...

2013-05-10 Thread Brian Henning
some important macros in a header file there, but overall I don't want docs for the files in "drivers/" I will try to create a small contrived example soon. Thanks, ~Brian -Original Message- From: Dimitri van Heesch [mailto:doxy...@gmail.com] Sent: Friday, May 10, 2013 7:

[Doxygen-users] Doxygen 1.8.3.1 not expanding macros?...

2013-05-08 Thread Brian Henning
s a member property of various classes instead of being expanded to a set of method declarations (which it was doing properly in 1.6.3). Any help? Thanks, ~Brian -- Brian Henning, Software Engineer /\Pine Research Instr

[Doxygen-users] Can't get XML callergraphs on global anonymous-namespace functions

2013-04-30 Thread Brian Henning
;m somewhat of a novice Doxygen user. I appreciate all input and assistance! I have created a small contrived example which reproduces the problem; I will be glad to provide it if needed. Thanks, ~Brian ---------- Brian Henning, Sof