[PATCH] Documentation: explain "git branch --with"
- From
Jonathan Nieder <jrnieder@gmail.com>
- Date
- Sep 7, 2010, 05:52 UTC
- Message-ID
- <20100907055209.GT1182@burratino>
- In-Reply-To
- <7v39tmtpci.fsf@alter.siamese.dyndns.org>
Junio C Hamano wrote:
Show 8 quoted lines
> 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 <jrnieder@gmail.com> --- 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 <commit>:: +--with <commit>:: Only list branches which contain the specified commit. --merged [<commit>]::
-- 1.7.2.3