public inbox for libstdc++-cvs@sourceware.org
help / color / mirror / Atom feed
From: Jonathan Wakely <redi@gcc.gnu.org>
To: gcc-cvs@gcc.gnu.org, libstdc++-cvs@gcc.gnu.org
Subject: [gcc r12-10264] libstdc++: Disable Doxygen GROUP_NESTED_COMPOUNDS config option
Date: Mon, 18 Mar 2024 14:07:08 +0000 (GMT)	[thread overview]
Message-ID: <20240318140708.B14CB385840C@sourceware.org> (raw)

https://gcc.gnu.org/g:d9f006da30def40747792d3ea37add1d80e02444

commit r12-10264-gd9f006da30def40747792d3ea37add1d80e02444
Author: Jonathan Wakely <jwakely@redhat.com>
Date:   Wed May 11 16:46:03 2022 +0100

    libstdc++: Disable Doxygen GROUP_NESTED_COMPOUNDS config option
    
    Before Doxygen version 1.9.2 this option is broken (see
    https://github.com/doxygen/doxygen/issues/8638 for more details) and
    classes are not added to the correct groups by @ingroup and @addtogroup.
    
    Also remove the obsolete CLASS_DIAGRAMS option that causes a warning.
    
    libstdc++-v3/ChangeLog:
    
            * doc/doxygen/user.cfg.in (GROUP_NESTED_COMPOUNDS): Set to NO.
            (CLASS_DIAGRAMS): Remove obsolete option.
    
    (cherry picked from commit 9c3a8fe34aeacabc2f62acef7f8f9108cb109238)

Diff:
---
 libstdc++-v3/doc/doxygen/user.cfg.in | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/libstdc++-v3/doc/doxygen/user.cfg.in b/libstdc++-v3/doc/doxygen/user.cfg.in
index bdff43c5f0a..b095addd10c 100644
--- a/libstdc++-v3/doc/doxygen/user.cfg.in
+++ b/libstdc++-v3/doc/doxygen/user.cfg.in
@@ -388,7 +388,7 @@ DISTRIBUTE_GROUP_DOC   = YES
 # is disabled and one has to add nested compounds explicitly via \ingroup.
 # The default value is: NO.
 
-GROUP_NESTED_COMPOUNDS = YES
+GROUP_NESTED_COMPOUNDS = NO
 
 # Set the SUBGROUPING tag to YES to allow class member groups of the same type
 # (for instance a group of public functions) to be put as a subgroup of that
@@ -2473,15 +2473,6 @@ EXTERNAL_PAGES         = YES
 # Configuration options related to the dot tool
 #---------------------------------------------------------------------------
 
-# If the CLASS_DIAGRAMS tag is set to YES, doxygen will generate a class diagram
-# (in HTML 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.
-# The default value is: YES.
-
-CLASS_DIAGRAMS         = YES
-
 # You can include diagrams made with dia in doxygen documentation. Doxygen will
 # then run dia to produce the diagram and insert it in the documentation. The
 # DIA_PATH tag allows you to specify the directory where the dia binary resides.

                 reply	other threads:[~2024-03-18 14:07 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20240318140708.B14CB385840C@sourceware.org \
    --to=redi@gcc.gnu.org \
    --cc=gcc-cvs@gcc.gnu.org \
    --cc=libstdc++-cvs@gcc.gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).