Re: Compile Docs on RH 8.0

Posted by Luigi Ballabio-2 on Oct 03, 2003; 1:28pm
URL: http://quantlib.414.s1.nabble.com/Compile-Docs-on-RH-8-0-tp10364p10367.html

At 1:20 PM -0500 10/3/03, Liguo Song wrote:

>Another thing that I noticed when compiling the documentation of
>QuantLib-0.3.3 is that doxygen-1.3.4 (1.3.3 is required) will
>complain about obsolete tags, such as:
>   Warning: Tag `CGI_NAME' at line 220 of file .quantlib.doxy has
>become obsolete.
>   To avoid this warning please update your configuration file using
>"doxygen -u"
>
>Using "doxygen -u .quantlib.doxy" before "doxygen .quantlib.doxy"
>seems solve this problem. Maybe we should also put this into the
>Makefile of Docs.
>
>I am not familiar with doxygen. Any suggestion from people with more
>experienced with doxygen?

Well, it's just that tags sometimes change between Doxygen releases.
Usually tags get added, and newer versions of Doxygen don't complain
upon processing older doxyfiles. This time, tags were removed, so
that the latest Doxygen issues obsolescence warnings. But: 1) this is
seldom the case; 2) they were only warnings, and the docs would have
been made succesfully anyway; 3) the doxyfile needs to be changed
only once per Doxygen release, and 4) the version in CVS is already
updated for 1.3.4, so I don't think a Makefile rule is needed...

Later,
        Luigi