ARM: "armv4_5" command prefix becomes "arm"

[openocd.git] / PATCHES

diff --git a/PATCHES b/PATCHES
index 5606e241ebf969a2798ad61c64d917548b0008ed..32f1bda5f070f0bee4b6a55f4b0d8a95b596a147 100644 (file)
--- a/PATCHES
+++ b/PATCHES
@@ -1,28 +1,47 @@
-Please mail patches to:
+// This file is part of the Doyxgen Developer Manual
+/** @page patchguide Patch Guidelines

 
 

-openocd-development@lists.berlios.de
+Please mail patches to: @par
+       openocd-development@lists.berlios.de

 
 

-The patch should be against svn trunk using an SVN
-diff. 
+Note that you can't send patches to that list unless
+you're a member, despite what the list info page says.
+
+@section Patch Guidelines in a Nutshell
+
+Your patches should be against git mainline.  Submit output
+of "git diff"; equivalently, quilt patches are OK.
+
+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
 
 
 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
 

+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:
 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
-
-NB! remember to use "svn add" on new files first!
-
-http://svnbook.red-bean.com/en/1.0/re01.html
+@code 
+       git diff >mypatch.txt
+@endcode

 
 

+@section More Information on Patching

 
 

+The @ref primerpatches provides a more complete guide to creating,
+managing, and contributing patches to the OpenOCD project.

 
 

-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
+ */
+/** @file
+This file contains the @ref patchguide page.
+*/