emacs-elpa-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[elpa] externals/denote 4205708b2c 3/9: Document in the manual denote-so


From: ELPA Syncer
Subject: [elpa] externals/denote 4205708b2c 3/9: Document in the manual denote-sort-dired-extra-prompts new exclude-regexp symbol
Date: Wed, 4 Dec 2024 09:58:04 -0500 (EST)

branch: externals/denote
commit 4205708b2cb10f3a588b4580e834a0686b673a2f
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Document in the manual denote-sort-dired-extra-prompts new exclude-regexp 
symbol
---
 README.org     | 15 ++++++++++++---
 denote-sort.el | 10 ++++++++--
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/README.org b/README.org
index 2fd901a2a3..0b45f60b3c 100644
--- a/README.org
+++ b/README.org
@@ -4046,9 +4046,18 @@ match file names, (ii) a file name component to sort by, 
and (iii)
 whether to reverse the sorting. Users can configure the latter two by
 modifying the user option ~denote-sort-dired-extra-prompts~.
 
-It accepts either a nil value or a list of symbols among ~sort-by-component~
-and ~reverse-sort~. The order those symbols appear in the list is
-significant, with the leftmost coming first.
+It accepts either a nil value or a list of symbols among
+~sort-by-component~, ~reverse-sort~, and ~exclude-regexp~. The order
+those symbols appear in the list is significant, with the leftmost
+coming first. [ The ~exclude-regexp~ feature is part of
+{{{development-version}}}. ]
+
+These symbols correspond to the following:
+
+- A choice to select the file name component to sort by.
+- A yes or no prompt on whether to reverse the sorting.
+- A string (or regular expression) of files to be excluded from the
+  results.
 
 #+vindex: denote-sort-dired-default-sort-component
 #+vindex: denote-sort-dired-default-reverse-sort
diff --git a/denote-sort.el b/denote-sort.el
index d21db255b7..704cfa7b4b 100644
--- a/denote-sort.el
+++ b/denote-sort.el
@@ -73,8 +73,14 @@ whether to sort by a given file name component and to then 
reverse the
 sort.
 
 The value is a list of symbols, which can include the symbols
-`sort-by-component' and `reverse-sort'.  The order is significant, with
-the leftmost symbol coming first.
+`sort-by-component', `reverse-sort', and `exclude-regexp'.  The order is
+significant, with the leftmost symbol coming first.
+
+These symbols correspond to the following:
+
+- A choice to select the file name component to sort by.
+- A yes or no prompt on whether to reverse the sorting.
+- A string (or regular expression) of files to be excluded from the results.
 
 If the value is nil, skip all prompts.  In this scenario, the sorting is
 done according to `denote-sort-dired-default-sort-component' and



reply via email to

[Prev in Thread] Current Thread [Next in Thread]