From: Jonathan Nieder Date: Tue, 07 Sep 2010 05:52:09 GMT Subject: [PATCH] Documentation: explain "git branch --with" Message-ID: <20100907055209.GT1182@burratino> In-Reply-To: <7v39tmtpci.fsf@alter.siamese.dyndns.org> Junio C Hamano wrote: > It was originally called --with. I wrote it to help me in the exact use > case in this thread, and the option was naturally named --with, as the > request I wanted to make was "Give me branches _with_ this commit, so that > I know which ones I need to rewind before reintegrating and publishing". > > Somehow people wanted to see an option with a longer name, but by that > time my fingers were well trained, so I kept "--with" but didn't bother > advertising duplicated options. More precisely, it is advertised by "git branch --help-all" but not the manual or "git branch -h". How about adding it to the man page so people can look up this option after encountering it in the wild? Signed-off-by: Jonathan Nieder --- Documentation/git-branch.txt | 1 + 1 files changed, 1 insertions(+), 0 deletions(-) diff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt index 1940256..f479e2f 100644 --- a/Documentation/git-branch.txt +++ b/Documentation/git-branch.txt @@ -142,6 +142,7 @@ start-point is either a local or remote branch. branch points to is not changed. --contains :: +--with :: Only list branches which contain the specified commit. --merged []:: -- 1.7.2.3