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 09D9A388206D; Wed,  6 Sep 2023 15:58:23 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 09D9A388206D
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org;
	s=default; t=1694015904;
	bh=jtSJPqP2kr8sBacJYngLPPuTyaShpf2rpcvKUNRWC+E=;
	h=From:To:Subject:Date:In-Reply-To:References:From;
	b=bs/J+49Wi5XMsEvxs+xIPcwjUQjgmMDmg4PhUUxtPSKDrpsmnSYPHRbxNrpPQFoXM
	 +fKhV1wdJnbqPXpnG7gohPZ9trDhhuyrFuH+dplymyNP6oVX1xRJubkClwTORWJAqJ
	 Dg99VQcFT/QySs4jngsFPh+qWl72ZBiIIDLiTLUY=
From: "cvs-commit at gcc dot gnu.org" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug c/102989] Implement C2x's n2763 (_BitInt)
Date: Wed, 06 Sep 2023 15:58:22 +0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: changed
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: gcc
X-Bugzilla-Component: c
X-Bugzilla-Version: 12.0
X-Bugzilla-Keywords: 
X-Bugzilla-Severity: enhancement
X-Bugzilla-Who: cvs-commit at gcc dot gnu.org
X-Bugzilla-Status: ASSIGNED
X-Bugzilla-Resolution: 
X-Bugzilla-Priority: P3
X-Bugzilla-Assigned-To: jakub at gcc dot gnu.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags: 
X-Bugzilla-Changed-Fields: 
Message-ID: <bug-102989-4-p6xJWv9Jtl@http.gcc.gnu.org/bugzilla/>
In-Reply-To: <bug-102989-4@http.gcc.gnu.org/bugzilla/>
References: <bug-102989-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=3D102989

--- Comment #106 from CVS Commits <cvs-commit at gcc dot gnu.org> ---
The master branch has been updated by Jakub Jelinek <jakub@gcc.gnu.org>:

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

commit r14-3755-gf6e0ec5696ec5f52baed71fe23f978bcef80d458
Author: Jakub Jelinek <jakub@redhat.com>
Date:   Wed Sep 6 17:42:37 2023 +0200

    libgcc _BitInt helper documentation [PR102989]

    On Mon, Aug 21, 2023 at 05:32:04PM +0000, Joseph Myers wrote:
    > I think the libgcc functions (i.e. those exported by libgcc, to which
    > references are generated by the compiler) need documenting in
libgcc.texi.
    > Internal functions or macros in the libgcc patch need appropriate
comments
    > specifying their semantics; especially FP_TO_BITINT and FP_FROM_BITINT
    > which have a lot of arguments and no comments saying what the semanti=
cs
of
    > the macros and their arguments are supposed to me.

    Here is an incremental patch which does that.

    2023-09-06  Jakub Jelinek  <jakub@redhat.com>

            PR c/102989
    gcc/
            * doc/libgcc.texi (Bit-precise integer arithmetic functions):
            Document general rules for _BitInt support library functions
            and document __mulbitint3 and __divmodbitint4.
            (Conversion functions): Document __fix{s,d,x,t}fbitint,
            __floatbitint{s,d,x,t,h,b}f, __bid_fix{s,d,t}dbitint and
            __bid_floatbitint{s,d,t}d.
    libgcc/
            * libgcc2.c (bitint_negate): Add function comment.
            * soft-fp/bitint.h (bitint_negate): Add function comment.
            (FP_TO_BITINT, FP_FROM_BITINT): Add comment explaining the macr=
os.=