diff mbox series

doc/tm.texi.in (Condition Code): Tweak post-cc0 wording.

Message ID 20210515184429.55BC2203BE@pchp3.se.axis.com
State New
Headers show
Series doc/tm.texi.in (Condition Code): Tweak post-cc0 wording. | expand

Commit Message

Hans-Peter Nilsson May 15, 2021, 6:44 p.m. UTC
Ok to commit?

When eyeballing the r12-440 / bd1cd0d0e0fe / "Remove
CC0" commit, I noticed parts that could be improved.

Regarding the first change: at first I thought that just
removing the word "better" was the best choice, as the
compared part (cc0) was apparently removed, but the
paragraph after the one in the patch (still) does speak of
"implicit setting" (i.e. cc0-style), but now as hypothetical
reasoning.  So, just add that to clarify what is not-better.

The second change is just that there's no non-modern
representation, so the "Modern" qualifier is just confusing.

gcc:
	* doc/tm.texi.in (Condition Code): Tweak post-cc0 wording.
	* doc/tm.texi: Regenerate.
---
 gcc/doc/tm.texi    | 4 ++--
 gcc/doc/tm.texi.in | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

Comments

Segher Boessenkool May 16, 2021, 4:18 p.m. UTC | #1
On Sat, May 15, 2021 at 08:44:29PM +0200, Hans-Peter Nilsson via Gcc-patches wrote:
> When eyeballing the r12-440 / bd1cd0d0e0fe / "Remove
> CC0" commit, I noticed parts that could be improved.
> 
> Regarding the first change: at first I thought that just
> removing the word "better" was the best choice, as the
> compared part (cc0) was apparently removed, but the
> paragraph after the one in the patch (still) does speak of
> "implicit setting" (i.e. cc0-style), but now as hypothetical
> reasoning.  So, just add that to clarify what is not-better.

It is better to remove that hypothetical, imho.

> Condition codes in GCC are represented as registers,

s/,/./ and remove the rest of this paragraph?

> -which provides better schedulability for
> +which provides better schedulability than implicit clobbering for
>  architectures that do have a condition code register, but on which
>  most instructions do not affect it.  The latter category includes
>  most RISC machines.


>  Condition codes in GCC are represented as registers,

s/,/./ and remove the rest as well?

> -which provides better schedulability for
> +which provides better schedulability than implicit clobbering for
>  architectures that do have a condition code register, but on which
>  most instructions do not affect it.  The latter category includes
>  most RISC machines.


> The second change is just that there's no non-modern
> representation, so the "Modern" qualifier is just confusing.

That is just fine of course :-)


I would commit such changes as obvious btw, so if you do so as well, you
can blame me if anyone asks!


Segher
Hans-Peter Nilsson May 16, 2021, 4:48 p.m. UTC | #2
> From: Segher Boessenkool <segher@kernel.crashing.org>
> Date: Sun, 16 May 2021 18:18:17 +0200

> On Sat, May 15, 2021 at 08:44:29PM +0200, Hans-Peter Nilsson via Gcc-patches wrote:
> > When eyeballing the r12-440 / bd1cd0d0e0fe / "Remove
> > CC0" commit, I noticed parts that could be improved.
> > 
> > Regarding the first change: at first I thought that just
> > removing the word "better" was the best choice, as the
> > compared part (cc0) was apparently removed, but the
> > paragraph after the one in the patch (still) does speak of
> > "implicit setting" (i.e. cc0-style), but now as hypothetical
> > reasoning.  So, just add that to clarify what is not-better.
> 
> It is better to remove that hypothetical, imho.
> 
> > Condition codes in GCC are represented as registers,
> 
> s/,/./ and remove the rest of this paragraph?

Perhaps.  Let's see what a doc maintainer says.

> I would commit such changes as obvious btw, so if you do so as well, you
> can blame me if anyone asks!

The second one likely, but for the first one there was
"obviously" a few different suggestions.

Thanks, for the review!

brgds, H-P
diff mbox series

Patch

diff --git a/gcc/doc/tm.texi.in b/gcc/doc/tm.texi.in
index d8e3de14af1a..9009eaecc4de 100644
--- a/gcc/doc/tm.texi.in
+++ b/gcc/doc/tm.texi.in
@@ -4269,7 +4269,7 @@  or @code{TARGET_MAX_ANCHOR_OFFSET} is set to a nonzero value.
 @cindex condition code status
 
 Condition codes in GCC are represented as registers,
-which provides better schedulability for
+which provides better schedulability than implicit clobbering for
 architectures that do have a condition code register, but on which
 most instructions do not affect it.  The latter category includes
 most RISC machines.
@@ -4300,7 +4300,7 @@  specified already in the compare instruction.  In this case, you are not
 interested in most macros in this section.
 
 @menu
-* MODE_CC Condition Codes::  Modern representation of condition codes.
+* MODE_CC Condition Codes::  Representation of condition codes.
 @end menu
 
 @node MODE_CC Condition Codes