Function: denote-make-links-buffer

denote-make-links-buffer is a byte-compiled function defined in denote.el.

Signature

(denote-make-links-buffer QUERY &optional FILES BUFFER-NAME DISPLAY-BUFFER-ACTION &rest _)

Documentation

Create links' buffer called BUFFER-NAME for QUERY.

Optional FILES can be a list of files to search for. It can also be a regexp, which limits the files accordingly per denote-directory-files.

Optional DISPLAY-BUFFER-ACTION is a display-buffer action and concomitant alist, such as denote-backlinks-display-buffer-action.

Aliases

denote-link--prepare-backlinks (obsolete since 4.0.0)

Source Code

;; Defined in ~/.emacs.d/elpa/denote-4.2.3/denote.el
;; NOTE 2025-03-24: The `&rest' is there because we used to have an
;; extra SHOW-CONTEXT parameter.  This way we do not break anybody's
;; code, even if we slightly modify the behaviour.
(defun denote-make-links-buffer (query &optional files buffer-name display-buffer-action &rest _)
  "Create links' buffer called BUFFER-NAME for QUERY.

Optional FILES can be a list of files to search for.  It can also be a
regexp, which limits the files accordingly per `denote-directory-files'.

Optional DISPLAY-BUFFER-ACTION is a `display-buffer' action and
concomitant alist, such as `denote-backlinks-display-buffer-action'."
  (if-let* ((inhibit-read-only t)
            (buffer (or buffer-name
                        (denote-format-buffer-name (format-message "query for `%s'" query) :special-buffer)))
            (xref-alist (denote-retrieve-xref-alist query files))
            (files (delete-dups (mapcar #'car xref-alist))))
      (progn
        (setq denote-query--last-query query)
        (setq denote-query--last-files files)
        (denote--display-buffer-from-xref-alist xref-alist buffer display-buffer-action))
    (error "No matches for query `%s'" query)))