X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=PATCHES;h=361a1591343ee2b3aedaf3a6dc3c06f212f45a5b;hp=7fc2b992200dd03b150f70b0cafcadb3cee9aec1;hb=b3a8f5dc2a32f62ec7f2199461c62df9becaf7f6;hpb=4528fa49f5b9937c4bdb47347a8a4c8d5912fd14

diff --git a/PATCHES b/PATCHES
index 7fc2b99220..361a159134 100644
--- a/PATCHES
+++ b/PATCHES
@@ -1,35 +1,48 @@
+/** @page patchguide OpenOCD Patch Policies
+
 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
+ 
+ */