]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
docs: add patching process to howto-contribute.txt
authorSami Kerola <kerolasa@iki.fi>
Sun, 10 Nov 2013 20:06:09 +0000 (20:06 +0000)
committerKarel Zak <kzak@redhat.com>
Tue, 12 Nov 2013 10:47:56 +0000 (11:47 +0100)
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
Documentation/howto-contribute.txt

index f0b64ef165668134046c7af6dc549904cc4d1956..5f4531eb32e155ce121f3a039ec8b76c9e954e0d 100644 (file)
@@ -88,6 +88,29 @@ Coding style
          something is not quite right, and you are unwilling to fix the
          issue.
 
+Patching process
+
+       * Tell in mail list when you are going to work with some particular
+         piece of code for long time.  This helps other to avoid massive
+         merge conflicts.  Small or quick work does not need to be
+         announced.
+
+       * Submit only changes that you think are ready to merge.  If you only
+         want change review tell your intention clearly in change cover
+         letter, and/or in each patch subject to review-only.
+
+       * When getting comments align the changes with them.  Resubmission
+         without changes is as good as ignoring advice, and is neither
+         recommended nor polite.
+
+       * Resubmission can be partial or complete.  If only few alterations
+         are needed here and there resubmit particular patches.  When
+         comments cause greater effect resubmit everything again.
+
+       * All patch submissions, big or small, are either commented, reject,
+         or merge.  When maintainer rejects a patch (series) it is pointless
+         to resubmit.
+
 Various notes
 
        * The util-linux does not use kernel headers for file system super