[PATCHv2 8/8] Doc branch: show -vv option and alternative

[PATCHv2 8/8] Doc branch: show -vv option and alternative

[Philip Oakley]

Indicate that the -v option can be given twice in the short options.
Without it users pass over the option. Also indicate the alternate
'git remote show' method.

Signed-off-by: Philip Oakley <philipoakley@iee.org>

diff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt
index 9c1d2f1..cc7f54c 100644
--- a/Documentation/git-branch.txt
+++ b/Documentation/git-branch.txt
@@ -130,12 +130,13 @@ This option is only applicable in non-verbose mode.
 	Activate the list mode. `git branch <pattern>` would try to create a branch,
 	use `git branch --list <pattern>` to list matching branches.
 
--v::
+-v, -vv::
 --verbose::
 	When in list mode,
 	show sha1 and commit subject line for each head, along with
 	relationship to upstream branch (if any). If given twice, print
-	the name of the upstream branch, as well.
+	the name of the upstream branch, as well (see also `git remote
+	show <remote>`).
 
 -q::
 --quiet::
-- 
1.7.8.msysgit.0

Re: [PATCHv2 8/8] Doc branch: show -vv option and alternative

[Junio C Hamano]

Philip Oakley <philipoakley@iee.org> writes:

> --v::
> +-v, -vv::
>  --verbose::
>  	When in list mode,
>  	show sha1 and commit subject line for each head, along with
>  	relationship to upstream branch (if any). If given twice, print
> -	the name of the upstream branch, as well.
> +	the name of the upstream branch, as well (see also `git remote
> +	show <remote>`).

Can you try

	-v::
        -vv::
        --verbose::
		The description...

instead?  Cf. http://thread.gmane.org/gmane.comp.version-control.git/205184/focus=205315

Re: [PATCHv2 8/8] Doc branch: show -vv option and alternative

[Philip Oakley]

From: "Junio C Hamano" <gitster@pobox.com>
> Philip Oakley <philipoakley@iee.org> writes:
>
>> --v::
>> +-v, -vv::
>>  --verbose::
>>  When in list mode,
>>  show sha1 and commit subject line for each head, along with
>>  relationship to upstream branch (if any). If given twice, print
>> - the name of the upstream branch, as well.
>> + the name of the upstream branch, as well (see also `git remote
>> + show <remote>`).
>
> Can you try
>
> -v::
>        -vv::
>        --verbose::
> The description...
>
> instead?  Cf. 
> http://thread.gmane.org/gmane.comp.version-control.git/205184/focus=205315
>

OK. update maybe a couple of days due to other commitments. 

Re: [PATCHv2 8/8] Doc branch: show -vv option and alternative

[Junio C Hamano]

Junio C Hamano <gitster@pobox.com> writes:

> Philip Oakley <philipoakley@iee.org> writes:
>
>> --v::
>> +-v, -vv::
>>  --verbose::
>>  	When in list mode,
>>  	show sha1 and commit subject line for each head, along with
>>  	relationship to upstream branch (if any). If given twice, print
>> -	the name of the upstream branch, as well.
>> +	the name of the upstream branch, as well (see also `git remote
>> +	show <remote>`).
>
> Can you try
>
> 	-v::
>         -vv::
>         --verbose::
> 		The description...
>
> instead?  Cf. http://thread.gmane.org/gmane.comp.version-control.git/205184/focus=205315

Nah, nevermind (I was being lazy and hoping for a quick turnaround).

I tried it and it formats well, so I'll squash that in and queue.