[gcc r14-9057] AVR: Improve documentation for -mmcu=.

[gcc r14-9057] AVR: Improve documentation for -mmcu=.

[Georg-Johann Lay]

https://gcc.gnu.org/g:e63ae9085aca9d306a2f16445b473289b9186e10

commit r14-9057-ge63ae9085aca9d306a2f16445b473289b9186e10
Author: Georg-Johann Lay <avr@gjlay.de>
Date:   Sun Feb 18 12:45:31 2024 +0100

    AVR: Improve documentation for -mmcu=.
    
    gcc/
            * doc/invoke.texi (AVR Options) <-mmcu>: Remove "Atmel".
            Note on complete device support.

Diff:
---
 gcc/doc/invoke.texi | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index d0e67729f565..e18886e0ac7b 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -23732,12 +23732,22 @@ These options are defined for AVR implementations:
 @table @gcctabopt
 @opindex mmcu
 @item -mmcu=@var{mcu}
-Specify Atmel AVR instruction set architectures (ISA) or MCU type.
-
-The default for this option is@tie{}@samp{avr2}.
-
-GCC supports the following AVR devices and ISAs:
-
+Specify the AVR instruction set architecture (ISA) or device type.
+The default for this option is@tie{}@code{avr2}.
+
+The following AVR devices and ISAs are supported.
+@emph{Note:} A complete device support consists of
+startup code @code{crt@var{mcu}.o}, a device header @code{avr/io*.h},
+a device library @code{lib@var{mcu}.a} and a
+@uref{https://gcc.gnu.org/wiki/avr-gcc#spec-files,device-specs} file
+@code{specs-@var{mcu}}. Only the latter is provided by the compiler
+according the supported @code{@var{mcu}}s below.  The rest is supported
+by @w{@uref{https://www.nongnu.org/avr-libc/,AVR-LibC}}, or by means of
+@uref{https://gcc.gnu.org/wiki/avr-gcc#atpack,@code{atpack}} files
+from the hardware manufacturer.
+
+@c Auto-generated.  Re-build when new devices are added to avr-mcus.def
+@c by running "make avr-mcus" in $builddir/gcc.
 @include avr-mmcu.texi
 
 @opindex mabsdata