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