Proc-errata » History » Version 2
David Demelier, 02/13/2017 01:08 PM
1 | 1 | David Demelier | h1. Proc-errata |
---|---|---|---|
2 | |||
3 | An errata has to be written when a bug is found in a release. |
||
4 | |||
5 | h2. Create a task |
||
6 | |||
7 | Create a task with *Bug* as tracker, mark it as *Urgent* and specify the current release branch in the custom field. |
||
8 | |||
9 | h2. Write the fix |
||
10 | |||
11 | Update to the current release branch: |
||
12 | |||
13 | <pre> |
||
14 | $ hg up release-x.y |
||
15 | </pre> |
||
16 | |||
17 | Write a unique revision and use the following commit template. |
||
18 | |||
19 | 2 | David Demelier | <pre> |
20 | Fix #TASK_NUMBER: short description |
||
21 | 1 | David Demelier | |
22 | 2 | David Demelier | Explanation |
23 | |||
24 | Task: #TASK_NUMBER |
||
25 | Errata: YYYYMMDD |
||
26 | </pre> |
||
27 | |||
28 | h2. Export patch |
||
29 | |||
30 | Export the patch and sign it. |
||
31 | |||
32 | 1 | David Demelier | <pre> |
33 | 2 | David Demelier | hg export > YYYYMMDD.patch |
34 | gpg --sign --armor YYYYMMDD.patch |
||
35 | </pre> |
||
36 | |||
37 | Upload it in http://releases.malikania.fr/irccd/errata. |
||
38 | |||
39 | h2. New release |
||
40 | |||
41 | Then, do a usual release as described in [[proc-new-release|New release]]. |
||
42 | |||
43 | h2. Wiki page |
||
44 | |||
45 | Create a new wiki page with the following template. |
||
46 | |||
47 | h3. Template |
||
48 | |||
49 | {{collapse(Voir les détails...) |
||
50 | <pre> |
||
51 | 1 | David Demelier | h1. Errata YYYYMMDD |
52 | |||
53 | *Topic*: |
||
54 | *Category*: As specified in tasks |
||
55 | *Corrected*: [[Version-x-y-z|x.y.z]] (or revision r???) |
||
56 | *Affected versions*: [[Version-x-y-z|x.y.z]] |
||
57 | *Task*: #??? |
||
58 | |||
59 | h1. Background |
||
60 | |||
61 | Short explanation about the feature/context. |
||
62 | |||
63 | h1. Problem |
||
64 | |||
65 | Short description about the problem. |
||
66 | |||
67 | h1. Solution |
||
68 | |||
69 | Upgrade to a newer version if applicable or apply one of the following fixes: |
||
70 | |||
71 | h2. Using Mercurial |
||
72 | |||
73 | If you don't have a local copy: |
||
74 | |||
75 | <pre> |
||
76 | hg clone -u release-x.y http://hg.malikania.fr/irccd |
||
77 | </pre> |
||
78 | |||
79 | If you already have a local copy: |
||
80 | |||
81 | <pre> |
||
82 | cd /path/to/irccd |
||
83 | hg pull |
||
84 | hg up release-x.y |
||
85 | </pre> |
||
86 | |||
87 | And install new version of irccd. |
||
88 | |||
89 | h2. Using patch |
||
90 | |||
91 | Download the following patch: |
||
92 | |||
93 | * http://releases.malikania.fr/irccd/errata/YYYYMMDD.patch |
||
94 | * http://releases.malikania.fr/irccd/errata/YYYYMMDD.patch.asc |
||
95 | |||
96 | Apply it: |
||
97 | |||
98 | <pre> |
||
99 | cd /path/to/irccd/ |
||
100 | patch -p1 < /path/to/YYYYMMDD.patch |
||
101 | </pre> |
||
102 | </pre> |
||
103 | 2 | David Demelier | }} |