[cairo] how to propose a change?
Carl Worth
cworth at cworth.org
Fri Aug 24 13:25:27 PDT 2007
On Fri, 24 Aug 2007 15:10:36 -0500, ionous wrote:
> hi . - i'm new to cairo but i've been looking through the source,
> learning how it works, and have found a couple areas where i would like
> to contribute if i can.
Welcome! We're always glad to accept a new memeber into the community,
and any contribution you make will be greatly appreciated.
> the first thing i wanted to play around with is a relatively minor, but
> hopefully useful, memory optimization to path storage. i've written up
> a pretty complete description of the change ( it's a tad long ^_^ ) but
> should i post it here? should i just go ahead and make the changes then
> post a patch? what would be best?
If you've already got something written up, please feel free to post
it here. Patches are welcome here as well, but are certainly not a
prerequisite to discussion.
> i also would be interested, as i learn my way around, in doing some (
> no big commitments here ) code side documentation-- are there any
> guidelines i should follow on that front?
Not much. We prefer C89-compatible comment delimiters, /* like this */
over the C99 things // like this
but there's not much else in the way of internal documentation
guidelines.
The public API is documented with (fairly minimal) gtkdoc-style
markup. Some of the internal documentation is as well, (in the
off chance that we'll ever generate formatted output from it). But I
think that generating formatted internal comments, (and hence
separating it from the code), would be quite useless. So I greatly
prefer to have markup-free comments in the code that are formatted to
be read as-is along with the code itself.
> ( and thanks for cairo -- its very cool and very useful. )
You're quite welcome. I'm glad you're enjoying it, and I hope you'll
continue to have fun with it.
-Carl
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.cairographics.org/archives/cairo/attachments/20070824/1b7327bf/attachment.pgp
More information about the cairo
mailing list