save: add -a option to save all attachments

Allow saving all message parts that have the content disposition
"attachment" header to a folder.

Suggested-by: Ondřej Synáček <ondrej@synacek.org>
Signed-off-by: Robin Jarry <robin@jarry.cc>
Acked-by: Koni Marti <koni.marti@gmail.com>
Tested-by: Moritz Poldrack <moritz@poldrack.dev>

1 files changed, 5 insertions, 3 deletions

diff --git a/doc/aerc.1.scd b/doc/aerc.1.scd
index 27384ad..dda8aed 100644
--- a/doc/aerc.1.scd
+++ b/doc/aerc.1.scd
@@ -337,12 +337,12 @@ message list, the message in the message viewer, etc).
 	Saves the current message part in a temporary file and opens it
 	with the system handler. Any given args are forwarded to the open handler
 
-*save* [-fp] <path>
+*save* [-fpa] <path>
 	Saves the current message part to the given path.
 	If the path is not an absolute path, general.default-save-path will be
 	prepended to the path given.
-	If path ends in a trailing slash or if a folder exists on disc,
-	aerc assumes it to be a directory.
+	If path ends in a trailing slash or if a folder exists on disc or if -a
+	is specified, aerc assumes it to be a directory.
 	When passed a directory :save infers the filename from the mail part if
 	possible, or if that fails, uses "aerc_$DATE".
 
@@ -350,6 +350,8 @@ message list, the message in the message viewer, etc).
 
 	*-p*: Create any directories in the path that do not exist
 
+	*-a*: Save all attachments. Individual filenames cannot be specified.
+
 *mark* [-atv]
 	Marks messages. Commands will execute on all marked messages instead of the
 	highlighted one if applicable. The flags below can be combined as needed.