Re: [Doxygen-develop] Re: [Doxygen-users] Making an Easy and fast readable C Library Manual reference.(TODO-Suggestions)

[Toni M. <ton...@wa...>]

> > I CAN'T HIDE MACRO BODY....
>
> Then you are doing something wrong!
>
> Using:
>
> /** \file */
>
> /** Docs here.
>  *  \hideinitializer
>  */
> #define GSDATAFORMAT_GET_FORMAT_WITHOUT_ENDIANES( __fmt )             \
>       ({ register guint __v;                                          \
>        if ( (((__fmt) & FORMAT_BYTEORDER_LE)>>4) ^                    \
>          (((__fmt) & FORMAT_BYTEORDER_BE)>>5) )                       \
>        __v=3D((__fmt) & ~GSDATAFORMAT_BYTEORDER_MASK);                 =
 \
>        else __v=3D(__fmt);                                             =
 \
>        __v;                                                           \
>        })
>
> /*! An enum */
> typedef enum
> {
>   val =3D 10 /*!< \hideinitializer enum value */
> } MyEnum;
>
> With a default config file, I get no initializer for defines or enums.

The enums runs OK thanks...
But i can't hide macros.

I have tested 4 ways.


1) ----------------------------------------
/** \def GSDATACHANNELSYS_GET_NUMCH
*       Gets the number of channels
*=09
*/

#define GSDATACHANNELSYS_GET_NUMCH(__chsys)\
        ((__chsys) & GSDATACHANNELSYS_NUMCH_MASK)

2) ----------------------------------------
/** \def GSDATACHANNELSYS_GET_NUMCH
*       Gets the number of channels
*	\hideinitializer=09
*/

#define GSDATACHANNELSYS_GET_NUMCH(__chsys)\
        ((__chsys) & GSDATACHANNELSYS_NUMCH_MASK)



3) ------------------------------------------
/** \def GSDATACHANNELSYS_GET_NUMCH
*       Gets the number of channels
*
*/
#define GSDATACHANNELSYS_GET_NUMCH(__chsys)\
        (\
        ((__chsys) & GSDATACHANNELSYS_NUMCH_MASK)\
        )

4) ------------------------------------------
/** \def GSDATACHANNELSYS_GET_NUMCH
*       Gets the number of channels
*	\hideinitializer
*/
#define GSDATACHANNELSYS_GET_NUMCH(__chsys)\
        (\
        ((__chsys) & GSDATACHANNELSYS_NUMCH_MASK)\
        )

--------------------------------------------

The Html Output for 3 and 4 cases are "exactly" the same  independent of =
the=20
\hideinitializer tag
In 3 and 4 cases the DEFINES section dont show the body of the macro but
the DEFINES DOCUMENTATIONS section continues showing it.

The output for 1 and 2 cases are "exactly" the same independent of the=20
\hideinitializer tag. Where the html ouput shows body macro in both secti=
ons
DEFINES section and DEFINES DOCUMENTATION section.

Perhaps I'm doing something wrong but i can't  solve it.


I have atached , my config file and a header source code for testing your=
self.

=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
Toni Moreno Gim=E9nez
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
Pje de las rosas  n=BA 22
Vilassar de Mar=20
(Barcelona) Espa=F1a
CP: 08340
-----------------
Tel:937598149
Tel: 699706656
-----------------