Re: [wwwdocs] Mention attribute noclone and -fipa-sra in changes.html

[Martin Jambor <mjambor at suse dot cz>]

Hi,

On Tue, Mar 16, 2010 at 04:32:14PM +0100, Gerald Pfeifer wrote:
> On Mon, 15 Mar 2010, Martin Jambor wrote:
> > the patch below briefly mentions the new noclone attribute (as well as 
> > that noinline no longer does this) and -fipa-sra in changes.html as they 
> > may be of some importance to some users.
> 
> Nice, thanks.
> 
> > +    <li>There is a new command-line switch <code>-fipa-sra</code>.  When
> > +    turned on, a new pass will attempt to change prototype of functions
> > +    to avoid unused parameters, pass only relevant parts of structures
> > +    and turn arguments passed by reference to arguments passed by value
> > +    when possible.  </li>
> 
> This one I suggest to adjust to say "There is a new optimization pass 
> that... .  It is enabled by <code>-O2</code> and above as well as 
> <code>-Os</code> and can be manuyll invoked using the new command-line 
> switch..." or something along these lines.
> 
> That is, talk about the optimization first and only then the invocation,
> and mention when it is active by default.
> 

Right, I simply reused structure sentence from 4.4 changes which I
copied from some older ones, I suppose.  What about this?

Thanks,

Martin


Index: changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-4.5/changes.html,v
retrieving revision 1.77
diff -u -r1.77 changes.html
--- changes.html	3 Mar 2010 05:27:49 -0000	1.77
+++ changes.html	18 Mar 2010 14:02:37 -0000
@@ -68,6 +68,12 @@
     to stricter standard conformance of the compiler and can be avoided by
     using the flag <code>-fexcess-precision=fast</code>; also see
     <a href="#x86">below</a>.</li>
+
+    <li>The function attribute <code>noinline</code> no longer prevents GCC
+    from cloning the function.  A new attribute <code>noclone</code>
+    has been introduced for this purpose.  Cloning a function means
+    that it is duplicated and the new copy is specialized for certain
+    contexts (for example when a parameter is a known constant).</li>    
  </ul>
 
 <h2>General Optimizer Improvements</h2>
@@ -145,6 +151,12 @@
     Optimizations based on restrict qualified pointers are now also available
     when using <code>-fno-strict-aliasing</code>.</li>
 
+    <li>There is a new optimization pass that attempts to change prototype
+    of functions to avoid unused parameters, pass only relevant parts of
+    structures and turn arguments passed by reference to arguments passed
+    by value when possible. It is enabled by <code>-O2</code> and above
+    as well as <code>-Os</code> and can be manually invoked using the new
+    command-line switch <code>-fipa-sra</code>.  </li>
   </ul>
 
 <h2>New Languages and Language specific improvements</h2>