Feature idea for gcc

[Robert Dewar]

> Martin,
> Now there is a strong idea for accomplishing your goal...
> Base your external processor on one of the many "literate programming" 
> processors - only extract the *.h rather than the entire source *.c
> Perhaps even use a "java-doc" like structure if you prefer.

That's also a technically stronger approach. Automatically extracing
.h files from random .c files is a bad idea, it encourages poor practice.
But extracting .h files from specially prepared .c files a la Java is
much more presentable (personally I think the Java approach is a mistake
compared to separately prepared and maintained specifications, but I
realize there are legitimate arguments on the other side).