Re: Code Comments

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi,

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.


Sven


_______________________________________________
Gimp-developer mailing list
Gimp-developer@xxxxxxxxxxxxxxxxxxxxxx
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-developer

[Index of Archives]     [Video For Linux]     [Photo]     [Yosemite News]     [gtk]     [GIMP for Windows]     [KDE]     [GEGL]     [Gimp's Home]     [Gimp on GUI]     [Gimp on Windows]     [Steve's Art]

  Powered by Linux