mu4e-view-save-attachments: document limitation

This function assumes that file names are unique; document this
limitation and point users to mu4e-view-mime-part-action.

Fixes #2742
This commit is contained in:
Dirk-Jan C. Binnema
2024-08-16 20:17:03 +02:00
parent af6ca080a4
commit 52e388923f

View File

@ -282,11 +282,18 @@ Optionally,
(defun mu4e-view-save-attachments (&optional ask-dir)
"Save files from the current view buffer.
This applies to all MIME-parts that are \"attachment-like\" (have a filename),
regardless of their disposition.
This applies to all MIME-parts that are \"attachment-like\" (have
a filename), regardless of their disposition.
With ASK-DIR is non-nil, user can specify the target-directory; otherwise
one is determined using `mu4e-attachment-dir'."
one is determined using `mu4e-attachment-dir'.
This command assumes unique filenames for the attachments, since
that is how the underlying completion mechanism works. If there
are duplicates, only one is recognized. For this corner-case, it
is recommended to use `mu4e-view-mime-part-action' instead, which
does not have this limitation."
(interactive "P")
(let* ((parts (mu4e-view-mime-parts))
(candidates (seq-map