On Mon, 2009-08-17 at 11:41 -0800, Christopher Howard wrote:
> So, two main questions here: first, what is the working philosophy
> around here about code comments? Are we preferring more of a "well
> written code should explain itself" approach?
Exactly. But comments are of course welcome.
> Are we inclined to accept
> patch submissions that simply add comments to code? Are there guidelines
> for what code comments should be like?
Of course patches that add comments are appreciated and we have accepted
such patches in the past. Comments should be in gtk-doc syntax, so that
they end up in the API reference manual.
> Second, if new developers can't figure out what a piece of code does, or
> where some functionality is, should we ask on this list? (That's
> actually not a hypothetical question in my case...)
Sure. This is the right place to ask.
Gimp-developer mailing list