[Bug other/56334] __attribute__((aligned)) documentation is misleading

["brooks at gcc dot gnu.org" <gcc-bugzilla at gcc dot gnu dot org>]

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

--- Comment #2 from Brooks Moses <brooks at gcc dot gnu.org> 2013-02-15 01:17:47 UTC ---
(In reply to comment #1)
> No, 33721 is about stack variables and not static allocated variables which
> still is limited by the linker.

Ah, I missed that.  That makes sense.

> > (2) The statement "See your linker documentation for further information" is
> > entirely unhelpful, because the GNU ld documentation makes no mention of
> > alignment limitations (or, for that matter, of aligning variables at all). 
> 
> That is because it is limited not by the GNU ld but rather the file formats
> that are in use for the target (or non GNU linkers).  So I think the
> documentation is still correct in what is says, it just needs to cleared up
> slightly and also talked about stack allocated variable which have no linker
> issue involved.

Fair enough.  Suffice it to say that it's definitely confusing, though, given
the datapoint that I was very confused!  :)  And it sent me off on rather a
wild goose chase through the GNU ld manual trying to figure out why alignment
wasn't working right (on an older pre-33721-fix version of GCC).

Is there useful documentation of the relevant file formats that could be
pointed to instead?