From: Markus Trippelsdorf <markus@trippelsdorf.de>
Date: Thu, 28 Apr 2016 16:25:00 +0000 (+0000)
Subject: doc/extend.texi: Discourage use of the optimize attribute
X-Git-Tag: basepoints/gcc-8~7336
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=893100c3fa9b3049ce84dcc0c1a839ddc7a21387;p=thirdparty%2Fgcc.git

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 c5cfea6bf9b7..52be94c01052 100644
--- 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 a5a8b23df275..3c8b8d735539 100644
--- 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