for-each-ref: fix documentation argument ordering

Improve the 'git-for-each-ref(1)' documentation with two corrections: 1. Add parentheses around `--exclude=<pattern>` to indicate this option can be repeated as a complete unit. 2. Move `--stdin | <pattern> ...` to the end, after all flags, since `<pattern>` is a positional argument that should appear last in the argument list. While here, change to using the synopsis block which will automatically format placeholders in italics and keywords in monospace. Signed-off-by: Karthik Nayak <karthik.188@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Karthik Nayak committed Jul 28, 2025 at 22:20 UTC a7c8a4c5f5bbe6c232c8aefc02499fe1c0b6d221
1 file changed +5 -5
Documentation/git-for-each-ref.adoc
+5 -5
@@ -7,14 +7,14 @@ git-for-each-ref - Output information on each ref
7
8 SYNOPSIS
9 --------
10 -[verse]
11 -'git for-each-ref' [--count=<count>] [--shell|--perl|--python|--tcl]
10 +[synopsis]
11 +git for-each-ref [--count=<count>] [--shell|--perl|--python|--tcl]
12 [(--sort=<key>)...] [--format=<format>]
13 - [--include-root-refs] [ --stdin | <pattern>... ]
14 - [--points-at=<object>]
13 + [--include-root-refs] [--points-at=<object>]
14 [--merged[=<object>]] [--no-merged[=<object>]]
15 [--contains[=<object>]] [--no-contains[=<object>]]
17 - [--exclude=<pattern> ...] [--start-after=<marker>]
16 + [(--exclude=<pattern>)...] [--start-after=<marker>]
17 + [ --stdin | <pattern>... ]
18
19 DESCRIPTION
20 -----------