[prev in list] [next in list] [prev in thread] [next in thread] 

List:       doxygen-users
Subject:    Re: [Doxygen-users] doxygen refusing to not include #define in file.c
From:       Dimitri van Heesch <doxygen () gmail ! com>
Date:       2013-11-23 13:19:36
Message-ID: 40E932C9-8E79-4EF3-A433-FC942C5E59DB () gmail ! com
[Download RAW message or body]

Hi David,

Which version of doxygen are you using?
This problem was fixed in doxygen 1.8.4, see also
https://bugzilla.gnome.org/show_bug.cgi?id=694631

Regards,
  Dimitri

On 22 Nov 2013, at 21:05 , mathog <mathog@caltech.edu> wrote:

> Trying to get doxygen to ignore a #define, so far without success
> 
> //! \cond
> #define UNUSED(x) (void)(x)  //! \hideinitializer
> //! \endcond
> 
> and it still emits:
> 
> file.c:35: warning: Member UNUSED(x) (macro definition) of file file.c 
> is not documented.
> 
> and puts in the html for file.c:
> 
> Macros
> #define 	UNUSED(x)   (void)(x)
> 
> It does that whether or not there is any comment at all on the same line 
> as UNUSED.
> 
> This macro should not be exposed in the documentation in any way shape 
> or form, but Doxygen
> insists that it be.  Note that when an assortment of functions and 
> typedef struct's are placed between \cond and \endcond they are excluded 
> from the HTML and there are no warnings about them not being documented. 
>  It seems to be only "#define" that is unexcludable.
> 
> Thanks,
> 
> David Mathog
> mathog@caltech.edu
> Manager, Sequence Analysis Facility, Biology Division, Caltech
> 
> ------------------------------------------------------------------------------
> Shape the Mobile Experience: Free Subscription
> Software experts and developers: Be at the forefront of tech innovation.
> Intel(R) Software Adrenaline delivers strategic insight and game-changing 
> conversations that shape the rapidly evolving mobile landscape. Sign up now. 
> http://pubads.g.doubleclick.net/gampad/clk?id=63431311&iu=/4140/ostg.clktrk
> _______________________________________________
> Doxygen-users mailing list
> Doxygen-users@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/doxygen-users


------------------------------------------------------------------------------
Shape the Mobile Experience: Free Subscription
Software experts and developers: Be at the forefront of tech innovation.
Intel(R) Software Adrenaline delivers strategic insight and game-changing 
conversations that shape the rapidly evolving mobile landscape. Sign up now. 
http://pubads.g.doubleclick.net/gampad/clk?id=63431311&iu=/4140/ostg.clktrk
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
[prev in list] [next in list] [prev in thread] [next in thread]