summaryrefslogtreecommitdiff
path: root/PATCHES
diff options
context:
space:
mode:
authorkc8apf <kc8apf@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2009-05-21 05:46:29 +0000
committerkc8apf <kc8apf@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2009-05-21 05:46:29 +0000
commit5982d4eca8ad4d0aecb5515d39975e39b9d537d7 (patch)
tree98a54576bef8cc7674772907552f868a2d4a7e4f /PATCHES
parent988d6a49a94fda0057e8670f4990cb494c347ae8 (diff)
downloadopenocd+libswd-5982d4eca8ad4d0aecb5515d39975e39b9d537d7.tar.gz
openocd+libswd-5982d4eca8ad4d0aecb5515d39975e39b9d537d7.tar.bz2
openocd+libswd-5982d4eca8ad4d0aecb5515d39975e39b9d537d7.tar.xz
openocd+libswd-5982d4eca8ad4d0aecb5515d39975e39b9d537d7.zip
Author: David Brownell <david-b@pacbell.net>
- Update PATCHES to better describe the policies in place git-svn-id: svn://svn.berlios.de/openocd/trunk@1872 b42882b7-edfa-0310-969c-e2dbd0fdcd60
Diffstat (limited to 'PATCHES')
-rw-r--r--PATCHES32
1 files changed, 21 insertions, 11 deletions
diff --git a/PATCHES b/PATCHES
index 7fc2b992..ea02a1d9 100644
--- a/PATCHES
+++ b/PATCHES
@@ -1,35 +1,45 @@
Please mail patches to:
-openocd-development@lists.berlios.de
+ openocd-development@lists.berlios.de
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.
+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
-
-http://svnbook.red-bean.com/en/1.0/re09.html
+ svn diff >mypatch.txt
-NB! remember to use "svn add" on new files first!
+See:
-http://svnbook.red-bean.com/en/1.0/re01.html
+ http://svnbook.red-bean.com/en/1.0/re09.html
+NB! remember to use "svn add" on new files first!
+ http://svnbook.red-bean.com/en/1.0/re01.html
If you have a decent SVN GUI, then that should be
able to create and apply patches as well...
- \ No newline at end of file
+