[Patch]: Little Cleanup

Joel Brobecker brobecker@adacore.com
Tue Mar 6 19:53:00 GMT 2007


> > The place to document the meaning of a function's return value is at
> > the function, not at each of its call sites.
> 
> So you are saying that it's normal to expect the code reader to
> constantly jump to the function's definition trying to understand what
> its callers try to accomplish?

Then perhaps this suggests that the function could be renamed into
something clearer? But otherwise, yes, I agree with Jim and Mark,
because maintaining these comments everywhere is going to be an issue.

-- 
Joel



More information about the Gdb-patches mailing list