Function: xref-backend-references

xref-backend-references is a byte-compiled function defined in xref.el.gz.

Signature

(xref-backend-references BACKEND IDENTIFIER)

Documentation

Find references of IDENTIFIER.

The result must be a list of xref objects. If no references can be found, return nil.

The default implementation uses semantic-symref-tool-alist to find a search tool; by default, this uses "find | grep" in the current project's main and external roots.

Implementations

(xref-backend-references (BACKEND (eql cider)) VAR) in `cider-xref-backend.el'.

Find references of VAR.

(xref-backend-references (BACKEND (eql 'tex-etags)) IDENTIFIER) in `tex-mode.el'.

Find references of IDENTIFIER in TeX buffers and files.

(xref-backend-references (BACKEND (eql eglot)) IDENTIFIER) in `eglot.el'.

Undocumented

(xref-backend-references BACKEND IDENTIFIER) in `xref.el'.

Undocumented

(xref-backend-references (BACKEND (eql 'elisp)) IDENTIFIER (NIL ((&context . major-mode) derived-mode help-mode))) in `help-fns.el'.

Undocumented

Source Code

;; Defined in /usr/src/emacs/lisp/progmodes/xref.el.gz
(cl-defgeneric xref-backend-references (_backend identifier)
  "Find references of IDENTIFIER.
The result must be a list of xref objects.  If no references can
be found, return nil.

The default implementation uses `semantic-symref-tool-alist' to
find a search tool; by default, this uses \"find | grep\" in the
current project's main and external roots."
  (mapcan
   (lambda (dir)
     (message "Searching %s..." dir)
     (redisplay)
     (prog1
         (xref-references-in-directory identifier dir)
       (message "Searching %s... done" dir)))
   (let ((pr (project-current t)))
     (project-combine-directories
      (cons
       (xref--project-root pr)
       (project-external-roots pr))))))