This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: new port: m32c
- From: Falk Hueffner <falk at debian dot org>
- To: DJ Delorie <dj at redhat dot com>
- Cc: richard at codesourcery dot com, gcc-patches at gcc dot gnu dot org
- Date: Fri, 01 Jul 2005 21:57:41 +0200
- Subject: Re: new port: m32c
- References: <200506092018.j59KIbEN018917@greed.delorie.com><Pine.LNX.4.61.0506092049420.1367@digraph.polyomino.org.uk><200506142342.j5ENgE27009773@greed.delorie.com><200506212120.j5LLK6Sh006352@greed.delorie.com><200506292052.j5TKqlFM017519@greed.delorie.com><87ekaih5gf.fsf@talisman.home><200507011821.j61IL8NW015026@greed.delorie.com>
DJ Delorie <dj@redhat.com> writes:
> Yeah, I'm not a big fan of comments for their own sake. I use them
> when the code isn't self-explanatory
Function comments aren't explaining what the code does; they explain
what it is supposed to do. That's a difference, because it might be
less specific with less guarantees. So even functions with
self-explanatory code need comments IMHO. Otherwise, when changing the
function, you don't know what subtle details callers might depend on.
--
Falk