GCC Bugzilla Bug 1078

There are many problems with the documentation of attributes in
extend.texi:

1) The syntax of attributes on labels is undocumented, though it's
   mentioned in invoke.texi that attributes can be placed on labels.

2) The data attributes eightbit_data and tiny_data are listed under
   function attributes.

3) There is no documentation for the attributes "common" and
   "no_stack_limit".

4) There is no documentation for the C++ attributes "com_interface"
   and "init_priority" in extend.texi, though init_priority is
   mentioned in invoke.texi.

5) Several attributes have documented lists of targets for which they
   are implemented, but those lists are incomplete, not mentioning
   some implemented targets:

        Attribute       Machines not documented
        =========       =======================
        interrupt       ARC, C4X, V850, m68hc11
        dllimport       ARM/pe, MCore, i386 Windows NT
        dllexport       ARM/pe, MCore, i386 Windows NT
        stdcall         ns32k
        cdecl           ns32k
        naked           MCore
        interrupt_handler   SH, V850

6) Several machine-specific attributes are not documented:

        Attribute       Machine
        =========       =======
        overlaid        VMS on Alpha
        isr             ARM
        progmem         AVR
        assembler       C4X
        leaf_pretend    C4X
        OS_Task         H8/300
        monitor         H8/300
        syscall_linkage IA64
        sp_switch       SH
        trap_exit       SH
        sda             V850
        tda             V850
        zda             V850
        trap            m68hc11

Release:
2.97 20001216 (experimental)

Environment:
System: Linux decomino 2.2.18 #1 Thu Dec 14 19:30:45 UTC 2000 i686 unknown
Architecture: i686

	
host: i686-pc-linux-gnu
build: i686-pc-linux-gnu
target: i686-pc-linux-gnu
configured with: ../gcc-cvs/configure --prefix=/opt/gcc/snapshot --disable-shared --enable-threads=posix --with-system-zlib

How-To-Repeat:
Find undocumented attributes in the source code or alluded to in other
bits of documentation.

Fix:
Document all attributes, using machine-specific knowledge where
necessary.

State-Changed-From-To: open->analyzed
State-Changed-Why: Documented interrupt_handler, sp_switch and trap_exit.

From: "Joseph S. Myers" <jsm28@cam.ac.uk>
To: <gcc-gnats@gcc.gnu.org>,  <gcc-bugs@gcc.gnu.org>
Cc:  
Subject: other/1078
Date: Mon, 10 Sep 2001 22:25:08 +0100 (BST)

 PR other/1078 lists problems with the documentation of various attributes.  
 The following is an update to the list there:
 
 init_priority is now documented.
 
 The SH attributes interrupt_handler, sp_switch and trap_exit are now
 documented.
 
 The ARM attribute interfacearm, not on the previous list, is undocumented.
 
 The stormy16 attribute interrupt is not documented.
 
 Could the ARC, ARM, AVR, C4X, H8/300, IA64, i386, m68hc11, MCore, ns32k,
 stormy16 and V850 maintainers update the documentation in extend.texi
 relating to their targets' attributes?
 
 -- 
 Joseph S. Myers
 jsm28@cam.ac.uk

PR 27544 is about a missing docs for an attribute for RS6000, altivec.
PR 27543 is about ms_struct attribute on rs6000/PowerPC as it just says x86
supports it which is no longer true.

Patch to document AVR progmem attribute:
http://gcc.gnu.org/ml/gcc-patches/2007-07/msg01832.html

(In reply to comment #5)
> Patch to document AVR progmem attribute:
> http://gcc.gnu.org/ml/gcc-patches/2007-07/msg01832.html
> 

Now committed:
http://gcc.gnu.org/ml/gcc-patches/2007-09/msg00159.html

This bug is fixed for the AVR target.