branch: externals/denote
commit cf78f863c3b030f8f44d7ab6d5cca593a0404fac
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Expand the docstring of denote-rename-file-title
---
denote.el | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
diff --git a/denote.el b/denote.el
index 1dd59ea0f2..709c2aafa5 100644
--- a/denote.el
+++ b/denote.el
@@ -3033,7 +3033,14 @@ one-by-one, use `denote-dired-rename-files'."
(defun denote-rename-file-title ()
"Convenience command to change the title of a file.
-Like `denote-rename-file', but prompts only for the title."
+Like `denote-rename-file', but prompts only for the title.
+
+Add or remove a title in one go. Do this by prepopulating the
+minibuffer prompt with the existing title. The user can then modify it
+accordingly. An empty input means to remove the title 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 '(title)))
