git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] log: decorate detached HEAD differently

From
Michael J Gruber <git@drmicha.warpmail.net>
Date
Mar 9, 2015, 09:16 UTC
Message-ID
<54FD64D1.6080103@drmicha.warpmail.net>
In-Reply-To
<xmqq61aeymlv.fsf@gitster.dls.corp.google.com>
Junio C Hamano venit, vidit, dixit 06.03.2015 20:03:
Show 25 quoted lines
> Michael J Gruber <git@drmicha.warpmail.net> writes:
> 
>> "git status" and "git branch" let the user know when the HEAD is
>> detached, as well as the current branch, while "git log --decorate" does not.
>>
>> Change the decoration by a non-detached HEAD pointing to branch foo to
>> "HEAD->foo". This can be seen as giving more information about the
>> decoration item itself in the same way as we prefix tags by "tag: ".
>>
>> Signed-off-by: Michael J Gruber <git@drmicha.warpmail.net>
>> ---
>>
>> Notes:
>>     v2 decorates the HEAD pointing to master as "HEAD->master", a detached
>>     HEAD just as "HEAD". The "->" hopefully conveys the symlink nature - a
>>     "=" would be confusing.
>>     
>>     Somehow I still prefer "detached HEAD", dunno. Maybe in addition?
>>     
>>     Note that now a checked branch is listed twice, once as target of the
>>     HEAD, once as branch: They are two different refs and colored differently.
> 
> The pointee of HEAD would always be branch and will always appear on
> the output when you show HEAD->$name_of_that_branch; is it feasible
> to drop the duplicate, I wonder?

It's doable but not nice, because we cannot take the order in which refs are processed for granted.

I also think that we shouldn't simply check whether branch foo is checked out (when decorating with foo) - we need to know whether HEAD is among the refs which are eligible for decoration. That caveat is also true for the "always" above. (I don't think we allow decorating by a subset of all refs right now, but it would be useful, and easy given the for-each-ref machinery.)

Also, HEAD and foo are two different refs, so even if HEAD has the value "foo", I think we should really show them both anyways.

Alternatively, we could decorate by (HEAD, *foo, master, tag: release) if foo is checked out, just like branch does.

Show 72 quoted lines
>>  log-tree.c                             | 8 +++++++-
>>  t/t4013/diff.log_--decorate=full_--all | 2 +-
>>  t/t4013/diff.log_--decorate_--all      | 2 +-
>>  t/t4207-log-decoration-colors.sh       | 2 +-
>>  4 files changed, 10 insertions(+), 4 deletions(-)
>>
>> diff --git a/log-tree.c b/log-tree.c
>> index 7f0890e..38862bb 100644
>> --- a/log-tree.c
>> +++ b/log-tree.c
>> @@ -118,8 +118,11 @@ static int add_ref_decoration(const char *refname, const unsigned char *sha1, in
>>  		type = DECORATION_REF_TAG;
>>  	else if (!strcmp(refname, "refs/stash"))
>>  		type = DECORATION_REF_STASH;
>> -	else if (!strcmp(refname, "HEAD"))
>> +	else if (!strcmp(refname, "HEAD")) {
>> +		unsigned char junk_sha1[20];
>>  		type = DECORATION_REF_HEAD;
>> +		refname = resolve_ref_unsafe("HEAD", 0, junk_sha1, NULL);
>> +	}
>>  
>>  	if (!cb_data || *(int *)cb_data == DECORATE_SHORT_REFS)
>>  		refname = prettify_refname(refname);
>> @@ -198,6 +201,9 @@ void format_decorations_extended(struct strbuf *sb,
>>  		strbuf_addstr(sb, decorate_get_color(use_color, decoration->type));
>>  		if (decoration->type == DECORATION_REF_TAG)
>>  			strbuf_addstr(sb, "tag: ");
>> +		else if (decoration->type == DECORATION_REF_HEAD &&
>> +			 strcmp(decoration->name, "HEAD"))
>> +			strbuf_addstr(sb, "HEAD->");
>>  		strbuf_addstr(sb, decoration->name);
>>  		strbuf_addstr(sb, color_reset);
>>  		prefix = separator;
>> diff --git a/t/t4013/diff.log_--decorate=full_--all b/t/t4013/diff.log_--decorate=full_--all
>> index 44d4525..3758ae9 100644
>> --- a/t/t4013/diff.log_--decorate=full_--all
>> +++ b/t/t4013/diff.log_--decorate=full_--all
>> @@ -5,7 +5,7 @@ Date:   Mon Jun 26 00:06:00 2006 +0000
>>  
>>      Rearranged lines in dir/sub
>>  
>> -commit 59d314ad6f356dd08601a4cd5e530381da3e3c64 (HEAD, refs/heads/master)
>> +commit 59d314ad6f356dd08601a4cd5e530381da3e3c64 (HEAD->refs/heads/master, refs/heads/master)
>>  Merge: 9a6d494 c7a2ab9
>>  Author: A U Thor <author@example.com>
>>  Date:   Mon Jun 26 00:04:00 2006 +0000
>> diff --git a/t/t4013/diff.log_--decorate_--all b/t/t4013/diff.log_--decorate_--all
>> index 27d3eab..df702ae 100644
>> --- a/t/t4013/diff.log_--decorate_--all
>> +++ b/t/t4013/diff.log_--decorate_--all
>> @@ -5,7 +5,7 @@ Date:   Mon Jun 26 00:06:00 2006 +0000
>>  
>>      Rearranged lines in dir/sub
>>  
>> -commit 59d314ad6f356dd08601a4cd5e530381da3e3c64 (HEAD, master)
>> +commit 59d314ad6f356dd08601a4cd5e530381da3e3c64 (HEAD->master, master)
>>  Merge: 9a6d494 c7a2ab9
>>  Author: A U Thor <author@example.com>
>>  Date:   Mon Jun 26 00:04:00 2006 +0000
>> diff --git a/t/t4207-log-decoration-colors.sh b/t/t4207-log-decoration-colors.sh
>> index 925f577..0437ff2 100755
>> --- a/t/t4207-log-decoration-colors.sh
>> +++ b/t/t4207-log-decoration-colors.sh
>> @@ -44,7 +44,7 @@ test_expect_success setup '
>>  '
>>  
>>  cat >expected <<EOF
>> -${c_commit}COMMIT_ID${c_reset}${c_commit} (${c_HEAD}HEAD${c_reset}${c_commit},\
>> +${c_commit}COMMIT_ID${c_reset}${c_commit} (${c_HEAD}HEAD->master${c_reset}${c_commit},\
>>   ${c_tag}tag: v1.0${c_reset}${c_commit},\
>>   ${c_tag}tag: B${c_reset}${c_commit},\
>>   ${c_branch}master${c_reset}${c_commit})${c_reset} B
Previous: Junio C HamanoNext: Junio C Hamano
Message 15 of 23 in “Should "git log --decorate" indicate whether the HEAD is detached?”
  1. Julien CretelFeb 16, 2015
  2. Junio C HamanoFeb 16, 2015
  3. Julien CretelFeb 16, 2015
  4. Michael J GruberFeb 18, 2015
  5. log: decorate detached HEAD differentlyMichael J Gruber, Feb 18, 2015
  6. Junio C HamanoFeb 18, 2015
  7. Michael J GruberFeb 18, 2015
  8. Junio C HamanoFeb 18, 2015
  9. Michael J GruberFeb 19, 2015
  10. Julien CretelFeb 19, 2015
  11. Junio C HamanoFeb 20, 2015
  12. log: decorate detached HEAD differentlyMichael J Gruber, Mar 6, 2015
  13. Michael J GruberMar 6, 2015
  14. Junio C HamanoMar 6, 2015
  15. Michael J GruberMar 9, 2015
  16. Junio C HamanoMar 10, 2015
  17. Michael J GruberMar 10, 2015
  18. 0/2 log decorations for HEADMichael J Gruber, Mar 10, 2015
  19. Junio C HamanoMar 10, 2015
  20. Michael J GruberMar 11, 2015
  21. Julien CretelMar 23, 2015
  22. 1/2 log-tree: properly reset colorsMichael J Gruber, Mar 10, 2015
  23. 2/2 log: decorate HEAD with branch nameMichael J Gruber, Mar 10, 2015

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.