On Fri, Mar 24, 2017 at 5:56 AM, Junio C Hamano <[email protected]> wrote:
> The paragraph begins with a sample command line `git branch <name>`
> that has nothing to do with the option being described. Remove it,
> but use the space to instead show that multiple patterns can be
> given.
>
> Also mention the unfortunate `-l` that can be easily confused with
> it.
>
> Helped-by: Jonathan Nieder <[email protected]>
> Signed-off-by: Junio C Hamano <[email protected]>
> ---
> Documentation/git-branch.txt | 9 +++++++--
> 1 file changed, 7 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt
> index 6a17ca591a..514b0d0b91 100644
> --- a/Documentation/git-branch.txt
> +++ b/Documentation/git-branch.txt
> @@ -142,8 +142,13 @@ This option is only applicable in non-verbose mode.
> List both remote-tracking branches and local branches.
>
> --list::
> - Activate the list mode. `git branch <branchname>` would try to create
> a branch,
> - use `git branch --list <pattern>` to list matching branches.
> + List branches. With optional `<pattern>...`, e.g. `git
> + branch --list 'maint-*'`, list only the branches that match
> + the pattern(s).
> ++
> +This should not be confused with `git branch -l <branchname>`,
> +which creates a branch named `<branchname>` with a reflog.
> +See `--create-reflog` above for details.
Looks good to me.
> -v::
> -vv::
> --
> 2.12.1-432-gf364f02724
>
