Version-Control layer

Table of ContentsClose

1. Description
- 1.1. Features
2. Install
- 2.1. Layer
3. Configuration
- 3.1. Differences between margin programs
4. Key Bindings
- 4.1. Version Control Transient-state

1 Description

This layers adds general configuration for Emacs VC. It should work with all VC backends such as Git, Mercurial, Bazaar, SVN, etc…

1.1 Features

highlights uncommitted changes in the fringe or margin with diff-hl,

git-gutter, or git-gutter+

adds vcs transient-state SPC g. to allow quick navigation and modification of

buffer hunks.

2 Install

2.1 Layer

To use this configuration layer, add it to your ~/.spacemacs. You will need to add version-control to the existing dotspacemacs-configuration-layers list in this file.

3 Configuration

You can choose the package to facilitate the diff transient-state and show margins by setting version-control-diff-tool

'(version-control :variables
                  version-control-diff-tool 'diff-hl)

To automatically enable diff margins in all buffers, set version-control-global-margin

'(version-control :variables
                  version-control-global-margin t)

3.1 Differences between margin programs

This layer contains generalized mappings for three diff margin packages: diff-hl, git-gutter, and git-gutter+.

There are some differences between packages that might have some people prefer one over the other:

Feature	diff-hl	git-gutter	git-gutter+
Show in fringe	X	X	X
Extended VCS support (e.g. hg, svn)	X	X
Stage hunks from buffer		X	X
Dired support	X

4 Key Bindings

Key Binding	Description
`SPC g .`	version control transient-state
`SPC T d`	toggle diff margins
`SPC T C-d`	toggle diff margins globally

4.1 Version Control Transient-state

Key Binding	Description
`SPC g . h`	Show diff of hunk
`SPC g . n`	Next hunk
`SPC g . N`	Previous hunk
`SPC g . p`	Previous hunk
`SPC g . r`	Revert hunk
`SPC g . s`	Stage hunk
`SPC g . t`	Toggle margin indicators
`SPC g . w`	Stage file
`SPC g . u`	Unstage file
`SPC g . d`	Repo diff popup
`SPC g . D`	Show diffs of unstaged hunks
`SPC g . c`	Commit with popup
`SPC g . C`	Commit
`SPC g . P`	Push repo with popup
`SPC g . f`	Fetch for repo with popup
`SPC g . F`	Pull repo with popup
`SPC g . l`	Show repo log