Re: [Doxygen-users] documenting multiple methods defined by a single macro - help

[Manfred D. <man...@me...>]

mx...@se... wrote:
> 
> You get evidently the macro not expanded, which means you have bad setup 
> in some way.
> 
> * maybe you want to expand even the macros BOOST_PP_REPEAT BOOST_PP_INC 
> RESHAPE_DIM_MAX etc.
> (EXPAND_AS_DEFINED      = RESHAPE BOOST_PP_REPEAT BOOST_PP_INC 
> RESHAPE_DIM_MAX)


that seems like a reasonable proposition at first, but wouldn't that 
mean having to `@def` the macros BOOST_PP_REPEAT and BOOST_PP_INC in the 
  files they are defined?

-if that's the case, then it's problematic ... because the PP_REPEAT, 
PP_INC are third party [C++ Boost library] macros, and it certainly 
would be a bad idea to doxygenize the Boost library sources; that'd be a 
maintenance nightmare at the very least (especially considering periodic 
updates to the Boost libs).

> 
> or in first try you can set EXPAND_ONLY_PREDEF     = NO and see what 
> happens.

no luck here :-(

> 
> * in the BOOST_PP_REPEAT(BOOST_PP_INC(RESHAPE_DIM_MAX), RESHAPE, _) 
> there are missing RESHAPE macro parameters?
> 

no, it's rightly coded.  You can quickly make doubly sure by trying the 
following:

    g++ -P -E <source-file>

    (... must have the C++ Boost libraries installed though)

> 
> And you must have included the headers where the macro is defined in 
> every file you want to expand the macro (=every .h and directly or 
> indirectly every .cpp), and the path to the macro header (and another 
> headers if you include the header indirectly) must be set in 
> INCLUDE_PATH = ... (it does NOT suffice to have this file only in INPUT 
> files).
> 
> 

Yes, that's been done for sure.



I'll have to keep trying I guess, ... and it's going to take a lot of 
head scratching to acheive, if it is at all possible.


Cheers,
-- 
Manfred Doudar
MetOcean Engineers
www.metoceanengineers.com