Function: vc-diff-incoming

vc-diff-incoming is an autoloaded, interactive and byte-compiled function defined in vc.el.gz.

Signature

(vc-diff-incoming &optional UPSTREAM-LOCATION FILESET)

Documentation

Report changes to VC fileset that would be pulled from UPSTREAM-LOCATION.

When unspecified UPSTREAM-LOCATION is the place C-x v + (vc-update) would pull from. When called interactively with a prefix argument, prompt for UPSTREAM-LOCATION. In some version control systems UPSTREAM-LOCATION can be a remote branch name. When called from Lisp optional argument FILESET overrides the VC fileset.

See vc-use-incoming-outgoing-prefixes regarding giving this command a global binding.

View in manual

Probably introduced at or before Emacs version 31.1.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/vc/vc.el.gz
;;;###autoload
(defun vc-diff-incoming (&optional upstream-location fileset)
  "Report changes to VC fileset that would be pulled from UPSTREAM-LOCATION.
When unspecified UPSTREAM-LOCATION is the place \\[vc-update] would pull
from.  When called interactively with a prefix argument, prompt for
UPSTREAM-LOCATION.  In some version control systems UPSTREAM-LOCATION
can be a remote branch name.
When called from Lisp optional argument FILESET overrides the VC
fileset.

See `vc-use-incoming-outgoing-prefixes' regarding giving this command a
global binding."
  (interactive (list (vc--maybe-read-upstream-location) nil))
  (let* ((fileset (or fileset (vc-deduce-fileset t)))
         (backend (car fileset))
         (incoming (vc--incoming-revision backend
                                          upstream-location 'refresh)))
    (vc-diff-internal vc-allow-async-diff fileset
                      (vc-call-backend backend 'mergebase incoming)
                      incoming
                      (called-interactively-p 'interactive))))