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.


Reply via email to