summaryrefslogtreecommitdiffstats
path: root/developer-doc/phb/submissions.docbook
blob: 8a69e0c8818ef3aebfb31892439949d91c95a44b (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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
<chapter id="submissions">
<chapterinfo>
<authorgroup>
<author>
        <firstname>Alvaro</firstname>
        <surname>Soliverez</surname>
        <affiliation>
                <address><email>asoliverez@gmail.com</email></address>
        </affiliation>
</author>
</authorgroup>
</chapterinfo>
<title>Patch Submissions</title>
<para>
This section describes how to send patches and additions when you don't have direct CVS access. In that case, you should send the contributions to the developer mailing list. That way, more people can test your contribution than if you send it to a specific developer. It could also happen that this developer has a lot of pending stuff, and your contribution gets delayed.
</para>

<para>
For the specifics on how to code, translate or write documentation, refer to the proper sections. Once you are done with the actual work, you have to create the patch file to send.
</para>

<sect1 id="patch">
<title>Steps to create a patch</title>

<sect2 id="prerequisites">
<title>Prerequisites</title>
<para>
Have an updated cvs version of the release you are contributing to (HEAD, stable release, etc)
</para>
<itemizedlist>
<listitem>
<para>
Make sure to run 'cvs upd' before you create the patch
</para>
</listitem>
<listitem>
<para>
If the update changes your sandbox, make sure that the changes still work
</para>
</listitem>
</itemizedlist>
</sect2>

<sect2 id="existingfiles">
<title>If you modified existing Files</title>

<itemizedlist>
<listitem>
<para>
Run 'cvs diff -u'  in the root directory. That should the create the patch to be applied to existing files
</para>
</listitem>
<listitem>
<para>
Inspect the patch that it does only contain your wanted changes
</para>
</listitem>
</itemizedlist>
</sect2>

<sect2 id="newfiles">
<title>If you have added new Files</title>

<itemizedlist>
<listitem>
<para>
Make sure you write down on the email the location of each new file (The developer handling the patch will probably know how to find the correct location, but this will save her/him some precious time)
</para>
</listitem>
</itemizedlist>
</sect2>

<sect2 id="finalsteps">
<title>Final Steps</title>

<itemizedlist>
<listitem>
<para>
Compress the patch and any new files into a single .tar.gz file
</para>
</listitem>
<listitem>
<para>
Send to the developer mailing list, explaining the nature of the submission
</para>
</listitem>
<listitem>
<para>
The developer handling the patch should acknowledge that to the list as well, to avoid duplicate work
</para>
</listitem>
</itemizedlist>
</sect2>

<para>
Keep in mind that there are times when all developers have plenty of work, or a patch should be best handled by a specific developer that may not be readily available, so be patient. Also, if you don't receive an acknowledgement after a few days, write to the list asking for the status of your patch. Subscribing to the developer mailing list would be a good idea if you are sending contributions.
</para>
</sect1>
</chapter>