[Bug other/88472] attribute documentation poorly structured, lots of duplication

[cvs-commit at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=88472

--- Comment #8 from GCC Commits <cvs-commit at gcc dot gnu.org> ---
The master branch has been updated by Sandra Loosemore <sandra@gcc.gnu.org>:

https://gcc.gnu.org/g:6e3c137f5dbbc5c993daf9bb015579be91fb410f

commit r16-7674-g6e3c137f5dbbc5c993daf9bb015579be91fb410f
Author: Sandra Loosemore <sloosemore@baylibre.com>
Date:   Wed Feb 18 01:05:31 2026 +0000

    doc: Merge function, variable, type, and statement attribute sections
[PR88472]

    The previous organization of the Attributes section of the manual was like

    Attributes
      Function Attributes
        Common Function Attributes
        + various subsections by target
      Variable Attributes
        Common Variable Attributes
        + various subsections by target
      Type Attributes
        likewise
      Label Attributes
      Enumerator Attributes
      Statement Attributes
      GNU Attribute Syntax

    There was a bunch of introductory text duplicated at the top of the
    sections for each kind of attribute, and many attributes were listed
    in multiple places -- particularly linker-related attributes like
    "section" that apply to both functions and variables with the same
    semantics.

    The material has been reorganized by merging the corresponding
    sections for each kind of attribute:

    Attributes
      Common Attributes
      Target-Specific Attributes
        + various subsections by target
      GNU Attribute Syntax

    Most of the previous boilerplate introductory text for each subsection
    has been discarded since it's been replaced by a general introduction
    in the top-level Attributes section in a previous patch of this
    series.  The duplicate entries for different kinds of attributes of
    the same name have been merged and in some cases I reworded things to
    provide explicit context about what entities the attribute applies to.

    gcc/ChangeLog
            PR other/88472
            * doc/extend.texi (Attributes): Merge respective subsections of
            Function Attributes, Variable Attributes, Type Attributes,
            Label Attributes, Enumerator Attributes, and Statement Attributes
            into new sections Common Attributes and Target-Specific Attributes.
            Fix cross-references.
            * doc/invoke.texi: Fix cross-references.
            * doc/trouble.texi: Likewise.