Difference between revisions of "Vc"
Jump to navigation
Jump to search
(intro) |
m (→Helpful key bindings: (see also diff-mode)) |
||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | '''vc''' is a [[Version Control]] minor mode. This minor mode is automatically activated whenever | + | {{Package |
| − | control of | + | |name=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/ | ||
| + | |in_emacs=yes | ||
| + | |Development status=active | ||
| + | }} | ||
| + | |||
| + | '''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 == | ||
| + | |||
| + | ; {{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 in a buffer using [[diff-mode]]. | ||
| + | ; {{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 == | ||
| + | :* [[Magit]] | ||
| + | :* [[diff]] | ||
| + | :* [[ediff]] | ||
| + | |||
| + | |||
| + | [[Category:Minor Mode]] | ||
| + | [[Category:Version Control]] | ||
| + | [[Category:Major Components of Emacs]] | ||
Latest revision as of 07:31, 4 April 2012
| 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 in a buffer using diff-mode.
- [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)))