On Fri, Mar 24, 2017 at 5:56 AM, Junio C Hamano <gitster@xxxxxxxxx> 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 <jrnieder@xxxxxxxxx> > Signed-off-by: Junio C Hamano <gitster@xxxxxxxxx> > --- > 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 >