aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/git-for-each-ref.adoc
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2025-08-04 08:10:32 -0700
committerJunio C Hamano <gitster@pobox.com>2025-08-04 08:10:32 -0700
commit10be1c41bcf5e7cdcd6968c914a9ffd7ce368dbe (patch)
treeafcfa4fd63a2796d744165616c50d2ddb6eb8251 /Documentation/git-for-each-ref.adoc
parentMerge branch 'jt/switch-restore-no-longer-experimental' (diff)
parentref-filter: use REF_ITERATOR_SEEK_SET_PREFIX instead of '1' (diff)
downloadgit-10be1c41bcf5e7cdcd6968c914a9ffd7ce368dbe.tar.gz
git-10be1c41bcf5e7cdcd6968c914a9ffd7ce368dbe.zip
Merge branch 'kn/for-each-ref-skip-updates'
Code clean-up. * kn/for-each-ref-skip-updates: ref-filter: use REF_ITERATOR_SEEK_SET_PREFIX instead of '1' t6302: add test combining '--start-after' with '--exclude' for-each-ref: reword the documentation for '--start-after' for-each-ref: fix documentation argument ordering ref-cache: use 'size_t' instead of int for length
Diffstat (limited to 'Documentation/git-for-each-ref.adoc')
-rw-r--r--Documentation/git-for-each-ref.adoc13
1 files changed, 7 insertions, 6 deletions
diff --git a/Documentation/git-for-each-ref.adoc b/Documentation/git-for-each-ref.adoc
index ae61ba642a..060940904d 100644
--- a/Documentation/git-for-each-ref.adoc
+++ b/Documentation/git-for-each-ref.adoc
@@ -7,14 +7,14 @@ git-for-each-ref - Output information on each ref
SYNOPSIS
--------
-[verse]
-'git for-each-ref' [--count=<count>] [--shell|--perl|--python|--tcl]
+[synopsis]
+git for-each-ref [--count=<count>] [--shell|--perl|--python|--tcl]
[(--sort=<key>)...] [--format=<format>]
- [--include-root-refs] [ --stdin | <pattern>... ]
- [--points-at=<object>]
+ [--include-root-refs] [--points-at=<object>]
[--merged[=<object>]] [--no-merged[=<object>]]
[--contains[=<object>]] [--no-contains[=<object>]]
- [--exclude=<pattern> ...] [--start-after=<marker>]
+ [(--exclude=<pattern>)...] [--start-after=<marker>]
+ [ --stdin | <pattern>... ]
DESCRIPTION
-----------
@@ -114,7 +114,8 @@ TAB %(refname)`.
deleted, modified or added between invocations. Output will only yield those
references which follow the marker lexicographically. Output begins from the
first reference that would come after the marker alphabetically. Cannot be
- used with general pattern matching or custom sort options.
+ used with `--sort=<key>` or `--stdin` options, or the _<pattern>_ argument(s)
+ to limit the refs.
FIELD NAMES
-----------