threads / discuss / 31598

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

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

## tl;dr

4 messages between Sep 18, 2012 and Sep 19, 2012.

replies: 3people: 2as markdown or json

Philip Oakley· Sep 18, 2012, 23:25 UTC · lore

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
Junio C Hamano· Sep 19, 2012, 04:01 UTC · re: Philip Oakley · lore

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

Philip Oakley <philipoakley@iee.org> writes:
Show 9 quoted lines
> --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
Philip Oakley· Sep 19, 2012, 07:20 UTC · re: Junio C Hamano · lore

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

From: "Junio C Hamano" <gitster@pobox.com>
Show 22 quoted lines
> 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.
Junio C Hamano· Sep 19, 2012, 17:22 UTC · re: Junio C Hamano · lore

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

Junio C Hamano <gitster@pobox.com> writes:
Show 20 quoted lines
> 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.

← back to recent threads