From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-bugzilla@gcc.gnu.org>
Received: by sourceware.org (Postfix, from userid 48)
	id 08DC53857700; Thu, 27 Apr 2023 16:00:56 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 08DC53857700
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org;
	s=default; t=1682611256;
	bh=2xorFqpiefPJXIv/G7UgrMs1LyB3ypyYU1eEmgdSTok=;
	h=From:To:Subject:Date:In-Reply-To:References:From;
	b=ohUw00MWE2jvUrTJNdvTrqF1KiKv3tGo0EDY7xypi1YScj1ABz0hf+FLd5dmUSWE1
	 yqXF35fuipAJUPcWCoi6828QyqHatcT0PEPVk/vIktsuYXsHR5H694GIEZh4zgcmC2
	 8KLEM2SIy1DWmzN8W1PQaoWoMOZo9E8m0ShR+N28=
From: "redi at gcc dot gnu.org" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug libstdc++/40380] class documentation should mention include
 file to use
Date: Thu, 27 Apr 2023 16:00:55 +0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: changed
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: gcc
X-Bugzilla-Component: libstdc++
X-Bugzilla-Version: 4.5.0
X-Bugzilla-Keywords: documentation
X-Bugzilla-Severity: enhancement
X-Bugzilla-Who: redi at gcc dot gnu.org
X-Bugzilla-Status: ASSIGNED
X-Bugzilla-Resolution: 
X-Bugzilla-Priority: P3
X-Bugzilla-Assigned-To: bkoz at gcc dot gnu.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags: 
X-Bugzilla-Changed-Fields: 
Message-ID: <bug-40380-4-BQ8BvVjbUd@http.gcc.gnu.org/bugzilla/>
In-Reply-To: <bug-40380-4@http.gcc.gnu.org/bugzilla/>
References: <bug-40380-4@http.gcc.gnu.org/bugzilla/>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Bugzilla-URL: http://gcc.gnu.org/bugzilla/
Auto-Submitted: auto-generated
MIME-Version: 1.0
List-Id: <gcc-bugs.sourceware.org>

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=3D40380

--- Comment #9 from Jonathan Wakely <redi at gcc dot gnu.org> ---
Grr, I've just noticed that classes defined in a header with no file extens=
ion
do not get an implicit @headerfile, the way that classes defined in a foo.h
header do. See https://github.com/doxygen/doxygen/issues/10010

This is frustrating for libstdc++, because **none** of the public headers h=
ave
an extension, so we can't rely on all the contents of e.g. <memory_resource>
getting a correct #include <memory_resource> displayed. The _only_ classes
which show a #include are the ones in a .h file where it's always wrong (un=
til
we add an explicit @headerfile to them).

So unless that doxygen issue gets fixed, we need an explicit @headerfile on
every single class in the library. Sigh.=