General > Gurus wanted !

[doxygen] strange warning

(1/2) > >>

Duke:
Among other warnings, doxygen will produce the following warning message:
/src/shared/sharedptr.h:93: warning: end of comment block while expecting command </b>

Staring at sharedptr.h up and down didn't give me a clue what doxygen doesn't like here.

Warnings log eg. : http://ninex.info:8010/builders/doxygen/builds/886/steps/compile/logs/warnings%20%2873%29
sharedptr.h source: https://github.com/ufoai/ufoai/blob/master/src/shared/sharedptr.h

Sandro:
Block starts with the /** instead of /*

It therefore expects some doxygen, but can't find any.

Duke:
Can't believe that, butI'll try.
The line number fits, but we have tons of other comments with /** and no doxy inside.

DarkRain:
Line 88:

--- Code: ---* assignment of a SharedPtr<B> object to a SharedPtr<A> object.
--- End code ---
Doxygen is obviously interpreting <B> as an opening tag and expects a closing one somewhere later...

Duke:
Removing the 2nd asterisk solved the problem, probably because doxygen now skips the whole block of comment.

I now re-added the 2nd asterisk and just quoted the "SharedPtr<B>" and A.

Navigation

[0] Message Index

[#] Next page