Documentation: improve description of --glob=pattern and friends
Consolidate the descriptions of --branches, --tags and --remotes a bit, to make it less repetitive. Improve the grammar a bit, and spell out the meaning of the 'append /*' rule. Signed-off-by: Thomas Rast <trast@student.ethz.ch> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:

committed by
Junio C Hamano

parent
b09fe971de
commit
e2b53e5808
@ -104,25 +104,23 @@ OPTIONS
|
|||||||
Show all refs found in `$GIT_DIR/refs`.
|
Show all refs found in `$GIT_DIR/refs`.
|
||||||
|
|
||||||
--branches[=pattern]::
|
--branches[=pattern]::
|
||||||
Show branch refs found in `$GIT_DIR/refs/heads`. If `pattern`
|
|
||||||
is given, only branches matching given shell glob are shown.
|
|
||||||
If pattern lacks '?', '*', or '[', '/*' at the end is impiled.
|
|
||||||
|
|
||||||
--tags[=pattern]::
|
--tags[=pattern]::
|
||||||
Show tag refs found in `$GIT_DIR/refs/tags`. If `pattern`
|
|
||||||
is given, only tags matching given shell glob are shown.
|
|
||||||
If pattern lacks '?', '*', or '[', '/*' at the end is impiled.
|
|
||||||
|
|
||||||
--remotes[=pattern]::
|
--remotes[=pattern]::
|
||||||
Show tag refs found in `$GIT_DIR/refs/remotes`. If `pattern`
|
Show all branches, tags, or remote-tracking branches,
|
||||||
is given, only remote tracking branches matching given shell glob
|
respectively (i.e., refs found in `$GIT_DIR/refs/heads`,
|
||||||
are shown. If pattern lacks '?', '*', or '[', '/*' at the end is
|
`$GIT_DIR/refs/tags`, or `$GIT_DIR/refs/remotes`,
|
||||||
impiled.
|
respectively).
|
||||||
|
+
|
||||||
|
If a `pattern` is given, only refs matching the given shell glob are
|
||||||
|
shown. If the pattern does not contain a globbing character (`?`,
|
||||||
|
`\*`, or `[`), it is turned into a prefix match by appending `/\*`.
|
||||||
|
|
||||||
--glob=glob-pattern::
|
--glob=pattern::
|
||||||
Show refs matching shell glob pattern `glob-pattern`. If pattern
|
Show all refs matching the shell glob pattern `pattern`. If
|
||||||
specified lacks leading 'refs/', it is automatically prepended.
|
the pattern does not start with `refs/`, this is automatically
|
||||||
If pattern lacks '?', '*', or '[', '/*' at the end is impiled.
|
prepended. If the pattern does not contain a globbing
|
||||||
|
character (`?`, `\*`, or `[`), it is turned into a prefix
|
||||||
|
match by appending `/\*`.
|
||||||
|
|
||||||
--show-prefix::
|
--show-prefix::
|
||||||
When the command is invoked from a subdirectory, show the
|
When the command is invoked from a subdirectory, show the
|
||||||
|
Reference in New Issue
Block a user