This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: "Documentation by paper"
- From: kenner at vlsi1 dot ultra dot nyu dot edu (Richard Kenner)
- To: dnovillo at redhat dot com
- Cc: gcc at gcc dot gnu dot org
- Date: Tue, 27 Jan 04 13:09:20 EST
- Subject: Re: "Documentation by paper"
Which reminds me. What happened to the proposal that was discussed in
the last GCC summit to start adding doxygen markers to the source code
comments?
I'd be very strongly *against* such a proposal. I don't see anything but
the slightest advantage of such "external" documentation, certainly not
worth cluttering up code with "markers".
If there is a value to having such external documentation, let's teach it
how to read GCC's documentation style, which already has enough information.