Bug 49674

Summary:	Improve documentation for __attribute__ __section__
Product:	gcc	Reporter:	R. Diez <rdiezmail-gcc>
Component:	c	Assignee:	Not yet assigned to anyone <unassigned>
Status:	RESOLVED WORKSFORME
Severity:	normal	CC:	sandra
Priority:	P3	Keywords:	documentation
Version:	4.6.1
Target Milestone:	---
Host:		Target:
Build:		Known to work:
Known to fail:		Last reconfirmed:	2011-07-08 10:23:58

Description R. Diez 2011-07-08 09:11:23 UTC

Can someone please improve the documentation for __attribute__ __section__ ? Only functions are mentioned, but I know it works for variables too. This is the documentation page on the Web:

  http://gcc.gnu.org/onlinedocs/gcc-4.6.1/gcc/Function-Attributes.html

Apparently, there are checks in GCC against the section properties. For example, you cannot place a non-const variable in a const section, you get a "section type conflict" error message. Documentation about this would be an extra bonus.

I wonder how documentation bugs are handled in this project, I couldn't find any "documentation" category in Bugzilla.

Many thanks in advance.

Comment 1 sandra 2018-11-13 02:29:55 UTC

There's already been documentation for the section attribute for variables for a long time (at least since 2001).  I think it predates the addition of the docs for the section attribute for functions.  Trunk already includes discussion of linker issues.

There are a lot of documentation bugs in bugzilla.  There are fewer volunteers working on fixing any of them.