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 4B1CD386FC38; Thu,  1 Jul 2021 08:05:00 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4B1CD386FC38
From: "redi at gcc dot gnu.org" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug libstdc++/101258] std ::is_integral_v is undocumented
Date: Thu, 01 Jul 2021 08:04:59 +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: 12.0
X-Bugzilla-Keywords: documentation
X-Bugzilla-Severity: normal
X-Bugzilla-Who: redi at gcc dot gnu.org
X-Bugzilla-Status: RESOLVED
X-Bugzilla-Resolution: FIXED
X-Bugzilla-Priority: P3
X-Bugzilla-Assigned-To: unassigned at gcc dot gnu.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags: 
X-Bugzilla-Changed-Fields: 
Message-ID: <bug-101258-4-VvxKrrN1gQ@http.gcc.gnu.org/bugzilla/>
In-Reply-To: <bug-101258-4@http.gcc.gnu.org/bugzilla/>
References: <bug-101258-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
X-BeenThere: gcc-bugs@gcc.gnu.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Gcc-bugs mailing list <gcc-bugs.gcc.gnu.org>
List-Unsubscribe: <https://gcc.gnu.org/mailman/options/gcc-bugs>,
 <mailto:gcc-bugs-request@gcc.gnu.org?subject=unsubscribe>
List-Archive: <https://gcc.gnu.org/pipermail/gcc-bugs/>
List-Post: <mailto:gcc-bugs@gcc.gnu.org>
List-Help: <mailto:gcc-bugs-request@gcc.gnu.org?subject=help>
List-Subscribe: <https://gcc.gnu.org/mailman/listinfo/gcc-bugs>,
 <mailto:gcc-bugs-request@gcc.gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 01 Jul 2021 08:05:00 -0000

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

--- Comment #18 from Jonathan Wakely <redi at gcc dot gnu.org> ---
The main problem with trying to rely on doxygen is that it's very buggy and
simply refuses to generate good docs for some entities, even though they are
correctly documented. See the commit message above, and see
https://gcc.gnu.org/onlinedocs/libstdc++/libstdc++-api.20210701.html/a01556=
.html
where it refuses to put filesystem::path in the relevant module despite
@ingroup being used.

And https://github.com/doxygen/doxygen/issues/8633 causes some entities to =
be
undocumented, because doxygen can't parse whitespace between tokens.

Obviously nobody is going to create something better than doxygen just for
libstdc++, so it's the best option we have.=