Re: [Boost-docs] Coding round Microsoft warning C4100 prevents Doxygen documenting the parameter with \param

Subject: Re: [Boost-docs] Coding round Microsoft warning C4100 prevents Doxygen documenting the parameter with \param
From: Daniel James (dnljms_at_[hidden])
Date: 2011-09-07 09:55:55

> Le 06/09/11 17:19, Paul A. Bristow a écrit :
>
>> I therefore propose to recommend instead
>>
>> in https://svn.boost.org/trac/boost/wiki/Guidelines/WarningsGuidelines

This isn't really the place to discuss warning guidelines.

>> that *all* jamfiles contain code to *suppress this warning*, rather than

That won't work outside of boost, and the warning guidelines are
mostly there for the sake of users rather than developers.

>>       <toolset>msvc:<cxxflags>/wd4100 # unreferenced formal parameter.

I'd just use a pragma, or Vicente's solution if it works. The other
option is to use the preprocessor to have a different version for
doxygen. Which slightly defeats the purpose, but isn't necessarily
bad.