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 7252F3858D32; Mon, 14 Nov 2022 13:32:07 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 7252F3858D32
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org;
	s=default; t=1668432727;
	bh=2DbTkLxmw62ivmKEDnNUox8NmpV+88LsgR49j4sgDXw=;
	h=From:To:Subject:Date:From;
	b=L3lMQtemuFJ/aBiRmB+fpcfslJ77TqB91cQSRNg9FJIXt6vsCbGz7iOhubqfChP2y
	 RPU08E3mjDfosmCn9gJTqgFbenOhJQehoYyQpzjA/TKVJP8Wu0sfVZCTmXCcpgSnDu
	 hTADiH/Y/LtXqvP5l27qjuh6A9q6FVYBKRCGRs3A=
From: "redi at gcc dot gnu.org" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug target/107676] New: Nonsensical docs for -mrelax-cmpxchg-loop
Date: Mon, 14 Nov 2022 13:32:07 +0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: new
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: gcc
X-Bugzilla-Component: target
X-Bugzilla-Version: 12.2.1
X-Bugzilla-Keywords: documentation
X-Bugzilla-Severity: normal
X-Bugzilla-Who: redi at gcc dot gnu.org
X-Bugzilla-Status: UNCONFIRMED
X-Bugzilla-Resolution: 
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: bug_id short_desc product version bug_status
 keywords bug_severity priority component assigned_to reporter
 target_milestone cf_gcctarget
Message-ID: <bug-107676-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=3D107676

            Bug ID: 107676
           Summary: Nonsensical docs for -mrelax-cmpxchg-loop
           Product: gcc
           Version: 12.2.1
            Status: UNCONFIRMED
          Keywords: documentation
          Severity: normal
          Priority: P3
         Component: target
          Assignee: unassigned at gcc dot gnu.org
          Reporter: redi at gcc dot gnu.org
  Target Milestone: ---
            Target: x86*

g:4d281ff7ddd8f6365943c0a622107f92315bb8a6 added:

+@item -mrelax-cmpxchg-loop
+@opindex mrelax-cmpxchg-loop
+Relax cmpxchg loop by emitting an early load and compare before cmpxchg,
+execute pause if load value is not expected. This reduces excessive
+cachline bouncing when and works for all atomic logic fetch builtins
+that generates compare and swap loop.


1) "cachline" is a typo
2) "when" ... when what?
3) What does "atomic logic fetch builtins" mean?
4) "generates" should be "generate"
5) Is a "cmpxchg loop" the same as a "compare and swap loop"? Can we use the
same term consistently?=