Submitting patches.

[slembcke]

If you want to submit a patch to Chipmunk, it saves me a great deal of time and energy if you send me a subversion patch. Sending me a zip file of the modified source or a hand typed list of changes can be very frustrating to integrate. A lot of times when given a patch of this form I won't have the time to look at it right away and I end up forgetting entirely. Given a proper patch file, I can apply the patch in a second or two and then easily browse the changes made to see what you changed.

For the uninitiated in subversion, it's a version control system that allows you to keep a history of file modifications. It also makes it fairly painless to create branches and merge the changes into other branches. If you aren't using version control for your projects, you really should be.

On the command line:
Checkout a copy of the Chipmunk source.

Code: Select all

svn checkout http://chipmunk-physics.googlecode.com/svn/trunk/ chipmunk-physics-read-only

Syncronize your copy with the latest code from within subversion.

Code: Select all

svn update

Create a patch file that holds all of your local changes. Must be run from within the Chipmunk directory. This does not include non-text changes like libraries and such unfortunately. Those have to be sent separately.

Code: Select all

svn diff > patchfile

To make a patch against a specific release such as 5.2.x, I keep branches that have the latest code for that release. You can browse them here to find the path for the branch:
http://code.google.com/p/chipmunk-physi ... n/branches

Windows users desiring a GUI tool should check out Tortoisesvn:
http://tortoisesvn.tigris.org/
http://tortoisesvn.net/docs/release/Tor ... patch.html

[supertommy]

FYI: I had to remove the 's' from https in the svn checkout command line, or googlecode would insist on a username and password.

[slembcke]

Ah yes. Good catch. The http url is read-only, but does not require authentication.

[blachman]

Just to note. Chipmunk now lives in its own google code project so the subversion URL is now:

Code: Select all

svn checkout http://chipmunk-physics.googlecode.com/svn/trunk/ Chipmunk

[PeskyJ]

I submitted a patch to the issue tracker... how do you change the type from "defect" in that thing?

Anyhow, hope that's the right place, if not let me know and I can re-post here as an attachment or email or whatever.

J

[slembcke]

I did not realize that they added an issue tracker to google projects... (or maybe I just never noticed it existed at all). Shame it doesn't notify you by email or something when an issue is submitted.

I'll take a look at it.

[viblo]

Its been there for a very long time
If you go to the issues admin part you can set an email adr that will get a notification each time an issue is created/updated
(for pymunk this is located at http://code.google.com/p/pymunk/adminIssues )

[jeapostrophe]

I sent you a patch.