code.delx.au - gnu-emacs-elpa/blob - README.md

   1 About
   2 =====
   3
   4 `diff-hl-mode` highlights uncommitted changes on the left fringe of the window,
   5 allows you to jump between and revert them selectively.
   6
   7 For the usage instructions and the list of commands, see the header comment.
   8
   9 Tested with Git, Mercurial, Bazaar and SVN. May work with other VC backends, too.
  10
  11 Screenshot
  12 =====
  13
  14 ![screenie](screenshot.png)
  15
  16 Top window: a buffer in this minor mode, bottom window: the corresponding diff.
  17
  18 Requirements
  19 =====
  20
  21 Emacs 24+. On OS X, Emacs 24.3 or higher is recommended.
  22
  23 Notes
  24 =====
  25
  26 * Since it uses the corresponding VC diff command, it's only accurate when the
  27   buffer is in saved state. Highlighting changes "on the fly" might be better,
  28   maybe we can do something similar to `highlight-markup-buffers` with a hidden
  29   buffer containing the unmodified copy.
  30
  31 * There's no fringe when Emacs is running in the console, but the navigation and
  32   revert commands still work.
  33
  34 * [git-gutter](https://github.com/syohex/emacs-git-gutter) provides interactive
  35   commands to show/hide/toggle margin indicators for the same information, and
  36   allows you to customize how the indicators look.