summaryrefslogtreecommitdiffstats
path: root/rev-list-options.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2019-01-28 14:05:25 -0800
committerJunio C Hamano <gitster@pobox.com>2019-01-28 14:05:25 -0800
commita90214fb857c988a9e8dff46626dc715918a9330 (patch)
tree756c139e2481e113fa188ed55f6b2c46c153a7a3 /rev-list-options.txt
parentace33e4fa1aa5ba14bafe92218bf07dea068791f (diff)
downloadgit-htmldocs-a90214fb857c988a9e8dff46626dc715918a9330.tar.gz
Autogenerated HTML docs for v2.20.1-421-g9403f
Diffstat (limited to 'rev-list-options.txt')
-rw-r--r--rev-list-options.txt9
1 files changed, 7 insertions, 2 deletions
diff --git a/rev-list-options.txt b/rev-list-options.txt
index 98b538bc7..91b3a72bd 100644
--- a/rev-list-options.txt
+++ b/rev-list-options.txt
@@ -730,8 +730,13 @@ specification contained in <path>.
+
The form '--filter=tree:<depth>' omits all blobs and trees whose depth
from the root tree is >= <depth> (minimum depth if an object is located
-at multiple depths in the commits traversed). Currently, only <depth>=0
-is supported, which omits all blobs and trees.
+at multiple depths in the commits traversed). <depth>=0 will not include
+any trees or blobs unless included explicitly in the command-line (or
+standard input when --stdin is used). <depth>=1 will include only the
+tree and blobs which are referenced directly by a commit reachable from
+<commit> or an explicitly-given object. <depth>=2 is like <depth>=1
+while also including trees and blobs one more level removed from an
+explicitly-given commit or tree.
--no-filter::
Turn off any previous `--filter=` argument.