Difference between revisions of "Vc"

From WikEmacs
Jump to: navigation, search
m (typos)
(Helpful keybindings + Common customization)
Line 18: Line 18:
 
No particular setup is needed for basic usage. Emacs checks for usage
 
No particular setup is needed for basic usage. Emacs checks for usage
 
of version control automatically when a file is being opened.
 
of version control automatically when a file is being opened.
 +
 +
 +
== Helpful key bindings ==
 +
 +
; {{CommandKeys|C-x v +|vc-update}}
 +
: Update the current fileset's files to their tip revisions.
 +
; {{CommandKeys|C-x v =|vc-diff}}
 +
: Display diffs between file revisions.
 +
; {{CommandKeys|C-x v g|vc-annotate}}
 +
: Display the edit history of the current file.
 +
 +
 +
== Common customizations ==
 +
 +
=== Automatically revert version-controlled buffers ===
 +
Since version controlled files tend to be changed outside of Emacs, it might be useful to automatically activate [[auto-revert-mode]].
 +
 +
<source lang="lisp">
 +
;; Activate `auto-revert-mode' for version-controlled files
 +
(defadvice vc-find-file-hook (after auto-revert-mode-for-vc activate)
 +
  "vc-find-file-hook advice for activating `auto-revert-mode'"
 +
  (when vc-mode (auto-revert-mode 1)))
 +
</source>
 +
  
 
== See Also ==
 
== See Also ==

Revision as of 03:12, 4 April 2012

vc
Description Version control front end for emacs
Author several authors
Maintainer Andre Spiegel
Source http://git.savannah.gnu.org/cgit/emacs.git/tree/lisp/vc/
Part of Emacs yes

vc is a Version Control minor mode. This minor mode is automatically activated whenever a file is opened which is under any revision control system. It supports many different version control systems including git, bazaar, CVS and SVN etc. It gives a unique interface to Emacs irrespective of back end version control system in operation.

Basic setup

No particular setup is needed for basic usage. Emacs checks for usage of version control automatically when a file is being opened.


Helpful key bindings

[C-x v +] (or M-x vc-update)
Update the current fileset's files to their tip revisions.
[C-x v =] (or M-x vc-diff)
Display diffs between file revisions.
[C-x v g] (or M-x vc-annotate)
Display the edit history of the current file.


Common customizations

Automatically revert version-controlled buffers

Since version controlled files tend to be changed outside of Emacs, it might be useful to automatically activate auto-revert-mode.

;; Activate `auto-revert-mode' for version-controlled files
(defadvice vc-find-file-hook (after auto-revert-mode-for-vc activate)
  "vc-find-file-hook advice for activating `auto-revert-mode'"
  (when vc-mode (auto-revert-mode 1)))


See Also