[wwwdocs] Update changes.html

[wwwdocs] Update changes.html

[Marek Polacek]

I've committed the following update to reflect the recent addition.

Index: changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-6/changes.html,v
retrieving revision 1.7
diff -u -r1.7 changes.html
--- changes.html	14 May 2015 22:07:28 -0000	1.7
+++ changes.html	25 May 2015 08:13:52 -0000
@@ -32,6 +32,14 @@
 
 <h3 id="c-family">C family</h3>
   <ul>
+    <li>The C and C++ compilers now support attributes on enumerators.  For instance,
+	it is now possible to mark enumerators as deprecated:
+<blockquote><pre>
+enum {
+  newval,
+  oldval __attribute__ ((deprecated ("too old")))
+};
+</pre></blockquote></li>
     <li>A new command-line option <code>-Wshift-negative-value</code> has been
 	added for the C and C++ compilers, which warns about left shifting
 	a negative value.</li>

	Marek

Re: [wwwdocs] Update changes.html

[Gerald Pfeifer]

On Mon, 11 May 2015, Marek Polacek wrote:
> Is the following any better?  Thanks,

Yes, this looks fine.

(I admit that "flexible array member-like arrays" confused me a bit,
but that's probably me not fully getting standards language. ;-)

Gerald

Re: [wwwdocs] Update changes.html

[Marek Polacek]

On Mon, May 11, 2015 at 06:04:48PM +0200, Gerald Pfeifer wrote:
> Hi Marek,
> 
> On Mon, 11 May 2015, Marek Polacek wrote:
> > Ok to commit?
> 
> as maintainer I am happy for you to commit documentation/web changes
> without approval, though I am also happy to review.

I was hoping you could glance over it before I commit the patch; and
given the below, I'm glad you did ;).
 
> Here I'm wondering whether the nested list could just be merged
> into the primary item (and I'd omit the colon before "enables").

Agreed.  If we have more new options, we can make a list out of it.
 
> "a union".  English can be tricky for us non-native speakers at 
> times, since usually you would use "an" before "u", except when 
> that "u" is pronounced as a consonant or a syllable starting with 
> one.  And the "u" in "union" actually is prounced as "you-nion".

Yeah, I'm familiar with this rule, and I usually got that right.
Not sure how I goofed it up this time.

Is the following any better?  Thanks,

Index: changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-6/changes.html,v
retrieving revision 1.3
diff -u -r1.3 changes.html
--- changes.html	6 May 2015 09:55:29 -0000	1.3
+++ changes.html	11 May 2015 16:16:04 -0000
@@ -16,15 +16,34 @@
 
 
 <!-- .................................................................. -->
-<!-- <h2 id="general">General Optimizer Improvements</h2> -->
-
+<h2 id="general">General Optimizer Improvements</h2>
+  <ul>
+    <li>UndefinedBehaviorSanitizer gained a new sanitization option,
+	<code>-fsanitize=bounds-strict</code>, which enables strict checking
+	of array bounds.  In particular, it enables
+	<code>-fsanitize=bounds</code> as well as instrumentation of
+	flexible array member-like arrays.
+  </ul>
 
 <!-- .................................................................. -->
 <h2 id="languages">New Languages and Language specific improvements</h2>
 
 <!-- <h3 id="ada">Ada</h3> -->
 
-<!-- <h3 id="c-family">C family</h3> -->
+<h3 id="c-family">C family</h3>
+  <ul>
+    <li>A new command-line option <code>-Wshift-negative-value</code> has been
+	added for the C and C++ compilers, which warns about left shifting
+	a negative value.</li>
+  </ul>
+
+<h3 id="c">C</h3>
+  <ul>
+    <li>It is possible to disable warnings when an initialized field of
+	a structure or a union with side effects is being overridden when
+	using designated initializers via a new warning option
+	<code>-Woverride-init-side-effects</code>.</li>
+  </ul>
 
 <h3 id="cxx">C++</h3>
 

	Marek

Re: [wwwdocs] Update changes.html

[Gerald Pfeifer]

Hi Marek,

On Mon, 11 May 2015, Marek Polacek wrote:
> Ok to commit?

as maintainer I am happy for you to commit documentation/web changes
without approval, though I am also happy to review.

> +<h2 id="general">General Optimizer Improvements</h2>
> +  <ul>
> +    <li>UndefinedBehaviorSanitizer gained a new sanitization option:
> +    <ul>
> +      <li><code>-fsanitize=bounds-strict</code>: enables strict checking
> +	  of array bounds.  In particular, it enables
> +	  <code>-fsanitize=bounds</code> as well as instrumentation of
> +	  flexible array member-like arrays.</li>
> +    </ul>
> +  </ul>

Here I'm wondering whether the nested list could just be merged
into the primary item (and I'd omit the colon before "enables").

> +    <li>It is possible to disable warnings when an initialized field of
> +	a structure or an union with side effects is being overridden when
> +	using designated initializers via a new warning option
> +	<code>-Woverride-init-side-effects</code>.</li>

"a union".  English can be tricky for us non-native speakers at 
times, since usually you would use "an" before "u", except when 
that "u" is pronounced as a consonant or a syllable starting with 
one.  And the "u" in "union" actually is prounced as "you-nion".

Gerald

[wwwdocs] Update changes.html

[Marek Polacek]

Ok to commit?

Index: changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-6/changes.html,v
retrieving revision 1.3
diff -u -r1.3 changes.html
--- changes.html	6 May 2015 09:55:29 -0000	1.3
+++ changes.html	11 May 2015 14:44:38 -0000
@@ -16,15 +16,36 @@
 
 
 <!-- .................................................................. -->
-<!-- <h2 id="general">General Optimizer Improvements</h2> -->
-
+<h2 id="general">General Optimizer Improvements</h2>
+  <ul>
+    <li>UndefinedBehaviorSanitizer gained a new sanitization option:
+    <ul>
+      <li><code>-fsanitize=bounds-strict</code>: enables strict checking
+	  of array bounds.  In particular, it enables
+	  <code>-fsanitize=bounds</code> as well as instrumentation of
+	  flexible array member-like arrays.</li>
+    </ul>
+  </ul>
 
 <!-- .................................................................. -->
 <h2 id="languages">New Languages and Language specific improvements</h2>
 
 <!-- <h3 id="ada">Ada</h3> -->
 
-<!-- <h3 id="c-family">C family</h3> -->
+<h3 id="c-family">C family</h3>
+  <ul>
+    <li>A new command-line option <code>-Wshift-negative-value</code> has been
+	added for the C and C++ compilers, which warns about left shifting
+	a negative value.</li>
+  </ul>
+
+<h3 id="c">C</h3>
+  <ul>
+    <li>It is possible to disable warnings when an initialized field of
+	a structure or an union with side effects is being overridden when
+	using designated initializers via a new warning option
+	<code>-Woverride-init-side-effects</code>.</li>
+  </ul>
 
 <h3 id="cxx">C++</h3>
 

	Marek

Re: [wwwdocs] Update changes.html

[Marek Polacek]

On Wed, Oct 15, 2014 at 12:51:41PM +0200, Jakub Jelinek wrote:
> And porting_to.html.

I plan to prepare "porting to" this week.

	Marek

Re: [wwwdocs] Update changes.html

[Marek Polacek]

On Wed, Oct 15, 2014 at 12:50:55PM +0200, Richard Biener wrote:
> On Wed, Oct 15, 2014 at 12:21 PM, Marek Polacek <polacek@redhat.com> wrote:
> > A trivial patch to document that the C default has been changed.
> 
> This should be also mentioned at the toplevel "Caveats" section.

Ok, I'll commit the following as well.

Index: changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-5/changes.html,v
retrieving revision 1.17
diff -u -r1.17 changes.html
--- changes.html	15 Oct 2014 10:22:16 -0000	1.17
+++ changes.html	15 Oct 2014 11:08:35 -0000
@@ -12,7 +12,11 @@
 <h1>GCC 5 Release Series<br />Changes, New Features, and Fixes</h1>
 
 
-<!-- h2>Caveats</h2 -->
+<h2>Caveats</h2>
+  <ul>
+    <li>The default mode for C is now <code>-std=gnu11</code> instead of
+        <code>-std=gnu89</code>.</li>
+  </ul>
 
 <h2 id="general">General Optimizer Improvements</h2>
 

	Marek

Re: [wwwdocs] Update changes.html

[Jakub Jelinek]

On Wed, Oct 15, 2014 at 12:50:55PM +0200, Richard Biener wrote:
> On Wed, Oct 15, 2014 at 12:21 PM, Marek Polacek <polacek@redhat.com> wrote:
> > A trivial patch to document that the C default has been changed.
> 
> This should be also mentioned at the toplevel "Caveats" section.

And porting_to.html.

	Jakub

Re: [wwwdocs] Update changes.html

[Richard Biener]

On Wed, Oct 15, 2014 at 12:21 PM, Marek Polacek <polacek@redhat.com> wrote:
> A trivial patch to document that the C default has been changed.

This should be also mentioned at the toplevel "Caveats" section.

Richard.

> Applying.
>
> Index: changes.html
> ===================================================================
> RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-5/changes.html,v
> retrieving revision 1.16
> diff -u -r1.16 changes.html
> --- changes.html        10 Oct 2014 17:57:52 -0000      1.16
> +++ changes.html        15 Oct 2014 10:20:18 -0000
> @@ -60,6 +60,7 @@
>
>  <h3 id="c">C</h3>
>    <ul>
> +    <li>The default mode has been changed to <code>-std=gnu11</code>.</li>
>      <li>A new command-line option <code>-Wc90-c99-compat</code> has been added
>         to warn about features not present in ISO C90, but present in ISO
>         C99.</li>
>
>         Marek

[wwwdocs] Update changes.html

[Marek Polacek]

A trivial patch to document that the C default has been changed.

Applying.

Index: changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-5/changes.html,v
retrieving revision 1.16
diff -u -r1.16 changes.html
--- changes.html	10 Oct 2014 17:57:52 -0000	1.16
+++ changes.html	15 Oct 2014 10:20:18 -0000
@@ -60,6 +60,7 @@
 
 <h3 id="c">C</h3>
   <ul>
+    <li>The default mode has been changed to <code>-std=gnu11</code>.</li>
     <li>A new command-line option <code>-Wc90-c99-compat</code> has been added
 	to warn about features not present in ISO C90, but present in ISO
 	C99.</li>

	Marek