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 3BEE53889829; Wed, 30 Jun 2021 20:39:14 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 3BEE53889829
From: "giecrilj at stegny dot 2a.pl" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug libstdc++/101258] std ::is_integral_v is undocumented
Date: Wed, 30 Jun 2021 20:39:14 +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: giecrilj at stegny dot 2a.pl
X-Bugzilla-Status: RESOLVED
X-Bugzilla-Resolution: WONTFIX
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-hh5mNykFvC@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: Wed, 30 Jun 2021 20:39:14 -0000

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

--- Comment #12 from Christopher Yeleighton <giecrilj at stegny dot 2a.pl> =
---
(In reply to Jonathan Wakely from comment #10)
> Lots of things in our API docs are not in the standard, and lots of things
> in the standard are not in our API docs. If you're trying to use it for
> that, no wonder it's painful. Stop it.

The difference between compiler documentation and the standard is that comp=
iler
documentation is easier to use and to understand and more task-oriented,
although it may be incomplete.  I understand the difference.  I understand =
that
compiler documentation may sacrifice precision for clarity here and there. =
 The
sacrifice must not go too far though---hence my patches to MSDN for example=
.  I
still prefer reading the vendor documentation to reading the standard, exce=
pt
in some special cases.

I promise I shall stop using GCC documentation if said documentation tells =
me
what I should use instead.  I have reported a request regarding that.  I can
still hardly accept that we are such a failure in this area (I believe that=
 if
we have time to implement things, we should also dedicate some to describe
them).=