Browse Source

Author: David Brownell <>

- Update PATCHES to better describe the policies in place

git-svn-id: svn:// b42882b7-edfa-0310-969c-e2dbd0fdcd60
kc8apf 13 years ago
1 changed files with 21 additions and 11 deletions
  1. +21

+ 21
- 11

@@ -1,35 +1,45 @@
Please mail patches to:

Note that you can't send patches to that list unless
you're a member, despite what the list info page says.

The patch should be against svn trunk using an SVN
diff. If you use git-svn, a git diff or patch is OK
too; likewise a quilt patch, if you use quilt.

It should be a "good patch": focus it on a single
issue, and make it be easily reviewable. Don't make
it so large that it's hard to review; split large
patches into smaller ones. (That can also help
track down bugs later on.) All patches should
be "clean", which includes preserving the existing
coding style and updating documentation as needed.j

Attach the patch to the email as a .txt file and
also write a short change log entry that maintainers
can copy and paste into the commit message

(However, don't expect the maintainers to actually
include such entries in their commit messages if
they're longer than a single $SUBJECT line.)
Say if it's a bugfix (describe the bug) or a new
feature. Don't expect patches to merge immediately
for the next release. Be ready to rework patches
in response to feedback.

Add yourself to the GPL copyright for non-trivial changes.

To create a patch from the command line:
svn diff >mypatch.txt
svn diff >mypatch.txt

NB! remember to use "svn add" on new files first!

NB! remember to use "svn add" on new files first!

If you have a decent SVN GUI, then that should be
able to create and apply patches as well...