{"thread":{"id":"24859","subject":"Does anyone use git-notes?","startedAt":"2010-08-25T18:15:31Z","lastAt":"2010-08-26T13:09:03Z","messageCount":9,"participants":["Scott Chacon","Joshua Jensen","Thomas Rast","Junio C Hamano","Tor Arntsen","Michael J Gruber","Jon Seymour","Will Palmer"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"148979","messageId":"AANLkTin=VXp2BU0vhTLUy6MpJ7spXRs1dZC1wygoN6T-@mail.gmail.com","threadId":"24859","inReplyTo":null,"subject":"Does anyone use git-notes?","fromName":"Scott Chacon","fromEmail":"schacon@gmail.com","sentAt":"2010-08-25T18:15:31Z","receivedAt":"2010-08-25T18:15:31Z","isPatch":false,"sender":{"key":"schacon@gmail.com","avatar":"https://gravatar.com/avatar/9b13a8a078e1dcf8588c4eea9554445d51ebed6c41b51f56f4d96738130b05c6?d=mp&s=160"},"body":"I would like to write a post on how to use them, but I'm a bit\nconfused as to how people actually use them on a day to day basis. I\nappears to me in trying to work out a flow for them that the lack of\nan ability to merge them makes them very difficult to use for anything\npractical. Can someone share with me how they use them and what the\ncycle is?\n\nThanks,\nScott\n"},{"id":"148983","messageId":"4C756395.6020103@workspacewhiz.com","threadId":"24859","inReplyTo":"AANLkTin=VXp2BU0vhTLUy6MpJ7spXRs1dZC1wygoN6T-@mail.gmail.com","subject":"Re: Does anyone use git-notes?","fromName":"Joshua Jensen","fromEmail":"jjensen@workspacewhiz.com","sentAt":"2010-08-25T18:40:21Z","receivedAt":"2010-08-25T18:40:21Z","isPatch":false,"sender":{"key":"jjensen@workspacewhiz.com","avatar":"https://avatars.githubusercontent.com/u/111687?v=4"},"body":" ----- Original Message -----\nFrom: Scott Chacon\nDate: 8/25/2010 12:15 PM\n> I would like to write a post on how to use them, but I'm a bit\n> confused as to how people actually use them on a day to day basis. I\n> appears to me in trying to work out a flow for them that the lack of\n> an ability to merge them makes them very difficult to use for anything\n> practical. Can someone share with me how they use them and what the\n> cycle is?\nI do. I use them to automatically store a matching Perforce revision \nnumber for a given Git commit. Only the server assigns them due to the \nmerging issues. I also change the ref, so they read as p4notes.\n\nIt irks me, though, that they show in the gitk --all view. ARGH!\n\nJosh\n"},{"id":"148984","messageId":"201008252052.37524.trast@student.ethz.ch","threadId":"24859","inReplyTo":"AANLkTin=VXp2BU0vhTLUy6MpJ7spXRs1dZC1wygoN6T-@mail.gmail.com","subject":"Re: Does anyone use git-notes?","fromName":"Thomas Rast","fromEmail":"trast@student.ethz.ch","sentAt":"2010-08-25T18:52:37Z","receivedAt":"2010-08-25T18:52:37Z","isPatch":false,"sender":{"key":"tr@thomasrast.ch","avatar":"https://avatars.githubusercontent.com/u/153510?v=4"},"body":"Scott Chacon wrote:\n> I would like to write a post on how to use them, but I'm a bit\n> confused as to how people actually use them on a day to day basis. I\n> appears to me in trying to work out a flow for them that the lack of\n> an ability to merge them makes them very difficult to use for anything\n> practical. Can someone share with me how they use them and what the\n> cycle is?\n\nI run a cronjob that downloads mail from gmane and fetches git.git,\nthen attempts to correlate mail with commits. The results are at\n\n git://repo.or.cz/git/trast.git notes/terse notes/full\n\nI have previously posted about this at e.g.\n\n http://mid.gmane.org/200902091508.11460.trast@student.ethz.ch\n http://mid.gmane.org/201003042321.36240.trast@student.ethz.ch\n\nthough I should point out that it no longer tries to apply the patches\nas outlined in the first post; this was simply way too expensive.\n\n\nI also use it when heavily editing a patch series to tack little\nreminders on my fixup patches. I have\n\n $ git config alias.fixup\n !sh -c 'r=$1; git commit -m\"fixup! $(git log -1 --pretty=%s $r)\"' -\n\nso I usually do\n\n # hack\n git add -p\n git fixup HEAD~3\n git notes add -m 'fix foo'\n\nwhich combined with notes.rewriteRef=refs/notes/* (and\nnotes.rewriteMode left at the default of 'concatenate') means that I\nend up having a little list of reminders what changed since the last\nrevisions. I then simply clear them out before starting a new round.\n\n-- \nThomas Rast\ntrast@{inf,student}.ethz.ch\n"},{"id":"149015","messageId":"7vhbiipb5z.fsf@alter.siamese.dyndns.org","threadId":"24859","inReplyTo":"AANLkTin=VXp2BU0vhTLUy6MpJ7spXRs1dZC1wygoN6T-@mail.gmail.com","subject":"Re: Does anyone use git-notes?","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2010-08-25T22:42:00Z","receivedAt":"2010-08-25T22:42:00Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Scott Chacon writes:\n\n> I would like to write a post on how to use them, but I'm a bit\n> confused as to how people actually use them on a day to day basis. I\n> appears to me in trying to work out a flow for them that the lack of\n> an ability to merge them makes them very difficult to use for anything\n> practical. Can someone share with me how they use them and what the\n> cycle is?\n\nI have a custom post-applypatch hook (see my \"todo\" branch) enabled and\nthen use the amlook script (again, see my \"todo\" branch) script to inspect\nthe corresponding notes tree.\n\nAfter applying a received patch e-mail, the result is annotated with\nenough information to identify which message it came from by the hook.\nWhen I am scouring the mailing list backlog to see if I have missed\nsomething interesting (sometimes I find interest in a topic that I thought\ntotally uninteresting earlier), the amlook script is used to see if the\npatch has been already applied.\n\nLooking through millions of notes this way won't scale (iow, amlook is a\nbad example of using this feature, as the notes tree is used as a database\nindex in the wrong direction), by the way, so you may probably not want to\nuse it as a good example.\n"},{"id":"149016","messageId":"7vd3t6pb3v.fsf@alter.siamese.dyndns.org","threadId":"24859","inReplyTo":"AANLkTin=VXp2BU0vhTLUy6MpJ7spXRs1dZC1wygoN6T-@mail.gmail.com","subject":"Re: Does anyone use git-notes?","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2010-08-25T22:43:16Z","receivedAt":"2010-08-25T22:43:16Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Scott Chacon writes:\n\n> I would like to write a post on how to use them, but I'm a bit\n> confused as to how people actually use them on a day to day basis. I\n> appears to me in trying to work out a flow for them that the lack of\n> an ability to merge them makes them very difficult to use for anything\n> practical. Can someone share with me how they use them and what the\n> cycle is?\n\nI have a custom post-applypatch hook (see my \"todo\" branch) enabled and\nthen use the amlook script (again, see my \"todo\" branch) to inspect the\nnotes the hook left.\n\nAfter applying a received patch e-mail, the result is annotated with\nenough information to identify which message it came from by the hook (I\nprobably should add more information to the notes, but never got around to\nit). When I am scouring the mailing list backlog to see if I have missed\nsomething interesting (sometimes I find interest in a topic that I thought\ntotally uninteresting earlier), the amlook script is used to see if the\npatch has already been applied, and if so to which branch.\n\nLooking through millions of notes this way won't scale (iow, amlook is a\nbad example of using this feature, as the notes tree is used as a database\nindex in the wrong direction), by the way, so you may probably not want to\nuse it as a good example.\n"},{"id":"149053","messageId":"AANLkTim01==of5ce07F4MFVazevNiRQLBMv38ferSgKB@mail.gmail.com","threadId":"24859","inReplyTo":"AANLkTin=VXp2BU0vhTLUy6MpJ7spXRs1dZC1wygoN6T-@mail.gmail.com","subject":"Re: Does anyone use git-notes?","fromName":"Tor Arntsen","fromEmail":"tor@spacetec.no","sentAt":"2010-08-26T07:56:55Z","receivedAt":"2010-08-26T07:56:55Z","isPatch":false,"sender":{"key":"tor@spacetec.no","avatar":null},"body":"On Wed, Aug 25, 2010 at 20:15, Scott Chacon wrote:\n> I would like to write a post on how to use them, but I'm a bit\n> confused as to how people actually use them on a day to day basis.  I\n> appears to me in trying to work out a flow for them that the lack of\n> an ability to merge them makes them very difficult to use for anything\n> practical.  Can someone share with me how they use them and what the\n> cycle is?\n\nI use Notes in a very simplistic way. For example, with an emulator\nI'm writing I have two or three ways of using git-notes:\n1: I commit fixes and changes with a commit message describing the\nfix. Later I may find out that the fix made a couple more programs of\nthe set I have run in the emulator, so I add a note to the commit\nsaying 'This change makes X and Y work'.\n2: I add test cases to the instruction validator I wrote for the\nemulator, if the test currently fails I say so in the commit message.\nAt some later point I may commit a fix that lets the test pass, then I\ngo back to the original commit message (which said the test currently\nfailed) and add a note saying 'Fixed by [commit] nnnnnnn'.\n3: Occasionally I just use notes as a reminder. If a commit adds a new\nfeature I may later (after using the feature) add a 'todo'-note about\nwhat improvements I should add.\n\nOne use case I have thought of for the company case is to add notes to\na release commit with information that wasn't or couldn't be added at\nthe time of the commit, e.g. a list of problem reports closed by the\nrelease. But I haven't actually figured out how I can get Notes\ntransferred over a pull yet.. although I haven't tried since 1.7.0.\n\n-Tor\n"},{"id":"149055","messageId":"4C762137.1090801@drmicha.warpmail.net","threadId":"24859","inReplyTo":"AANLkTin=VXp2BU0vhTLUy6MpJ7spXRs1dZC1wygoN6T-@mail.gmail.com","subject":"Re: Does anyone use git-notes?","fromName":"Michael J Gruber","fromEmail":"git@drmicha.warpmail.net","sentAt":"2010-08-26T08:09:27Z","receivedAt":"2010-08-26T08:09:27Z","isPatch":false,"sender":{"key":"git@grubix.eu","avatar":"https://avatars.githubusercontent.com/u/233215?v=4"},"body":"Scott Chacon venit, vidit, dixit 25.08.2010 20:15:\n> I would like to write a post on how to use them, but I'm a bit\n> confused as to how people actually use them on a day to day basis. I\n> appears to me in trying to work out a flow for them that the lack of\n> an ability to merge them makes them very difficult to use for anything\n> practical. Can someone share with me how they use them and what the\n> cycle is?\n\nI use it to store the patch comments (the part that goes after the\n\"---\", before the diff) along with my commits so that I have them in my\ngit.git tree, not only in my mbox. This makes it also easier to redo a\npatch and keep the comment when regenerating the patch e-mail with\nformat-patch. (I don't have a good solution for the cover letter yet.)\n\nMichael\n"},{"id":"149056","messageId":"AANLkTi=jNPtvpO_gVKyS0U_0qRLtKZ84p=B+8zStxvkX@mail.gmail.com","threadId":"24859","inReplyTo":"AANLkTin=VXp2BU0vhTLUy6MpJ7spXRs1dZC1wygoN6T-@mail.gmail.com","subject":"Re: Does anyone use git-notes?","fromName":"Jon Seymour","fromEmail":"jon.seymour@gmail.com","sentAt":"2010-08-26T08:26:27Z","receivedAt":"2010-08-26T08:26:27Z","isPatch":false,"sender":{"key":"jon.seymour@gmail.com","avatar":"https://avatars.githubusercontent.com/u/207131?v=4"},"body":"On Thu, Aug 26, 2010 at 4:15 AM, Scott Chacon wrote:\n> I would like to write a post on how to use them, but I'm a bit\n> confused as to how people actually use them on a day to day basis.  I\n> appears to me in trying to work out a flow for them that the lack of\n> an ability to merge them makes them very difficult to use for anything\n> practical.  Can someone share with me how they use them and what the\n> cycle is?\n>\n\nI use them to store test execution output.\n\nBy post-processing, then diffing such notes, I can work out what was\nregressed or fixed between two commits.\n\njon.\n"},{"id":"149063","messageId":"1282828143.6120.3.camel@wpalmer.simply-domain","threadId":"24859","inReplyTo":"4C762137.1090801@drmicha.warpmail.net","subject":"Re: Does anyone use git-notes?","fromName":"Will Palmer","fromEmail":"wmpalmer@gmail.com","sentAt":"2010-08-26T13:09:03Z","receivedAt":"2010-08-26T13:09:03Z","isPatch":false,"sender":{"key":"wmpalmer@gmail.com","avatar":"https://avatars.githubusercontent.com/u/357044?v=4"},"body":"On Thu, 2010-08-26 at 10:09 +0200, Michael J Gruber wrote:\n> I use it to store the patch comments (the part that goes after the\n> \"---\", before the diff) along with my commits so that I have them in my\n> git.git tree, not only in my mbox. This makes it also easier to redo a\n> patch and keep the comment when regenerating the patch e-mail with\n> format-patch. (I don't have a good solution for the cover letter yet.)\n> \n> Michael\n\nNot to stray off-topic, but I use tags for the cover letter eg:\nrefs/tags/patches/short-description/v[N]\n\nI hadn't thought of using git-notes for the per-patch comments, here I\nwas with the opposite problem (A straighforward way to keep track of\ncover-letters, but no good way to keep track of the per-patch comments)\n"}]}