From: Steve Ellcey <sje@cup.hp.com>
Date: Tue, 3 Mar 2009 18:27:42 +0000 (+0000)
Subject: re PR middle-end/34443 (The GCC manual about section variable attribute is incorrect)
X-Git-Tag: releases/gcc-4.4.0~370
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8b9d598f0340b46fb087c0a7009ee982cb9475f8;p=thirdparty%2Fgcc.git

re PR middle-end/34443 (The GCC manual about section variable attribute is incorrect)

	PR middle-end/34443
	* doc/extend.texi (section): Update description.

From-SVN: r144582
---

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 3d4b017a92cc..a4a187464e77 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2009-03-03  Steve Ellcey  <sje@cup.hp.com>
+
+	PR middle-end/34443
+	* doc/extend.texi (section): Update description.
+
 2009-03-03  H.J. Lu  <hongjiu.lu@intel.com>
 
 	PR middle-end/39345
diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index 21769c161bfb..f901db32fdac 100644
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -3872,7 +3872,7 @@ section.  For example, this small program uses several specific section names:
 struct duart a __attribute__ ((section ("DUART_A"))) = @{ 0 @};
 struct duart b __attribute__ ((section ("DUART_B"))) = @{ 0 @};
 char stack[10000] __attribute__ ((section ("STACK"))) = @{ 0 @};
-int init_data __attribute__ ((section ("INITDATA"))) = 0;
+int init_data __attribute__ ((section ("INITDATA")));
 
 main()
 @{
@@ -3889,18 +3889,19 @@ main()
 @end smallexample
 
 @noindent
-Use the @code{section} attribute with an @emph{initialized} definition
-of a @emph{global} variable, as shown in the example.  GCC issues
-a warning and otherwise ignores the @code{section} attribute in
-uninitialized variable declarations.
+Use the @code{section} attribute with
+@emph{global} variables and not @emph{local} variables,
+as shown in the example.
 
-You may only use the @code{section} attribute with a fully initialized
-global definition because of the way linkers work.  The linker requires
+You may use the @code{section} attribute with initialized or
+uninitialized global variables but the linker requires
 each object be defined once, with the exception that uninitialized
 variables tentatively go in the @code{common} (or @code{bss}) section
-and can be multiply ``defined''.  You can force a variable to be
-initialized with the @option{-fno-common} flag or the @code{nocommon}
-attribute.
+and can be multiply ``defined''.  Using the @code{section} attribute
+will change what section the variable goes into and may cause the
+linker to issue an error if an uninitialized variable has multiple
+definitions.  You can force a variable to be initialized with the
+@option{-fno-common} flag or the @code{nocommon} attribute.
 
 Some file formats do not support arbitrary sections so the @code{section}
 attribute is not available on all platforms.