Sync with Git 2.22.1
[git/git.git] / contrib / emacs / README
1 This directory used to contain various modules for Emacs support.
2
3 These were added shortly after Git was first released. Since then
4 Emacs's own support for Git got better than what was offered by these
5 modes. There are also popular 3rd-party Git modes such as Magit which
6 offer replacements for these.
7
8 The following modules were available, and can be dug up from the Git
9 history:
10
11 * git.el:
12
13 Wrapper for "git status" that provided access to other git commands.
14
15 Modern alternatives to this include Magit, and VC mode that ships
16 with Emacs.
17
18 * git-blame.el:
19
20 A wrapper for "git blame" written before Emacs's own vc-annotate
21 mode learned to invoke git-blame, which can be done via C-x v g.
22
23 * vc-git.el:
24
25 This file used to contain the VC-mode backend for git, but it is no
26 longer distributed with git. It is now maintained as part of Emacs
27 and included in standard Emacs distributions starting from version
28 22.2.
29
30 If you have an earlier Emacs version, upgrading to Emacs 22 is
31 recommended, since the VC mode in older Emacs is not generic enough
32 to be able to support git in a reasonable manner, and no attempt has
33 been made to backport vc-git.el.