about summary refs log tree commit diff stats
path: root/doc/aerc.1.scd
diff options
context:
space:
mode:
authorReto Brunner <reto@labrat.space>2020-01-19 20:22:56 +0100
committerDrew DeVault <sir@cmpwn.com>2020-01-20 09:21:28 -0500
commit5b3acb8034e78680eb8dca472af5dd72af57414e (patch)
treeea1d3426f9cc26772bce7db2a8d6a12564982a3b /doc/aerc.1.scd
parentef029aa26359b6524fc12ccc9f4c43b59d8b8f48 (diff)
downloadaerc-5b3acb8034e78680eb8dca472af5dd72af57414e.tar.gz
msgview/save: Adapt to already decoded reader
The functionality was broken since the decoding changes.
This commit also simplifies the code (in my view) to make the application logic
easier to follow.
The docs are updated accordingly (the feature was poorly documented).

As far as I am aware there should be no breaking changes (and is certainly
still in the spec of the prior documentation)
Diffstat (limited to 'doc/aerc.1.scd')
-rw-r--r--doc/aerc.1.scd13
1 files changed, 9 insertions, 4 deletions
diff --git a/doc/aerc.1.scd b/doc/aerc.1.scd
index c0e8ad4..38c0bd4 100644
--- a/doc/aerc.1.scd
+++ b/doc/aerc.1.scd
@@ -240,13 +240,18 @@ 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.
 
-*save* [-p] <path>
+*save* [-fp] <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.
+	When passed a directory :save infers the filename from the mail part if
+	possible, or if that fails, uses "aerc_$DATE".
 
-	If no path is given but general.default-save-path is set, the
-	file will be saved there.
+	*-f*: Overwrite the destination whether or not it exists
 
-	*-p*: Make any directories in the path that do not exist
+	*-p*: Create any directories in the path that do not exist
 
 *mark* [-atv]
 	Marks messages. Commands will execute on all marked messages instead of the