diff options
Diffstat (limited to 'tools/patman')
| -rw-r--r-- | tools/patman/README | 68 |
1 files changed, 34 insertions, 34 deletions
diff --git a/tools/patman/README b/tools/patman/README index ee38afc..587c97f 100644 --- a/tools/patman/README +++ b/tools/patman/README @@ -10,7 +10,7 @@ # # This program is distributed in the hope that it will be useful, # 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. # # 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. 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, ... - 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 - Sets the version number of this patch series + Sets the version number of this patch series 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: This is the patch set title blah blah more blah blah 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: blah blah blah blah more blah blah 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> - 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> 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 - Guinea pig moved into its cage - Other changes ending with a 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> - 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 Gerrit tags: @@ -205,7 +205,7 @@ subject are also picked up to Cc patches. For example, a commit like this: >>>> commit 10212537b85ff9b6e09c82045127522c0f0db981 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 @@ -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, 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 and use git rebase -i to edit the commits, dropping the wip one. You add |