[wwwdocs] [PATCH] document new features and options

[wwwdocs] [PATCH] document new features and options

[Nathan Froyd]

Gerald asked that the PowerPC -msingle-pic-base option be documented.
I've skimmed through the ChangeLog and tried to add other interesting
things in as well.

OK to commit?  David, do the PowerPC descriptions look reasonable?

-Nathan

*** changes.html.~1.81.~	2011-01-06 17:29:36.000000000 -0500
--- changes.html	2011-01-06 19:43:31.252499307 -0500
***************
*** 145,150 ****
--- 145,155 ----
        It can be used to enable or disable the compiler's stack-slot combining
        pass which before was enabled automatically at <code>-O1</code> and above,
        but could not be controlled on its own.</li>
+       <li>A new switch <code>-fstrict-volatile-bitfields</code> has been
+ 	added.  Using it indicates that accesses to volatile bitfields
+ 	should use a single access of the width of the field's type.
+ 	This option can be useful for precisely defining and accessing
+ 	memory-mapped peripheral registers from C.</li>
    </ul>
  
  <h2>Compile time and memory usage improvements</h2>
***************
*** 185,190 ****
--- 190,200 ----
      <li>The new function attribute <code>callee_pop_aggregate</code> allows
      to specify if the caller or callee is responsible for popping the
      aggregate return pointer value from the stack.</li>
+     <li>Support for selectively enabling and disabling warnings
+       via <code>#pragma GCC diagnostic</code> has been added.</li>
+     <li>The <code>-fmax-errors=N</code> option is now supported.  Using
+     this option causes the compiler to exit after <code>N</code> errors
+     have been issued.</li>
    </ul>
  
  <h3 id="c">C</h3>
***************
*** 244,249 ****
--- 254,268 ----
      type declaration shadows another type in C++. Note that the compiler will
      not warn if a local variable shadows a struct/class/enum, but will warn
      if it shadows an explicit typedef. </li>
+ 
+     <li>When an identifier is not found in the current scope, G++ now
+     offers suggestions about which identifier might have been
+     intended.</li>
+ 
+     <li>G++ now issues clearer diagnostics for missing semicolons
+     after <code>class</code>, <code>struct</code>,
+     and <code>union</code> definitions.  Clearer diagnostics are also
+     issued for missing semicolons after class member declarations.
    </ul>
  
    <h4>Runtime Library (libstdc++)</h4>
***************
*** 530,535 ****
--- 549,556 ----
    <ul>
      <li>The SSA loop prefetching pass is enabled when
        using <code>-O3</code>.</li>
+     <li>GCC now supports the Cortex-M4 processor
+     with <code>-mcpu=cortex-m4</code>.</li>
    </ul>
  
  <h3>IA-32/x86-64</h3>
***************
*** 582,593 ****
  
  <h3 id="picochip">picochip</h3>
  
! <h3>PowerPC64</h3>
    <ul>
! 	<li>PowerPC64 Linux support for applications requiring a large
! 	TOC section has been improved.  A new command-line option,
! 	<code>-mcmodel=[small,medium,large]</code>, controls this
! 	feature.</li>
    </ul>
  
  <h3>S/390, zSeries and System z9/z10, IBM zEnterprise z196</h3>
--- 603,629 ----
  
  <h3 id="picochip">picochip</h3>
  
! <h3>PowerPC/PowerPC64</h3>
    <ul>
!     <li>GCC now supports the Applied Micro Titan processor
!     with <code>-mcpu=titan</code>.</li>
!     <li>The <code>-mrecip</code> option has been added, which indicates
!     whether to the reciprocal and reciprocal square root instructions
!     should be used.</li>
!     <li>The <code>-mveclibabi=mass</code> option can be used to enable
!     the compiler to autovectorize mathematical functions using the
!     Mathematical Acceleration Subsystem library.</li>
!     <li>The <code>-msingle-pic-base</code> option has been added, which
!     instructs the compiler to avoid loading the PIC base register in
!     function prologues.  The PIC base register must be initialized by
!     the runtime system.</li>
!     <li>The <code>-mblock-move-inline-limit</code> option has been
!     added, which enables the user to control the maximum size of
!     inlined <code>memcpy</code> calls and similar.</li>
!     <li>PowerPC64 Linux support for applications requiring a large
!       TOC section has been improved.  A new command-line option,
!       <code>-mcmodel=[small,medium,large]</code>, controls this
!       feature.</li>
    </ul>
  
  <h3>S/390, zSeries and System z9/z10, IBM zEnterprise z196</h3>

Re: [wwwdocs] [PATCH] document new features and options

[Joseph S. Myers]

On Thu, 6 Jan 2011, Nathan Froyd wrote:

> Gerald asked that the PowerPC -msingle-pic-base option be documented.
> I've skimmed through the ChangeLog and tried to add other interesting
> things in as well.

Thanks for doing this.  I do intend to add release notes for implemented 
C1X features (with appropriate caveats that they may change incompatibly 
if C1X changes in the relevant areas) before 4.6 is out.

(This is not a review or approval of your patch.)

-- 
Joseph S. Myers
joseph@codesourcery.com

Re: [wwwdocs] [PATCH] document new features and options

[Nathan Froyd]

On Thu, Jan 06, 2011 at 07:49:06PM -0500, Nathan Froyd wrote:
> Gerald asked that the PowerPC -msingle-pic-base option be documented.
> I've skimmed through the ChangeLog and tried to add other interesting
> things in as well.
> 
> OK to commit?  David, do the PowerPC descriptions look reasonable?

http://gcc.gnu.org/ml/gcc-patches/2011-01/msg00337.html

Ping.

-Nathan

Re: [wwwdocs] [PATCH] document new features and options

[Gerald Pfeifer]

On Thu, 6 Jan 2011, Nathan Froyd wrote:
> Gerald asked that the PowerPC -msingle-pic-base option be documented.
> I've skimmed through the ChangeLog and tried to add other interesting
> things in as well.

Nice, thanks for doing this, Nathan!

I am not completely firm in all of these areas so I suggest to wait
another day for others to chime in and then go ahead.  To me it looks
good.

> +     <li>Support for selectively enabling and disabling warnings
> +       via <code>#pragma GCC diagnostic</code> has been added.</li>

Here it would be nice to see a small example.  Not required for 
approval, but nice. :-)

> !       TOC section has been improved.  A new command-line option,
> !       <code>-mcmodel=[small,medium,large]</code>, controls this
> !       feature.</li>

Here I suggest to omit the commas?

Thanks again,
Gerald

Re: [wwwdocs] [PATCH] document new features and options

[David Edelsohn]

On Mon, Jan 10, 2011 at 11:03 AM, Nathan Froyd <froydnj@codesourcery.com> wrote:
> On Thu, Jan 06, 2011 at 07:49:06PM -0500, Nathan Froyd wrote:
>> Gerald asked that the PowerPC -msingle-pic-base option be documented.
>> I've skimmed through the ChangeLog and tried to add other interesting
>> things in as well.
>>
>> OK to commit?  David, do the PowerPC descriptions look reasonable?
>
> http://gcc.gnu.org/ml/gcc-patches/2011-01/msg00337.html
>
> Ping.

Okay.

Thanks, David