From 5982d4eca8ad4d0aecb5515d39975e39b9d537d7 Mon Sep 17 00:00:00 2001 From: kc8apf Date: Thu, 21 May 2009 05:46:29 +0000 Subject: Author: David Brownell - Update PATCHES to better describe the policies in place git-svn-id: svn://svn.berlios.de/openocd/trunk@1872 b42882b7-edfa-0310-969c-e2dbd0fdcd60 --- PATCHES | 32 +++++++++++++++++++++----------- 1 file changed, 21 insertions(+), 11 deletions(-) (limited to 'PATCHES') 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 + -- cgit v1.2.3