[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