git-init-db(1): Describe --shared and the idempotent nature of init-db

diff --git a/Documentation/git-rev-list.txt b/Documentation/git-rev-list.txt
index 993911070a2ced38586b3aedcb5078f25d57ec35..75c9968004b4de9ba83432c9e35d4bbef1822396 100644 (file)
--- a/Documentation/git-rev-list.txt
+++ b/Documentation/git-rev-list.txt
@@ -73,10 +73,11 @@ OPTIONS
 
 --sparse::
        When optional paths are given, the command outputs only
-       the commits that changes at least one of them.  This
-       flag makes the command ignore the paths, outputting all
-       eligible commits (still subject to count and age
-       limitation).
+       the commits that changes at least one of them, and also
+       ignores merges that do not touch the given paths.  This
+       flag makes the command output all eligible commits
+       (still subject to count and age limitation), but apply
+       merge simplification nevertheless.
 
 --all::
        Pretend as if all the refs in `$GIT_DIR/refs/` are
@@ -128,7 +129,7 @@ the marked commit in the list.
 +
 Commits marked with (^) are not parents of the immediately preceding commit.
 These "breaks" represent necessary discontinuities implied by trying to
-represent an arbtirary DAG in a linear form.
+represent an arbitrary DAG in a linear form.
 +
 `--show-breaks` is only valid if `--merge-order` is also specified.