]> git.ipfire.org Git - thirdparty/gcc.git/commit
Only document -A/--assert options in cpp manual [PR122243]
authorSandra Loosemore <sloosemore@baylibre.com>
Wed, 22 Oct 2025 01:58:01 +0000 (01:58 +0000)
committerSandra Loosemore <sloosemore@baylibre.com>
Mon, 10 Nov 2025 17:59:46 +0000 (17:59 +0000)
commita9bd095b6dd52f6d0ffacfb3defd688932646c4a
tree05e9cc207f24de2748e404d37f3f6320c09776e0
parenteed59c586c565f7fd14aa1bfd814a631466bb4e9
Only document -A/--assert options in cpp manual [PR122243]

Assertions are a preprocessor feature that has been declared obsolete
with strong warnings not to use them since 2001.  The main GCC manual
documents the -A command-line option but doesn't include the section
that explains the purpose of the feature or that it is obsolete; that
material appears only in the preprocessor manual.  It seems rather pointless
to clutter up the GCC manual with unhelpful documentation of an obsolete
feature, so I've restricted the option documentation to the
preprocessor manual too.  I've also added the missing documentation
entries for the long form of the option, --assert.

gcc/ChangeLog
PR other/122243
* doc/cppopts.texi (-A): Restrict option documentation to the CPP
manual.  Also document the --assert form.
* doc/invoke.texi (Option Summary): Don't list the -A option.
gcc/doc/cppopts.texi
gcc/doc/invoke.texi