summaryrefslogtreecommitdiffstats
path: root/rev-list-options.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2019-09-18 12:30:01 -0700
committerJunio C Hamano <gitster@pobox.com>2019-09-18 12:30:01 -0700
commitcb705397f111dc1fcb3e3fa844bfd5b3050dee38 (patch)
tree7a08f9890ae401f03a3d3fb034c06f1be74e727e /rev-list-options.txt
parent926cc052d4e49ae0c1af3703c87b0d1037d7fbac (diff)
downloadgit-htmldocs-cb705397f111dc1fcb3e3fa844bfd5b3050dee38.tar.gz
Autogenerated HTML docs for v2.23.0-256-g4c861
Diffstat (limited to 'rev-list-options.txt')
-rw-r--r--rev-list-options.txt16
1 files changed, 16 insertions, 0 deletions
diff --git a/rev-list-options.txt b/rev-list-options.txt
index bb1251c03..90ff9e2be 100644
--- a/rev-list-options.txt
+++ b/rev-list-options.txt
@@ -756,6 +756,22 @@ explicitly-given commit or tree.
Note that the form '--filter=sparse:path=<path>' that wants to read
from an arbitrary path on the filesystem has been dropped for security
reasons.
++
+Multiple '--filter=' flags can be specified to combine filters. Only
+objects which are accepted by every filter are included.
++
+The form '--filter=combine:<filter1>+<filter2>+...<filterN>' can also be
+used to combined several filters, but this is harder than just repeating
+the '--filter' flag and is usually not necessary. Filters are joined by
+'{plus}' and individual filters are %-encoded (i.e. URL-encoded).
+Besides the '{plus}' and '%' characters, the following characters are
+reserved and also must be encoded: `~!@#$^&*()[]{}\;",<>?`+&#39;&#96;+
+as well as all characters with ASCII code &lt;= `0x20`, which includes
+space and newline.
++
+Other arbitrary characters can also be encoded. For instance,
+'combine:tree:3+blob:none' and 'combine:tree%3A3+blob%3Anone' are
+equivalent.
--no-filter::
Turn off any previous `--filter=` argument.