branch: externals/denote-org
commit 2eeb06f60b00482ef7fe01c6f01728b3badd1f4b
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Document new 'random' sort for the Org dynamic blocks
This is a new feature in the 'denote' package, starting with commit
ffd3bef:
<https://github.com/protesilaos/denote/commit/ffd3bef12b6c266e1725fe5493d4bed786d25017>.
---
README.org | 27 +++++++++++++++------------
1 file changed, 15 insertions(+), 12 deletions(-)
diff --git a/README.org b/README.org
index c43f9b8cc5..ef8ed6793f 100644
--- a/README.org
+++ b/README.org
@@ -160,10 +160,11 @@ line to update the block.
- The =:sort-by-component= parameter is optional. It sorts the files
by the given Denote file name component. The value it accepts is an
- unquoted symbol among =title=, =keywords=, =signature=, =identifier=.
- When using the command ~denote-org-dblock-insert-files~, this
- parameter is automatically inserted together with the (=:regexp=
- parameter) and the user is prompted for a file name component.
+ unquoted symbol among =title=, =keywords=, =signature=, =identifier=,
+ =random=. When using the command ~denote-org-dblock-insert-files~,
+ this parameter is automatically inserted together with the
+ (=:regexp= parameter) and the user is prompted for a file name
+ component. [ The =random= sort is part of {{{development-version}}}. ]
- The =:reverse-sort= parameter is optional. It reverses the order in
which files appear in. This is meaningful even without the presence
@@ -311,10 +312,11 @@ parameters, which are described further below:
- The =:sort-by-component= parameter is optional. It sorts the files
by the given Denote file name component. The value it accepts is an
- unquoted symbol among =title=, =keywords=, =signature=, =identifier=.
- When using the command ~denote-org-dblock-insert-files~, this
- parameter is automatically inserted together with the (=:regexp=
- parameter) and the user is prompted for a file name component.
+ unquoted symbol among =title=, =keywords=, =signature=, =identifier=,
+ =random=. When using the command ~denote-org-dblock-insert-files~,
+ this parameter is automatically inserted together with the
+ (=:regexp= parameter) and the user is prompted for a file name
+ component. [ The =random= sort is part of {{{development-version}}}. ]
- The =:reverse-sort= parameter is optional. It reverses the order in
which files appear in. This is meaningful even without the presence
@@ -420,10 +422,11 @@ you get all the parameters included:
- The =:sort-by-component= parameter is optional. It sorts the files
by the given Denote file name component. The value it accepts is an
- unquoted symbol among =title=, =keywords=, =signature=, =identifier=.
- When using the command ~denote-org-dblock-insert-files~, this
- parameter is automatically inserted together with the (=:regexp=
- parameter) and the user is prompted for a file name component.
+ unquoted symbol among =title=, =keywords=, =signature=, =identifier=,
+ =random=. When using the command ~denote-org-dblock-insert-files~,
+ this parameter is automatically inserted together with the
+ (=:regexp= parameter) and the user is prompted for a file name
+ component. [ The =random= sort is part of {{{development-version}}}. ]
- The =:reverse-sort= parameter is optional. It reverses the order in
which files appear in. This is meaningful even without the presence
