[elpa] externals/vc-got f2e1ddb 028/145: document vc-got-stage-mode

[ELPA Syncer]

branch: externals/vc-got
commit f2e1ddb3b2513bc1f99687079cb609a133feac00
Author: Omar Polo <op@omarpolo.com>
Commit: Omar Polo <op@omarpolo.com>

    document vc-got-stage-mode
---
 README.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/README.md b/README.md
index d872ab2..0afc79d 100644
--- a/README.md
+++ b/README.md
@@ -32,3 +32,28 @@ With `use-package` something like this should be enough:
   (add-to-list 'vc-handled-backends 'Got)
   (add-to-list 'vc-directory-exclusion-list ".got"))
 ```
+
+### vc-got-stage-mode
+
+`vc-got-stage-mode` is a minor mode to stage individual changes
+(currently you can't commit the staged changes).
+
+The Emacs VC system usually operates at a *fileset* level: i.e. it can
+commit/rollback/etc sets of file.  Yet, sometimes you may want to
+commit only individual changes (eventually from multiple files), and
+VC doesn't support this.  This is the motivation behind
+`vc-got-stage-mode`.
+
+The following keys are enabled by `vc-got-stage-mode`:
+
+| <kbd>C-c g A</kbd> | Applies (i.e. stage in got) the marked changes |
+| <kbd>C-c g b</kbd> | Go to beginning of change |
+| <kbd>C-c g e</kbd> | Go to end of change |
+| <kbd>C-c g n</kbd> | Go to next change |
+| <kbd>C-c g p</kbd> | Go to previous change |
+| <kbd>C-c g t</kbd> | Toggle mark |
+
+A change is a set of sequential line added/removed by the diff, it is
+a smaller unit than a *hunk*.
+
+The staged changes are indicated by an arrow in the left fringe.