{"thread":{"id":"16874","subject":"[PATCH] gitrepository-layout: No longer first two letters. Also add \"down\".","startedAt":"2008-12-26T16:43:07Z","lastAt":"2008-12-29T08:52:52Z","messageCount":19,"participants":["jidanni@jidanni.org","Junio C Hamano","Nanako Shiraishi","Boyd Stephen Smith Jr.","Sverre Rabbelier"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"98736","messageId":"E1LGFoE-0001EZ-0F@jidanni.org","threadId":"16874","inReplyTo":null,"subject":"[PATCH] gitrepository-layout: No longer first two letters. Also add \"down\".","fromName":"","fromEmail":"jidanni@jidanni.org","sentAt":"2008-12-26T16:43:07Z","receivedAt":"2008-12-26T16:43:07Z","isPatch":true,"sender":{"key":"jidanni@jidanni.org","avatar":"https://gravatar.com/avatar/36568d4af4c8d3e71627ef3b8c8d00e39065b12f29676cccd38ced75e68fa2a6?d=mp&s=160"},"body":"\nSigned-off-by: jidanni \n\ndiff --git a/gitrepository-layout.txt b/gitrepository-layout.txt\nindex 03c52ff..81103fc 100644\n--- a/gitrepository-layout.txt\n+++ b/gitrepository-layout.txt\n@@ -46,6 +46,4 @@ objects/[0-9a-f][0-9a-f]::\n-\tTraditionally, each object is stored in its own file.\n-\tThey are split into 256 subdirectories using the first\n-\ttwo letters from its object name to keep the number of\n-\tdirectory entries `objects` directory itself needs to\n-\thold. Objects found here are often called 'unpacked'\n-\t(or 'loose') objects.\n+\tTraditionally, each object is stored in its own file. They are\n+\tsplit into 256 subdirectories to keep the number of directory\n+\tentries `objects` directory itself needs to hold down. Objects\n+\tfound here are often called 'unpacked' (or 'loose') objects.\n-- \n1.5.6.5\n"},{"id":"98737","messageId":"7veizuog2z.fsf@gitster.siamese.dyndns.org","threadId":"16874","inReplyTo":"E1LGFoE-0001EZ-0F@jidanni.org","subject":"Re: [PATCH] gitrepository-layout: No longer first two letters. Also add \"down\".","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2008-12-26T20:07:48Z","receivedAt":"2008-12-26T20:07:48Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"jidanni@jidanni.org writes:\n\n> Signed-off-by: jidanni \n\nFirst off, when I tried to respond to your message, I got this:\n\n Cc: undisclosed-recipients:;\n\nwhich I had to edit it to point at the list.\n\nI think you did \"Bcc: git@vger.kernel.org\" without any explicit recipient;\nplease don't. It wastes everybody's time.\n\nSecond, please realize that the Subject: line is one of the most important\npiece of information in your patch submission. It is used as the summary\nof what this change is about in the shortlog output. 2 months from now,\ndo you think anybody (other than you) can guess what the \"first two\nletters\" is about among 400 other changes?\n\nI would have preferred the Subject: and the commit log message like this\nfor this patch:\n\n Subject: [PATCH] Fix description of objects/??/ directories in the repository-layout doc\n\n These fan-out directories are no longer first two letters. Also fix\n a sentence that meant to say \"keep something down\" but forgot \"down\".\n\nThat is, summarize what this patch is about on Subject: line, and explain\nwhy the change is a good idea (in other words, why the current one is bad)\nin the commit log message.\n\nI agree with the \"down\" fix; thanks for catching this grammatical and\nsemantic error.\n\nI however do not understand the reason behind the former \"two letters\"\nchange.\n\nWhen creating a new object, the filename to hold it when its object name\nis e.g. 92b35d66d0e335771c2e4a4a79f95adb844b1f91 (that's a tag object for\nv1.6.1 if anybody cares) is computed by taking its first two letters \"92\"\nand using that to choose \".git/object/92\" as the containing \"fan-out\"\ndirectory. The file in that directory is named using the remainder of the\nobject name.\n\nThe entry in the repository layout document explains what the directories\nwith two-letter names you find in objects/ directory are, and I do not see\na reason why you want to say \"no longer first two letters\". Their names\nstill are, and very likely continue to be, two-letter long.\n\nMaybe I misunderstood what you wanted to say by \"no longer...\". Did you\nmean (unlike the sample commit log message I suggested above):\n\n Subject: [PATCH] Fix description of objects/??/ directories in the repository-layout doc\n\n Do not say first two letters anymore. Also fix a sentence that meant\n to say \"keep something down\" but forgot \"down\".\n\nIf that is the case, please justify why you think it is better not to say\n\"first two letters\" the documentation.\n\nThanks.\n"},{"id":"98738","messageId":"87skoau1su.fsf@jidanni.org","threadId":"16874","inReplyTo":"7veizuog2z.fsf@gitster.siamese.dyndns.org","subject":"Re: [PATCH] gitrepository-layout: No longer first two letters. Also add \"down\".","fromName":"","fromEmail":"jidanni@jidanni.org","sentAt":"2008-12-26T20:19:45Z","receivedAt":"2008-12-26T20:19:45Z","isPatch":true,"sender":{"key":"jidanni@jidanni.org","avatar":"https://gravatar.com/avatar/36568d4af4c8d3e71627ef3b8c8d00e39065b12f29676cccd38ced75e68fa2a6?d=mp&s=160"},"body":">>>>> \"JCH\" == Junio C Hamano writes:\n\nJCH> If that is the case, please justify why you think it is better not to say\nJCH> \"first two letters\" the documentation.\nOK, I saw\n$ ls 3d\n05a66c3..\n189066f..\nIf it were the first to letters, it would be\n$ ls 3d\n3d05a66c3..\n3d189066f..\nAh, you mean it snaps them off to form the directory name?! OK, please\nnote that.\n\nAs far as all your other points and messed up To:, OK, next time I will do better.\n"},{"id":"98740","messageId":"7vmyeilj3z.fsf@gitster.siamese.dyndns.org","threadId":"16874","inReplyTo":"87skoau1su.fsf@jidanni.org","subject":"Re: [PATCH] gitrepository-layout: No longer first two letters. Also add \"down\".","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2008-12-26T21:30:40Z","receivedAt":"2008-12-26T21:30:40Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"jidanni@jidanni.org writes:\n\n>>>>>> \"JCH\" == Junio C Hamano writes:\n>\n> JCH> If that is the case, please justify why you think it is better not to say\n> JCH> \"first two letters\" the documentation.\n> OK, I saw\n> $ ls 3d\n> 05a66c3..\n> 189066f..\n> If it were the first to letters, it would be\n> $ ls 3d\n> 3d05a66c3..\n> 3d189066f..\n> Ah, you mean it snaps them off to form the directory name?! OK, please\n> note that.\n\nIf you read the description again, you will notice that the entry explains\nwhat these directories are; it is not a description about the files in\nthese directories.\n\n> As far as all your other points and messed up To:, OK, next time I will do better.\n\nWhen sending the fixed-up patch, please send it in an applicable form. I\ndo not know how you stripped \"Documentation/\" from the front, but your\npatch was against {a,b}/gitrepository-layout.txt.\n\nThanks.\n"},{"id":"98745","messageId":"20081227070232.6117@nanako3.lavabit.com","threadId":"16874","inReplyTo":"E1LGFoE-0001EZ-0F@jidanni.org","subject":"Re: [PATCH] gitrepository-layout: No longer first two letters. Also add \"down\".","fromName":"Nanako Shiraishi","fromEmail":"nanako3@lavabit.com","sentAt":"2008-12-26T22:02:32Z","receivedAt":"2008-12-26T22:02:32Z","isPatch":true,"sender":{"key":"nanako3@lavabit.com","avatar":"https://gravatar.com/avatar/3777b9e201c5883a62b1a6fdf7c53f2d712d1d80989146063ea861e33aad72a8?d=mp&s=160"},"body":"Quoting jidanni@jidanni.org:\n\n> Signed-off-by: jidanni \n\nDidn't you mean \"Signed-off-by: 積丹尼 \"?\n\n-- \nNanako Shiraishi\nhttp://ivory.ap.teacup.com/nanako3/\n"},{"id":"98747","messageId":"87tz8qsgn2.fsf_-_@jidanni.org","threadId":"16874","inReplyTo":"20081227070232.6117@nanako3.lavabit.com","subject":"commit.template","fromName":"","fromEmail":"jidanni@jidanni.org","sentAt":"2008-12-26T22:42:09Z","receivedAt":"2008-12-26T22:42:09Z","isPatch":false,"sender":{"key":"jidanni@jidanni.org","avatar":"https://gravatar.com/avatar/36568d4af4c8d3e71627ef3b8c8d00e39065b12f29676cccd38ced75e68fa2a6?d=mp&s=160"},"body":"NS> Didn't you mean \"Signed-off-by: 積丹尼 \"?\n\nNo. I want in fact just to use \"Signed-off-by: jidanni@jidanni.org\",\nbut apparently\n1) man git-config mentions\n commit.template\n Specify a file to use as the template for new commit messages.\n\nbut doesn't mention what file is being used presently, so one can know\nwhat to adjust.\n\n2) .git/hooks/commit-msg etc. don't seem to control that line.\n3) Making a line without a name would probably break other things.\n"},{"id":"98748","messageId":"87lju2sfft.fsf@jidanni.org","threadId":"16874","inReplyTo":"7vmyeilj3z.fsf@gitster.siamese.dyndns.org","subject":"Re: [PATCH] gitrepository-layout: No longer first two letters. Also add \"down\".","fromName":"","fromEmail":"jidanni@jidanni.org","sentAt":"2008-12-26T23:08:06Z","receivedAt":"2008-12-26T23:08:06Z","isPatch":true,"sender":{"key":"jidanni@jidanni.org","avatar":"https://gravatar.com/avatar/36568d4af4c8d3e71627ef3b8c8d00e39065b12f29676cccd38ced75e68fa2a6?d=mp&s=160"},"body":"OK, the two letters are related by an algorithm.\n"},{"id":"98750","messageId":"7v8wq2lcwq.fsf@gitster.siamese.dyndns.org","threadId":"16874","inReplyTo":"87tz8qsgn2.fsf_-_@jidanni.org","subject":"Re: commit.template","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2008-12-26T23:44:37Z","receivedAt":"2008-12-26T23:44:37Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"jidanni@jidanni.org writes:\n\n> NS> Didn't you mean \"Signed-off-by: 積丹尼 \"?\n>\n> No. I want in fact just to use \"Signed-off-by: jidanni@jidanni.org\",\n\nThat won't fly well, provided if you want your patches in git.git tree.\n"},{"id":"98751","messageId":"200812261750.12204.bss@iguanasuicide.net","threadId":"16874","inReplyTo":"87tz8qsgn2.fsf_-_@jidanni.org","subject":"Re: commit.template","fromName":"Boyd Stephen Smith Jr.","fromEmail":"bss@iguanasuicide.net","sentAt":"2008-12-26T23:50:06Z","receivedAt":"2008-12-26T23:50:06Z","isPatch":false,"sender":{"key":"bss@iguanasuicide.net","avatar":"https://gravatar.com/avatar/84b95eeff194b816c1568b1339e63e4b229825298664a9037b9f1ec713ead1e3?d=mp&s=160"},"body":"On Friday 2008 December 26 16:42:09 jidanni@jidanni.org wrote:\n> NS> Didn't you mean \"Signed-off-by: 積丹尼 \"?\n>\n> No. I want in fact just to use \"Signed-off-by: jidanni@jidanni.org\",\n> but apparently\n> 1) man git-config mentions\n> commit.template\n> Specify a file to use as the template for new commit messages.\n>\n> but doesn't mention what file is being used presently, so one can know\n> what to adjust.\n\ngit commit --help tells how this configuration option is used, in the \ndocumentation of the \"-t\" option.\n\n> 3) Making a line without a name would probably break other things.\n\nWell, then use your legal name -- unicode is allowed.\n-- \nBoyd Stephen Smith Jr. ,= ,-_-. =. \nbss@iguanasuicide.net ((_/)o o(\\_))\nICQ: 514984 YM/AIM: DaTwinkDaddy `-'(. .)`-' \nhttp://iguanasuicide.net/ \\_/ \n"},{"id":"98753","messageId":"87hc4qscz5.fsf@jidanni.org","threadId":"16874","inReplyTo":"200812261750.12204.bss@iguanasuicide.net","subject":"Re: commit.template","fromName":"","fromEmail":"jidanni@jidanni.org","sentAt":"2008-12-27T00:01:18Z","receivedAt":"2008-12-27T00:01:18Z","isPatch":false,"sender":{"key":"jidanni@jidanni.org","avatar":"https://gravatar.com/avatar/36568d4af4c8d3e71627ef3b8c8d00e39065b12f29676cccd38ced75e68fa2a6?d=mp&s=160"},"body":"OK, both\n>> 1) man git-config mentions\n>> commit.template\nand\nBSS> git commit --help tells how this configuration option is used, in the \nBSS> documentation of the \"-t\" option.\nshould\n>> mention what file is being used presently\nas one needs a template in order to modify a template... in case\nsomeone one day wants to. Not me. I'm happy already.\n"},{"id":"98754","messageId":"20081227090727.6117@nanako3.lavabit.com","threadId":"16874","inReplyTo":"87tz8qsgn2.fsf_-_@jidanni.org","subject":"Re: commit.template","fromName":"Nanako Shiraishi","fromEmail":"nanako3@lavabit.com","sentAt":"2008-12-27T00:07:27Z","receivedAt":"2008-12-27T00:07:27Z","isPatch":false,"sender":{"key":"nanako3@lavabit.com","avatar":"https://gravatar.com/avatar/3777b9e201c5883a62b1a6fdf7c53f2d712d1d80989146063ea861e33aad72a8?d=mp&s=160"},"body":"Quoting jidanni@jidanni.org:\n\n> NS> Didn't you mean \"Signed-off-by: 積丹尼 \"?\n>\n> No. I want in fact just to use \"Signed-off-by: jidanni@jidanni.org\",\n\nI think everybody on the list now understands that you desperately want to be different. I think it would be beneficial for you to try making a difference in areas that matter, instead of just trying to be different in how your name is spelled.\n\nJust my two yen ;-)\n\n-- \nNanako Shiraishi\nhttp://ivory.ap.teacup.com/nanako3/\n"},{"id":"98755","messageId":"7vwsdmjwzr.fsf@gitster.siamese.dyndns.org","threadId":"16874","inReplyTo":"20081227090727.6117@nanako3.lavabit.com","subject":"Re: commit.template","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2008-12-27T00:13:44Z","receivedAt":"2008-12-27T00:13:44Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Nanako Shiraishi writes:\n\n> Quoting jidanni@jidanni.org:\n>\n>> NS> Didn't you mean \"Signed-off-by: 積丹尼 \"?\n>>\n>> No. I want in fact just to use \"Signed-off-by: jidanni@jidanni.org\",\n>\n> I think everybody on the list now understands that you desperately want to be different. I think it would be beneficial for you to try making a difference in areas that matter, instead of just trying to be different in how your name is spelled.\n>\n> Just my two yen ;-)\n\nEven though I soft-of-kind-of understand that you are frustrated for\ngetting that response after offering an advice to satisfy his earlier\nwish:\n\n\t\"Thanks but I want to be http://zh.wikipedia.org/wiki/積丹尼\"\n\nmade in $gmane/103591, you do not sound so harsh and play a bad girl.\n\nBe civil and friendly around here, please...\n"},{"id":"98756","messageId":"7vr63ujwvg.fsf@gitster.siamese.dyndns.org","threadId":"16874","inReplyTo":"7vwsdmjwzr.fsf@gitster.siamese.dyndns.org","subject":"Re: commit.template","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2008-12-27T00:16:19Z","receivedAt":"2008-12-27T00:16:19Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Junio C Hamano writes:\n\n> made in $gmane/103591, you do not sound so harsh and play a bad girl.\n\nSorry, I meant \"do not have to\"...\n"},{"id":"98766","messageId":"200812261853.55464.bss@iguanasuicide.net","threadId":"16874","inReplyTo":"87hc4qscz5.fsf@jidanni.org","subject":"Re: commit.template","fromName":"Boyd Stephen Smith Jr.","fromEmail":"bss@iguanasuicide.net","sentAt":"2008-12-27T00:53:51Z","receivedAt":"2008-12-27T00:53:51Z","isPatch":false,"sender":{"key":"bss@iguanasuicide.net","avatar":"https://gravatar.com/avatar/84b95eeff194b816c1568b1339e63e4b229825298664a9037b9f1ec713ead1e3?d=mp&s=160"},"body":"On Friday 2008 December 26 18:01:18 jidanni@jidanni.org wrote:\n> OK, both\n>\n> >> 1) man git-config mentions\n> >> commit.template\n>\n> and\n> BSS> git commit --help tells how this configuration option is used, in the\n> BSS> documentation of the \"-t\" option.\n> should\n>\n> >> mention what file is being used presently\n\nThere is no file being used presently. With the \"-m\" or \"-F\" option, no \ntemplate is ever used. Without those options, either the argument to \"-t\" or \nthe value of commit.template is used in that order; the editor is invoked on \nthat. Finally if neither of those are defined the editor is invoked on a \nnew, empty file.\n\n> as one needs a template in order to modify a template.\n\nYou aren't modifying the template with commit.template or \"-t\", you are \nspecifying one. You can create one from scratch in your editor of choice.\n-- \nBoyd Stephen Smith Jr. ,= ,-_-. =. \nbss@iguanasuicide.net ((_/)o o(\\_))\nICQ: 514984 YM/AIM: DaTwinkDaddy `-'(. .)`-' \nhttp://iguanasuicide.net/ \\_/ \n"},{"id":"98767","messageId":"874p0qsa2h.fsf@jidanni.org","threadId":"16874","inReplyTo":"200812261853.55464.bss@iguanasuicide.net","subject":"Re: commit.template","fromName":"","fromEmail":"jidanni@jidanni.org","sentAt":"2008-12-27T01:04:06Z","receivedAt":"2008-12-27T01:04:06Z","isPatch":false,"sender":{"key":"jidanni@jidanni.org","avatar":"https://gravatar.com/avatar/36568d4af4c8d3e71627ef3b8c8d00e39065b12f29676cccd38ced75e68fa2a6?d=mp&s=160"},"body":"OK, but there should be a reference to any %escapes available in\ntemplates, etc.\n\nOr say the template is purely and additional \".signature\" style file\nthat will be inserted at some certain spot...\n"},{"id":"98768","messageId":"200812261948.58032.bss@iguanasuicide.net","threadId":"16874","inReplyTo":"874p0qsa2h.fsf@jidanni.org","subject":"Re: commit.template","fromName":"Boyd Stephen Smith Jr.","fromEmail":"bss@iguanasuicide.net","sentAt":"2008-12-27T01:48:52Z","receivedAt":"2008-12-27T01:48:52Z","isPatch":false,"sender":{"key":"bss@iguanasuicide.net","avatar":"https://gravatar.com/avatar/84b95eeff194b816c1568b1339e63e4b229825298664a9037b9f1ec713ead1e3?d=mp&s=160"},"body":"On Friday 2008 December 26 19:04:06 jidanni@jidanni.org wrote:\n> OK, but there should be a reference to any %escapes available in\n> templates, etc.\n\nThere are none, at least not right now.\n\n> Or say the template is purely and additional \".signature\" style file\n> that will be inserted at some certain spot...\n\nThere's what it says:\n\"Use the contents of the given file as the initial version of the\ncommit message. The editor is invoked and you can make subsequent\nchanges. [...] This overrides the commit.template\nconfiguration variable.\"\n\t-- 'git commit --help'\n\nWhat isn't clear about that? It's not an *extra* file; it is the template \n(what you start with) for commit messages.\n-- \nBoyd Stephen Smith Jr. ,= ,-_-. =. \nbss@iguanasuicide.net ((_/)o o(\\_))\nICQ: 514984 YM/AIM: DaTwinkDaddy `-'(. .)`-' \nhttp://iguanasuicide.net/ \\_/ \n"},{"id":"98770","messageId":"87r63uqswe.fsf@jidanni.org","threadId":"16874","inReplyTo":"200812261948.58032.bss@iguanasuicide.net","subject":"Re: commit.template","fromName":"","fromEmail":"jidanni@jidanni.org","sentAt":"2008-12-27T02:00:17Z","receivedAt":"2008-12-27T02:00:17Z","isPatch":false,"sender":{"key":"jidanni@jidanni.org","avatar":"https://gravatar.com/avatar/36568d4af4c8d3e71627ef3b8c8d00e39065b12f29676cccd38ced75e68fa2a6?d=mp&s=160"},"body":"I see, it's not replacing something current. It is adding something\nextra. OK, would have never guessed. OK, stopping here.\n"},{"id":"98843","messageId":"bd6139dc0812280900t12189c6anb583033e52a5b027@mail.gmail.com","threadId":"16874","inReplyTo":"20081227070232.6117@nanako3.lavabit.com","subject":"Re: [PATCH] gitrepository-layout: No longer first two letters. Also add \"down\".","fromName":"Sverre Rabbelier","fromEmail":"srabbelier@gmail.com","sentAt":"2008-12-28T17:00:02Z","receivedAt":"2008-12-28T17:00:02Z","isPatch":true,"sender":{"key":"srabbelier@gmail.com","avatar":"https://avatars.githubusercontent.com/u/3098?v=4"},"body":"On Fri, Dec 26, 2008 at 16:02, Nanako Shiraishi wrote:\n> Quoting jidanni@jidanni.org:\n>\n>> Signed-off-by: jidanni \n>\n> Didn't you mean \"Signed-off-by: 積丹尼 \"?\n\nBe nice, they are obviously a bit peculiar about their name/sign-off name :).\n-- \nCheers,\n\nSverre Rabbelier\n"},{"id":"98871","messageId":"20081229175252.6117@nanako3.lavabit.com","threadId":"16874","inReplyTo":"bd6139dc0812280900t12189c6anb583033e52a5b027@mail.gmail.com","subject":"Re: [PATCH] gitrepository-layout: No longer first two letters. Also add \"down\".","fromName":"Nanako Shiraishi","fromEmail":"nanako3@lavabit.com","sentAt":"2008-12-29T08:52:52Z","receivedAt":"2008-12-29T08:52:52Z","isPatch":true,"sender":{"key":"nanako3@lavabit.com","avatar":"https://gravatar.com/avatar/3777b9e201c5883a62b1a6fdf7c53f2d712d1d80989146063ea861e33aad72a8?d=mp&s=160"},"body":"Quoting \"Sverre Rabbelier\" :\n\n> On Fri, Dec 26, 2008 at 16:02, Nanako Shiraishi wrote:\n>> Quoting jidanni@jidanni.org:\n>>\n>>> Signed-off-by: jidanni \n>>\n>> Didn't you mean \"Signed-off-by: 積丹尼 \"?\n>\n> Be nice, they are obviously a bit peculiar about their name/sign-off name :).\n\nIf you are telling me that I said something un-nice, I apologize. I did not mean to offend anybody. But I do not understand. Who do you mean by they in your sentence? \n\n> -- \n> Cheers,\n>\n> Sverre Rabbelier\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-- \nNanako Shiraishi\nhttp://ivory.ap.teacup.com/nanako3/\n"}]}