| 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 |