branch: externals/denote commit 5789ca599b2c3a4d7f6bed427193dc18e36699f7 Author: Protesilaos Stavrou <i...@protesilaos.com> Commit: Protesilaos Stavrou <i...@protesilaos.com>
Clarify denote-rename-file docs about keeping components not covered by denote-prompts --- README.org | 9 +++------ denote.el | 10 ++++------ 2 files changed, 7 insertions(+), 12 deletions(-) diff --git a/README.org b/README.org index 45deea1498..31f68c28a6 100644 --- a/README.org +++ b/README.org @@ -1232,12 +1232,9 @@ separated by a comma, else the ~crm-separator~). For all prompts, the ~denote-rename-file~ interprets an empty input as an instruction to remove that file name component. For example, if a =TITLE= prompt is available and =FILE= is =20240211T093531--some-title__keyword1.org= -then it renames =FILE= to =20240211T093531__keyword1.org=. For -interactive use, this also means that if a prompt is missing from the -~denote-prompts~ the corresponding file name component will be removed -during the renaming process (e.g. a ~denote-prompts~ without an entry -for keywords is the same as passing an empty/nil =KEYWORDS= argument, -thus removing the keywords of the file). +then it renames =FILE= to =20240211T093531__keyword1.org=. If a file +name component is present, but there is no entry for it in +~denote-prompts~, keep it as-is. [ NOTE: Please check with your minibuffer user interface how to provide an empty input. The Emacs default setup accepts the empty diff --git a/denote.el b/denote.el index 80caf685f9..bc525d73c0 100644 --- a/denote.el +++ b/denote.el @@ -2780,12 +2780,10 @@ keywords, each separated by a comma, else the `crm-separator'). For all prompts, interpret an empty input as an instruction to remove that file name component. For example, if a TITLE prompt is available and FILE is 20240211T093531--some-title__keyword1.org -then rename FILE to 20240211T093531__keyword1.org. For -interactive use, this also means that if a prompt is missing from -the `denote-prompts' the corresponding file name component will -be removed during the renaming process (e.g. a `denote-prompts' -without an entry for keywords is the same as passing an empty/nil -KEYWORDS argument, thus removing the keywords of the file). +then rename FILE to 20240211T093531__keyword1.org. + +If a file name component is present, but there is no entry for it in +`denote-prompts', keep it as-is. [ NOTE: Please check with your minibuffer user interface how to provide an empty input. The Emacs default setup accepts the