On 12/22/20 12:46 PM, Jonathan Wakely wrote:
On Tue, 22 Dec 2020 at 08:29, Martin Liška <mli...@suse.cz> wrote:

Hello.

May I please ask a native speaker for a correction of my wording?

Thanks,
Martin

---
   htdocs/gcc-11/changes.html | 28 ++++++++++++++++++++++++++++
   1 file changed, 28 insertions(+)

diff --git a/htdocs/gcc-11/changes.html b/htdocs/gcc-11/changes.html
index 1a9e72c1..badc9e12 100644
--- a/htdocs/gcc-11/changes.html
+++ b/htdocs/gcc-11/changes.html
@@ -116,6 +116,28 @@ a work-in-progress.</p>
         option (which defaults to 8 spaces per tab stop).
       </p>
     </li>
+  <li>New warning <a 
href="https://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html#index-Wtsan";><code>-Wtsan</code></a>,
 enabled by default,

"A new warning" or "The new warning". My preference would be "a new warning".

+      warns about unsupported features in ThreadSanitizer 
(<code>std::atomic_thread_fence</code>).</li>
+  <li>Series of if conditions, sharing a common index variable, can be 
transformed into a switch statement if each

There is no "if" condition in your example, and I don't know what the
"index variable" is either.

"A series of conditional expressions that compare the same variable
can be transformed into a switch statement" seems to be what you want
to say.

I like the wording.


+      of them contains a comparison expession.  Example:
+      <pre>
+        int IsHTMLWhitespace(int aChar) {
+          return aChar == 0x0009 || aChar == 0x000A ||
+                 aChar == 0x000C || aChar == 0x000D ||
+                 aChar == 0x0020;
+        }
+       </pre>
+       The statement is transformed into a GIMPLE switch statement that is 
later effectively expanded as bit-test.

Do users know or care about GIMPLE? I'm unsure what "effectively
expanded as bit-test" means.

They don't care. I wanted to express that such transformation can lead in a 
faster
code eventually. Do you have a suggesting for wording?



+  </li>
+  <li>
+    New command-line options:
+    <ul>
+        <li><a 
href="https://gcc.gnu.org/onlinedocs/gcc/Code-Gen-Options.html#index-fno-bit-tests";><code>-fbit-tests</code></a>,
 enabled by default, can be used to enable or disable switch expansion using bit-tests.</li>
+    </ul>
+  </li>
+  <li>GCOV data file format can effectively store a group of counters that are all 
zero.</li>

What does "effectively" mean here? It can have two slightly different
meanings in English, it can mean "doing a good job" or "not
officially, but in practice".

It means doing a good job :)
What about: "The GCOV data file format outputs smaller files as zero counters can be 
represented in a compact way." ?

Thanks,
Martin



+  <li>Some <code>gcov</code> tool options are renamed: 
<code>-i,--json-format</code> to

s/are/have been/ ?

+  <code>-j,--json-format</code> and <code>-j,--human-readable</code> to 
<code>-H,--human-readable</code>.</li>
   </ul>


Reply via email to