Re: [Quantlib-dev] Compile Docs on RH 8.0

[Luigi B. <lui...@fa...>]

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