Here's another batch of patches to address PR42270, a complaint about the
poor organization of the documentation for GNU extensions. My last set of
patches for this was focused on grouping everything but the attributes and
builtins documentation into categories. This set does those two groupings,
plus a couple of other leftover cleanups.
For the attributes documentation, I moved the multiple existing sections
to be subsections of a new container section. I didn't attempt to rewrite
any of the material to reduce duplication (PR88472) or to focus on using
standard attribute syntax instead of the traditional GNU syntax (PR102397).
With the builtins documentation, adding a new level to the section
hierarchy wasn't practical because of the limitation that Texinfo only
goes as far down as @subsubsection, and we already had many of those
in the target-specific builtins sections. Instead, I created a new
parallel chapter for builtins. Here I did do some additional
reorganization of the material, combining some sections, deleting
others, and adding some new container sections, but I didn't do much
review or correction of the actual text.
As with the previous batch of these patches, I'll hold off on
committing these for a few days in case anybody has any complaints or
suggestions. (E.g., should the attributes documentation be split into
a separate chapter as well, instead of being pushed down?)
-Sandra
Sandra Loosemore (7):
Doc: Remove separate "Target Format Checks" section [PR42270]
Doc: Add a container section to consolidate attribute documentation
[PR42270]
Doc: Move builtin documentation to a new chapter [PR42270]
Doc: Break up and rearrange the "other builtins" section [PR42270]
Doc: Organize atomic memory builtins documentation [PR42270]
Doc: Move Integer Overflow Builtins section [PR42270]
Doc: Clean up New/Delete Builtins manual section
gcc/doc/extend.texi | 3569 ++++++++++++++++++++++---------------------
gcc/doc/gcc.texi | 1 +
gcc/doc/invoke.texi | 4 +-
3 files changed, 1848 insertions(+), 1726 deletions(-)
--
2.34.1
