Variable: vc-hg-symbolic-revision-styles

vc-hg-symbolic-revision-styles is a customizable variable defined in vc-hg.el.gz.

Value

(builtin-active-bookmark "{if(bookmarks,sub(' ',',',bookmarks),if(phabdiff,phabdiff,shortest(node,6)))}")

Documentation

List of ways to present versions symbolically.

The version that we use is the first one that successfully produces a non-empty string.

Each entry in the list can be either:

- The symbol builtin-active-bookmark, which indicates that we
should use the active bookmark if one exists. A template can supply this information as well, but builtin-active-bookmark is handled entirely inside Emacs and so is more efficient than using the generic Mercurial mechanism.

- A string giving the Mercurial template to supply to "hg
parent". "hg help template" may be useful reading.

- A function to call; it should accept two arguments (a revision
and an optional path to which to limit history) and produce a string. The function is called with default-directory set to within the repository.

If no list entry produces a useful revision, return nil.

This variable was added, or its default value changed, in Emacs 26.1.

Probably introduced at or before Emacs version 26.2.

Source Code

;; Defined in /usr/src/emacs/lisp/vc/vc-hg.el.gz
(defcustom vc-hg-symbolic-revision-styles
  '(builtin-active-bookmark
    "{if(bookmarks,sub(' ',',',bookmarks),if(phabdiff,phabdiff,shortest(node,6)))}")
  "List of ways to present versions symbolically.
The version that we use is the first one that successfully
produces a non-empty string.

Each entry in the list can be either:

- The symbol `builtin-active-bookmark', which indicates that we
should use the active bookmark if one exists.  A template can
supply this information as well, but `builtin-active-bookmark' is
handled entirely inside Emacs and so is more efficient than using
the generic Mercurial mechanism.

- A string giving the Mercurial template to supply to \"hg
parent\".  \"hg help template\" may be useful reading.

- A function to call; it should accept two arguments (a revision
and an optional path to which to limit history) and produce a
string.  The function is called with `default-directory' set to
within the repository.

If no list entry produces a useful revision, return nil."
  :type '(repeat (choice
                  (const :tag "Active bookmark" builtin-active-bookmark)
                  (string :tag "Hg template")
                  (function :tag "Custom")))
  :version "26.1")