summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKonstantin Ryabitsev <konstantin@linuxfoundation.org>2020-04-08 13:05:42 -0400
committerKonstantin Ryabitsev <konstantin@linuxfoundation.org>2020-04-08 13:05:42 -0400
commit18a3026a98c2e7c57c0c3e3988520b82da92aff5 (patch)
treebfd43e3bb2baeca3db87c83ca9b7e92eb3f4f8f1
parent8742e3f0675a2b7a8e3e1ba8e11bf7f20d93b063 (diff)
downloadb4-18a3026a98c2e7c57c0c3e3988520b82da92aff5.tar.gz
Add pr subcommand to the manpage
Signed-off-by: Konstantin Ryabitsev <konstantin@linuxfoundation.org>
-rw-r--r--man/b4.5.rst41
1 files changed, 32 insertions, 9 deletions
diff --git a/man/b4.5.rst b/man/b4.5.rst
index 7dacf9c..a95a8bd 100644
--- a/man/b4.5.rst
+++ b/man/b4.5.rst
@@ -1,14 +1,14 @@
B4
==
--------------------------------------------
-Work with patches in a public-inbox archive
--------------------------------------------
+----------------------------------------------------
+Work with code submissions in a public-inbox archive
+----------------------------------------------------
:Author: mricon@kernel.org
-:Date: 2020-03-23
+:Date: 2020-04-08
:Copyright: The Linux Foundation and contributors
:License: GPLv2+
-:Version: 0.3.4
+:Version: 0.4.0
:Manual section: 5
SYNOPSIS
@@ -17,10 +17,10 @@ b4 {mbox,am,attest,attverify} [options]
DESCRIPTION
-----------
-This is a helper utility to work with patches made available via a
-public-inbox archive like lore.kernel.org. It is written to make it
-easier to participate in a patch-based workflows, like those used in
-the Linux kernel development.
+This is a helper utility to work with patches and pull requests made
+available via a public-inbox archive like lore.kernel.org. It is
+written to make it easier to participate in a patch-based workflows,
+like those used in the Linux kernel development.
The name "b4" was chosen for ease of typing and because B-4 was the
precursor to Lore and Data in the Star Trek universe.
@@ -30,6 +30,7 @@ SUBCOMMANDS
* *b4 mbox*: Download a thread as an mbox file
* *b4 am*: Create an mbox file that is ready to git-am
* *b4 attest*: Submit cryptographic attestation for patches
+* *b4 pr*: Work with pull requests
OPTIONS
-------
@@ -122,6 +123,28 @@ optional arguments:
*Example*: b4 attest -n -o output/xxxx-attestation.patch output/\*.patch
+b4 pr
+~~~~~
+usage:
+ command.py pr [-h] [-g GITDIR] [-b BRANCH] [-c] [-e] [-o OUTMBOX] [msgid]
+
+positional arguments:
+ msgid Message ID to process, or pipe a raw message
+
+optional arguments:
+ -h, --help show this help message and exit
+ -g GITDIR, --gitdir GITDIR
+ Operate on this git tree instead of current dir
+ -b BRANCH, --branch BRANCH
+ Check out FETCH_HEAD into this branch after fetching
+ -c, --check Check if pull request has already been applied
+ -e, --explode Convert a pull request into an mbox full of patches
+ -o OUTMBOX, --output-mbox OUTMBOX
+ Save exploded messages into this mailbox (default:
+ msgid.mbx)
+
+*Example*: b4 pr 202003292120.2BDCB41@keescook
+
CONFIGURATION
-------------
B4 configuration is handled via git-config(1), so you can store it in