doc/extend.texi: Discourage use of the optimize attribute

	* doc/extend.texi (Common Function Attributes) [optimize]:
	Discourage use of the optimize attribute.

From-SVN: r235580

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index c5cfea6bf9b7fb05c734e7dcd654051f37b98696..52be94c01052674606995e6e83bc748d852c332d 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2016-04-28  Markus Trippelsdorf  <markus@trippelsdorf.de> 
+
+       * doc/extend.texi (Common Function Attributes) [optimize]:
+       Discourage use of the optimize attribute.
+
 2016-04-28  Bill Seurer  <seurer@linux.vnet.ibm.com>
 
        * config/rs6000/rs6000-builtin.def (vec_adde): Change vec_adde to a

diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index a5a8b23df275b70f047a3af9f79fa18a8542dcc0..3c8b8d735539640f006f81a769032e055b154b01 100644 (file)
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -3026,10 +3026,8 @@ that affect more than one function.
 @xref{Function Specific Option Pragmas}, for details about the
 @samp{#pragma GCC optimize} pragma.
 
-This can be used for instance to have frequently-executed functions
-compiled with more aggressive optimization options that produce faster
-and larger code, while other functions can be compiled with less
-aggressive options.
+This attribute should be used for debugging purposes only.  It is not
+suitable in production code.
 
 @item pure
 @cindex @code{pure} function attribute