branch: externals/denote
commit 9970d09bd6ab49769d6637dc654ced3f8ff66f05
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Expand the docstring of denote-rename-file-signature
---
denote.el | 10 +++++++++-
1 file changed, 9 insertions(+), 1 deletion(-)
diff --git a/denote.el b/denote.el
index e0d3972969..67414d9744 100644
--- a/denote.el
+++ b/denote.el
@@ -3070,7 +3070,15 @@ how a completion User Interface may accept an empty
input."
(defun denote-rename-file-signature ()
"Convenience command to change the signature of a file.
-Like `denote-rename-file', but prompts only for the signature."
+Like `denote-rename-file', but prompts only for the signature.
+
+Add or remove a signature in one go. Do this by prepopulating the
+minibuffer prompt with the existing signature. The user can then modify
+it accordingly. An empty input means to remove the signature
+altogether.
+
+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 '(signature)))
