This is the mail archive of the
mailing list for the GCC project.
Ping #2: [Patch]: Include auto-generated avr-mmcu.texi in invoke.texi
- From: Georg-Johann Lay <avr at gjlay dot de>
- To: gcc-patches at gcc dot gnu dot org
- Date: Thu, 26 Apr 2012 17:25:55 +0200
- Subject: Ping #2: [Patch]: Include auto-generated avr-mmcu.texi in invoke.texi
- References: <4F8C65DC.firstname.lastname@example.org>
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.
The avr-specific part is already approved:
> 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".
> * 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.