From be5c8a1de09436ed8933bc4ef10c71e5fe1261ef Mon Sep 17 00:00:00 2001 From: Konstantin Ryabitsev Date: Fri, 15 May 2020 12:34:29 -0400 Subject: Document changes to -P Add changes to -P,--cherry-pick to the man page. Signed-off-by: Konstantin Ryabitsev --- man/b4.5 | 19 ++++++++++--------- man/b4.5.rst | 5 ++++- 2 files changed, 14 insertions(+), 10 deletions(-) diff --git a/man/b4.5 b/man/b4.5 index 54676cf..0e7df0e 100644 --- a/man/b4.5 +++ b/man/b4.5 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH B4 5 "2020-04-10" "0.4.0" "" +.TH B4 5 "2020-04-10" "0.4.1" "" .SH NAME B4 \- Work with code submissions in a public-inbox archive . @@ -161,6 +161,11 @@ Add a lore.kernel.org/r/ link to every patch .TP .B \-Q\fP,\fB \-\-quilt\-ready Save mbox patches in a quilt\-ready folder +.TP +.BI \-P \ CHERRYPICK\fP,\fB \ \-\-cherry\-pick \ CHERRYPICK +Cherry\-pick a subset of patches (e.g. "\-P 1\-2,4,6\-", +"\-P _" to use just the msgid specified, +or "\-P *globbing*" to match on commit subject) .UNINDENT .UNINDENT .sp @@ -250,23 +255,19 @@ Write thanks files into this dir (default=.) List pull requests and patch series you have retrieved .TP .BI \-s \ SEND\fP,\fB \ \-\-send \ SEND -Generate thankyous for specified messages (use \-l to -get the list or "all") +Generate thankyous for specific entries from \-l (e.g.: 1,3\-5,7\-; or "all") .TP .BI \-d \ DISCARD\fP,\fB \ \-\-discard \ DISCARD -Discard specified messages (use \-l to get the list, or -use "all") +Discard specific messages from \-l (e.g.: 1,3\-5,7\-; or "all") .TP .B \-a\fP,\fB \-\-auto -Use the Auto\-Thankanator to figure out what got -applied/merged +Use the Auto\-Thankanator to figure out what got applied/merged .TP .BI \-b \ BRANCH\fP,\fB \ \-\-branch \ BRANCH The branch to check against, instead of current .TP .BI \-\-since \ SINCE -The \-\-since option to use when auto\-matching patches -(default=1.week) +The \-\-since option to use when auto\-matching patches (default=1.week) .UNINDENT .UNINDENT .sp diff --git a/man/b4.5.rst b/man/b4.5.rst index b44dc96..c95b172 100644 --- a/man/b4.5.rst +++ b/man/b4.5.rst @@ -102,7 +102,10 @@ optional arguments: -l, --add-link Add a lore.kernel.org/r/ link to every patch -Q, --quilt-ready Save mbox patches in a quilt-ready folder -P CHERRYPICK, --cherry-pick CHERRYPICK - Cherry-pick a subset of patches (e.g. -P 1-2,4,6-) + Cherry-pick a subset of patches (e.g. "-P 1-2,4,6-", + "-P _" to use just the msgid specified, + or "-P \*globbing\*" to match on commit subject) +  *Example*: b4 am 20200313231252.64999-1-keescook@chromium.org -- cgit v1.2.3