2009-11-24 19:28:21 +00:00
|
|
|
// This file is part of the Doxygen Developer Manual
|
2009-06-03 02:17:26 +00:00
|
|
|
/** @page patchguide Patch Guidelines
|
2009-05-23 22:05:05 +00:00
|
|
|
|
2009-07-08 22:26:20 +00:00
|
|
|
Please mail patches to: @par
|
2011-10-12 08:32:59 +00:00
|
|
|
openocd-devel@lists.sourceforge.net
|
2009-04-28 06:29:32 +00:00
|
|
|
|
2009-05-18 17:20:51 +00:00
|
|
|
Note that you can't send patches to that list unless
|
|
|
|
you're a member, despite what the list info page says.
|
|
|
|
|
2009-06-03 02:17:26 +00:00
|
|
|
@section Patch Guidelines in a Nutshell
|
|
|
|
|
2009-10-08 00:13:50 +00:00
|
|
|
Your patches should be against git mainline. Submit output
|
|
|
|
of "git diff"; equivalently, quilt patches are OK.
|
2009-05-21 05:46:29 +00:00
|
|
|
|
|
|
|
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
|
2009-04-28 06:29:32 +00:00
|
|
|
|
|
|
|
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
|
|
|
|
|
2009-05-21 05:46:29 +00:00
|
|
|
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.
|
2009-05-18 17:20:51 +00:00
|
|
|
|
2009-04-28 06:29:32 +00:00
|
|
|
Add yourself to the GPL copyright for non-trivial changes.
|
|
|
|
|
|
|
|
To create a patch from the command line:
|
2009-12-29 23:48:49 +00:00
|
|
|
@code
|
2009-10-08 00:13:50 +00:00
|
|
|
git diff >mypatch.txt
|
2009-06-03 02:17:26 +00:00
|
|
|
@endcode
|
2009-04-28 06:29:32 +00:00
|
|
|
|
2009-06-03 02:17:26 +00:00
|
|
|
@section More Information on Patching
|
|
|
|
|
|
|
|
The @ref primerpatches provides a more complete guide to creating,
|
|
|
|
managing, and contributing patches to the OpenOCD project.
|
|
|
|
|
2009-05-23 22:05:05 +00:00
|
|
|
*/
|
2009-05-26 23:58:01 +00:00
|
|
|
/** @file
|
|
|
|
This file contains the @ref patchguide page.
|
|
|
|
*/
|