patch/apply: add apply sub-cmd

Add the :patch apply command to apply a patch set and create a
corresponding tag. The tag command argument can be completed based on
the subject lines of the selected messages. Add a test for the
completion proposal.

Signed-off-by: Koni Marti <koni.marti@gmail.com>
Acked-by: Robin Jarry <robin@jarry.cc>

1 files changed, 10 insertions, 3 deletions

diff --git a/doc/aerc-patch.7.scd b/doc/aerc-patch.7.scd
index 4209b493..98c271bb 100644
--- a/doc/aerc-patch.7.scd
+++ b/doc/aerc-patch.7.scd
@@ -35,13 +35,20 @@ The following *:patch* sub-commands are supported:
 
 	*-a*: Lists all projects.
 
-*:patch apply* _<tag>_
+*:patch apply* [*-c* _<cmd>_] _<tag>_
 	Applies the selected message(s) to the repository of the current
 	project. It uses the *:pipe* command for this and keeps track of the
 	applied patch.
 
-	*aerc* will propose completions for _<tag>_ based on the subject lines
-	of the selected or marked messages.
+	A user-defined command for applying patches can be used with the *-c*
+	option. Any occurence of '%r' in the command string will be replaced
+	with the root directory of the current project. However, this approach
+	is not recommended in general and should only be used for very specific
+	purposes, i.e. when a maintainer is applying a patch set via a separate
+	script to deal with git trailers.
+
+	*aerc* will propose completions for the _<tag>_ based on the subject
+	lines of the selected or marked messages.
 
 *:patch remove* _<tag>_
 	Removes the patch _<tag>_ from the repository.