summaryrefslogtreecommitdiff
path: root/PATCHES.txt
blob: 856b094771bd0b79d88e3a1461fd689fa067a020 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
// This file is part of the Doxygen Developer Manual
/** @page patchguide Patch Guidelines

Please mail patches to: @par
	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.

@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

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:
@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.

 */
/** @file
This file contains the @ref patchguide page.
*/