[Bug c/49674] New: Improve documentation for __attribute__ __section__

[rdiezmail-gcc at yahoo dot de]

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=49674

           Summary: Improve documentation for __attribute__ __section__
           Product: gcc
           Version: 4.6.1
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: c
        AssignedTo: unassigned@gcc.gnu.org
        ReportedBy: rdiezmail-gcc@yahoo.de


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.