Bug 49674 - Improve documentation for __attribute__ __section__
Summary: Improve documentation for __attribute__ __section__
Status: RESOLVED WORKSFORME
Alias: None
Product: gcc
Classification: Unclassified
Component: c (show other bugs)
Version: 4.6.1
: P3 normal
Target Milestone: ---
Assignee: Not yet assigned to anyone
URL:
Keywords: documentation
Depends on:
Blocks:
 
Reported: 2011-07-08 09:11 UTC by R. Diez
Modified: 2018-11-13 02:29 UTC (History)
1 user (show)

See Also:
Host:
Target:
Build:
Known to work:
Known to fail:
Last reconfirmed: 2011-07-08 10:23:58


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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.