[Doxygen-users] C++ cast operator, 1.8.4 to 1.8.5 changes and maybe a feature request
Brought to you by:
dimitri
From: liam m. <lia...@go...> - 2013-11-02 14:31:00
|
Couple of questions: - How can you reference a cast operator which is a member function of a C++ class? - Has there been changes in how parameters are handled between 1.8.4 and 1.8.5? I could not see anything in the changelog about this. In 1.8.4 I was using Doxygen to document Lua code as if it was a build in language, this required a few changes just for docs although it did work. For a Lua functions documented as the following it produced correct parameter details \fn function gen(options, path) \param options [optional] Defaults to the library \ref defaults \param path [optional] Defaults to the current working directory \brief Generate boilerplate header files \details Generates boilerplate C++ files code required for OOLua using the passed options or if an option is not present then the default is used. If Path is not nil then it is required to be a string which is slash postfixed. Yet in 1.8.5 it no longer generates correct parameter documentation, instead it places the param documentation verbatim. I have tried removing [optional] to see if that was the problem, yet it had no effect. - Is there an keyword I can use so that the library does not warn about something Doxygen finds at a specific location? I am abusing the library documenting macros which take __VA_ARGS__ as if they take named parameters and the output is cluttered with warnings, which makes it difficult to pick out genuine problems. I could write a script to strip some of these from the log but it would be nice if there was some keyword for this, in a similar manner to //NOLINT. Thanks --Liam |