[DOC++] A bug with const qualifier in overloaded methods
Brought to you by:
adragos
From: Eric G. <Eri...@ob...> - 2003-01-09 11:03:26
|
Hi, We are using DOC++ for the LORENE project http://www.lorene.obspm.fr and are very happy about it. It produces very usefull documentation as can be seen on http://www.lorene.obspm.fr/Refguide/index.html However, there is a bug which is quite annoying: DOC++ does not distinguish overloaded methods when the parameters of these methods are declared 'const'. Considerer the following example: //---------------------------------- class A ; class B ; /** Class C */ class C { public: /// Constructor from A C(const A&) ; /// Constructor from B C(const B&) ; } ; //--------------------------------- DOC++ gives the warning message "Warning: ` C::C(const B&)' already have documentation, merging" and produces the following ugly output: C(const B&) Constructor from BConstructor from A This bug is present in the current version (3.4.10), as well as in the two previous ones (3.4.8 and 3.4.9), but it did not exist in older versions (e.g. 3.2). This bug has been already pointed out in March 2001 by Marc Toussaint, see http://groups.yahoo.com/group/docpp/message/1028 but no fixing has been performed yet. Thank you for your help, Eric Gourgoulhon. -- Eric Gourgoulhon Laboratoire de l'Univers et de ses THeories (LUTH) CNRS / Observatoire de Paris, F-92195 Meudon Cedex, France tel: +33 1.45.07.74.33 (secretariat : +33 1.45.07.75.10) e-mail: Eri...@ob... WWW: http://www.luth.obspm.fr/ |