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

            Bug ID: 69477
           Summary: attribute aligned documentation misleading
           Product: gcc
           Version: 6.0
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: other
          Assignee: unassigned at gcc dot gnu.org
          Reporter: msebor at gcc dot gnu.org
  Target Milestone: ---

The documentation of attribute aligned mentions attribute packed. 
Unfortunately, it does so in two paragraphs separated by a third paragraph that
talks only about attribute aligned, with the second paragraph reading as if it
referred to attribute aligned. Here's the relevant text:

The aligned attribute can only increase the alignment; but you can decrease it
by specifying packed as well. See below.

Note that the effectiveness of aligned attributes may be limited...

Specifying this attribute for struct and union types is equivalent to
specifying the packed attribute on each of the structure or union members. ...

Since the third paragraph refers to "this attribute" and the last attribute
that was discussed was "attribute aligned" it suggests that:

Specifying attribute aligned for struct and union types is equivalent to
specifying the packed attribute on each of the structure or union members. ...

which is not the case.

Reply via email to