Skip to content

Commit eaec838

Browse files
committed
rev-list: add filtering help text
Signed-off-by: Jeff Hostetler <[email protected]>
1 parent a59fd79 commit eaec838

File tree

2 files changed

+33
-1
lines changed

2 files changed

+33
-1
lines changed

Documentation/git-rev-list.txt

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,13 @@ SYNOPSIS
4747
[ --fixed-strings | -F ]
4848
[ --date=<format>]
4949
[ [ --objects | --objects-edge | --objects-edge-aggressive ]
50-
[ --unpacked ] ]
50+
[ --unpacked ]
51+
[ [ --filter-omit-all-blobs |
52+
--filter-omit-large-blobs=<n>[kmg] |
53+
--filter-use-blob=<blob-ish> |
54+
--filter-use-path=<path> ]
55+
[ --filter-print-manifest ] ] ]
56+
[ --filter-relax ]
5157
[ --pretty | --header ]
5258
[ --bisect ]
5359
[ --bisect-vars ]

Documentation/rev-list-options.txt

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -698,6 +698,32 @@ ifdef::git-rev-list[]
698698
--unpacked::
699699
Only useful with `--objects`; print the object IDs that are not
700700
in packs.
701+
702+
--filter-omit-all-blobs::
703+
Only useful with one of the `--objects*`; omits all blobs from
704+
the printed list of objects.
705+
706+
--filter-omit-large-blobs=<n>[kmg]::
707+
Only useful with one of the `--objects*`; omits blobs larger than
708+
n bytes from the printed list of objects. May optionally be
709+
followed by 'k', 'm', or 'g' units. Value may be zero. Special
710+
files (matching ".git*") are always included, regardless of size.
711+
712+
--filter-use-blob=<blob-ish>::
713+
--filter-use-path=<path>::
714+
Only useful with one of the `--objects*`; uses a sparse-checkout
715+
specification contained in the given object or file to filter the
716+
result to only contain blobs referenced by such a sparse-checkout.
717+
718+
--filter-print-manifest::
719+
Only useful with one of the above `--filter*`; prints a manifest
720+
of the omitted objects. Object IDs are prefixed with a ``~''
721+
character. The object size is printed after the ID.
722+
723+
--filter-relax::
724+
Relax consistency checking for missing blobs. Do not warn of
725+
missing blobs during normal (non-filtering) object traversal
726+
following an earlier partial/narrow clone or fetch.
701727
endif::git-rev-list[]
702728

703729
--no-walk[=(sorted|unsorted)]::

0 commit comments

Comments
 (0)