https://gcc.gnu.org/bugzilla/show_bug.cgi?id=88472
--- Comment #6 from sandra at gcc dot gnu.org --- Thanks. It's good to get confirmation that the structural changes make sense even if the formatting and presentation still need work. I wasn't very happy with putting the info about the entities each attribute applies to in the running text, either. I could definitely add a boilerplate sentence right at the beginning of every attribute's documentation like "This attribute can be applied to ....", the way the C standard does it. I also considered defining some sort of @defwhatever macro to format these things in a compact way, but I didn't think this could all fit on one line in the general case. I think it would also be a good idea to have a separate index for attributes instead of using @cindex. regenerate-attr-urls.py is going to need some extra changes for that (beyond whatever changes are required just by things moving to different sections). The patch that does the text shuffling is huge (275k) and I would like to get that committed soon, before it gets bit-rotten. The PDF also includes some smaller patches already in my stack that have fixed some problems with the presentation in the AArch64 and LoongArch sections, and a rewrite of the introductory material to address PR102397, but my plan is to defer finishing PR102397 (namely, rewriting examples) and any other purely editorial work on the content until after I get the changes for this issue in shape to commit.
