{"thread":{"id":"41486","subject":"[PATCH 1/5] README: use markdown syntax","startedAt":"2016-02-23T17:40:24Z","lastAt":"2016-02-25T08:37:30Z","messageCount":25,"participants":["Matthieu Moy","Junio C Hamano","Johannes Schindelin","Jeff King"],"isPatch":true,"patchVersion":1,"patchTotal":5},"messages":[{"id":"279041","messageId":"1456249229-30454-1-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":null,"subject":"[RFC/PATCH 0/5] Make README more pleasant to read","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-23T17:40:24Z","receivedAt":"2016-02-23T17:40:24Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"This patch series was inspired by a discussion I had with Emma Jane\nafter Git Merge last year. It tries both to make the README file less\nagressive and generally more pleasant to read.\n\nTo get a quick overview, compare the old one:\n\n https://github.com/git/git#readme\n\nand my proposal:\n\n https://github.com/moy/git/tree/git-readme#readme\n\nMatthieu Moy (5):\n README: use markdown syntax\n README.md: add hyperlinks on filenames\n README.md: move the link to git-scm.com up\n README.md: don't call git stupid in the title\n README.md: move down historical explanation about the name\n\n README => README.md | 54 ++++++++++++++++++++++++++++-------------------------\n t/t7001-mv.sh | 2 +-\n 2 files changed, 30 insertions(+), 26 deletions(-)\n rename README => README.md (67%)\n\n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279036","messageId":"1456249229-30454-2-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456249229-30454-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH 1/5] README: use markdown syntax","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-23T17:40:25Z","receivedAt":"2016-02-23T17:40:25Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"This allows repository browsers like GitHub to display the content of\nthe file nicely formatted.\n\nSigned-off-by: Matthieu Moy \n---\n README => README.md | 6 +-----\n t/t7001-mv.sh | 2 +-\n 2 files changed, 2 insertions(+), 6 deletions(-)\n rename README => README.md (93%)\n\ndiff --git a/README b/README.md\nsimilarity index 93%\nrename from README\nrename to README.md\nindex 1083735..907eb3b 100644\n--- a/README\n+++ b/README.md\n@@ -1,8 +1,4 @@\n-////////////////////////////////////////////////////////////////\n-\n-\tGit - the stupid content tracker\n-\n-////////////////////////////////////////////////////////////////\n+# Git - the stupid content tracker\n \n \"git\" can mean anything, depending on your mood.\n \ndiff --git a/t/t7001-mv.sh b/t/t7001-mv.sh\nindex 51dd2b4..4008fae 100755\n--- a/t/t7001-mv.sh\n+++ b/t/t7001-mv.sh\n@@ -102,7 +102,7 @@ test_expect_success \\\n \n test_expect_success \\\n 'adding another file' \\\n- 'cp \"$TEST_DIRECTORY\"/../README path0/README &&\n+ 'cp \"$TEST_DIRECTORY\"/../README.md path0/README &&\n git add path0/README &&\n git commit -m add2 -a'\n \n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279038","messageId":"1456249229-30454-3-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456249229-30454-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH 2/5] README.md: add hyperlinks on filenames","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-23T17:40:26Z","receivedAt":"2016-02-23T17:40:26Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"Signed-off-by: Matthieu Moy \n---\n README.md | 19 +++++++++++++------\n 1 file changed, 13 insertions(+), 6 deletions(-)\n\ndiff --git a/README.md b/README.md\nindex 907eb3b..750fdda 100644\n--- a/README.md\n+++ b/README.md\n@@ -20,17 +20,17 @@ License version 2 (some parts of it are under different licenses,\n compatible with the GPLv2). It was originally written by Linus\n Torvalds with help of a group of hackers around the net.\n \n-Please read the file INSTALL for installation instructions.\n+Please read the file [INSTALL][] for installation instructions.\n \n-See Documentation/gittutorial.txt to get started, then see\n-Documentation/giteveryday.txt for a useful minimum set of commands, and\n-Documentation/git-commandname.txt for documentation of each command.\n+See [Documentation/gittutorial.txt][] to get started, then see\n+[Documentation/giteveryday.txt][] for a useful minimum set of commands, and\n+[Documentation/git-commandname.txt][] for documentation of each command.\n If git has been correctly installed, then the tutorial can also be\n read with \"man gittutorial\" or \"git help tutorial\", and the\n documentation of each command with \"man git-commandname\" or \"git help\n commandname\".\n \n-CVS users may also want to read Documentation/gitcvs-migration.txt\n+CVS users may also want to read [Documentation/gitcvs-migration.txt][]\n (\"man gitcvs-migration\" or \"git help cvs-migration\" if git is\n installed).\n \n@@ -40,7 +40,7 @@ including full documentation and Git related tools.\n The user discussion and development of Git take place on the Git\n mailing list -- everyone is welcome to post bug reports, feature\n requests, comments and patches to git@vger.kernel.org (read\n-Documentation/SubmittingPatches for instructions on patch submission).\n+[Documentation/SubmittingPatches][] for instructions on patch submission).\n To subscribe to the list, send an email with just \"subscribe git\" in\n the body to majordomo@vger.kernel.org. The mailing list archives are\n available at http://news.gmane.org/gmane.comp.version-control.git/,\n@@ -50,3 +50,10 @@ The maintainer frequently sends the \"What's cooking\" reports that\n list the current status of various development topics to the mailing\n list. The discussion following them give a good reference for\n project status, development direction and remaining tasks.\n+\n+[INSTALL]: INSTALL\n+[Documentation/gittutorial.txt]: Documentation/gittutorial.txt\n+[Documentation/giteveryday.txt]: Documentation/giteveryday.txt\n+[Documentation/git-commandname.txt]: Documentation/git-commandname.txt\n+[Documentation/gitcvs-migration.txt]: Documentation/gitcvs-migration.txt\n+[Documentation/SubmittingPatches]: Documentation/SubmittingPatches\n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279040","messageId":"1456249229-30454-4-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456249229-30454-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH 3/5] README.md: move the link to git-scm.com up","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-23T17:40:27Z","receivedAt":"2016-02-23T17:40:27Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"The documentation available on git-scm.com is nicely formatted. It's\nbetter to point users to it than to the source code of the\ndocumentation.\n\nSigned-off-by: Matthieu Moy \n---\n README.md | 6 +++---\n 1 file changed, 3 insertions(+), 3 deletions(-)\n\ndiff --git a/README.md b/README.md\nindex 750fdda..1625352 100644\n--- a/README.md\n+++ b/README.md\n@@ -22,6 +22,9 @@ Torvalds with help of a group of hackers around the net.\n \n Please read the file [INSTALL][] for installation instructions.\n \n+Many Git online resources are accessible from http://git-scm.com/\n+including full documentation and Git related tools.\n+\n See [Documentation/gittutorial.txt][] to get started, then see\n [Documentation/giteveryday.txt][] for a useful minimum set of commands, and\n [Documentation/git-commandname.txt][] for documentation of each command.\n@@ -34,9 +37,6 @@ CVS users may also want to read [Documentation/gitcvs-migration.txt][]\n (\"man gitcvs-migration\" or \"git help cvs-migration\" if git is\n installed).\n \n-Many Git online resources are accessible from http://git-scm.com/\n-including full documentation and Git related tools.\n-\n The user discussion and development of Git take place on the Git\n mailing list -- everyone is welcome to post bug reports, feature\n requests, comments and patches to git@vger.kernel.org (read\n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279037","messageId":"1456249229-30454-5-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456249229-30454-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH 4/5] README.md: don't call git stupid in the title","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-23T17:40:28Z","receivedAt":"2016-02-23T17:40:28Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"\"the stupid content tracker\" was true in the early days of Git, but\nhardly applicable these days. \"fast, scalable, distributed\" describes\nGit more accuralety.\n\nAlso, \"stupid\" can be seen as offensive by some people. Let's not use it\nin the very first words of the README.\n\nThe new formulation is taken from the description of the Debian package.\n\nSigned-off-by: Matthieu Moy \n---\n README.md | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/README.md b/README.md\nindex 1625352..c11c3e2 100644\n--- a/README.md\n+++ b/README.md\n@@ -1,4 +1,4 @@\n-# Git - the stupid content tracker\n+# Git - fast, scalable, distributed revision control system\n \n \"git\" can mean anything, depending on your mood.\n \n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279039","messageId":"1456249229-30454-6-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456249229-30454-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH 5/5] README.md: move down historical explanation about the name","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-23T17:40:29Z","receivedAt":"2016-02-23T17:40:29Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"The explanations about why the name was chosen are secondary compared to\nthe description and link to the documentation.\n\nSome consider these explanations as good computer scientists joke, but\nother see it as needlessly offensive vocabulary.\n\nThis patch preserves the historical joke, but gives it less importance\nby moving it to the end of the README, and makes it clear that it is a\nhistorical explanation, that does not necessarily reflect the state of\nmind of current developers.\n\nSigned-off-by: Matthieu Moy \n---\n README.md | 23 ++++++++++++-----------\n 1 file changed, 12 insertions(+), 11 deletions(-)\n\ndiff --git a/README.md b/README.md\nindex c11c3e2..40de78e 100644\n--- a/README.md\n+++ b/README.md\n@@ -1,16 +1,5 @@\n # Git - fast, scalable, distributed revision control system\n \n-\"git\" can mean anything, depending on your mood.\n-\n- - random three-letter combination that is pronounceable, and not\n- actually used by any common UNIX command. The fact that it is a\n- mispronunciation of \"get\" may or may not be relevant.\n- - stupid. contemptible and despicable. simple. Take your pick from the\n- dictionary of slang.\n- - \"global information tracker\": you're in a good mood, and it actually\n- works for you. Angels sing, and a light suddenly fills the room.\n- - \"goddamn idiotic truckload of sh*t\": when it breaks\n-\n Git is a fast, scalable, distributed revision control system with an\n unusually rich command set that provides both high-level operations\n and full access to internals.\n@@ -51,6 +40,18 @@ list the current status of various development topics to the mailing\n list. The discussion following them give a good reference for\n project status, development direction and remaining tasks.\n \n+The name \"git\" was given by Linus Torvalds when he wrote the very\n+first version. He described it as (depending on your mood):\n+\n+ - random three-letter combination that is pronounceable, and not\n+ actually used by any common UNIX command. The fact that it is a\n+ mispronunciation of \"get\" may or may not be relevant.\n+ - stupid. contemptible and despicable. simple. Take your pick from the\n+ dictionary of slang.\n+ - \"global information tracker\": you're in a good mood, and it actually\n+ works for you. Angels sing, and a light suddenly fills the room.\n+ - \"goddamn idiotic truckload of sh*t\": when it breaks\n+\n [INSTALL]: INSTALL\n [Documentation/gittutorial.txt]: Documentation/gittutorial.txt\n [Documentation/giteveryday.txt]: Documentation/giteveryday.txt\n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279051","messageId":"xmqqoab71c09.fsf@gitster.mtv.corp.google.com","threadId":"41486","inReplyTo":"1456249229-30454-2-git-send-email-Matthieu.Moy@imag.fr","subject":"Re: [PATCH 1/5] README: use markdown syntax","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2016-02-23T19:07:34Z","receivedAt":"2016-02-23T19:07:34Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Matthieu Moy writes:\n\n> This allows repository browsers like GitHub to display the content of\n> the file nicely formatted.\n>\n> Signed-off-by: Matthieu Moy \n> ---\n\nTo be honest, I have the most problem with this step in the whole\nseries.\n\nMarkdown when rendered may be easier to read, but plain text is even\neasier, and it somehow feels backward to cater to those who browse\nat GitHub sacrificing those who use \"less\" in the source tree.\n\n> README => README.md | 6 +-----\n> t/t7001-mv.sh | 2 +-\n> 2 files changed, 2 insertions(+), 6 deletions(-)\n> rename README => README.md (93%)\n>\n> diff --git a/README b/README.md\n> similarity index 93%\n> rename from README\n> rename to README.md\n> index 1083735..907eb3b 100644\n> --- a/README\n> +++ b/README.md\n> @@ -1,8 +1,4 @@\n> -////////////////////////////////////////////////////////////////\n> -\n> -\tGit - the stupid content tracker\n> -\n> -////////////////////////////////////////////////////////////////\n> +# Git - the stupid content tracker\n> \n> \"git\" can mean anything, depending on your mood.\n> \n> diff --git a/t/t7001-mv.sh b/t/t7001-mv.sh\n> index 51dd2b4..4008fae 100755\n> --- a/t/t7001-mv.sh\n> +++ b/t/t7001-mv.sh\n> @@ -102,7 +102,7 @@ test_expect_success \\\n> \n> test_expect_success \\\n> 'adding another file' \\\n> - 'cp \"$TEST_DIRECTORY\"/../README path0/README &&\n> + 'cp \"$TEST_DIRECTORY\"/../README.md path0/README &&\n> git add path0/README &&\n> git commit -m add2 -a'\n"},{"id":"279052","messageId":"xmqqio1f1bw7.fsf@gitster.mtv.corp.google.com","threadId":"41486","inReplyTo":"1456249229-30454-3-git-send-email-Matthieu.Moy@imag.fr","subject":"Re: [PATCH 2/5] README.md: add hyperlinks on filenames","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2016-02-23T19:10:00Z","receivedAt":"2016-02-23T19:10:00Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Matthieu Moy writes:\n\n> Signed-off-by: Matthieu Moy \n> ---\n> README.md | 19 +++++++++++++------\n> 1 file changed, 13 insertions(+), 6 deletions(-)\n\nMakes sense, provided if we want to do Markdown.\n\nIf I were pushing this topic (i.e. cater to those who browse at\nGitHub, not with \"less\" in the source tree), I'd have further made\nthese links to the preformatted documentation at git-scm.com; I\nexpected the later steps in this series to do that, but it seems you\nstopped short of it for some reason.\n\n> diff --git a/README.md b/README.md\n> index 907eb3b..750fdda 100644\n> --- a/README.md\n> +++ b/README.md\n> @@ -20,17 +20,17 @@ License version 2 (some parts of it are under different licenses,\n> compatible with the GPLv2). It was originally written by Linus\n> Torvalds with help of a group of hackers around the net.\n> \n> -Please read the file INSTALL for installation instructions.\n> +Please read the file [INSTALL][] for installation instructions.\n> \n> -See Documentation/gittutorial.txt to get started, then see\n> -Documentation/giteveryday.txt for a useful minimum set of commands, and\n> -Documentation/git-commandname.txt for documentation of each command.\n> +See [Documentation/gittutorial.txt][] to get started, then see\n> +[Documentation/giteveryday.txt][] for a useful minimum set of commands, and\n> +[Documentation/git-commandname.txt][] for documentation of each command.\n> If git has been correctly installed, then the tutorial can also be\n> read with \"man gittutorial\" or \"git help tutorial\", and the\n> documentation of each command with \"man git-commandname\" or \"git help\n> commandname\".\n> \n> -CVS users may also want to read Documentation/gitcvs-migration.txt\n> +CVS users may also want to read [Documentation/gitcvs-migration.txt][]\n> (\"man gitcvs-migration\" or \"git help cvs-migration\" if git is\n> installed).\n> \n> @@ -40,7 +40,7 @@ including full documentation and Git related tools.\n> The user discussion and development of Git take place on the Git\n> mailing list -- everyone is welcome to post bug reports, feature\n> requests, comments and patches to git@vger.kernel.org (read\n> -Documentation/SubmittingPatches for instructions on patch submission).\n> +[Documentation/SubmittingPatches][] for instructions on patch submission).\n> To subscribe to the list, send an email with just \"subscribe git\" in\n> the body to majordomo@vger.kernel.org. The mailing list archives are\n> available at http://news.gmane.org/gmane.comp.version-control.git/,\n> @@ -50,3 +50,10 @@ The maintainer frequently sends the \"What's cooking\" reports that\n> list the current status of various development topics to the mailing\n> list. The discussion following them give a good reference for\n> project status, development direction and remaining tasks.\n> +\n> +[INSTALL]: INSTALL\n> +[Documentation/gittutorial.txt]: Documentation/gittutorial.txt\n> +[Documentation/giteveryday.txt]: Documentation/giteveryday.txt\n> +[Documentation/git-commandname.txt]: Documentation/git-commandname.txt\n> +[Documentation/gitcvs-migration.txt]: Documentation/gitcvs-migration.txt\n> +[Documentation/SubmittingPatches]: Documentation/SubmittingPatches\n"},{"id":"279053","messageId":"xmqqegc31br3.fsf@gitster.mtv.corp.google.com","threadId":"41486","inReplyTo":"1456249229-30454-5-git-send-email-Matthieu.Moy@imag.fr","subject":"Re: [PATCH 4/5] README.md: don't call git stupid in the title","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2016-02-23T19:13:04Z","receivedAt":"2016-02-23T19:13:04Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Matthieu Moy writes:\n\n> \"the stupid content tracker\" was true in the early days of Git, but\n> hardly applicable these days. \"fast, scalable, distributed\" describes\n> Git more accuralety.\n>\n> Also, \"stupid\" can be seen as offensive by some people. Let's not use it\n> in the very first words of the README.\n>\n> The new formulation is taken from the description of the Debian package.\n>\n> Signed-off-by: Matthieu Moy \n> ---\n\nThis self-derogatory reference shouldn't offend those who didn't\nhelp write it.\n\nHaving said that, I agree with the spirit of 4/5 and 5/5; but it is\nsad that this line is not resurrected by 5/5 in some way.\n\n> README.md | 2 +-\n> 1 file changed, 1 insertion(+), 1 deletion(-)\n>\n> diff --git a/README.md b/README.md\n> index 1625352..c11c3e2 100644\n> --- a/README.md\n> +++ b/README.md\n> @@ -1,4 +1,4 @@\n> -# Git - the stupid content tracker\n> +# Git - fast, scalable, distributed revision control system\n> \n> \"git\" can mean anything, depending on your mood.\n"},{"id":"279056","messageId":"vpq60xfgq9q.fsf@anie.imag.fr","threadId":"41486","inReplyTo":"xmqqoab71c09.fsf@gitster.mtv.corp.google.com","subject":"Re: [PATCH 1/5] README: use markdown syntax","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@grenoble-inp.fr","sentAt":"2016-02-23T19:50:25Z","receivedAt":"2016-02-23T19:50:25Z","isPatch":true,"sender":{"key":"matthieu.moy@grenoble-inp.fr","avatar":"https://gravatar.com/avatar/72c8a2705971a25dfaff23cece15130d405685845d911aedd5667ace277f3fc5?d=mp&s=160"},"body":"Junio C Hamano writes:\n\n> Matthieu Moy writes:\n>\n>> This allows repository browsers like GitHub to display the content of\n>> the file nicely formatted.\n>>\n>> Signed-off-by: Matthieu Moy \n>> ---\n>\n> To be honest, I have the most problem with this step in the whole\n> series.\n>\n> Markdown when rendered may be easier to read, but plain text is even\n> easier, and it somehow feels backward to cater to those who browse\n> at GitHub sacrificing those who use \"less\" in the source tree.\n\nWell, actually almost all the page was already in markdown. The real\nchange done by this patch is a rename, and change the asciiart in the\ntitle:\n\n>> --- a/README\n>> +++ b/README.md\n>> @@ -1,8 +1,4 @@\n>> -////////////////////////////////////////////////////////////////\n>> -\n>> -\tGit - the stupid content tracker\n>> -\n>> -////////////////////////////////////////////////////////////////\n>> +# Git - the stupid content tracker\n\nMarkdown would also accept ascii-art underlining.\n\nGit - the stupid content tracker\n================================\n\nwe can use this if people think it's easier to read in the source.\n\n-- \nMatthieu Moy\nhttp://www-verimag.imag.fr/~moy/\n"},{"id":"279058","messageId":"vpqwppvfblb.fsf@anie.imag.fr","threadId":"41486","inReplyTo":"xmqqio1f1bw7.fsf@gitster.mtv.corp.google.com","subject":"Re: [PATCH 2/5] README.md: add hyperlinks on filenames","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@grenoble-inp.fr","sentAt":"2016-02-23T19:52:48Z","receivedAt":"2016-02-23T19:52:48Z","isPatch":true,"sender":{"key":"matthieu.moy@grenoble-inp.fr","avatar":"https://gravatar.com/avatar/72c8a2705971a25dfaff23cece15130d405685845d911aedd5667ace277f3fc5?d=mp&s=160"},"body":"Junio C Hamano writes:\n\n> Matthieu Moy writes:\n>\n>> Signed-off-by: Matthieu Moy \n>> ---\n>> README.md | 19 +++++++++++++------\n>> 1 file changed, 13 insertions(+), 6 deletions(-)\n>\n> Makes sense, provided if we want to do Markdown.\n\nI'd say it the other way around: declaring README as markdown costs\nalmost nothing and doesn't harm source code readability. This patch\nslightly decreases the source's readability so we may want to drop it.\n\n> If I were pushing this topic (i.e. cater to those who browse at\n> GitHub, not with \"less\" in the source tree), I'd have further made\n> these links to the preformatted documentation at git-scm.com; I\n> expected the later steps in this series to do that, but it seems you\n> stopped short of it for some reason.\n\nI tried to keep the spirit of the README as \"this is the entry point to\nthe source code\" rather than \"this is the new homepage of Git\" (as some\nproject do on GitHub, but we have such a nice git-scm.com ...).\n\n-- \nMatthieu Moy\nhttp://www-verimag.imag.fr/~moy/\n"},{"id":"279065","messageId":"vpqmvqrf8w5.fsf@anie.imag.fr","threadId":"41486","inReplyTo":"xmqqegc31br3.fsf@gitster.mtv.corp.google.com","subject":"Re: [PATCH 4/5] README.md: don't call git stupid in the title","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@grenoble-inp.fr","sentAt":"2016-02-23T20:51:06Z","receivedAt":"2016-02-23T20:51:06Z","isPatch":true,"sender":{"key":"matthieu.moy@grenoble-inp.fr","avatar":"https://gravatar.com/avatar/72c8a2705971a25dfaff23cece15130d405685845d911aedd5667ace277f3fc5?d=mp&s=160"},"body":"Junio C Hamano writes:\n\n> Matthieu Moy writes:\n>\n>> \"the stupid content tracker\" was true in the early days of Git, but\n>> hardly applicable these days. \"fast, scalable, distributed\" describes\n>> Git more accuralety.\n>>\n>> Also, \"stupid\" can be seen as offensive by some people. Let's not use it\n>> in the very first words of the README.\n>>\n>> The new formulation is taken from the description of the Debian package.\n>>\n>> Signed-off-by: Matthieu Moy \n>> ---\n>\n> This self-derogatory reference shouldn't offend those who didn't\n> help write it.\n>\n> Having said that, I agree with the spirit of 4/5 and 5/5; but it is\n> sad that this line is not resurrected by 5/5 in some way.\n\nDo you mean something like this:\n\ndiff --git a/README.md b/README.md\nindex 40de78e..b1c89bd 100644\n--- a/README.md\n+++ b/README.md\n@@ -41,7 +41,8 @@ list. The discussion following them give a good reference for\n project status, development direction and remaining tasks.\n \n The name \"git\" was given by Linus Torvalds when he wrote the very\n-first version. He described it as (depending on your mood):\n+first version. He described the tool as \"the stupid content tracker\"\n+and the name as (depending on your mood):\n \n - random three-letter combination that is pronounceable, and not\n actually used by any common UNIX command. The fact that it is a\n\n?\n\nWhy not, but I don't think it adds really much, and I'd rather keep the\nREADME as short as possible.\n\n-- \nMatthieu Moy\nhttp://www-verimag.imag.fr/~moy/\n"},{"id":"279079","messageId":"xmqqwppvxg3z.fsf@gitster.mtv.corp.google.com","threadId":"41486","inReplyTo":"vpqmvqrf8w5.fsf@anie.imag.fr","subject":"Re: [PATCH 4/5] README.md: don't call git stupid in the title","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2016-02-23T21:37:52Z","receivedAt":"2016-02-23T21:37:52Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Matthieu Moy writes:\n\n> Junio C Hamano writes:\n>\n>> Having said that, I agree with the spirit of 4/5 and 5/5; but it is\n>> sad that this line is not resurrected by 5/5 in some way.\n>\n> Do you mean something like this:\n>\n> diff --git a/README.md b/README.md\n> index 40de78e..b1c89bd 100644\n> --- a/README.md\n> +++ b/README.md\n> @@ -41,7 +41,8 @@ list. The discussion following them give a good reference for\n> project status, development direction and remaining tasks.\n> \n> The name \"git\" was given by Linus Torvalds when he wrote the very\n> -first version. He described it as (depending on your mood):\n> +first version. He described the tool as \"the stupid content tracker\"\n> +and the name as (depending on your mood):\n\nExactly.\n"},{"id":"279124","messageId":"alpine.DEB.2.20.1602240801550.3152@virtualbox","threadId":"41486","inReplyTo":"xmqqoab71c09.fsf@gitster.mtv.corp.google.com","subject":"Re: [PATCH 1/5] README: use markdown syntax","fromName":"Johannes Schindelin","fromEmail":"johannes.schindelin@gmx.de","sentAt":"2016-02-24T07:08:52Z","receivedAt":"2016-02-24T07:08:52Z","isPatch":true,"sender":{"key":"johannes.schindelin@gmx.de","avatar":"https://avatars.githubusercontent.com/u/127790?v=4"},"body":"Hi Junio,\n\nOn Tue, 23 Feb 2016, Junio C Hamano wrote:\n\n> Matthieu Moy writes:\n> \n> > This allows repository browsers like GitHub to display the content of\n> > the file nicely formatted.\n> >\n> > Signed-off-by: Matthieu Moy \n> > ---\n> \n> To be honest, I have the most problem with this step in the whole\n> series.\n> \n> Markdown when rendered may be easier to read, but plain text is even\n> easier, and it somehow feels backward to cater to those who browse\n> at GitHub sacrificing those who use \"less\" in the source tree.\n\nThat assumes that the primary audience of the README file is the\ndevelopers who already decided to clone the repository, as opposed to\npeople browsing the README file in the browser to determine whether they\nfound the correct project, or to read up on the background of the project\nwithout downloading the entire source code.\n\nI'd wager real money (without scientific evidence. just going on common\nsense) that your 'less' people are in the vast minority.\n\nSince I am convinced that markdown'ed READMEs enhance the user experience\ndramatically, Git for Windows has one already for a long time.\n\nHence *my* main objection: this patch series would conflict with patches\nwe carry in Git for Windows.\n\n;-)\n\nCiao,\nDscho\n\nP.S.: If it was not clear, my objection was meant as a joke. I am very\nmuch in favor of enhancing the user experience via Matthieu's patches.\n"},{"id":"279138","messageId":"20160224101857.GB20807@sigill.intra.peff.net","threadId":"41486","inReplyTo":"alpine.DEB.2.20.1602240801550.3152@virtualbox","subject":"Re: [PATCH 1/5] README: use markdown syntax","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2016-02-24T10:18:57Z","receivedAt":"2016-02-24T10:18:57Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Wed, Feb 24, 2016 at 08:08:52AM +0100, Johannes Schindelin wrote:\n\n> > Markdown when rendered may be easier to read, but plain text is even\n> > easier, and it somehow feels backward to cater to those who browse\n> > at GitHub sacrificing those who use \"less\" in the source tree.\n> \n> That assumes that the primary audience of the README file is the\n> developers who already decided to clone the repository, as opposed to\n> people browsing the README file in the browser to determine whether they\n> found the correct project, or to read up on the background of the project\n> without downloading the entire source code.\n> \n> I'd wager real money (without scientific evidence. just going on common\n> sense) that your 'less' people are in the vast minority.\n> \n> Since I am convinced that markdown'ed READMEs enhance the user experience\n> dramatically, Git for Windows has one already for a long time.\n\nYeah, I agree. I cannot imagine why I would read Git's README at this\npoint in time. And I find I primarily consume READMEs on the web these\ndays, as they are the first step in me figuring out whether a project is\nworth looking into.\n\nWhereas I _do_ care what things like Documentation/technical look like,\nor CodingGuidelines, because I actually refer to them locally.\n\nIMHO the title formatting is somewhat moot, though, as we can have our\ncake and eat it, too, with the \"====\" underlines. I don't think they are\nany worse than the lines of slashes in the original. :)\n\nI'd worry more about the [] links from patch 2, but even those are fine\nby me.\n\n-Peff\n"},{"id":"279139","messageId":"20160224102247.GA21152@sigill.intra.peff.net","threadId":"41486","inReplyTo":"1456249229-30454-1-git-send-email-Matthieu.Moy@imag.fr","subject":"Re: [RFC/PATCH 0/5] Make README more pleasant to read","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2016-02-24T10:22:47Z","receivedAt":"2016-02-24T10:22:47Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Tue, Feb 23, 2016 at 06:40:24PM +0100, Matthieu Moy wrote:\n\n> This patch series was inspired by a discussion I had with Emma Jane\n> after Git Merge last year. It tries both to make the README file less\n> agressive and generally more pleasant to read.\n> \n> To get a quick overview, compare the old one:\n> \n> https://github.com/git/git#readme\n> \n> and my proposal:\n> \n> https://github.com/moy/git/tree/git-readme#readme\n> \n> Matthieu Moy (5):\n> README: use markdown syntax\n> README.md: add hyperlinks on filenames\n> README.md: move the link to git-scm.com up\n> README.md: don't call git stupid in the title\n> README.md: move down historical explanation about the name\n\nThanks for working on this. I think the end product is much nicer on the\nweb, with very little downside for local viewing.\n\nI'm especially happy about the final patch. I don't look at Git's README\noften, but I always cringe when I see that intro paragraph and think\nthat it's some people's first introduction to what git is.\n\n> README => README.md | 54 ++++++++++++++++++++++++++++-------------------------\n> t/t7001-mv.sh | 2 +-\n\nI do not overly care, but I wonder if it would be nice to keep README as\na symlink. I don't think that complicates things for people checking out\non Windows (we already have RelNotes as a symlink, and IIRC they just\nget a file with the link contents. Not helpful, but not harmful to them\neither).\n\n-Peff\n"},{"id":"279158","messageId":"vpqziuq6xha.fsf@anie.imag.fr","threadId":"41486","inReplyTo":"20160224102247.GA21152@sigill.intra.peff.net","subject":"Re: [RFC/PATCH 0/5] Make README more pleasant to read","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@grenoble-inp.fr","sentAt":"2016-02-24T13:37:05Z","receivedAt":"2016-02-24T13:37:05Z","isPatch":true,"sender":{"key":"matthieu.moy@grenoble-inp.fr","avatar":"https://gravatar.com/avatar/72c8a2705971a25dfaff23cece15130d405685845d911aedd5667ace277f3fc5?d=mp&s=160"},"body":"Jeff King writes:\n\n> On Tue, Feb 23, 2016 at 06:40:24PM +0100, Matthieu Moy wrote:\n>\n>> README => README.md | 54 ++++++++++++++++++++++++++++-------------------------\n>> t/t7001-mv.sh | 2 +-\n>\n> I do not overly care, but I wonder if it would be nice to keep README as\n> a symlink.\n\nI can add it if people want to see it, but we already have so many files\nat the root, I'd rather avoid adding duplicates through symlinks.\n\n-- \nMatthieu Moy\nhttp://www-verimag.imag.fr/~moy/\n"},{"id":"279278","messageId":"20160225061456.GA3921@sigill.intra.peff.net","threadId":"41486","inReplyTo":"vpqziuq6xha.fsf@anie.imag.fr","subject":"Re: [RFC/PATCH 0/5] Make README more pleasant to read","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2016-02-25T06:14:56Z","receivedAt":"2016-02-25T06:14:56Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Wed, Feb 24, 2016 at 02:37:05PM +0100, Matthieu Moy wrote:\n\n> Jeff King writes:\n> \n> > On Tue, Feb 23, 2016 at 06:40:24PM +0100, Matthieu Moy wrote:\n> >\n> >> README => README.md | 54 ++++++++++++++++++++++++++++-------------------------\n> >> t/t7001-mv.sh | 2 +-\n> >\n> > I do not overly care, but I wonder if it would be nice to keep README as\n> > a symlink.\n> \n> I can add it if people want to see it, but we already have so many files\n> at the root, I'd rather avoid adding duplicates through symlinks.\n\nThat's reasonable. I thought it might appease the \"I use `less README`\nto view the README\" crowd, but it is probably not that hard to find the\n`.md` variant.\n\n-Peff\n"},{"id":"279280","messageId":"xmqqr3g1pavf.fsf@gitster.mtv.corp.google.com","threadId":"41486","inReplyTo":"20160225061456.GA3921@sigill.intra.peff.net","subject":"Re: [RFC/PATCH 0/5] Make README more pleasant to read","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2016-02-25T06:22:44Z","receivedAt":"2016-02-25T06:22:44Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Jeff King writes:\n\n>> > I do not overly care, but I wonder if it would be nice to keep README as\n>> > a symlink.\n>> \n>> I can add it if people want to see it, but we already have so many files\n>> at the root, I'd rather avoid adding duplicates through symlinks.\n>\n> That's reasonable. I thought it might appease the \"I use `less README`\n> to view the README\" crowd, but it is probably not that hard to find the\n> `.md` variant.\n\nWell, \"less README\" folks would not be happy with a mere symbolic\nlink anyway--things like [INSTALL][] are pure eyesore and regression\nrelative to the straight text version.\n\nI do not overly care, either. I do not think people would complain\ntoo much about the eyesore as long as the file is named README.md,\nso in that sense, we'd be better off not having such a symbolic\nlink.\n"},{"id":"279287","messageId":"1456389450-27118-1-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456249229-30454-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH v2 0/5] Make README more pleasant to read","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-25T08:37:25Z","receivedAt":"2016-02-25T08:37:25Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"Minor tweaks after discussion on v1 (for those who missed it, this\nseries makes README render nicely on GitHub and tries to present\nimportant information early).\n\nThe result is here:\n\n https://github.com/moy/git/tree/git-readme#readme\n\nChanges since v1:\n\n* Visible on the rendered page: resurect \"the stupid content tracker\"\n at the bottom (\"He described the tool as \"the stupid content\n tracker\" and the name as (depending on your mood)\") as suggested by\n Junio. I first disagreed, but that's part of the explanation why Git\n is called Git, so why not.\n\n* Visible only in the source: change\n\n # title\n\n to\n\n title\n =====\n\n (I chose the first because it was more easy to type, but for someone\n not familiar with markdown, the second makes it more obvious that\n its' a title)\n\nI kept the patch introducing explicit links on filenames. I do not\ncare deeply about it.\n\nMatthieu Moy (5):\n README: use markdown syntax\n README.md: add hyperlinks on filenames\n README.md: move the link to git-scm.com up\n README.md: don't call git stupid in the title\n README.md: move down historical explanation about the name\n\n README => README.md | 56 +++++++++++++++++++++++++++++------------------------\n t/t7001-mv.sh | 2 +-\n 2 files changed, 32 insertions(+), 26 deletions(-)\n rename README => README.md (65%)\n\n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279289","messageId":"1456389450-27118-2-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456389450-27118-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH v2 1/5] README: use markdown syntax","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-25T08:37:26Z","receivedAt":"2016-02-25T08:37:26Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"This allows repository browsers like GitHub to display the content of\nthe file nicely formatted.\n\nSigned-off-by: Matthieu Moy \n---\n README => README.md | 7 ++-----\n t/t7001-mv.sh | 2 +-\n 2 files changed, 3 insertions(+), 6 deletions(-)\n rename README => README.md (93%)\n\ndiff --git a/README b/README.md\nsimilarity index 93%\nrename from README\nrename to README.md\nindex 1083735..600779c 100644\n--- a/README\n+++ b/README.md\n@@ -1,8 +1,5 @@\n-////////////////////////////////////////////////////////////////\n-\n-\tGit - the stupid content tracker\n-\n-////////////////////////////////////////////////////////////////\n+Git - the stupid content tracker\n+================================\n \n \"git\" can mean anything, depending on your mood.\n \ndiff --git a/t/t7001-mv.sh b/t/t7001-mv.sh\nindex 51dd2b4..4008fae 100755\n--- a/t/t7001-mv.sh\n+++ b/t/t7001-mv.sh\n@@ -102,7 +102,7 @@ test_expect_success \\\n \n test_expect_success \\\n 'adding another file' \\\n- 'cp \"$TEST_DIRECTORY\"/../README path0/README &&\n+ 'cp \"$TEST_DIRECTORY\"/../README.md path0/README &&\n git add path0/README &&\n git commit -m add2 -a'\n \n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279291","messageId":"1456389450-27118-3-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456389450-27118-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH v2 2/5] README.md: add hyperlinks on filenames","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-25T08:37:27Z","receivedAt":"2016-02-25T08:37:27Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"Signed-off-by: Matthieu Moy \n---\n README.md | 19 +++++++++++++------\n 1 file changed, 13 insertions(+), 6 deletions(-)\n\ndiff --git a/README.md b/README.md\nindex 600779c..e54f9e7 100644\n--- a/README.md\n+++ b/README.md\n@@ -21,17 +21,17 @@ License version 2 (some parts of it are under different licenses,\n compatible with the GPLv2). It was originally written by Linus\n Torvalds with help of a group of hackers around the net.\n \n-Please read the file INSTALL for installation instructions.\n+Please read the file [INSTALL][] for installation instructions.\n \n-See Documentation/gittutorial.txt to get started, then see\n-Documentation/giteveryday.txt for a useful minimum set of commands, and\n-Documentation/git-commandname.txt for documentation of each command.\n+See [Documentation/gittutorial.txt][] to get started, then see\n+[Documentation/giteveryday.txt][] for a useful minimum set of commands, and\n+[Documentation/git-commandname.txt][] for documentation of each command.\n If git has been correctly installed, then the tutorial can also be\n read with \"man gittutorial\" or \"git help tutorial\", and the\n documentation of each command with \"man git-commandname\" or \"git help\n commandname\".\n \n-CVS users may also want to read Documentation/gitcvs-migration.txt\n+CVS users may also want to read [Documentation/gitcvs-migration.txt][]\n (\"man gitcvs-migration\" or \"git help cvs-migration\" if git is\n installed).\n \n@@ -41,7 +41,7 @@ including full documentation and Git related tools.\n The user discussion and development of Git take place on the Git\n mailing list -- everyone is welcome to post bug reports, feature\n requests, comments and patches to git@vger.kernel.org (read\n-Documentation/SubmittingPatches for instructions on patch submission).\n+[Documentation/SubmittingPatches][] for instructions on patch submission).\n To subscribe to the list, send an email with just \"subscribe git\" in\n the body to majordomo@vger.kernel.org. The mailing list archives are\n available at http://news.gmane.org/gmane.comp.version-control.git/,\n@@ -51,3 +51,10 @@ The maintainer frequently sends the \"What's cooking\" reports that\n list the current status of various development topics to the mailing\n list. The discussion following them give a good reference for\n project status, development direction and remaining tasks.\n+\n+[INSTALL]: INSTALL\n+[Documentation/gittutorial.txt]: Documentation/gittutorial.txt\n+[Documentation/giteveryday.txt]: Documentation/giteveryday.txt\n+[Documentation/git-commandname.txt]: Documentation/git-commandname.txt\n+[Documentation/gitcvs-migration.txt]: Documentation/gitcvs-migration.txt\n+[Documentation/SubmittingPatches]: Documentation/SubmittingPatches\n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279290","messageId":"1456389450-27118-4-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456389450-27118-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH v2 3/5] README.md: move the link to git-scm.com up","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-25T08:37:28Z","receivedAt":"2016-02-25T08:37:28Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"The documentation available on git-scm.com is nicely formatted. It's\nbetter to point users to it than to the source code of the\ndocumentation.\n\nSigned-off-by: Matthieu Moy \n---\n README.md | 6 +++---\n 1 file changed, 3 insertions(+), 3 deletions(-)\n\ndiff --git a/README.md b/README.md\nindex e54f9e7..5500f8a 100644\n--- a/README.md\n+++ b/README.md\n@@ -23,6 +23,9 @@ Torvalds with help of a group of hackers around the net.\n \n Please read the file [INSTALL][] for installation instructions.\n \n+Many Git online resources are accessible from http://git-scm.com/\n+including full documentation and Git related tools.\n+\n See [Documentation/gittutorial.txt][] to get started, then see\n [Documentation/giteveryday.txt][] for a useful minimum set of commands, and\n [Documentation/git-commandname.txt][] for documentation of each command.\n@@ -35,9 +38,6 @@ CVS users may also want to read [Documentation/gitcvs-migration.txt][]\n (\"man gitcvs-migration\" or \"git help cvs-migration\" if git is\n installed).\n \n-Many Git online resources are accessible from http://git-scm.com/\n-including full documentation and Git related tools.\n-\n The user discussion and development of Git take place on the Git\n mailing list -- everyone is welcome to post bug reports, feature\n requests, comments and patches to git@vger.kernel.org (read\n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279288","messageId":"1456389450-27118-5-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456389450-27118-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH v2 4/5] README.md: don't call git stupid in the title","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-25T08:37:29Z","receivedAt":"2016-02-25T08:37:29Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"\"the stupid content tracker\" was true in the early days of Git, but\nhardly applicable these days. \"fast, scalable, distributed\" describes\nGit more accuralety.\n\nAlso, \"stupid\" can be seen as offensive by some people. Let's not use it\nin the very first words of the README.\n\nThe new formulation is taken from the description of the Debian package.\n\nSigned-off-by: Matthieu Moy \n---\n README.md | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/README.md b/README.md\nindex 5500f8a..e3ddc3e 100644\n--- a/README.md\n+++ b/README.md\n@@ -1,5 +1,5 @@\n-Git - the stupid content tracker\n-================================\n+Git - fast, scalable, distributed revision control system\n+=========================================================\n \n \"git\" can mean anything, depending on your mood.\n \n-- \n2.7.2.334.g35ed2ae.dirty\n"},{"id":"279292","messageId":"1456389450-27118-6-git-send-email-Matthieu.Moy@imag.fr","threadId":"41486","inReplyTo":"1456389450-27118-1-git-send-email-Matthieu.Moy@imag.fr","subject":"[PATCH v2 5/5] README.md: move down historical explanation about the name","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2016-02-25T08:37:30Z","receivedAt":"2016-02-25T08:37:30Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"The explanations about why the name was chosen are secondary compared to\nthe description and link to the documentation.\n\nSome consider these explanations as good computer scientists joke, but\nother see it as needlessly offensive vocabulary.\n\nThis patch preserves the historical joke, but gives it less importance\nby moving it to the end of the README, and makes it clear that it is a\nhistorical explanation, that does not necessarily reflect the state of\nmind of current developers.\n\nSigned-off-by: Matthieu Moy \n---\n README.md | 24 +++++++++++++-----------\n 1 file changed, 13 insertions(+), 11 deletions(-)\n\ndiff --git a/README.md b/README.md\nindex e3ddc3e..d1ffbb6 100644\n--- a/README.md\n+++ b/README.md\n@@ -1,17 +1,6 @@\n Git - fast, scalable, distributed revision control system\n =========================================================\n \n-\"git\" can mean anything, depending on your mood.\n-\n- - random three-letter combination that is pronounceable, and not\n- actually used by any common UNIX command. The fact that it is a\n- mispronunciation of \"get\" may or may not be relevant.\n- - stupid. contemptible and despicable. simple. Take your pick from the\n- dictionary of slang.\n- - \"global information tracker\": you're in a good mood, and it actually\n- works for you. Angels sing, and a light suddenly fills the room.\n- - \"goddamn idiotic truckload of sh*t\": when it breaks\n-\n Git is a fast, scalable, distributed revision control system with an\n unusually rich command set that provides both high-level operations\n and full access to internals.\n@@ -52,6 +41,19 @@ list the current status of various development topics to the mailing\n list. The discussion following them give a good reference for\n project status, development direction and remaining tasks.\n \n+The name \"git\" was given by Linus Torvalds when he wrote the very\n+first version. He described the tool as \"the stupid content tracker\"\n+and the name as (depending on your mood):\n+\n+ - random three-letter combination that is pronounceable, and not\n+ actually used by any common UNIX command. The fact that it is a\n+ mispronunciation of \"get\" may or may not be relevant.\n+ - stupid. contemptible and despicable. simple. Take your pick from the\n+ dictionary of slang.\n+ - \"global information tracker\": you're in a good mood, and it actually\n+ works for you. Angels sing, and a light suddenly fills the room.\n+ - \"goddamn idiotic truckload of sh*t\": when it breaks\n+\n [INSTALL]: INSTALL\n [Documentation/gittutorial.txt]: Documentation/gittutorial.txt\n [Documentation/giteveryday.txt]: Documentation/giteveryday.txt\n-- \n2.7.2.334.g35ed2ae.dirty\n"}]}