[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