branch: externals/denote
commit bf6cc904634dce6004224fa4752f53ff831cb94d
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Expand the docstring of denote-rename-file-keywords
---
denote.el | 11 ++++++++++-
1 file changed, 10 insertions(+), 1 deletion(-)
diff --git a/denote.el b/denote.el
index 709c2aafa5..e0d3972969 100644
--- a/denote.el
+++ b/denote.el
@@ -3048,7 +3048,16 @@ how a completion User Interface may accept an empty
input."
(defun denote-rename-file-keywords ()
"Convenience command to change the keywords of a file.
-Like `denote-rename-file', but prompts only for keywords."
+Like `denote-rename-file', but prompts only for keywords.
+
+Add or remove keywords in one go. Do this by prepopulating the
+minibuffer prompt with the existing keywords. The user can then insert
+the `crm-separator' (normally a comma), to write new keywords or edit
+what is in the prompt to rewrite them accordingly. An empty input means
+to remove all keywords.
+
+Please check the documentation of `denote-rename-file' with regard to
+how a completion User Interface may accept an empty input."
(declare (interactive-only t))
(interactive)
(let ((denote-prompts '(keywords)))
