Junio C Hamano wrote: > I can go without "Do not forget ..." and everything that follows, > though, and if we are going to do so, then > > --list:: > List branches. With optional <pattern>..., > e.g. `git branch --list 'maint-*`, list only the > branches that match the pattern(s). > > would be fine. I am not opposed to having an visually distinctive > example--I just do not want to have one that is wrong without > clearly marking it as such. I like this one. I haven't witnessed "git branch maint-*" being a common mistake. For comparison, "git branch -l maint-*" does seem to be a common mistake. It's a shame that the short-and-sweet "-l" was taken for that purpose. Perhaps it's worth calling that out here? --list:: --list <pattern>:: List branches. If <pattern> is specified (e.g., "git branch --list 'maint-*'), list only the branches that match the pattern. + 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. Thanks, Jonathan