OLD | NEW |
1 | 1 |
2 Contributing to GDB | 2 Contributing to GDB |
3 | 3 |
4 GDB is a collaborative project and one which wants to encourage new | 4 GDB is a collaborative project and one which wants to encourage new |
5 development. You may wish to fix GDB bugs, improve testing, port GDB | 5 development. You may wish to fix GDB bugs, improve testing, port GDB |
6 to a new platform, update documentation, add new GDB features, and the | 6 to a new platform, update documentation, add new GDB features, and the |
7 like. To help with this, there is a lot of documentation | 7 like. To help with this, there is a lot of documentation |
8 available.. In addition to the user guide and internals manual | 8 available.. In addition to the user guide and internals manual |
9 included in the GDB distribution, the GDB web pages also contain much | 9 included in the GDB distribution, the GDB web pages also contain much |
10 information. | 10 information. |
(...skipping 52 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
63 A description of the bug and how your patch fixes this | 63 A description of the bug and how your patch fixes this |
64 bug. A reference to a testsuite failure is very helpful. For | 64 bug. A reference to a testsuite failure is very helpful. For |
65 new features a description of the feature and your | 65 new features a description of the feature and your |
66 implementation. | 66 implementation. |
67 | 67 |
68 A ChangeLog entry as plaintext (separate from the patch); see | 68 A ChangeLog entry as plaintext (separate from the patch); see |
69 the various ChangeLog files for format and content. Note that, | 69 the various ChangeLog files for format and content. Note that, |
70 unlike some other projects, we do require ChangeLogs also for | 70 unlike some other projects, we do require ChangeLogs also for |
71 documentation (i.e., .texi files). | 71 documentation (i.e., .texi files). |
72 | 72 |
73 » The patch itself. If you are accessing the CVS repository use | 73 » The patch itself. If you are accessing the git repository, use |
74 » "cvs update; cvs diff -up"; else, use "diff -up OLD NEW". If | 74 » "git diff", remembering first to update to the current master; |
75 » your version of diff does not support these options, then get | 75 » else, use "diff -up OLD NEW". If your version of diff does not |
76 » the latest version of GNU diff. | 76 » support these options, then get the latest version of GNU diff. |
77 | 77 |
78 We accept patches as plain text (preferred for the compilers | 78 We accept patches as plain text (preferred for the compilers |
79 themselves), MIME attachments (preferred for the web pages), | 79 themselves), MIME attachments (preferred for the web pages), |
80 or as uuencoded gzipped text. | 80 or as uuencoded gzipped text. |
81 | 81 |
82 When you have all these pieces, bundle them up in a mail | 82 When you have all these pieces, bundle them up in a mail |
83 message and send it to gdb-patches@sourceware.org. All | 83 message and send it to gdb-patches@sourceware.org. All |
84 patches and related discussion should be sent to the | 84 patches and related discussion should be sent to the |
85 gdb-patches mailinglist. For further information on the GDB | 85 gdb-patches mailinglist. For further information on the GDB |
86 » CVS repository, see the Anonymous read-only CVS access and | 86 » git repository, see the Anonymous read-only git access and |
87 » Read-write CVS access page. | 87 » Read-write git access page. |
88 | 88 |
89 -- | 89 -- |
90 | 90 |
91 Supplemental information for GDB: | 91 Supplemental information for GDB: |
92 | 92 |
93 o Please try to run the relevant testsuite before and after | 93 o Please try to run the relevant testsuite before and after |
94 committing a patch | 94 committing a patch |
95 | 95 |
96 If the contributor doesn't do it then the maintainer will. A | 96 If the contributor doesn't do it then the maintainer will. A |
97 contributor might include before/after test results in their | 97 contributor might include before/after test results in their |
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
133 | 133 |
134 o When submitting a patch that fixes a bug | 134 o When submitting a patch that fixes a bug |
135 in GDB's bug database a brief reference | 135 in GDB's bug database a brief reference |
136 to the bug can be included in the ChangeLog | 136 to the bug can be included in the ChangeLog |
137 vis | 137 vis |
138 | 138 |
139 * CONTRIBUTE: Mention PR convention. | 139 * CONTRIBUTE: Mention PR convention. |
140 Fix PR gdb/4705. | 140 Fix PR gdb/4705. |
141 | 141 |
142 The text ``PR gdb/4705'' should also be included | 142 The text ``PR gdb/4705'' should also be included |
143 » in the CVS commit message. That causes the | 143 » in the git commit message. That causes the |
144 patch to automatically be archived with the PR. | 144 patch to automatically be archived with the PR. |
OLD | NEW |