Re: [committed] wwwdocs: gcc-11/changes.html: Editorial changes for RISC-V

2021-06-14 Thread Kito Cheng
Hi Gerald:

Thanks your patch, my grammar is really...weak :p

Hi Bernhard:

>> +  Add new option -misa-spec=* to control ISA spec version.
>> +  This controls the default version of each extensions.
>> +  It defaults to 2.2.
> Is "each extensions" in plural really correct gramatically?
> "default version of extensions" or
> "default version of each extension"
> And is "version of" correct WRT the code or does the code control the
> version "for extensions"?
>
> I.e.
> "to control the default ISA spec version for extensions" if that's what
> the option does?

ISA spec version control a set of default version, like that:

2.2 = { i-ext=2.0, m-ext=2.0, a-ext=2.0 f-ext=2.0 ..}
20190608 = { i-ext=2.1, m-ext=2.0, a-ext=2.0 f-ext=2.2 ...}
20191213 = { i-ext=2.1, m-ext=2.0, a-ext=2.1 f-ext=2.2 ...}

so...I think
"to control the default ISA spec version for extensions"
should be right, feel free to commit patches to fix the
 gramm issue, I will be very grateful :)


On Mon, Jun 14, 2021 at 3:41 PM Gerald Pfeifer  wrote:
>
> On Sun, 13 Jun 2021, Bernhard Reutner-Fischer wrote:
> >> +  Add new option -misa-spec=* to control ISA spec 
> >> version.
> >> +  This controls the default version of each extensions.
> >> +  It defaults to 2.2.
> > Is "each extensions" in plural really correct gramatically?
> > "default version of extensions" or
> > "default version of each extension"
>
> No, that one escaped my edits - good catch, Bernhard!
>
> > And is "version of" correct WRT the code or does the code control the
> > version "for extensions"?
> >
> > I.e.
> > "to control the default ISA spec version for extensions" if that's what
> > the option does?
>
> Let's see what Kito advises. Once we know, feel free to make a change or
> advise and I'll do.
>
> Thanks,
> Gerald


Re: [committed] wwwdocs: gcc-11/changes.html: Editorial changes for RISC-V

2021-06-14 Thread Gerald Pfeifer
On Sun, 13 Jun 2021, Bernhard Reutner-Fischer wrote:
>> +  Add new option -misa-spec=* to control ISA spec version.
>> +  This controls the default version of each extensions.
>> +  It defaults to 2.2.
> Is "each extensions" in plural really correct gramatically?
> "default version of extensions" or
> "default version of each extension"

No, that one escaped my edits - good catch, Bernhard!

> And is "version of" correct WRT the code or does the code control the 
> version "for extensions"?
> 
> I.e.
> "to control the default ISA spec version for extensions" if that's what
> the option does?

Let's see what Kito advises. Once we know, feel free to make a change or
advise and I'll do.

Thanks,
Gerald


Re: [committed] wwwdocs: gcc-11/changes.html: Editorial changes for RISC-V

2021-06-13 Thread Bernhard Reutner-Fischer via Gcc-patches
On Sun, 13 Jun 2021 07:58:50 +0200 (CEST)
Gerald Pfeifer  wrote:

> RISC-V has received a very nice section in the GCC 11 release notes
> thanks to Kito.
> 
> This are a couple of editorial changes, completing some sentence and
> breaking longer sentences among others, and a bit of grammar.
> 
> Pushed.
> 
> Gerald
> 
> ---
>  htdocs/gcc-11/changes.html | 33 ++---
>  1 file changed, 18 insertions(+), 15 deletions(-)
> 
> diff --git a/htdocs/gcc-11/changes.html b/htdocs/gcc-11/changes.html
> index 97606174..491b6b71 100644
> --- a/htdocs/gcc-11/changes.html
> +++ b/htdocs/gcc-11/changes.html
> @@ -953,33 +953,36 @@ You may also want to check out our

> +  Legacy architecture extension test macros like
> +  __riscv_atomic are deprecated, but will still be
> +  supported for at least 2 release cycles.

I didn't look if we can annotate macros as deprecated to emit a warning
on use nor if they are marked as such.

>
>Support IFUNC for riscv*-*-linux*.

> +  Add new option -misa-spec=* to control ISA spec version.
> +  This controls the default version of each extensions.
> +  It defaults to 2.2.

Is "each extensions" in plural really correct gramatically?
"default version of extensions" or
"default version of each extension"
And is "version of" correct WRT the code or does the code control the
version "for extensions"?

I.e.
"to control the default ISA spec version for extensions" if that's what
the option does?

thanks,


[committed] wwwdocs: gcc-11/changes.html: Editorial changes for RISC-V

2021-06-12 Thread Gerald Pfeifer
RISC-V has received a very nice section in the GCC 11 release notes
thanks to Kito.

This are a couple of editorial changes, completing some sentence and
breaking longer sentences among others, and a bit of grammar.

Pushed.

Gerald

---
 htdocs/gcc-11/changes.html | 33 ++---
 1 file changed, 18 insertions(+), 15 deletions(-)

diff --git a/htdocs/gcc-11/changes.html b/htdocs/gcc-11/changes.html
index 97606174..491b6b71 100644
--- a/htdocs/gcc-11/changes.html
+++ b/htdocs/gcc-11/changes.html
@@ -953,33 +953,36 @@ You may also want to check out our
 
   Support address sanitizer for RISC-V.
   Support big-endian for RISC-V, thanks to Marcus Comstedt.
-  Implement new style of architecture extension test macros,
-  each architecture extension has corresponding feature test macro, which
-  could use to test its existence and version information.
+  Implement new style of architecture extension test macros:
+  each architecture extension has a corresponding feature test macro,
+  which can be used to test its existence and version information.
   
-  Legacy architecture extension test macro like 
__riscv_atomic,
-   are deprecated, but it will still supported for at least 2 release 
cycles.
+  Legacy architecture extension test macros like
+  __riscv_atomic are deprecated, but will still be
+  supported for at least 2 release cycles.
   
   Support IFUNC for riscv*-*-linux*.
-  Add new option -misa-spec=* to control ISA spec version, default is 2.2,
-  this option could control the default version of each extensions.
-  Introduce --with-multilib-generator to configure time 
option,
-  this option could flexible config multi-lib settings, syntax is same as
-  RISC-V's multilib-generator.
+  Add new option -misa-spec=* to control ISA spec version.
+  This controls the default version of each extensions.
+  It defaults to 2.2.
+  Introduce the --with-multilib-generator configure time
+  option.
+  This allows for flexible config multi-lib settings. Its syntax is
+  the same as RISC-V's multilib-generator.
   
   Extend the sytax for multilib-generator, support expansion
   operator * to reduce the complexity of complicated multi-lib
-  re-use rule.
+  re-use rules.
   
-  Support -mcpu=* option, the behavior is aligned to RISC-V
-  clang/LLVM, it will set pipeline model and architecture extension, like
+  Support -mcpu=* option aligned with RISC-V clang/LLVM.
+  It sets the pipeline model and architecture extensions, like
   -mtune=* plus -march=*.
   
   Support for TLS stack protector canary access, thanks to Cooper Qu.
   
   Support __builtin_thread_pointer for RISC-V.
-  Introduce shorten_memrefs optimization, which could reduce 
the
-  code size for memory access, thanks to Craig Blackmore.
+  Introduce shorten_memrefs optimization, which reduces
+  the code size for memory access, thanks to Craig Blackmore.
   
 
 
-- 
2.31.1