Submitting Patches

Hopefully with my switch to Mercurial, it's become a bit easier to submit patches. After all, if you run Python, you can install Mercurial. (And if you aren't running Python, then why are you submitting patches to flup...?!?!) I'm not going to describe how to install or use Mercurial though, see the Mercurial site for that.

Anyway, if you have a new bug fix or feature, this is how you can submit patches. In order of preference:

  1. Publish a Mercurial repository of your changes somewhere. This is by far the easiest for me, but it requires that you have your own web space somewhere or have a Mercurial repository host.
  2. Perform an "hg outgoing" against my flup repository and then export your new revision(s) via "hg export". I would almost prefer each revision to be its own file since "hg import" doesn't like having multiple revisions in one file (I hope that gets fixed soon!), but I understand if its more convenient to send a single file.
  3. A standard diff -- mainly for people without Mercurial. This tried-and-true method also works of course, but I would prefer the methods outlined above since they preserve authorship info and commit details.

That's how you get your changes to me. Notifying me that you have changes can be done by either:

I have no real preference. The only difference is that opening a ticket is obviously more public.