This patch series is for my long-planned revision of the attributes
documentation in the GCC manual, addressing PR88472 and partly
PR102397, as well as fixing some copy-editing issues I noted along the
way, and improving the indexing of attributes by moving them out of
the concept index into an index of their own.
Part 2 of this series, the part that does that actual merging of the
attribute sections per PR88472, is very large, and I don't think it's
a good use of anybody's time to review that patch. Instead I have
attached a PDF of the reorganized attribute section (the result of
applying all parts of the patch series) to PR88472, which people can
look over.
The unfinished part of PR102397 is updating at least some of the
examples for specific attributes to use the new standard syntax. I am
wary of messing with the target-specific examples, though, because I
don't have build configurations set up for most targets to get a GCC
to check the syntax with.
There are also about a dozen other open bugzilla issues relating to
attribute documentation that I am deferring until I get the parts I
have finished so far committed. Because the current patch set touches
so much text, I'd like to get it in before it becomes bit-rotten and
follow up with additional incremental patches.
So, I'll push this patch series in a few days unless there are
objections meanwhile.
-Sandra
Sandra Loosemore (11):
doc: Rewrite/reorganize discussion of attribute syntax [PR102397]
doc: Merge function, variable, type, and statement attribute sections
[PR88472]
doc: Tag attributes with what they apply to [PR88472]
doc: General copy-editing in Attributes section
doc, aarch64: Tidy AArch64 target attribute documentation
doc, loongarch: Clean up LoongArch attribute documentation
doc, riscv: Tidy RISC-V attribute documentation
doc: Consolidate hot/cold attribute documentation [PR88472]
doc: Consolidate documentation for naked attribute [PR88472]
doc: Put attributes in their own index [PR88472]
doc: Fix the attribute urlifier after changes to indexing [PR88472]
gcc/Makefile.in | 2 +-
gcc/attr-urls.def | 661 ++-
gcc/doc/extend.texi | 7426 ++++++++++++++++-----------------
gcc/doc/gcc.texi | 16 +-
gcc/doc/invoke.texi | 109 +-
gcc/doc/trouble.texi | 3 +-
gcc/gcc-attribute-urlifier.cc | 37 +-
gcc/regenerate-attr-urls.py | 75 +-
8 files changed, 4034 insertions(+), 4295 deletions(-)
--
2.39.5
