diff options
| author | Taylor Blau <me@ttaylorr.com> | 2024-10-18 13:56:20 -0400 |
|---|---|---|
| committer | Taylor Blau <me@ttaylorr.com> | 2024-10-18 13:56:20 -0400 |
| commit | ee064ba65a564d73c60909407794052d826e9e9a (patch) | |
| tree | 72b5c86e1bc93390059bd03195e527e2c0438201 | |
| parent | Merge branch 'aa/t7300-modernize' (diff) | |
| parent | doc: clarify <src> in refspec syntax (diff) | |
| download | git-ee064ba65a564d73c60909407794052d826e9e9a.tar.gz git-ee064ba65a564d73c60909407794052d826e9e9a.zip | |
Merge branch 'jc/doc-refspec-syntax'
Doc updates.
* jc/doc-refspec-syntax:
doc: clarify <src> in refspec syntax
| -rw-r--r-- | Documentation/pull-fetch-param.txt | 7 |
1 files changed, 4 insertions, 3 deletions
diff --git a/Documentation/pull-fetch-param.txt b/Documentation/pull-fetch-param.txt index c718f7946f..d79d2f6065 100644 --- a/Documentation/pull-fetch-param.txt +++ b/Documentation/pull-fetch-param.txt @@ -25,14 +25,15 @@ endif::git-pull[] + The format of a <refspec> parameter is an optional plus `+`, followed by the source <src>, followed -by a colon `:`, followed by the destination ref <dst>. +by a colon `:`, followed by the destination <dst>. The colon can be omitted when <dst> is empty. <src> is -typically a ref, but it can also be a fully spelled hex object +typically a ref, or a glob pattern with a single `*` that is used +to match a set of refs, but it can also be a fully spelled hex object name. + A <refspec> may contain a `*` in its <src> to indicate a simple pattern match. Such a refspec functions like a glob that matches any ref with the -same prefix. A pattern <refspec> must have a `*` in both the <src> and +pattern. A pattern <refspec> must have one and only one `*` in both the <src> and <dst>. It will map refs to the destination by replacing the `*` with the contents matched from the source. + |