gawkworkflow: Submitting Changes
1
1 4.6 Submitting Your Changes
1 ===========================
1
1 So now your feature is complete. You've added test cases for it to the
1 test suite(1), you have 'ChangeLog' entries that describe all the
1 changes(2), you have documented the new feature(3), and everything works
1 great. You're ready to submit the changes for review, and with any
1 luck, inclusion into 'gawk'.
1
1 There are two ways to submit your changes for review.
1
1 _Generate a single large patch_
1 To do this, simply compare your branch to the branch off which it
1 is based:
1
1 $ git checkout feature/python
1 $ git diff master > /tmp/python.diff
1
1 Mail the 'python.diff' file to the appropriate mailing list along
1 with a description of what you've changed and why.
1
1 _Generate a set of patches that in toto comprise your changes_
1 To do this, use 'git format-patch':
1
1 $ git checkout feature/python
1 $ git format-patch
1
1 This creates a set of patch files, one per commit that isn't on the
1 original branch. Mail these patches, either separately, or as a
1 set of attachments, to the appropriate mailing list along with a
1 description of what you've changed and why.
1
1 Either way you choose to submit your changes, the 'gawk' maintainer
1 and development team will review your changes and provide feedback. If
1 you have signed paperwork with the FSF for 'gawk' and the maintainer
1 approves your changes, he will apply the patch(es) and commit the
1 changes.
1
1 Which list should you send mail to? If you are just starting to
1 contribute, use <bug-gawk@gnu.org>. After making enough contributions,
1 you may be invited to join the private 'gawk' developers' mailing list.
1 If you do so, then submit your changes to that list.
1
1 If you make any substantial changes, you will need to assign
1 copyright in those changes to the Free Software Foundation before the
1 maintainer can commit those changes. ⇒Doing paperwork, for more
1 information.
1
1 ---------- Footnotes ----------
1
1 (1) You did do this, didn't you?
1
1 (2) You remembered this, right?
1
1 (3) You wouldn't neglect this, would you?
1