From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 25 Feb 2015 06:10:39 +0000 (-0800)
Subject: Merge branch 'jc/doc-log-rev-list-options' into maint
X-Git-Tag: v2.3.1~3
X-Git-Url: https://git.lorimer.id.au/gitweb.git/diff_plain/254a3ebfe8d6061721629d9cba9b3d5f4f591ba6?ds=inline;hp=-c

Merge branch 'jc/doc-log-rev-list-options' into maint

"git log --help" used to show rev-list options that are irrelevant
to the "log" command.

* jc/doc-log-rev-list-options:
Documentation: what does "git log --indexed-objects" even mean?
---

254a3ebfe8d6061721629d9cba9b3d5f4f591ba6
diff --combined Documentation/rev-list-options.txt
index 2984f407a9,c88d5e142c..97ef2e8e71
--- a/Documentation/rev-list-options.txt
+++ b/Documentation/rev-list-options.txt
@@@ -160,7 -160,7 +160,7 @@@ parents) and `--max-parents=-1` (negati
  	consider. Repetitions of this option accumulate exclusion patterns
  	up to the next `--all`, `--branches`, `--tags`, `--remotes`, or
  	`--glob` option (other options or arguments do not clear
 -	accumlated patterns).
 +	accumulated patterns).
  +
  The patterns given should not begin with `refs/heads`, `refs/tags`, or
  `refs/remotes` when applied to `--branches`, `--tags`, or `--remotes`,
@@@ -172,11 -172,6 +172,6 @@@ explicitly
  	Pretend as if all objects mentioned by reflogs are listed on the
  	command line as `<commit>`.
  
- --indexed-objects::
- 	Pretend as if all trees and blobs used by the index are listed
- 	on the command line.  Note that you probably want to use
- 	`--objects`, too.
- 
  --ignore-missing::
  	Upon seeing an invalid object name in the input, pretend as if
  	the bad input was not given.
@@@ -644,6 -639,7 +639,7 @@@ Object Traversa
  
  These options are mostly targeted for packing of Git repositories.
  
+ ifdef::git-rev-list[]
  --objects::
  	Print the object IDs of any object referenced by the listed
  	commits.  `--objects foo ^bar` thus means ``send me
@@@ -653,18 -649,19 +649,24 @@@
  --objects-edge::
  	Similar to `--objects`, but also print the IDs of excluded
  	commits prefixed with a ``-'' character.  This is used by
 -	linkgit:git-pack-objects[1] to build ``thin'' pack, which records
 +	linkgit:git-pack-objects[1] to build a ``thin'' pack, which records
  	objects in deltified form based on objects contained in these
  	excluded commits to reduce network traffic.
  
 +--objects-edge-aggressive::
 +	Similar to `--objects-edge`, but it tries harder to find excluded
 +	commits at the cost of increased time.  This is used instead of
 +	`--objects-edge` to build ``thin'' packs for shallow repositories.
 +
+ --indexed-objects::
+ 	Pretend as if all trees and blobs used by the index are listed
+ 	on the command line.  Note that you probably want to use
+ 	`--objects`, too.
+ 
  --unpacked::
  	Only useful with `--objects`; print the object IDs that are not
  	in packs.
+ endif::git-rev-list[]
  
  --no-walk[=(sorted|unsorted)]::
  	Only show the given commits, but do not traverse their ancestors.