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