[Bug target/79747] Missing documentation for -malign-{jumps,label,loops,functions}= and strange value range limitation

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

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=79747

--- Comment #3 from Martin Liška <marxin at gcc dot gnu.org> ---
(In reply to Martin Sebor from comment #2)
> I don't see -malign-functions in the latest manual.  -falign-functions is
> documented with an optional equals at the end.
> 
> $ (cd /src/gcc/trunk && grep align-functions= gcc/doc/*)
> grep: gcc/doc/include: Is a directory
> gcc/doc/invoke.texi:@itemx -falign-functions=@var{n}
> gcc/doc/invoke.texi:@option{-falign-functions=32} aligns functions to the
> next 32-byte
> gcc/doc/invoke.texi:boundary, but @option{-falign-functions=24} aligns to
> the next
> gcc/doc/invoke.texi:@option{-fno-align-functions} and
> @option{-falign-functions=1} are

Sure, -falign-functions is documented, by -malign-functions is not.

> 
> With today's trunk I get:
> 
> $ gcc  -Wall -Wextra -Wpedantic -Wrestrict -malign-functions -xc - <
> /dev/null
> xgcc: error: unrecognized command line option ‘-malign-functions’; did you
> mean ‘-falign-functions’?

Yes, you have to provide a value for -malign-functions option:

$ gcc  -Wall -Wextra -Wpedantic -Wrestrict -malign-functions=111111 -xc - <
/dev/null
cc1: warning: -malign-functions is obsolete, use -falign-functions
cc1: error: -malign-functions=111111 is not between 0 and 16

That means the option is not documented.