This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: Warning Messages (was: Is this a gcc bug?)
- To: fjh at cs dot mu dot oz dot au
- Subject: Re: Warning Messages (was: Is this a gcc bug?)
- From: Laurent Guerby <guerby at acm dot org>
- Date: Sat, 13 Jan 2001 20:14:00 +0100
- CC: dewar at gnat dot com, Anshil at gmx dot net, aoliva at redhat dot com, gcc at gcc dot gnu dot org
- References: <20010113031522.B284B34D81@nile.gnat.com> <20010113142913.A30791@hg.cs.mu.oz.au>
- Reply-to: guerby at acm dot org
An alternative solution for warnings where the only valid hint is one
paragraph long (or more ;-), is to put a really short one, even if
mysterious, plus "see GCC documentation for more information" or "GCC
documentation has more information", and have sections "Common
Warnings for Language X" in the compiler manual detailing the
issues. Such a solution would solve cleanly the education issue, and
the "meta-education" issue: there's a manual dude! ;-).
I often found that people ask themselves questions the first time they
see a warning, then the messages is just an id and it's better when
it's short in listings.
--
Laurent Guerby <guerby@acm.org>