{"thread":{"id":"1734","subject":"git/cogito suggestion: tags with descriptions","startedAt":"2005-09-05T18:45:51Z","lastAt":"2006-04-08T02:35:59Z","messageCount":7,"participants":["Zack Brown","Junio C Hamano","A Large Angry SCM","Petr Baudis"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"8105","messageId":"20050905184551.GA14720@tumblerings.org","threadId":"1734","inReplyTo":null,"subject":"git/cogito suggestion: tags with descriptions","fromName":"Zack Brown","fromEmail":"zbrown@tumblerings.org","sentAt":"2005-09-05T18:45:51Z","receivedAt":"2005-09-05T18:45:51Z","isPatch":false,"sender":{"key":"zbrown@tumblerings.org","avatar":null},"body":"Hi folks,\n\nI've been using git on my new projects, and loving it!\n\nWhen I use tags, I typically will use a name like \"0.3_basic_description\"\nand \"0.4_full_outline\", because I want to know not only what version number I'm\nconsidering, but also the reason why I chose to tag that particular version.\n\nThe problem is that when I want to seek to a particular version to see where my\nhead was at, I have to do all that typing, or cut and paste the full text of the\ntag, which is not terribly annoying, but it seems unnecessary. The version\nnumber is the unique ID I'm really interested in, and the descriptive part of\nthe name is just extra, so I know what I'm talking about.\n\nIt would be great if tags also allowed a brief description to go along with\nthem, that would show up in cg-tag-ls. Then I could seek to a tag that's just\nan easy-to-type version number, and still have an idea of what's significant\nabout that version because of the descriptive text.\n\nBe well,\nZack\n\n-- \nZack Brown\n"},{"id":"8107","messageId":"7vd5nn49uz.fsf@assigned-by-dhcp.cox.net","threadId":"1734","inReplyTo":"20050905184551.GA14720@tumblerings.org","subject":"Re: git/cogito suggestion: tags with descriptions","fromName":"Junio C Hamano","fromEmail":"junkio@cox.net","sentAt":"2005-09-05T19:01:40Z","receivedAt":"2005-09-05T19:01:40Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Zack Brown writes:\n\n> It would be great if tags also allowed a brief description to go along with\n> them, that would show up in cg-tag-ls. Then I could seek to a tag that's just\n> an easy-to-type version number, and still have an idea of what's significant\n> about that version because of the descriptive text.\n\nWould 'git tag -a' work for you?\n\n: siamese; git tag -a -m 'This is to just demonstrate.' test-for-brown\n: siamese; git cat-file tag test-for-brown\nobject 0516de30e8bdd26086e2a3edd3375981fd0c34d6\ntype commit\ntag test-for-brown\ntagger Junio C Hamano 1125946805 -0700\n\nThis is to just demonstrate.\n: siamese; \n\nBTW, when will the next issue of GIT traffic appear ;-)?\n"},{"id":"8113","messageId":"20050905212431.GB14720@tumblerings.org","threadId":"1734","inReplyTo":"7vd5nn49uz.fsf@assigned-by-dhcp.cox.net","subject":"Re: git/cogito suggestion: tags with descriptions","fromName":"Zack Brown","fromEmail":"zbrown@tumblerings.org","sentAt":"2005-09-05T21:24:31Z","receivedAt":"2005-09-05T21:24:31Z","isPatch":false,"sender":{"key":"zbrown@tumblerings.org","avatar":null},"body":"Hi Junio!\n\nOn Mon, Sep 05, 2005 at 12:01:40PM -0700, Junio C Hamano wrote:\n> Zack Brown writes:\n> \n> > It would be great if tags also allowed a brief description to go along with\n> > them, that would show up in cg-tag-ls. Then I could seek to a tag that's just\n> > an easy-to-type version number, and still have an idea of what's significant\n> > about that version because of the descriptive text.\n> \n> Would 'git tag -a' work for you?\n> \n> : siamese; git tag -a -m 'This is to just demonstrate.' test-for-brown\n> : siamese; git cat-file tag test-for-brown\n> object 0516de30e8bdd26086e2a3edd3375981fd0c34d6\n> type commit\n> tag test-for-brown\n> tagger Junio C Hamano 1125946805 -0700\n> \n> This is to just demonstrate.\n> : siamese; \n\nI'm not sure. I'm not as familiar with the low-level git commands as I am with\ncogito. But cogito has a -d option for giving a tag description. I guess what\nwould be closest to what I was thinking about would be this:\n\n$ cg-tag -d \"First draft, everything in place.\" 0.3 7540e503b9b9c1b03e44ee7fd700c844b2a02224\n$ cg-tag-ls\n0.1 Initial idea complete f953b71b21a0bea682c2bed91362f2dce2cc204f\n0.3 First draft, everything in place. 7540e503b9b9c1b03e44ee7fd700c844b2a02224 \n$\n\nor something like that. Currently when I do the above cg-tag command,\na subsequent cg-tag-ls gives just:\n\n$ cg-tag-ls\n0.1 f953b71b21a0bea682c2bed91362f2dce2cc204f\n0.3 7540e503b9b9c1b03e44ee7fd700c844b2a02224\n\nIn fact, I probably wouldn't even be interested in seeing the actual hash key\nunless I gave a special flag, maybe -f (for \"full\"):\n\n$ cg-tag-ls\n0.1 Initial idea complete\n0.3 First draft, everything in place.\n$ cg-tag-ls -f\n0.1 Initial idea complete f953b71b21a0bea682c2bed91362f2dce2cc204f\n0.3 First draft, everything in place. 7540e503b9b9c1b03e44ee7fd700c844b2a02224\n$\n\n> \n> BTW, when will the next issue of GIT traffic appear ;-)?\n\nHonestly, I don't know. I seem to be having my hands full just trying to\nkeep Kernel Traffic up-to-date (just caught up today, finally). I really did\nthe first Git Traffic to kind of spread the word about how mind-blowing the\nwhole git development process was.\n\nBut whether I'll keep on doing it, I don't know. Between Kernel Traffic,\nmy day job, and a few non-Linux projects, I may have my hands full.\n\nOn the other hand, if someone wanted to volunteer to write Git Traffic, I'd\nbe happy to help them get started. I don't mean you, but perhaps a regular\nreader of this list would be interested. It seems like there's at least some\ninterest in seeing it continue. :-)\n\nBe well,\nZack\n\n> \n> \n> -\n> To unsubscribe from this list: send the line \"unsubscribe git\" in\n> the body of a message to majordomo@vger.kernel.org\n> More majordomo info at http://vger.kernel.org/majordomo-info.html\n\n-- \nZack Brown\n"},{"id":"8181","messageId":"7vu0gw1htd.fsf@assigned-by-dhcp.cox.net","threadId":"1734","inReplyTo":"20050905184551.GA14720@tumblerings.org","subject":"Re: git/cogito suggestion: tags with descriptions","fromName":"Junio C Hamano","fromEmail":"junkio@cox.net","sentAt":"2005-09-08T01:14:54Z","receivedAt":"2005-09-08T01:14:54Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Zack Brown writes:\n\n> It would be great if tags also allowed a brief description to go along with\n> them, that would show up in cg-tag-ls. Then I could seek to a tag that's just\n> an easy-to-type version number, and still have an idea of what's significant\n> about that version because of the descriptive text.\n\nDo people crave for 'git tag' showing list of tags with their\nbrief descriptions just like 'git branch' does?\n \n"},{"id":"8186","messageId":"431F9DB3.5090204@gmail.com","threadId":"1734","inReplyTo":"7vu0gw1htd.fsf@assigned-by-dhcp.cox.net","subject":"Re: git/cogito suggestion: tags with descriptions","fromName":"A Large Angry SCM","fromEmail":"gitzilla@gmail.com","sentAt":"2005-09-08T02:10:59Z","receivedAt":"2005-09-08T02:10:59Z","isPatch":false,"sender":{"key":"gitzilla@gmail.com","avatar":"https://gravatar.com/avatar/354625c442439908ff3dd99757dee330e29e9df7847472384faf7a00add247fb?d=mp&s=160"},"body":"Junio C Hamano wrote:\n> Zack Brown writes:\n> \n>>It would be great if tags also allowed a brief description to go along with\n>>them, that would show up in cg-tag-ls. Then I could seek to a tag that's just\n>>an easy-to-type version number, and still have an idea of what's significant\n>>about that version because of the descriptive text.\n> \n> Do people crave for 'git tag' showing list of tags with their\n> brief descriptions just like 'git branch' does?\n\nSort of like what gitweb does now?\n"},{"id":"8349","messageId":"20050912010051.GJ15630@pasky.or.cz","threadId":"1734","inReplyTo":"20050905212431.GB14720@tumblerings.org","subject":"Re: git/cogito suggestion: tags with descriptions","fromName":"Petr Baudis","fromEmail":"pasky@suse.cz","sentAt":"2005-09-12T01:00:51Z","receivedAt":"2005-09-12T01:00:51Z","isPatch":false,"sender":{"key":"pasky@ucw.cz","avatar":"https://avatars.githubusercontent.com/u/18439?v=4"},"body":"Dear diary, on Mon, Sep 05, 2005 at 11:24:31PM CEST, I got a letter\nwhere Zack Brown told me that...\n> I'm not sure. I'm not as familiar with the low-level git commands as I am with\n> cogito. But cogito has a -d option for giving a tag description. I guess what\n> would be closest to what I was thinking about would be this:\n> \n> $ cg-tag -d \"First draft, everything in place.\" 0.3 7540e503b9b9c1b03e44ee7fd700c844b2a02224\n> $ cg-tag-ls\n> 0.1 Initial idea complete f953b71b21a0bea682c2bed91362f2dce2cc204f\n> 0.3 First draft, everything in place. 7540e503b9b9c1b03e44ee7fd700c844b2a02224 \n> $\n> \n> or something like that. Currently when I do the above cg-tag command,\n> a subsequent cg-tag-ls gives just:\n> \n> $ cg-tag-ls\n> 0.1 f953b71b21a0bea682c2bed91362f2dce2cc204f\n> 0.3 7540e503b9b9c1b03e44ee7fd700c844b2a02224\n> \n> In fact, I probably wouldn't even be interested in seeing the actual hash key\n> unless I gave a special flag, maybe -f (for \"full\"):\n> \n> $ cg-tag-ls\n> 0.1 Initial idea complete\n> 0.3 First draft, everything in place.\n> $ cg-tag-ls -f\n> 0.1 Initial idea complete f953b71b21a0bea682c2bed91362f2dce2cc204f\n> 0.3 First draft, everything in place. 7540e503b9b9c1b03e44ee7fd700c844b2a02224\n\nThat's a nice idea (except that I'd prefer -l). I'll implement this\nafter cogito-0.14.\n\nThanks,\n\n-- \n\t\t\t\tPetr \"Pasky\" Baudis\nStuff: http://pasky.or.cz/\nIf you want the holes in your knowledge showing up try teaching\nsomeone. -- Alan Cox\n"},{"id":"18461","messageId":"20060408023559.GS27689@pasky.or.cz","threadId":"1734","inReplyTo":"20050912010051.GJ15630@pasky.or.cz","subject":"Re: git/cogito suggestion: tags with descriptions","fromName":"Petr Baudis","fromEmail":"pasky@suse.cz","sentAt":"2006-04-08T02:35:59Z","receivedAt":"2006-04-08T02:35:59Z","isPatch":false,"sender":{"key":"pasky@ucw.cz","avatar":"https://avatars.githubusercontent.com/u/18439?v=4"},"body":"Dear diary, on Mon, Sep 12, 2005 at 03:00:51AM CEST, I got a letter\nwhere Petr Baudis said that...\n> Dear diary, on Mon, Sep 05, 2005 at 11:24:31PM CEST, I got a letter\n> where Zack Brown told me that...\n> > I'm not sure. I'm not as familiar with the low-level git commands as I am with\n> > cogito. But cogito has a -d option for giving a tag description. I guess what\n> > would be closest to what I was thinking about would be this:\n> > \n> > $ cg-tag -d \"First draft, everything in place.\" 0.3 7540e503b9b9c1b03e44ee7fd700c844b2a02224\n> > $ cg-tag-ls\n> > 0.1 Initial idea complete f953b71b21a0bea682c2bed91362f2dce2cc204f\n> > 0.3 First draft, everything in place. 7540e503b9b9c1b03e44ee7fd700c844b2a02224 \n> > $\n> > \n> > or something like that. Currently when I do the above cg-tag command,\n> > a subsequent cg-tag-ls gives just:\n> > \n> > $ cg-tag-ls\n> > 0.1 f953b71b21a0bea682c2bed91362f2dce2cc204f\n> > 0.3 7540e503b9b9c1b03e44ee7fd700c844b2a02224\n> > \n> > In fact, I probably wouldn't even be interested in seeing the actual hash key\n> > unless I gave a special flag, maybe -f (for \"full\"):\n> > \n> > $ cg-tag-ls\n> > 0.1 Initial idea complete\n> > 0.3 First draft, everything in place.\n> > $ cg-tag-ls -f\n> > 0.1 Initial idea complete f953b71b21a0bea682c2bed91362f2dce2cc204f\n> > 0.3 First draft, everything in place. 7540e503b9b9c1b03e44ee7fd700c844b2a02224\n> \n> That's a nice idea (except that I'd prefer -l). I'll implement this\n> after cogito-0.14.\n\nSo, I did. ;-) (In the master branch now.) The format is slightly\ndifferent from the proposed one:\n\n\tS cogito-0.16rc2 7766e3ba0664\n\tS cogito-0.17 51392f2dd82a Poetic cogito-0.17.\n\tS cogito-0.17rc1 7cb4d8972d5b Behold, cogito-0.17rc1! Plenty new features and cool stuff.\n\t% cogito-0.8 f9f0459b5b39\n\t% cogito-0.9 cc5517b4ea41\n\t test 05862786175d\n\nObject IDs are still shown, but abbreviated so they shouldn't get in the\nway too much; the full first line is shown in the list output,\nuntrimmed. The initial flag column denotes signed tags by 'S', \"direct\ntags\" (not pointing to a tag object) by '%' and broken tags by '!'.\n\nP.S.: Also, cg-tag received a lot of improvements in the last two days.\nNow features the same cool editor as cg-commit (but only if ran with\n-e), -d was renamed to -m (but will stay aliased for quite some time),\ncg-tag now also accepts multiple -m options for creating multi-paragraph\ndescriptions from the commandline, and bunch of other minor stuff was\nimplemented.\n\nThanks for the idea,\n\n-- \n\t\t\t\tPetr \"Pasky\" Baudis\nStuff: http://pasky.or.cz/\nRight now I am having amnesia and deja-vu at the same time. I think\nI have forgotten this before.\n"}]}