Lines Matching +full:application +full:- +full:notes
3 # SPDX-License-Identifier: GPL-2.0+
10 - Creates patch directly from your branch
11 - Cleans them up by removing unwanted tags
12 - Inserts a cover letter with change lists
13 - Runs the patches through checkpatch.pl and its own checks
14 - Optionally emails them out to selected people
17 error-prone process. It is useful for U-Boot and Linux work so far,
23 git format-patch, git send-email, etc. with the correct parameters
26 Series-to: fred.blogs@napier.co.nz
30 In Linux and U-Boot this will also call get_maintainer.pl on each of your
31 patches automatically (unless you use -m to disable this).
39 - Maintain a number of branches, one for each patch series you are
41 - Add tags into the commits within each branch to indicate where the
44 commit --amend'
45 - Each branch tracks the upstream branch, so that this script can
47 - Check out a branch, and run this script to create and send out your
55 For most cases of using patman for U-Boot development, patman can use the
56 file 'doc/git-mailrc' in your U-Boot directory to supply the email aliases
60 git config sendemail.aliasesfile doc/git-mailrc
62 For both Linux and U-Boot the 'scripts/get_maintainer.pl' handles figuring
76 u-boot: U-Boot Mailing List <u-boot@lists.denx.de>
84 The checkpatch.pl in the U-Boot tools/ subdirectory will be located and
100 If you want to change the defaults for patman's command-line arguments,
104 (all with the non-default setting):
134 $ ./tools/patman/patman -n
139 $ ./tools/patman/patman -n -c5
144 $ ./tools/patman/patman -n -c5 -s1
153 The most up to date version of patman can be found in the U-Boot sources.
155 a standalone application. A distutils installer is included, this can be used
167 Series-to: email / alias
171 Series-cc: email / alias, ...
175 Series-version: n
178 Series-prefix: prefix
186 Series-name: name
191 Cover-letter:
199 Cover-letter-cc: email / alias
203 Series-notes:
208 Sets some notes for the patch series, which you don't want in
209 the commit messages, but do want to send, The notes are joined
213 Commit-notes:
218 Similar, but for a single commit (patch). These notes will appear
219 immediately below the --- cut in the patch file.
221 Signed-off-by: Their Name <email>
222 A sign-off is added automatically to your patches (this is
227 Tested-by: Their Name <email>
228 Reviewed-by: Their Name <email>
229 Acked-by: Their Name <email>
233 you send out the next version. If 'Tested-by:' is set to
236 Series-changes: n
237 - Guinea pig moved into its cage
238 - Other changes ending with a blank line
251 Patch-cc: Their Name <email>
253 Cc: used by git send-email is ignored by patman, but will be
254 interpreted by git send-email if you use it.
256 Series-process-log: sort, uniq
268 Change-Id:
270 Reviewed-on:
271 Commit-xxxx: (except Commit-notes)
280 Once the patches are created, patman sends them using git send-email. The
281 whole series is sent to the recipients in Series-to: and Series-cc.
282 You can Cc individual patches to other people with the Patch-cc: tag. Tags
289 Date: Mon Nov 7 23:18:44 2011 -0500
293 This should make sending out e-mails to the right people easier.
295 Patch-cc: sandbox, mikef, ag
296 Patch-cc: afleming
302 If you have a cover letter it will get sent to the union of the Patch-cc
306 Cover-letter-cc: <list of addresses>
319 these rather contrived patches in the following order in branch us-cmd in
321 output by git log --oneline):
334 patman -s1 -n
336 If you want to do all of them including the work-in-progress one, then
339 patman -n
343 git rebase -i HEAD~6
346 git add -u
347 git rebase --continue
351 patman -s1 -n
356 git commit --amend
365 Series-to: u-boot
366 Series-cc: bfin, marex
367 Series-prefix: RFC
368 Cover-letter:
376 Change-Id: Ica71a14c1f0ecb5650f771a32fecb8d2eb9d8a17
384 Now to send the patches, take off the -n flag:
386 patman -s1
393 Let's say one person sent comments and you get an Acked-by: on one patch.
400 and use git rebase -i to edit the commits, dropping the wip one. You add
403 Acked-by: Heiko Schocher <hs@denx.de>
405 update the Series-cc: in the top commit:
407 Series-cc: bfin, marex, Heiko Schocher <hs@denx.de>
409 and remove the Series-prefix: tag since it it isn't an RFC any more. The
413 Series-to: u-boot
414 Series-cc: bfin, marex, Heiko Schocher <hs@denx.de>
415 Series-version: 2
416 Cover-letter:
423 Series-changes: 2
424 - Updated the command decoder to reduce code size
425 - Wound the torque propounder up a little more
446 1. When you change back to the us-cmd branch days or weeks later all your
458 git tag sent/us-cmd-rfc
460 git tag sent/us-cmd-v2
465 5. If you want to run git send-email yourself, use the -n flag which will
479 It would be nice if this could handle the In-reply-to side of things.
481 The tests are incomplete, as is customary. Use the --test flag to run them,
484 $ cd /path/to/u-boot
486 $ ./patman --test
488 Error handling doesn't always produce friendly error messages - e.g.
497 v1, v2, 19-Oct-11
498 revised v3 24-Nov-11