[elpa] externals/denote cf78f863c3 10/14: Expand the docstring of denote-rename-file-title

[ELPA Syncer]

branch: externals/denote
commit cf78f863c3b030f8f44d7ab6d5cca593a0404fac
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@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)))