The following patch has some parts that still need approval, i.e.
* Makefile.in (TEXI_GCC_FILES): Add avr-mmcu.texi. * doc/avr-mmcu.texi: New auto-generated file. * doc/invoke.texi (AVR Options): Include avr-mmcu.texi in order to document all valid -mmcu= arguments. http://gcc.gnu.org/ml/gcc-patches/2012-04/msg00961.html The avr-specific part is already approved: http://gcc.gnu.org/ml/gcc-patches/2012-04/msg00976.html Thanks, Johann
This patch adds a new file ./gcc/doc/avr-mmcu.texi that lists all valid -mmcu= settings and replaces the respective text in invoke.texi by @include avr-mmcu.texi Up to now, there is no complete list of -mmcu= options, and a list is hard to maintain by hand because it contains more than 180 devices. If, during the build of avr-gcc, a change of ./gcc/doc/avr-mmcu.texi is detected, the build aborts with a message that nags the user to copy the new content of avr-mmcu.texi to ./gcc/doc/avr-mmcu.texi. The error message's text is: *** Verify that you have permission to grant a *** GFDL license for all new text in *** avr-mmcu.texi, then copy it to $(srcdir)/doc/avr-mmcu.texi ./gcc/doc/avr-mmcu.texi is auto-generated, but there is no rule to automatically update it during the build process. Documents (HTML, PDF, ...) build fine. Ok for trunk? If it's appropriate for 4.7, I'd change invoke.texi accordingly by copy-pasting the auto-generated texi code into that file, i.e. into section "AVR Options". Johann * Makefile.in (TEXI_GCC_FILES): Add avr-mmcu.texi. * doc/avr-mmcu.texi: New auto-generated file. * doc/invoke.texi (AVR Options): Include avr-mmcu.texi in order to document all valid -mmcu= arguments. * config/avr/avr.h (arch_info_s): New struct definition. * config/avr/avr-devices.c (avr_texinfo): New variable. * config/avr/gen-avr-mmcu-texi.c: New file. * config/avr/t-avr: New rules and dependencies to build avr-mmcu.texi.