|
@@ -10,7 +10,7 @@
|
|
#
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
|
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
# GNU General Public License for more details.
|
|
#
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# You should have received a copy of the GNU General Public License
|
|
@@ -116,68 +116,68 @@ To make this script useful you must add tags like the following into any
|
|
commit. Most can only appear once in the whole series.
|
|
commit. Most can only appear once in the whole series.
|
|
|
|
|
|
Series-to: email / alias
|
|
Series-to: email / alias
|
|
- Email address / alias to send patch series to (you can add this
|
|
|
|
- multiple times)
|
|
|
|
|
|
+ Email address / alias to send patch series to (you can add this
|
|
|
|
+ multiple times)
|
|
|
|
|
|
Series-cc: email / alias, ...
|
|
Series-cc: email / alias, ...
|
|
- Email address / alias to Cc patch series to (you can add this
|
|
|
|
- multiple times)
|
|
|
|
|
|
+ Email address / alias to Cc patch series to (you can add this
|
|
|
|
+ multiple times)
|
|
|
|
|
|
Series-version: n
|
|
Series-version: n
|
|
- Sets the version number of this patch series
|
|
|
|
|
|
+ Sets the version number of this patch series
|
|
|
|
|
|
Series-prefix: prefix
|
|
Series-prefix: prefix
|
|
- Sets the subject prefix. Normally empty but it can be RFC for
|
|
|
|
- RFC patches, or RESEND if you are being ignored.
|
|
|
|
|
|
+ Sets the subject prefix. Normally empty but it can be RFC for
|
|
|
|
+ RFC patches, or RESEND if you are being ignored.
|
|
|
|
|
|
Cover-letter:
|
|
Cover-letter:
|
|
This is the patch set title
|
|
This is the patch set title
|
|
blah blah
|
|
blah blah
|
|
more blah blah
|
|
more blah blah
|
|
END
|
|
END
|
|
- Sets the cover letter contents for the series. The first line
|
|
|
|
- will become the subject of the cover letter
|
|
|
|
|
|
+ Sets the cover letter contents for the series. The first line
|
|
|
|
+ will become the subject of the cover letter
|
|
|
|
|
|
Series-notes:
|
|
Series-notes:
|
|
blah blah
|
|
blah blah
|
|
blah blah
|
|
blah blah
|
|
more blah blah
|
|
more blah blah
|
|
END
|
|
END
|
|
- Sets some notes for the patch series, which you don't want in
|
|
|
|
- the commit messages, but do want to send, The notes are joined
|
|
|
|
- together and put after the cover letter. Can appear multiple
|
|
|
|
- times.
|
|
|
|
|
|
+ Sets some notes for the patch series, which you don't want in
|
|
|
|
+ the commit messages, but do want to send, The notes are joined
|
|
|
|
+ together and put after the cover letter. Can appear multiple
|
|
|
|
+ times.
|
|
|
|
|
|
Signed-off-by: Their Name <email>
|
|
Signed-off-by: Their Name <email>
|
|
- A sign-off is added automatically to your patches (this is
|
|
|
|
- probably a bug). If you put this tag in your patches, it will
|
|
|
|
- override the default signoff that patman automatically adds.
|
|
|
|
|
|
+ A sign-off is added automatically to your patches (this is
|
|
|
|
+ probably a bug). If you put this tag in your patches, it will
|
|
|
|
+ override the default signoff that patman automatically adds.
|
|
|
|
|
|
Tested-by: Their Name <email>
|
|
Tested-by: Their Name <email>
|
|
Acked-by: Their Name <email>
|
|
Acked-by: Their Name <email>
|
|
- These indicate that someone has acked or tested your patch.
|
|
|
|
- When you get this reply on the mailing list, you can add this
|
|
|
|
- tag to the relevant commit and the script will include it when
|
|
|
|
- you send out the next version. If 'Tested-by:' is set to
|
|
|
|
- yourself, it will be removed. No one will believe you.
|
|
|
|
|
|
+ These indicate that someone has acked or tested your patch.
|
|
|
|
+ When you get this reply on the mailing list, you can add this
|
|
|
|
+ tag to the relevant commit and the script will include it when
|
|
|
|
+ you send out the next version. If 'Tested-by:' is set to
|
|
|
|
+ yourself, it will be removed. No one will believe you.
|
|
|
|
|
|
Series-changes: n
|
|
Series-changes: n
|
|
- Guinea pig moved into its cage
|
|
- Guinea pig moved into its cage
|
|
- Other changes ending with a blank line
|
|
- Other changes ending with a blank line
|
|
<blank line>
|
|
<blank line>
|
|
- This can appear in any commit. It lists the changes for a
|
|
|
|
- particular version n of that commit. The change list is
|
|
|
|
- created based on this information. Each commit gets its own
|
|
|
|
- change list and also the whole thing is repeated in the cover
|
|
|
|
- letter (where duplicate change lines are merged).
|
|
|
|
|
|
+ This can appear in any commit. It lists the changes for a
|
|
|
|
+ particular version n of that commit. The change list is
|
|
|
|
+ created based on this information. Each commit gets its own
|
|
|
|
+ change list and also the whole thing is repeated in the cover
|
|
|
|
+ letter (where duplicate change lines are merged).
|
|
|
|
|
|
- By adding your change lists into your commits it is easier to
|
|
|
|
- keep track of what happened. When you amend a commit, remember
|
|
|
|
- to update the log there and then, knowing that the script will
|
|
|
|
- do the rest.
|
|
|
|
|
|
+ By adding your change lists into your commits it is easier to
|
|
|
|
+ keep track of what happened. When you amend a commit, remember
|
|
|
|
+ to update the log there and then, knowing that the script will
|
|
|
|
+ do the rest.
|
|
|
|
|
|
Cc: Their Name <email>
|
|
Cc: Their Name <email>
|
|
- This copies a single patch to another email address.
|
|
|
|
|
|
+ This copies a single patch to another email address.
|
|
|
|
|
|
Various other tags are silently removed, like these Chrome OS and
|
|
Various other tags are silently removed, like these Chrome OS and
|
|
Gerrit tags:
|
|
Gerrit tags:
|
|
@@ -205,7 +205,7 @@ subject are also picked up to Cc patches. For example, a commit like this:
|
|
>>>>
|
|
>>>>
|
|
commit 10212537b85ff9b6e09c82045127522c0f0db981
|
|
commit 10212537b85ff9b6e09c82045127522c0f0db981
|
|
Author: Mike Frysinger <vapier@gentoo.org>
|
|
Author: Mike Frysinger <vapier@gentoo.org>
|
|
-Date: Mon Nov 7 23:18:44 2011 -0500
|
|
|
|
|
|
+Date: Mon Nov 7 23:18:44 2011 -0500
|
|
|
|
|
|
x86: arm: add a git mailrc file for maintainers
|
|
x86: arm: add a git mailrc file for maintainers
|
|
|
|
|
|
@@ -304,7 +304,7 @@ Let's say one person sent comments and you get an Acked-by: on one patch.
|
|
Also, the patch on the list that you were waiting for has been merged,
|
|
Also, the patch on the list that you were waiting for has been merged,
|
|
so you can drop your wip commit. So you resync with upstream:
|
|
so you can drop your wip commit. So you resync with upstream:
|
|
|
|
|
|
- git fetch origin (or whatever upstream is called)
|
|
|
|
|
|
+ git fetch origin (or whatever upstream is called)
|
|
git rebase origin/master
|
|
git rebase origin/master
|
|
|
|
|
|
and use git rebase -i to edit the commits, dropping the wip one. You add
|
|
and use git rebase -i to edit the commits, dropping the wip one. You add
|