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

Re: Refactoring the tag object; Introducing soft references (softrefs); Git 'notes' (take 2)

From
Steven Grimm <koreth@midwinter.com>
Date
Jun 9, 2007, 22:57 UTC
Message-ID
<466B305A.5080802@midwinter.com>
In-Reply-To
<200706040251.05286.johan@herland.net>
(Resending this in plaintext; sorry to those who got it twice.)

Being able to specify relationships between commits after the fact seems like a very useful facility.

Does it make sense to have type information to record what the relationship between two objects means? Without that, it seems like it'll be hard to build much of a tool set on top of this feature, since no two tools that made use of it could unambiguously query just their own softrefs.

A few use cases for relationships-after-the-fact come to mind in addition to the one the patch itself mentions:

A facility like this could replace the info/grafts file, or at least provide another way to turn a regular commit into a merge commit. Just put a "manually specified merge parent" ref between the target revision and the one you want git to think you've merged from. That would scale a lot better than info/grafts does, I suspect, if only by virtue of being O(log n) searchable thanks to the sorting.

One could easily imagine recording a "cherry picked" softref, which could, e.g., be the rebase machinery to skip over an already-applied revision. IMO the lack of any tool-readable history about cherry picking -- which is, after all, a sort of merge, at least conceptually -- is a shortcoming in present-day git. (Not a huge one, but if nothing else it'd be great to see cherry picking represented in, e.g., the gitk history display.)

It might be possible to annotate rebases to make pulling from rebased branches less troublesome. If you have

A--B--C--D
    \
     -E--F--G

and you rebase E onto D, a "rebased from" softref could be recorded between E and E':

A--B--C--D
    \     \
     -E....E'--F'--G'

Then a pulling client could potentially use that information to cleanly replay the rebase operation to keep its history straight. Perhaps if you could record historical rebases like that, you could do away with the current gotchas involving rebasing shared repositories. One negative side effect would be that you'd end up needing to keep E around where before you'd have been able to throw it away, but it should delta compress well, and you can, I think, still prune revisions F and G in the above picture. Or maybe it's enough to just keep E's SHA1 around without actually retaining its contents.

But in any event, this seems like the start of a useful new set of capabilities for git.

-Steve
Previous: Jakub NarebskiNext: Johan Herland
Message 48 of 52 in “Refactoring the tag object; Introducing soft references (softrefs); Git 'notes' (take 2)”
  1. Johan HerlandJun 4, 2007
  2. 0/6 Refactor the tag objectJohan Herland, Jun 4, 2007
  3. 1/6 Refactor git tag objects; make "tag" header optional; introduce new optional "keywords" headerJohan Herland, Jun 4, 2007
  4. Matthias LederhoferJun 4, 2007
  5. Johan HerlandJun 4, 2007
  6. 2/6 git-show: When showing tag objects with no tag name, show tag object's SHA1 instead of an empty stringJohan Herland, Jun 4, 2007
  7. 3/6 git-fsck: Do thorough verification of tag objects.Johan Herland, Jun 4, 2007
  8. Matthias LederhoferJun 4, 2007
  9. Johan HerlandJun 4, 2007
  10. Junio C HamanoJun 6, 2007
  11. 3/6 git-fsck: Do thorough verification of tag objects.Johan Herland, Jun 6, 2007
  12. Junio C HamanoJun 6, 2007
  13. Junio C HamanoJun 6, 2007
  14. Johan HerlandJun 6, 2007
  15. Junio C HamanoJun 6, 2007
  16. 4/6 Documentation/git-mktag: Document the changes in tag object structureJohan Herland, Jun 4, 2007
  17. 5/6 git-mktag tests: Fix and expand the mktag tests according to the new tag object structureJohan Herland, Jun 4, 2007
  18. 6/6 Add fsck_verify_ref_to_tag_object() to verify that refname matches name stored in tag objectJohan Herland, Jun 4, 2007
  19. Junio C HamanoJun 4, 2007
  20. Fix bug in tag parsing when thorough verification was in effectJohan Herland, Jun 7, 2007
  21. 0/7 Introduce soft references (softrefs)Johan Herland, Jun 9, 2007
  22. 1/7 Softrefs: Add softrefs header file with API documentationJohan Herland, Jun 9, 2007
  23. Johannes SchindelinJun 10, 2007
  24. Junio C HamanoJun 10, 2007
  25. Johannes SchindelinJun 10, 2007
  26. Johan HerlandJun 10, 2007
  27. Jakub NarebskiJun 10, 2007
  28. Teach git-gc to merge unsorted softrefsJohan Herland, Jun 10, 2007
  29. 2/7 Softrefs: Add implementation of softrefs APIJohan Herland, Jun 9, 2007
  30. 3/7 Softrefs: Add git-softref, a builtin command for adding, listing and administering softrefsJohan Herland, Jun 9, 2007
  31. 4/7 Softrefs: Add manual page documenting git-softref and softrefs subsystem in generalJohan Herland, Jun 9, 2007
  32. 5/7 Softrefs: Add testcases for basic softrefs behaviourJohan Herland, Jun 9, 2007
  33. 6/7 Softrefs: Administrivia associated with softrefs subsystem and git-softref builtinJohan Herland, Jun 9, 2007
  34. 7/7 Teach git-mktag to register softrefs for all tag objectsJohan Herland, Jun 9, 2007
  35. Change softrefs file format from text (82 bytes per entry) to binary (40 bytes per entry)Johan Herland, Jun 9, 2007
  36. Johannes SchindelinJun 10, 2007
  37. Junio C HamanoJun 10, 2007
  38. Johannes SchindelinJun 10, 2007
  39. Johan HerlandJun 10, 2007
  40. Comment on weak refsJunio C Hamano, Jun 9, 2007
  41. Johan HerlandJun 10, 2007
  42. Johannes SchindelinJun 10, 2007
  43. Johan HerlandJun 10, 2007
  44. Pierre HabouzitJun 10, 2007
  45. Pierre HabouzitJun 10, 2007
  46. Pierre HabouzitJun 10, 2007
  47. Jakub NarebskiJun 10, 2007
  48. Steven GrimmJun 9, 2007
  49. Johan HerlandJun 9, 2007
  50. Pierre HabouzitJun 10, 2007
  51. Johan HerlandJun 10, 2007
  52. Steven GrimmJun 10, 2007

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.