doxygen-users — List for users of doxygen

Re: [Doxygen-users] Zooming text in doxygen chm file

[Maciej W <tri...@gm...>]

TP, thanks for the links.

On Sat, Mar 22, 2014 at 2:09 AM, TP <wi...@gm...> wrote:

> First of all, changing the font size while viewing a CHM file can be done
> by simply pressing Control+"+" or Control+"-" (control+Plus or
> control+Minus keys).
>
> Ctrl++/- fail for me in the standard Windows CHM viewer while the doxygen
help file is opened (Windows XP SP3). Also, the Font button is visible, but
nothing happens upon clicking on it.

On Fri, Mar 21, 2014 at 10:41 AM, Albert <alb...@gm...> wrote:

>
> The "How to achieve this" is more on the programming / configuration
> level, I have not been able to find information to achieve the requested
> functionality. In the article I mentioned in my previous email there was a
> way to achieve it by setting some flags trough some settings in the IE
> properties panel. I assume there must be another way as well, but how?
> I tried the method mentioned in the article and this worked for me.
>


> Total Commander has a chm file with a working Font button.

Thanks.

Re: [Doxygen-users] Zooming text in doxygen chm file

[TP <wi...@gm...>]

First of all, changing the font size while viewing a CHM file can be done
by simply pressing Control+"+" or Control+"-" (control+Plus or
control+Minus keys).

The Locate / Next / Previous / Zoom toolbar buttons can be enabled by
following the instructions at "Adding tabs and toolbar buttons to HTML
Help" [1]. Additional info is at the HTML Help FAQ "Toolbar buttons"
article [2], "Adding The MSDN Menu To A CHM" [3], "Adding The Font Button
To A CHM" [4], and "How To Add a Font Button to an HTML Help Window
Toolbar" [5].

chm is pretty old now, but I have often wondered why this isn't the
default. In particular, it is very handy to have the "msdn" / Next /
Previous icons since that allows you to navigate thru the chm using the
Alt+Down / Alt+Up keyboard shortcuts.

BTW, changing toolbar button visibility requires the free Microsoft HTML
Help Workshop [6]. It can be used to decompile CHM files that you didn't
make yourself.

[1]
http://www.mif2go.com/xhtml/htmlhelp_0016_943addingtabsandtoolbarbuttonstohtmlhelp.htm#Rz108x95873

[2] http://wiki.helpmvp.com/home/notes/hhfaq#TOC-Toolbar-Buttons

[3]
http://frogleg.mvps.org/helptechnologies/htmlhelp/hhtips.html#addmenu2chm

[4]
http://frogleg.mvps.org/helptechnologies/htmlhelp/hhtips.html#addfontbtnchm

[5] http://support.microsoft.com/default.aspx?scid=KB;EN-US;Q240062&

[6] http://www.microsoft.com/en-us/download/details.aspx?id=21138

On Fri, Mar 21, 2014 at 10:41 AM, Albert <alb...@gm...> wrote:

>
> The "How to achieve this" is more on the programming / configuration
> level, I have not been able to find information to achieve the requested
> functionality. In the article I mentioned in my previous email there was a
> way to achieve it by setting some flags trough some settings in the IE
> properties panel. I assume there must be another way as well, but how?
> I tried the method mentioned in the article and this worked for me.
>

Re: [Doxygen-users] Zooming text in doxygen chm file

[Albert <alb...@gm...>]

Hi Maciej,

Thank you for the answer. How it will work for the user is indeed through
the Font button.

The "How to achieve this" is more on the programming / configuration level,
I have not been able to find information to achieve the requested
functionality. In the article I mentioned in my previous email there was a
way to achieve it by setting some flags trough some settings in the IE
properties panel. I assume there must be another way as well, but how?
I tried the method mentioned in the article and this worked for me.

You mention and image in your last mail. Where can I find the corresponding
chm file so I can have a look if they have set something special.

Albert



On Fri, Mar 21, 2014 at 10:12 AM, Maciej W <tri...@gm...> wrote:

> Hello Albert,
>
> this is how it works in other chm files: http://i.imgur.com/TsPaI4y.png .
> Upon clicking on that button the size of the font of the chm changes (there
> are five hard-coded zoom levels). I've also seen other chm files that
> displayed a menu with available zoom ratios upon clicking on a similar
> button.
>
>
> On Wed, Mar 19, 2014 at 6:49 PM, Albert <alb...@gm...> wrote:
>
>> How do you think this can be achieved? I looked at some documentation (
>> http://savannah.nongnu.org/projects/chmspec and
>> http://download.savannah.gnu.org/releases/chmspec/) but was not able to
>> find anything usable to put in the chm file.
>> I found this article:
>> http://geekycoder.wordpress.com/2010/01/12/solutions-to-enlarge-the-text-size-of-chm-without-tears/but this is on a per computer bas as far as I can see.
>>
>> Albert
>>
>>
>>
>> On Wed, Mar 19, 2014 at 11:28 AM, Maciej W <tri...@gm...> wrote:
>>
>>> Greetings,
>>>
>>> I've just downloaded doxygen and wanted to read the documentation from
>>> the chm file. The problem I have with the help file is that it is
>>> impossible to zoom the text / change the size of the font.
>>> Could the zoom option in doxygen chm help file be fixed?
>>>
>>> Cheers.
>>>
>>>
>>> ------------------------------------------------------------------------------
>>> Learn Graph Databases - Download FREE O'Reilly Book
>>> "Graph Databases" is the definitive new guide to graph databases and
>>> their
>>> applications. Written by three acclaimed leaders in the field,
>>> this first edition is now available. Download your free book today!
>>> http://p.sf.net/sfu/13534_NeoTech
>>> _______________________________________________
>>> Doxygen-users mailing list
>>> Dox...@li...
>>> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>>>
>>>
>>
>

Re: [Doxygen-users] Zooming text in doxygen chm file

[Albert <alb...@gm...>]

How do you think this can be achieved? I looked at some documentation (
http://savannah.nongnu.org/projects/chmspec and
http://download.savannah.gnu.org/releases/chmspec/) but was not able to
find anything usable to put in the chm file.
I found this article:
http://geekycoder.wordpress.com/2010/01/12/solutions-to-enlarge-the-text-size-of-chm-without-tears/but
this is on a per computer bas as far as I can see.

Albert



On Wed, Mar 19, 2014 at 11:28 AM, Maciej W <tri...@gm...> wrote:

> Greetings,
>
> I've just downloaded doxygen and wanted to read the documentation from the
> chm file. The problem I have with the help file is that it is impossible to
> zoom the text / change the size of the font.
> Could the zoom option in doxygen chm help file be fixed?
>
> Cheers.
>
>
> ------------------------------------------------------------------------------
> Learn Graph Databases - Download FREE O'Reilly Book
> "Graph Databases" is the definitive new guide to graph databases and their
> applications. Written by three acclaimed leaders in the field,
> this first edition is now available. Download your free book today!
> http://p.sf.net/sfu/13534_NeoTech
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>
>

[Doxygen-users] Zooming text in doxygen chm file

[Maciej W <tri...@gm...>]

Greetings,

I've just downloaded doxygen and wanted to read the documentation from the
chm file. The problem I have with the help file is that it is impossible to
zoom the text / change the size of the font.
Could the zoom option in doxygen chm help file be fixed?

Cheers.

Re: [Doxygen-users] Unable to run with the input filter

[Lorenzo R. <lor...@gm...>]

Hi Paul,
is js2doxy.pl in the Doxygen working directory?
Did you test the js2doxy.pl as INPUT_FILTER?
All the best,
Lorenzo.


2014-03-18 20:39 GMT+01:00 Paul Suman Raj Talari <pau...@gm...>:

> Hi Team,
> I tried adding the filter patter *.js=doxygen.js (
> https://gist.github.com/dimitarcl/3767879)
> sh: doxygen.js: command not found
> i even get the same error with *js=js2doxy.pl
> sh: s2doxy.pl: command not found
>
> Any help would be greatly appreciated. Thanks,
> Paul.
>
>
> ------------------------------------------------------------------------------
> Learn Graph Databases - Download FREE O'Reilly Book
> "Graph Databases" is the definitive new guide to graph databases and their
> applications. Written by three acclaimed leaders in the field,
> this first edition is now available. Download your free book today!
> http://p.sf.net/sfu/13534_NeoTech
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>
>

Re: [Doxygen-users] how to document multi dimensional arrays

[Ron W. <ron...@gm...>]

Date: Mon, 17 Mar 2014 20:54:43 +0100

> From: Fabio Mosti <fa...@vi...>
> hi everybody,
> in my application I use a simple array-based config system, something
> like this:
>
> $cf['section1']['param1'] = 'value';
> $cf['section1']['param2'] = 'value';
> $cf['section2']['param1'] = 'value';
>
> and so on... the problem is that in variable browsing section of the
> html docs the whole array is seen as a single $cf variable. There is a
> proper way to document the single cells of the array?
>

Looks like you are using PHP and named indices to simulate fields in a data
structure.

Disclaimer: I don't use PHP, so my examples below probably are not fully
correct. They are meant to illustrate my suggestions.

You might be able to just add @var directives to your source:

    $cf['section1']['param1'] = 'value'; ## @var $cf_section1_param1
description
    $cf['section1']['param2'] = 'value'; ## @var $cf_section1_param2
description

Not sure if this will actually work without trying it.

For Doxygen to actually see the individual elements of an array as
document-able entities, an input filter for Doxygen would be needed. The
filter output would something like:

    $cf_section1_param1 = 'value'; ##< description
    $cf_section1_param2 = 'value'; ##< description

[Doxygen-users] Unable to run with the input filter

[Paul S. R. T. <pau...@gm...>]

Hi Team,
I tried adding the filter patter *.js=doxygen.js (
https://gist.github.com/dimitarcl/3767879)
sh: doxygen.js: command not found
i even get the same error with *js=js2doxy.pl
sh: s2doxy.pl: command not found

Any help would be greatly appreciated. Thanks,
Paul.

[Doxygen-users] how to document multi dimensional arrays

[Fabio M. <fa...@vi...>]

hi everybody,
in my application I use a simple array-based config system, something 
like this:

$cf['section1']['param1'] = 'value';
$cf['section1']['param2'] = 'value';
$cf['section2']['param1'] = 'value';

and so on... the problem is that in variable browsing section of the 
html docs the whole array is seen as a single $cf variable. There is a 
proper way to document the single cells of the array?

-- 
*Fabio Mosti*
titolare - direzione produzione
fa...@vi... <mailto:fa...@vi...>
cell. +39.329.434.90.95
skype fabio.massimo.mosti

*Videoarts Webdesign*
via Floriano Ambrosini 2/b
40131 Bologna BO
tel. +39.051.098.08.21
fax +39.051.199.31.222
in...@vi... <mailto:in...@vi...>
www.videoarts.eu <http://www.videoarts.eu>
skype videoarts.webdesign

p.iva 02263631208
cod.fisc. MSTFBA79B26A944C

Re: [Doxygen-users] Forward declaration of typedef results in warning

[didje <dia...@pd...>]

Hi Albert,
The documentation of "NONE" is indeed inside the namespace, so that's strange to have this problem in those circumstances.
I tried using the fully qualified names - with namespace - but the problem remained.
I solved this problem by renaming the enum "NONE" to something else, however, I cannot understand why the problem occurs and when I try to create a sample program doing the same thing, I cannot reproduce it.
I will post to Stack Exchange the details.
Diarmuid


From: Albert_1 [via Doxygen] [mailto:ml-...@n7...]
Sent: Thursday, March 13, 2014 9:38 AM
To: Diarmuid Kieran
Subject: Re: Forward declaration of typedef results in warning

Hi Diarmuid,
Some thoughts:
- is the documentation of the "NONE" etc inside or outside the namespace, if outside what is te effect of bringing it inside
- is it possible to use "full qualified names" i.e. with namespace etc?
- Can you also post, as an answer, the results of the investigations so far in your stach exchange question?
Albert

On Wed, Mar 12, 2014 at 6:04 PM, Albert <[hidden email]</user/SendEmail.jtp?type=node&node=6553&i=0>> wrote:
Hi Diarmuid,
Indeed without more information it is hard to get to the root of the problem.
Albert

On Wed, Mar 12, 2014 at 5:02 PM, Diarmuid Kieran <[hidden email]</user/SendEmail.jtp?type=node&node=6553&i=1>> wrote:
Hi again Albert

-          Version 1.8.4

-          I don't understand the code of the macro in question, so I can't tell you much about it. However, here are some (perhaps) relevant doxyfile config properties:

MACRO_EXPANSION = YES

EXPAND_ONLY_PREDEF = YES
Probably not much help that, this macro and its use is somewhat beyond me (not being a C++ programmer myself...)


From: Albert [mailto:[hidden email]</user/SendEmail.jtp?type=node&node=6553&i=2>]
Sent: Wednesday, March 12, 2014 12:33 PM
To: Diarmuid Kieran
Cc: [hidden email]</user/SendEmail.jtp?type=node&node=6553&i=3>
Subject: Re: [Doxygen-users] Forward declaration of typedef results in warning

- Which version of doxygen are you using
- can you give a little bit more of an example (i.e. changes of your doxyfile compared to the standard doxyfile, definition of FORWARD_DECLARE_MACRO etc.) so the problem can be reproduced?
Albert

On Wed, Mar 12, 2014 at 12:09 PM, didje <[hidden email]</user/SendEmail.jtp?type=node&node=6553&i=4>> wrote:
Forward declaration of typedef results in warning:
Warning: documented symbol TypeDef_A_ptr  was not declared or defined.

Example
(Note: the macro below forward declares a typedef called "TypeDef_A_ptr")

ClassA.h

FORWARD_DECLARE_MACRO(TypeDef_A)


ClassA.cpp

/* \typedef typedef TypeDef_A_ptr
* Description of TypeDef_A
*/





--
View this message in context: http://doxygen.10944.n7.nabble.com/Forward-declaration-of-typedef-results-in-warning-tp6542.html
Sent from the Doxygen - Users mailing list archive at Nabble.com.

------------------------------------------------------------------------------
Learn Graph Databases - Download FREE O'Reilly Book
"Graph Databases" is the definitive new guide to graph databases and their
applications. Written by three acclaimed leaders in the field,
this first edition is now available. Download your free book today!
http://p.sf.net/sfu/13534_NeoTech
_______________________________________________
Doxygen-users mailing list
[hidden email]</user/SendEmail.jtp?type=node&node=6553&i=5>
https://lists.sourceforge.net/lists/listinfo/doxygen-users

-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.



------------------------------------------------------------------------------
Learn Graph Databases - Download FREE O'Reilly Book
"Graph Databases" is the definitive new guide to graph databases and their
applications. Written by three acclaimed leaders in the field,
this first edition is now available. Download your free book today!
http://p.sf.net/sfu/13534_NeoTech
_______________________________________________
Doxygen-users mailing list
[hidden email]</user/SendEmail.jtp?type=node&node=6553&i=6>
https://lists.sourceforge.net/lists/listinfo/doxygen-users

________________________________
If you reply to this email, your message will be added to the discussion below:
http://doxygen.10944.n7.nabble.com/Forward-declaration-of-typedef-results-in-warning-tp6542p6553.html
To unsubscribe from Forward declaration of typedef results in warning, click here<http://doxygen.10944.n7.nabble.com/template/NamlServlet.jtp?macro=unsubscribe_by_code&node=6542&code=ZGlhcm11aWQua2llcmFuQHBkZ20uY29tfDY1NDJ8NTEyNTQ5NDM2>.
NAML<http://doxygen.10944.n7.nabble.com/template/NamlServlet.jtp?macro=macro_viewer&id=instant_html%21nabble%3Aemail.naml&base=nabble.naml.namespaces.BasicNamespace-nabble.view.web.template.NabbleNamespace-nabble.view.web.template.NodeNamespace&breadcrumbs=notify_subscribers%21nabble%3Aemail.naml-instant_emails%21nabble%3Aemail.naml-send_instant_email%21nabble%3Aemail.naml>
-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.




--
View this message in context: http://doxygen.10944.n7.nabble.com/Forward-declaration-of-typedef-results-in-warning-tp6542p6558.html
Sent from the Doxygen - Users mailing list archive at Nabble.com.

[Doxygen-users] Fwd: Starting with 1.8.4 I get a blank output

[Albert <alb...@gm...>]

Forgot to include the list

---------- Forwarded message ----------
From: Albert <alb...@gm...>
Date: Sun, Mar 16, 2014 at 6:43 PM
Subject: Re: [Doxygen-users] Starting with 1.8.4 I get a blank output
To: Timo Kunze <TKu...@gm...>


Hi Timo,

You are using version 1.8.4 of doxygen, but according to your
public_docs_CHM.cfg your start version was 1.7.3.

In version 1.7.3 there was no support for markdown, this introduced (a.o.)
"fenced code blocks. From the documentation:
5.2.3 Fenced Code Blocks
Another feature defined by "Markdown Extra" is support for fenced code
blocks:
A fenced code block does not require indentation, and is defined by a pair
of "fence lines". Such a line consists of
3 or more tilde ( ) characters on a line. The end of the block should have
the same number of tildes.

This will not solve your problem completely as there seems to be an
interaction with the <pre> tag (see *Bug
726469*<https://bugzilla.gnome.org/show_bug.cgi?id=726469>- Tilde
sign in combination with <pre> and MARKDOWN_SUPPORT disabled) a solution
for you might be to use = (equal) or - (minus) signs.

Albert


On Mon, Feb 17, 2014 at 11:20 PM, Timo Kunze <TKu...@gm...> wrote:

> Hi,
>
> I'm getting a blank HTML/CHM output with any doxygen version newer than
> 1.8.3.1. I use this config file:
>
> www.timosoft-software.de/stuff/public_docs_CHM.cfg
>
>
> And basically this file is the only source file:
>
> www.timosoft-software.de/stuff/AnimU.idl
>
>
> The error message I get is:
>
> "doxygen reached end of file while inside a (null) block!"
>
> But I cannot find any block that gets opened, but not closed.
> So is this a bug in doxygen? Or am I using it wrong?
>
> Regards
> Timo
> --
> www.TimoSoft-Software.de - Unicode controls for VB6
> "Those who sacrifice freedom for safety deserve neither."
> "Demokratie ist per Definition unsicher. Ihr Schutz entsteht aus der
> Überzeugung, dass die demokratischen Kräfte überwiegen und sich - auf
> demokratischem Wege - durchsetzen."
>
>
> ------------------------------------------------------------------------------
> Managing the Performance of Cloud-Based Applications
> Take advantage of what the Cloud has to offer - Avoid Common Pitfalls.
> Read the Whitepaper.
>
> http://pubads.g.doubleclick.net/gampad/clk?id=121054471&iu=/4140/ostg.clktrk
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>

Re: [Doxygen-users] Generating documentation when source code is continuously being updated

[Dimitri v. H. <do...@gm...>]

On 16 Mar 2014, at 11:31 , Khirod Kant Naik <khi...@gm...> wrote:

> I want to add Doxygen support to DXR. The DXR indexes the source code of popular mozilla source trees like mozilla-central and comm-central.
> 
> As said the source code of these trees is continuously being updated. How can we generate documentation of such source code?? Is there a possible, work around or one has to deal with it and generate documentation each time from scratch.

It depends. I've explained a way here: http://stackoverflow.com/a/8247993/784672 but it has some limitations (which are listed).

Regards,
  Dimitri

[Doxygen-users] Generating documentation when source code is continuously being updated

[Khirod K. N. <khi...@gm...>]

I want to add Doxygen support to DXR. The DXR indexes the source code of
popular mozilla source trees like mozilla-central and comm-central.

As said the source code of these trees is continuously being updated. How
can we generate documentation of such source code?? Is there a possible,
work around or one has to deal with it and generate documentation each time
from scratch.

[Doxygen-users] Description from static functions

[skraxberger <ste...@nx...>]

Hi,

I have a problem with the description of static functions. In some cases our
H files are split into two. xxxx.h and xxxx_int.h (which contains the
internal functions). The implementation is for both H files in xxxx.c. Now
for generating the documentation the contents for the static functions is
only taken from the H file and not from the xxxx.c file, where additional
information is provided (other than a brief function and parameter
description). I have annotated all the files with \file in order to group
them together but it still doesn't show the whole information in the
resulting documentation.

Can anyone help please?

Regards,

Stefan



--
View this message in context: http://doxygen.10944.n7.nabble.com/Description-from-static-functions-tp6554.html
Sent from the Doxygen - Users mailing list archive at Nabble.com.

Re: [Doxygen-users] Forward declaration of typedef results in warning

[Albert <alb...@gm...>]

Hi Diarmuid,

Some thoughts:
- is the documentation of the "NONE" etc inside or outside the namespace,
if outside what is te effect of bringing it inside
- is it possible to use "full qualified names" i.e. with namespace etc?

- Can you also post, as an answer, the results of the investigations so far
in your stach exchange question?

Albert


On Wed, Mar 12, 2014 at 6:04 PM, Albert <alb...@gm...> wrote:

> Hi Diarmuid,
>
> Indeed without more information it is hard to get to the root of the
> problem.
>
> Albert
>
>
> On Wed, Mar 12, 2014 at 5:02 PM, Diarmuid Kieran <Dia...@pd...
> > wrote:
>
>>  Hi again Albert
>>
>> -          Version 1.8.4
>>
>> -          I don't understand the code of the macro in question, so I
>> can't tell you much about it. However, here are some (perhaps) relevant
>> doxyfile config properties:
>>
>> MACRO_EXPANSION = YES
>>
>> EXPAND_ONLY_PREDEF = YES
>>
>> Probably not much help that, this macro and its use is somewhat beyond me
>> (not being a C++ programmer myself...)
>>
>>
>>
>>
>>
>> *From:* Albert [mailto:alb...@gm...]
>> *Sent:* Wednesday, March 12, 2014 12:33 PM
>> *To:* Diarmuid Kieran
>> *Cc:* dox...@li...
>> *Subject:* Re: [Doxygen-users] Forward declaration of typedef results in
>> warning
>>
>>
>>
>> - Which version of doxygen are you using
>>
>> - can you give a little bit more of an example (i.e. changes of your
>> doxyfile compared to the standard doxyfile, definition of
>> FORWARD_DECLARE_MACRO etc.) so the problem can be reproduced?
>>
>> Albert
>>
>>
>>
>> On Wed, Mar 12, 2014 at 12:09 PM, didje <dia...@pd...> wrote:
>>
>> Forward declaration of typedef results in warning:
>> Warning: documented symbol TypeDef_A_ptr  was not declared or defined.
>>
>> Example
>> (Note: the macro below forward declares a typedef called "TypeDef_A_ptr")
>>
>> ClassA.h
>>
>> FORWARD_DECLARE_MACRO(TypeDef_A)
>>
>>
>> ClassA.cpp
>>
>> /* \typedef typedef TypeDef_A_ptr
>> * Description of TypeDef_A
>> */
>>
>>
>>
>>
>>
>> --
>> View this message in context:
>> http://doxygen.10944.n7.nabble.com/Forward-declaration-of-typedef-results-in-warning-tp6542.html
>> Sent from the Doxygen - Users mailing list archive at Nabble.com.
>>
>>
>> ------------------------------------------------------------------------------
>> Learn Graph Databases - Download FREE O'Reilly Book
>> "Graph Databases" is the definitive new guide to graph databases and their
>> applications. Written by three acclaimed leaders in the field,
>> this first edition is now available. Download your free book today!
>> http://p.sf.net/sfu/13534_NeoTech
>> _______________________________________________
>> Doxygen-users mailing list
>> Dox...@li...
>> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>>
>>
>>  --------------------------------------------------------------------------------
>> This e-mail, including any attached files, may contain confidential and
>> privileged information for the sole use of the intended recipient. Any
>> review, use, distribution, or disclosure by others is strictly prohibited.
>> If you are not the intended recipient (or authorized to receive information
>> for the intended recipient), please contact the sender by reply e-mail and
>> delete all copies of this message.
>>
>
>

Re: [Doxygen-users] Forward declaration of typedef results in warning

[Albert <alb...@gm...>]

Hi Diarmuid,

Indeed without more information it is hard to get to the root of the
problem.

Albert


On Wed, Mar 12, 2014 at 5:02 PM, Diarmuid Kieran
<Dia...@pd...>wrote:

>  Hi again Albert
>
> -          Version 1.8.4
>
> -          I don't understand the code of the macro in question, so I
> can't tell you much about it. However, here are some (perhaps) relevant
> doxyfile config properties:
>
> MACRO_EXPANSION = YES
>
> EXPAND_ONLY_PREDEF = YES
>
> Probably not much help that, this macro and its use is somewhat beyond me
> (not being a C++ programmer myself...)
>
>
>
>
>
> *From:* Albert [mailto:alb...@gm...]
> *Sent:* Wednesday, March 12, 2014 12:33 PM
> *To:* Diarmuid Kieran
> *Cc:* dox...@li...
> *Subject:* Re: [Doxygen-users] Forward declaration of typedef results in
> warning
>
>
>
> - Which version of doxygen are you using
>
> - can you give a little bit more of an example (i.e. changes of your
> doxyfile compared to the standard doxyfile, definition of
> FORWARD_DECLARE_MACRO etc.) so the problem can be reproduced?
>
> Albert
>
>
>
> On Wed, Mar 12, 2014 at 12:09 PM, didje <dia...@pd...> wrote:
>
> Forward declaration of typedef results in warning:
> Warning: documented symbol TypeDef_A_ptr  was not declared or defined.
>
> Example
> (Note: the macro below forward declares a typedef called "TypeDef_A_ptr")
>
> ClassA.h
>
> FORWARD_DECLARE_MACRO(TypeDef_A)
>
>
> ClassA.cpp
>
> /* \typedef typedef TypeDef_A_ptr
> * Description of TypeDef_A
> */
>
>
>
>
>
> --
> View this message in context:
> http://doxygen.10944.n7.nabble.com/Forward-declaration-of-typedef-results-in-warning-tp6542.html
> Sent from the Doxygen - Users mailing list archive at Nabble.com.
>
>
> ------------------------------------------------------------------------------
> Learn Graph Databases - Download FREE O'Reilly Book
> "Graph Databases" is the definitive new guide to graph databases and their
> applications. Written by three acclaimed leaders in the field,
> this first edition is now available. Download your free book today!
> http://p.sf.net/sfu/13534_NeoTech
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>
>
>  --------------------------------------------------------------------------------
> This e-mail, including any attached files, may contain confidential and
> privileged information for the sole use of the intended recipient. Any
> review, use, distribution, or disclosure by others is strictly prohibited.
> If you are not the intended recipient (or authorized to receive information
> for the intended recipient), please contact the sender by reply e-mail and
> delete all copies of this message.
>

Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

[Albert <alb...@gm...>]

Hi Diarmuid,

Maybe you can create a small example with the recent acquired knowledge and
file a bug report.

Albert


On Wed, Mar 12, 2014 at 4:46 PM, Diarmuid Kieran
<Dia...@pd...>wrote:

>  Just putting the below exchange onto the mailing list in case someone
> might also have an idea about it.
>
>
>
> *From:* Diarmuid Kieran
> *Sent:* Wednesday, March 12, 2014 4:44 PM
> *To:* 'Albert'
> *Subject:* RE: [Doxygen-users] enum value of "NONE" is not understood by
> Doxygen.
>
>
>
> I've discovered the problem, but not the solution. (Sort of like global
> warming!)
>
> There is another file elsewhere in the code which has an enum with an
> identically named member.
>
> If I rename that enum member in the other file, the present enum member
> has its doxygen doc generated successfully without warning. Otherwise, the
> warning and documentation for code are not generated.
>
> Weird thing is that the other enum is in a different namespace, so I don't
> see why its causing a problem, but it is.
>
>
>
> *From:* Albert [mailto:alb...@gm... <alb...@gm...>]
> *Sent:* Wednesday, March 12, 2014 2:37 PM
> *To:* Diarmuid Kieran
> *Subject:* Re: [Doxygen-users] enum value of "NONE" is not understood by
> Doxygen.
>
>
>
> Hi Diarmund
>
> Looks indeed like a local problem. You probably won't be able to send me
> the offending code (proprietary  code) so best way would be to remove files
> in batches / directories and see when you get a minimal set or just take
> the files where NONE is defined and run them.
>
> Albert
>
>
>
> On Wed, Mar 12, 2014 at 2:30 PM, Diarmuid Kieran <Dia...@pd...>
> wrote:
>
> I ran the same example as you using the doxyfile you sent and I get the
> same result as you.
>
> And then I ran it using my own doxygen file and - also the same result as
> you! (I had not run the example correctly when I posted on nabble, I now
> realize...)
>
> I also see various places in our code "NONE" as a member of an ENUM
> without problem. It is only causing a problem in one place. Unfortunately,
> I can't figure out why it causes the problem there.
>
>
>
> *From:* Albert [mailto:alb...@gm...]
> *Sent:* Wednesday, March 12, 2014 1:46 PM
>
>
> *To:* Diarmuid Kieran
> *Cc:* dox...@li...
> *Subject:* Re: [Doxygen-users] enum value of "NONE" is not understood by
> Doxygen.
>
>
>
> As requested
>
>
>
> On Wed, Mar 12, 2014 at 1:42 PM, Diarmuid Kieran <Dia...@pd...>
> wrote:
>
> Can you send me the files you are using to test it, I'll run them on my
> side and see if that helps.
>
>
>
> *From:* Albert [mailto:alb...@gm...]
> *Sent:* Wednesday, March 12, 2014 1:39 PM
>
>
> *To:* Diarmuid Kieran
> *Cc:* dox...@li...
> *Subject:* Re: [Doxygen-users] enum value of "NONE" is not understood by
> Doxygen.
>
>
>
> Hi Diarmuid,
>
> I tried it with 1.8.4 and see no warning message and I see on the page of
> the g file the enum completely described.
>
> As I cannot reproduce the problem I'm not sure which setting might cause
> the problem.
>
> Albert
>
>
>
>
>
> On Wed, Mar 12, 2014 at 1:34 PM, Diarmuid Kieran <Dia...@pd...>
> wrote:
>
> Hi Albert,
>
> Thanks for your reply.
>
> I'm using version 1.8.4
>
> I'm not sure what special settings you mean? The config file has been
> changed from the standard alright, but in a lot of places. Is there some
> specific properties you are referring to?
>
> Diarmuid
>
>
>
> *From:* Albert [mailto:alb...@gm...]
> *Sent:* Wednesday, March 12, 2014 12:13 PM
> *To:* Diarmuid Kieran
> *Cc:* dox...@li...
> *Subject:* Re: [Doxygen-users] enum value of "NONE" is not understood by
> Doxygen.
>
>
>
> I tried the example with version 1.8.6  and didn't see a problem / warning
> (standard doxygen configuration file, adding \file command to Aclass.{h,cpp}
> - Which version are you using?
>
> - Any special settings in your doxygen configuration file?
>
> Albert
>
>
>
> On Wed, Mar 12, 2014 at 11:34 AM, didje <dia...@pd...> wrote:
>
> In this example:
>
> AClass.h
>
> enum AnEnum {
>  NONE=0, A_VALUE, B_VALUE
> };
>
>
> AClass.cpp
>
> /*! \enum AnEnum
>  * \brief Various useful values
> */
>
> /*! \var A_VALUE
>  * \brief THe value of A
> */
>
> /*! \var B_VALUE
>  * \brief THe value of B
> */
>
> /*! \var NONE
>  * \brief A value of zero
> */
>
>
> Doxygen gives me the warning message:
>
> Warning: no matching class member found for AnEnum::NONE
>
> If I change the name of "NONE" to "NONE*X*", I don't have this warning. So
> it would seem that
> "NONE" is not understood properly by doxygen as an enum value.
>
> Does anyone know if I can get around this somehow (other than by renaming
> "NONE"). This would seem to be a bug in Doxygen.
>
>
>
>
> --
> View this message in context:
> http://doxygen.10944.n7.nabble.com/enum-value-of-NONE-is-not-understood-by-Doxygen-tp6541.html
> Sent from the Doxygen - Users mailing list archive at Nabble.com.
>
>
> ------------------------------------------------------------------------------
> Learn Graph Databases - Download FREE O'Reilly Book
> "Graph Databases" is the definitive new guide to graph databases and their
> applications. Written by three acclaimed leaders in the field,
> this first edition is now available. Download your free book today!
> http://p.sf.net/sfu/13534_NeoTech
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>
>
>
> --------------------------------------------------------------------------------
> This e-mail, including any attached files, may contain confidential and
> privileged information for the sole use of the intended recipient. Any
> review, use, distribution, or disclosure by others is strictly prohibited.
> If you are not the intended recipient (or authorized to receive information
> for the intended recipient), please contact the sender by reply e-mail and
> delete all copies of this message.
>
>
>
> --------------------------------------------------------------------------------
> This e-mail, including any attached files, may contain confidential and
> privileged information for the sole use of the intended recipient. Any
> review, use, distribution, or disclosure by others is strictly prohibited.
> If you are not the intended recipient (or authorized to receive information
> for the intended recipient), please contact the sender by reply e-mail and
> delete all copies of this message.
>
>
>
> --------------------------------------------------------------------------------
> This e-mail, including any attached files, may contain confidential and
> privileged information for the sole use of the intended recipient. Any
> review, use, distribution, or disclosure by others is strictly prohibited.
> If you are not the intended recipient (or authorized to receive information
> for the intended recipient), please contact the sender by reply e-mail and
> delete all copies of this message.
>
>
>  --------------------------------------------------------------------------------
> This e-mail, including any attached files, may contain confidential and
> privileged information for the sole use of the intended recipient. Any
> review, use, distribution, or disclosure by others is strictly prohibited.
> If you are not the intended recipient (or authorized to receive information
> for the intended recipient), please contact the sender by reply e-mail and
> delete all copies of this message.
>

Re: [Doxygen-users] Forward declaration of typedef results in warning

[Diarmuid K. <Dia...@PD...>]

Hi again Albert

-          Version 1.8.4

-          I don't understand the code of the macro in question, so I can't tell you much about it. However, here are some (perhaps) relevant doxyfile config properties:

MACRO_EXPANSION = YES

EXPAND_ONLY_PREDEF = YES
Probably not much help that, this macro and its use is somewhat beyond me (not being a C++ programmer myself...)


From: Albert [mailto:alb...@gm...]
Sent: Wednesday, March 12, 2014 12:33 PM
To: Diarmuid Kieran
Cc: dox...@li...
Subject: Re: [Doxygen-users] Forward declaration of typedef results in warning

- Which version of doxygen are you using
- can you give a little bit more of an example (i.e. changes of your doxyfile compared to the standard doxyfile, definition of FORWARD_DECLARE_MACRO etc.) so the problem can be reproduced?
Albert

On Wed, Mar 12, 2014 at 12:09 PM, didje <dia...@pd...<mailto:dia...@pd...>> wrote:
Forward declaration of typedef results in warning:
Warning: documented symbol TypeDef_A_ptr  was not declared or defined.

Example
(Note: the macro below forward declares a typedef called "TypeDef_A_ptr")

ClassA.h

FORWARD_DECLARE_MACRO(TypeDef_A)


ClassA.cpp

/* \typedef typedef TypeDef_A_ptr
* Description of TypeDef_A
*/





--
View this message in context: http://doxygen.10944.n7.nabble.com/Forward-declaration-of-typedef-results-in-warning-tp6542.html
Sent from the Doxygen - Users mailing list archive at Nabble.com.

------------------------------------------------------------------------------
Learn Graph Databases - Download FREE O'Reilly Book
"Graph Databases" is the definitive new guide to graph databases and their
applications. Written by three acclaimed leaders in the field,
this first edition is now available. Download your free book today!
http://p.sf.net/sfu/13534_NeoTech
_______________________________________________
Doxygen-users mailing list
Dox...@li...<mailto:Dox...@li...>
https://lists.sourceforge.net/lists/listinfo/doxygen-users

-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.

Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

[Diarmuid K. <Dia...@PD...>]

Just putting the below exchange onto the mailing list in case someone might also have an idea about it.

From: Diarmuid Kieran
Sent: Wednesday, March 12, 2014 4:44 PM
To: 'Albert'
Subject: RE: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

I've discovered the problem, but not the solution. (Sort of like global warming!)
There is another file elsewhere in the code which has an enum with an identically named member.
If I rename that enum member in the other file, the present enum member has its doxygen doc generated successfully without warning. Otherwise, the warning and documentation for code are not generated.
Weird thing is that the other enum is in a different namespace, so I don't see why its causing a problem, but it is.

From: Albert [mailto:alb...@gm...]
Sent: Wednesday, March 12, 2014 2:37 PM
To: Diarmuid Kieran
Subject: Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

Hi Diarmund
Looks indeed like a local problem. You probably won't be able to send me the offending code (proprietary  code) so best way would be to remove files in batches / directories and see when you get a minimal set or just take the files where NONE is defined and run them.
Albert

On Wed, Mar 12, 2014 at 2:30 PM, Diarmuid Kieran <Dia...@pd...<mailto:Dia...@pd...>> wrote:
I ran the same example as you using the doxyfile you sent and I get the same result as you.
And then I ran it using my own doxygen file and - also the same result as you! (I had not run the example correctly when I posted on nabble, I now realize...)
I also see various places in our code "NONE" as a member of an ENUM without problem. It is only causing a problem in one place. Unfortunately, I can't figure out why it causes the problem there.

From: Albert [mailto:alb...@gm...<mailto:alb...@gm...>]
Sent: Wednesday, March 12, 2014 1:46 PM

To: Diarmuid Kieran
Cc: dox...@li...<mailto:dox...@li...>
Subject: Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

As requested

On Wed, Mar 12, 2014 at 1:42 PM, Diarmuid Kieran <Dia...@pd...<mailto:Dia...@pd...>> wrote:
Can you send me the files you are using to test it, I'll run them on my side and see if that helps.

From: Albert [mailto:alb...@gm...<mailto:alb...@gm...>]
Sent: Wednesday, March 12, 2014 1:39 PM

To: Diarmuid Kieran
Cc: dox...@li...<mailto:dox...@li...>
Subject: Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

Hi Diarmuid,
I tried it with 1.8.4 and see no warning message and I see on the page of the g file the enum completely described.
As I cannot reproduce the problem I'm not sure which setting might cause the problem.
Albert


On Wed, Mar 12, 2014 at 1:34 PM, Diarmuid Kieran <Dia...@pd...<mailto:Dia...@pd...>> wrote:
Hi Albert,
Thanks for your reply.
I'm using version 1.8.4
I'm not sure what special settings you mean? The config file has been changed from the standard alright, but in a lot of places. Is there some specific properties you are referring to?
Diarmuid

From: Albert [mailto:alb...@gm...<mailto:alb...@gm...>]
Sent: Wednesday, March 12, 2014 12:13 PM
To: Diarmuid Kieran
Cc: dox...@li...<mailto:dox...@li...>
Subject: Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

I tried the example with version 1.8.6  and didn't see a problem / warning (standard doxygen configuration file, adding \file command to Aclass.{h,cpp}
- Which version are you using?
- Any special settings in your doxygen configuration file?
Albert

On Wed, Mar 12, 2014 at 11:34 AM, didje <dia...@pd...<mailto:dia...@pd...>> wrote:
In this example:

AClass.h

enum AnEnum {
 NONE=0, A_VALUE, B_VALUE
};


AClass.cpp

/*! \enum AnEnum
 * \brief Various useful values
*/

/*! \var A_VALUE
 * \brief THe value of A
*/

/*! \var B_VALUE
 * \brief THe value of B
*/

/*! \var NONE
 * \brief A value of zero
*/


Doxygen gives me the warning message:

Warning: no matching class member found for AnEnum::NONE

If I change the name of "NONE" to "NONE*X*", I don't have this warning. So
it would seem that
"NONE" is not understood properly by doxygen as an enum value.

Does anyone know if I can get around this somehow (other than by renaming
"NONE"). This would seem to be a bug in Doxygen.




--
View this message in context: http://doxygen.10944.n7.nabble.com/enum-value-of-NONE-is-not-understood-by-Doxygen-tp6541.html
Sent from the Doxygen - Users mailing list archive at Nabble.com.

------------------------------------------------------------------------------
Learn Graph Databases - Download FREE O'Reilly Book
"Graph Databases" is the definitive new guide to graph databases and their
applications. Written by three acclaimed leaders in the field,
this first edition is now available. Download your free book today!
http://p.sf.net/sfu/13534_NeoTech
_______________________________________________
Doxygen-users mailing list
Dox...@li...<mailto:Dox...@li...>
https://lists.sourceforge.net/lists/listinfo/doxygen-users

-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.

-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.

-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.

-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.

Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

[Diarmuid K. <Dia...@PD...>]

Can you send me the files you are using to test it, I'll run them on my side and see if that helps.

From: Albert [mailto:alb...@gm...]
Sent: Wednesday, March 12, 2014 1:39 PM
To: Diarmuid Kieran
Cc: dox...@li...
Subject: Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

Hi Diarmuid,
I tried it with 1.8.4 and see no warning message and I see on the page of the g file the enum completely described.
As I cannot reproduce the problem I'm not sure which setting might cause the problem.
Albert


On Wed, Mar 12, 2014 at 1:34 PM, Diarmuid Kieran <Dia...@pd...<mailto:Dia...@pd...>> wrote:
Hi Albert,
Thanks for your reply.
I'm using version 1.8.4
I'm not sure what special settings you mean? The config file has been changed from the standard alright, but in a lot of places. Is there some specific properties you are referring to?
Diarmuid

From: Albert [mailto:alb...@gm...<mailto:alb...@gm...>]
Sent: Wednesday, March 12, 2014 12:13 PM
To: Diarmuid Kieran
Cc: dox...@li...<mailto:dox...@li...>
Subject: Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

I tried the example with version 1.8.6  and didn't see a problem / warning (standard doxygen configuration file, adding \file command to Aclass.{h,cpp}
- Which version are you using?
- Any special settings in your doxygen configuration file?
Albert

On Wed, Mar 12, 2014 at 11:34 AM, didje <dia...@pd...<mailto:dia...@pd...>> wrote:
In this example:

AClass.h

enum AnEnum {
 NONE=0, A_VALUE, B_VALUE
};


AClass.cpp

/*! \enum AnEnum
 * \brief Various useful values
*/

/*! \var A_VALUE
 * \brief THe value of A
*/

/*! \var B_VALUE
 * \brief THe value of B
*/

/*! \var NONE
 * \brief A value of zero
*/


Doxygen gives me the warning message:

Warning: no matching class member found for AnEnum::NONE

If I change the name of "NONE" to "NONE*X*", I don't have this warning. So
it would seem that
"NONE" is not understood properly by doxygen as an enum value.

Does anyone know if I can get around this somehow (other than by renaming
"NONE"). This would seem to be a bug in Doxygen.




--
View this message in context: http://doxygen.10944.n7.nabble.com/enum-value-of-NONE-is-not-understood-by-Doxygen-tp6541.html
Sent from the Doxygen - Users mailing list archive at Nabble.com.

------------------------------------------------------------------------------
Learn Graph Databases - Download FREE O'Reilly Book
"Graph Databases" is the definitive new guide to graph databases and their
applications. Written by three acclaimed leaders in the field,
this first edition is now available. Download your free book today!
http://p.sf.net/sfu/13534_NeoTech
_______________________________________________
Doxygen-users mailing list
Dox...@li...<mailto:Dox...@li...>
https://lists.sourceforge.net/lists/listinfo/doxygen-users

-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.

-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.

Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

[Diarmuid K. <Dia...@PD...>]

Hi Albert,
Thanks for your reply.
I'm using version 1.8.4
I'm not sure what special settings you mean? The config file has been changed from the standard alright, but in a lot of places. Is there some specific properties you are referring to?
Diarmuid

From: Albert [mailto:alb...@gm...]
Sent: Wednesday, March 12, 2014 12:13 PM
To: Diarmuid Kieran
Cc: dox...@li...
Subject: Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

I tried the example with version 1.8.6  and didn't see a problem / warning (standard doxygen configuration file, adding \file command to Aclass.{h,cpp}
- Which version are you using?
- Any special settings in your doxygen configuration file?
Albert

On Wed, Mar 12, 2014 at 11:34 AM, didje <dia...@pd...<mailto:dia...@pd...>> wrote:
In this example:

AClass.h

enum AnEnum {
 NONE=0, A_VALUE, B_VALUE
};


AClass.cpp

/*! \enum AnEnum
 * \brief Various useful values
*/

/*! \var A_VALUE
 * \brief THe value of A
*/

/*! \var B_VALUE
 * \brief THe value of B
*/

/*! \var NONE
 * \brief A value of zero
*/


Doxygen gives me the warning message:

Warning: no matching class member found for AnEnum::NONE

If I change the name of "NONE" to "NONE*X*", I don't have this warning. So
it would seem that
"NONE" is not understood properly by doxygen as an enum value.

Does anyone know if I can get around this somehow (other than by renaming
"NONE"). This would seem to be a bug in Doxygen.




--
View this message in context: http://doxygen.10944.n7.nabble.com/enum-value-of-NONE-is-not-understood-by-Doxygen-tp6541.html
Sent from the Doxygen - Users mailing list archive at Nabble.com.

------------------------------------------------------------------------------
Learn Graph Databases - Download FREE O'Reilly Book
"Graph Databases" is the definitive new guide to graph databases and their
applications. Written by three acclaimed leaders in the field,
this first edition is now available. Download your free book today!
http://p.sf.net/sfu/13534_NeoTech
_______________________________________________
Doxygen-users mailing list
Dox...@li...<mailto:Dox...@li...>
https://lists.sourceforge.net/lists/listinfo/doxygen-users

-------------------------------------------------------------------------------- This e-mail, including any attached files, may contain confidential and privileged information for the sole use of the intended recipient. Any review, use, distribution, or disclosure by others is strictly prohibited. If you are not the intended recipient (or authorized to receive information for the intended recipient), please contact the sender by reply e-mail and delete all copies of this message.

Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

[Albert <alb...@gm...>]

Hi Diarmuid,

I tried it with 1.8.4 and see no warning message and I see on the page of
the g file the enum completely described.
As I cannot reproduce the problem I'm not sure which setting might cause
the problem.

Albert



On Wed, Mar 12, 2014 at 1:34 PM, Diarmuid Kieran
<Dia...@pd...>wrote:

>  Hi Albert,
>
> Thanks for your reply.
>
> I'm using version 1.8.4
>
> I'm not sure what special settings you mean? The config file has been
> changed from the standard alright, but in a lot of places. Is there some
> specific properties you are referring to?
>
> Diarmuid
>
>
>
> *From:* Albert [mailto:alb...@gm...]
> *Sent:* Wednesday, March 12, 2014 12:13 PM
> *To:* Diarmuid Kieran
> *Cc:* dox...@li...
> *Subject:* Re: [Doxygen-users] enum value of "NONE" is not understood by
> Doxygen.
>
>
>
> I tried the example with version 1.8.6  and didn't see a problem / warning
> (standard doxygen configuration file, adding \file command to Aclass.{h,cpp}
> - Which version are you using?
>
> - Any special settings in your doxygen configuration file?
>
> Albert
>
>
>
> On Wed, Mar 12, 2014 at 11:34 AM, didje <dia...@pd...> wrote:
>
> In this example:
>
> AClass.h
>
> enum AnEnum {
>  NONE=0, A_VALUE, B_VALUE
> };
>
>
> AClass.cpp
>
> /*! \enum AnEnum
>  * \brief Various useful values
> */
>
> /*! \var A_VALUE
>  * \brief THe value of A
> */
>
> /*! \var B_VALUE
>  * \brief THe value of B
> */
>
> /*! \var NONE
>  * \brief A value of zero
> */
>
>
> Doxygen gives me the warning message:
>
> Warning: no matching class member found for AnEnum::NONE
>
> If I change the name of "NONE" to "NONE*X*", I don't have this warning. So
> it would seem that
> "NONE" is not understood properly by doxygen as an enum value.
>
> Does anyone know if I can get around this somehow (other than by renaming
> "NONE"). This would seem to be a bug in Doxygen.
>
>
>
>
> --
> View this message in context:
> http://doxygen.10944.n7.nabble.com/enum-value-of-NONE-is-not-understood-by-Doxygen-tp6541.html
> Sent from the Doxygen - Users mailing list archive at Nabble.com.
>
>
> ------------------------------------------------------------------------------
> Learn Graph Databases - Download FREE O'Reilly Book
> "Graph Databases" is the definitive new guide to graph databases and their
> applications. Written by three acclaimed leaders in the field,
> this first edition is now available. Download your free book today!
> http://p.sf.net/sfu/13534_NeoTech
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>
>
>  --------------------------------------------------------------------------------
> This e-mail, including any attached files, may contain confidential and
> privileged information for the sole use of the intended recipient. Any
> review, use, distribution, or disclosure by others is strictly prohibited.
> If you are not the intended recipient (or authorized to receive information
> for the intended recipient), please contact the sender by reply e-mail and
> delete all copies of this message.
>

Re: [Doxygen-users] Forward declaration of typedef results in warning

[Albert <alb...@gm...>]

- Which version of doxygen are you using
- can you give a little bit more of an example (i.e. changes of your
doxyfile compared to the standard doxyfile, definition of
FORWARD_DECLARE_MACRO etc.) so the problem can be reproduced?

Albert


On Wed, Mar 12, 2014 at 12:09 PM, didje <dia...@pd...> wrote:

> Forward declaration of typedef results in warning:
> Warning: documented symbol TypeDef_A_ptr  was not declared or defined.
>
> Example
> (Note: the macro below forward declares a typedef called "TypeDef_A_ptr")
>
> ClassA.h
>
> FORWARD_DECLARE_MACRO(TypeDef_A)
>
>
> ClassA.cpp
>
> /* \typedef typedef TypeDef_A_ptr
> * Description of TypeDef_A
> */
>
>
>
>
>
> --
> View this message in context:
> http://doxygen.10944.n7.nabble.com/Forward-declaration-of-typedef-results-in-warning-tp6542.html
> Sent from the Doxygen - Users mailing list archive at Nabble.com.
>
>
> ------------------------------------------------------------------------------
> Learn Graph Databases - Download FREE O'Reilly Book
> "Graph Databases" is the definitive new guide to graph databases and their
> applications. Written by three acclaimed leaders in the field,
> this first edition is now available. Download your free book today!
> http://p.sf.net/sfu/13534_NeoTech
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>

Re: [Doxygen-users] enum value of "NONE" is not understood by Doxygen.

[Albert <alb...@gm...>]

I tried the example with version 1.8.6  and didn't see a problem / warning
(standard doxygen configuration file, adding \file command to Aclass.{h,cpp}
- Which version are you using?
- Any special settings in your doxygen configuration file?

Albert


On Wed, Mar 12, 2014 at 11:34 AM, didje <dia...@pd...> wrote:

> In this example:
>
> AClass.h
>
> enum AnEnum {
>  NONE=0, A_VALUE, B_VALUE
> };
>
>
> AClass.cpp
>
> /*! \enum AnEnum
>  * \brief Various useful values
> */
>
> /*! \var A_VALUE
>  * \brief THe value of A
> */
>
> /*! \var B_VALUE
>  * \brief THe value of B
> */
>
> /*! \var NONE
>  * \brief A value of zero
> */
>
>
> Doxygen gives me the warning message:
>
> Warning: no matching class member found for AnEnum::NONE
>
> If I change the name of "NONE" to "NONE*X*", I don't have this warning. So
> it would seem that
> "NONE" is not understood properly by doxygen as an enum value.
>
> Does anyone know if I can get around this somehow (other than by renaming
> "NONE"). This would seem to be a bug in Doxygen.
>
>
>
>
> --
> View this message in context:
> http://doxygen.10944.n7.nabble.com/enum-value-of-NONE-is-not-understood-by-Doxygen-tp6541.html
> Sent from the Doxygen - Users mailing list archive at Nabble.com.
>
>
> ------------------------------------------------------------------------------
> Learn Graph Databases - Download FREE O'Reilly Book
> "Graph Databases" is the definitive new guide to graph databases and their
> applications. Written by three acclaimed leaders in the field,
> this first edition is now available. Download your free book today!
> http://p.sf.net/sfu/13534_NeoTech
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>

[Doxygen-users] Forward declaration of typedef results in warning

[didje <dia...@pd...>]

Forward declaration of typedef results in warning:
Warning: documented symbol TypeDef_A_ptr  was not declared or defined.

Example
(Note: the macro below forward declares a typedef called "TypeDef_A_ptr")

ClassA.h

FORWARD_DECLARE_MACRO(TypeDef_A)


ClassA.cpp

/* \typedef typedef TypeDef_A_ptr
* Description of TypeDef_A
*/





--
View this message in context: http://doxygen.10944.n7.nabble.com/Forward-declaration-of-typedef-results-in-warning-tp6542.html
Sent from the Doxygen - Users mailing list archive at Nabble.com.