[PATCH 10/13] rev-list: add filtering help text
From: Jeff Hostetler <jeffhost@microsoft.com>
Signed-off-by: Jeff Hostetler <jeffhost@microsoft.com>
---
Documentation/git-rev-list.txt | 9 ++++++++-
Documentation/rev-list-options.txt | 32 ++++++++++++++++++++++++++++++++
2 files changed, 40 insertions(+), 1 deletion(-)
diff --git a/Documentation/git-rev-list.txt b/Documentation/git-rev-list.txt
index ef22f17..b2e8255 100644
--- a/Documentation/git-rev-list.txt
+++ b/Documentation/git-rev-list.txt
@@ -47,7 +47,14 @@ SYNOPSIS
[ --fixed-strings | -F ]
[ --date=<format>]
[ [ --objects | --objects-edge | --objects-edge-aggressive ]
- [ --unpacked ] ]
+ [ --unpacked ]
+ [ [ --filter-omit-all-blobs |
+ --filter-omit-large-blobs=<n>[kmg] |
+ --filter-use-blob=<blob-ish> |
+ --filter-use-path=<path> ]
+ [ --filter-print-missing ]
+ [ --filter-print-omitted ] ] ]
+ [ --filter-relax ]
[ --pretty | --header ]
[ --bisect ]
[ --bisect-vars ]
diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt
index a6cf9eb..5c7d53c 100644
--- a/Documentation/rev-list-options.txt
+++ b/Documentation/rev-list-options.txt
@@ -698,6 +698,38 @@ ifdef::git-rev-list[]
--unpacked::
Only useful with `--objects`; print the object IDs that are not
in packs.
+
+--filter-omit-all-blobs::
+ Only useful with one of the `--objects*`; omits all blobs from
+ the printed list of objects.
+
+--filter-omit-large-blobs=<n>[kmg]::
+ Only useful with one of the `--objects*`; omits blobs larger than
+ n bytes from the printed list of objects. May optionally be
+ followed by 'k', 'm', or 'g' units. Value may be zero. Special
+ files (matching ".git*") are always included, regardless of size.
+
+--filter-use-blob=<blob-ish>::
+--filter-use-path=<path>::
+ Only useful with one of the `--objects*`; uses a sparse-checkout
+ specification contained in the given object or file to filter the
+ result to only contain blobs referenced by such a sparse-checkout.
+
+--filter-print-missing::
+ Prints a list of the missing objects for the requested traversal.
+ Object IDs are prefixed with a ``?'' character. The object type
+ is printed after the ID. This may be used with or without any of
+ the above filtering options.
+
+--filter-print-omitted::
+ Only useful with one of the above `--filter*`; prints a list
+ of the omitted objects. Object IDs are prefixed with a ``~''
+ character. The object size is printed after the ID.
+
+--filter-relax::
+ Relax consistency checking for missing blobs. Do not warn of
+ missing blobs during normal (non-filtering) object traversal
+ following an earlier partial/narrow clone or fetch.
endif::git-rev-list[]
--no-walk[=(sorted|unsorted)]::
--
2.9.3