Variable: denote-query-sorting

denote-query-sorting is a customizable variable defined in denote.el.

Value

nil

Documentation

How to sort files in query buffers.

This applies to buffers generated by the denote-grep command, query links for file contents, as well as backlinks.

By default (a nil value), no sorting of matching files is performed. Files are displayed in the order they are returned by the search program (which often, but not always, means they are sorted by file name).

The value can be a symbol among those listed in the value of the variable denote-sort-components. Files will then be sorted according to the given file name component or the relevant method (e.g. randomly for the random symbol).

The value may also be a custom function. It takes two arguments, as described by sort (internally, the function responsible is the denote-sort-files).

Whatever the value of denote-query-sorting, users may change the sorting of query buffers on demand by calling the command denote-query-sort-last-search.

This variable was added, or its default value changed, in denote version 4.1.0.

Source Code

;; Defined in ~/.emacs.d/elpa/denote-4.2.3/denote.el
(defcustom denote-query-sorting nil
  "How to sort files in query buffers.
This applies to buffers generated by the `denote-grep' command, query
links for file contents, as well as backlinks.

By default (a nil value), no sorting of matching files is performed.
Files are displayed in the order they are returned by the search
program (which often, but not always, means they are sorted by file
name).

The value can be a symbol among those listed in the value of the
variable `denote-sort-components'.  Files will then be sorted according
to the given file name component or the relevant method (e.g. randomly
for the `random' symbol).

The value may also be a custom function.  It takes two arguments, as
described by `sort' (internally, the function responsible is the
`denote-sort-files').

Whatever the value of `denote-query-sorting', users may change the
sorting of query buffers on demand by calling the command
`denote-query-sort-last-search'."
  :type '(radio
          (const :tag "Don't sort (default)" nil)
          (const :tag "Sort by identifier" identifier)
          (const :tag "Sort by title" title)
          (const :tag "Sort by keywords" keywords)
          (const :tag "Sort by signature" signature)
          (const :tag "Random order" random)
          (const :tag "Last modified" last-modified)
          (function :tag "Custom function that take two arguments for `sort'"))
  :package-version '(denote . "4.1.0")
  :group 'denote-query)