GNOME Bugzilla – Bug 571014
Documentation for CLASS_DIAGRAMS option is misleading
Last modified: 2010-10-09 08:19:48 UTC
Documentation Section: tooltip for the CLASS_DIAGRAMS option "... Note that this option is superseded by the HAVE_DOT option below. This is only a fallback. ..." Correct version: Other information: This option is not really superseded by the HAVE_DOT option. If CLASS_DIAGRAMS is set to "no", then no class diagrams are generated by dot for each individual class page even if HAVE_DOT is set to true. The documentation as it stands leads the user to believe that CLASS_DIAGRAMS is useless if HAVE_DOT is set to "yes", but in fact CLASS_DIAGRAMS still controls whether or not those class diagrams are shown on the individual class pages.
Actually, this might be a bug in how CLASS_GRAPH and CLASS_DIAGRAMS are handled when HAVE_DOT is true. In my case, I only get the individual class inheritance diagrams on each class page if CLASS_DIAGRAMS is checked in doxywizard, even though the CLASS_GRAPH documentation says CLASS_GRAPH forces CLASS_DIAGRAMS to NO.
Status unconfirmed? Well, I can confirm the documentation for CLASS_DIAGRAMS has mislead me to turn it off and into a wild goose chase for many hours.
Agreed, I propose the following new text: "If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base or super classes. Setting the tag to NO turns the diagrams off. Note that this option also works with HAVE_DOT disabled, but it is recommended to install and use dot, since it yields more powerful graphs. " and will also make HAVE_DOT=YES and CLASS_GRAPH=YES generate class diagrams regardless of the CLASS_DIAGRAMS setting (which was actually the original intention).
This bug was previously marked ASSIGNED, which means it should be fixed in doxygen version 1.7.2. Please verify if this is indeed the case. Reopen the bug if you think it is not fixed and please include any additional information that you think can be relevant.