summaryrefslogtreecommitdiffstats
path: root/rev-list-options.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2019-02-05 15:33:56 -0800
committerJunio C Hamano <gitster@pobox.com>2019-02-05 15:33:56 -0800
commit2567b326fac6961a6fc6075ad2f22a744252f2f3 (patch)
tree2e4c640f64f1f8f00b992e414a2fd316aea798d4 /rev-list-options.txt
parentcf7310088e7328f8aa7ea2c5de767ef9499b5d78 (diff)
downloadgit-htmldocs-2567b326fac6961a6fc6075ad2f22a744252f2f3.tar.gz
Autogenerated HTML docs for v2.20.1-519-g8fedd
Diffstat (limited to 'rev-list-options.txt')
-rw-r--r--rev-list-options.txt15
1 files changed, 10 insertions, 5 deletions
diff --git a/rev-list-options.txt b/rev-list-options.txt
index 98b538bc7..8a4867998 100644
--- a/rev-list-options.txt
+++ b/rev-list-options.txt
@@ -270,13 +270,13 @@ depending on a few rules:
+
--
1. If the starting point is specified as `ref@{Nth}`, show the index
-format.
+ format.
+
2. If the starting point was specified as `ref@{now}`, show the
-timestamp format.
+ timestamp format.
+
3. If neither was used, but `--date` was given on the command line, show
-the timestamp in the format requested by `--date`.
+ the timestamp in the format requested by `--date`.
+
4. Otherwise, show the index format.
--
@@ -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.