[RFA/C] Break out C options into a separate file

[Joseph S. Myers]

On Wed, 21 May 2003, Zack Weinberg wrote:

> I'm wondering how practical it would be to mark up invoke.texi and
> generate the options parser from that.  This would also need a way
> for extra languages to inject text into the manual, but we ought to
> have that anyway.

It would certainly help to avoid people adding options without
documentation (while requiring all the existing options without
documentation - hopefully just target-specific at present - to be fixed).  
Magic comments could be included in front end manuals as well as the main
manual (and config-lang.in point to the relevant files), so avoiding the
need for any dependence of the main manual on the languages available in
the source tree or configured.

-- 
Joseph S. Myers
jsm28@cam.ac.uk