{"thread":{"id":"17032","subject":"[PATCH] tutorial.txt renamed","startedAt":"2009-01-07T04:23:37Z","lastAt":"2009-01-08T09:21:46Z","messageCount":6,"participants":["Joey Hess","Christian Couder","Brian Gernhardt","Junio C Hamano","Brian Foster"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"99537","messageId":"20090107042337.GA24735@gnu.kitenet.net","threadId":"17032","inReplyTo":null,"subject":"[PATCH] tutorial.txt renamed","fromName":"Joey Hess","fromEmail":"joey@kitenet.net","sentAt":"2009-01-07T04:23:37Z","receivedAt":"2009-01-07T04:23:37Z","isPatch":true,"sender":{"key":"joey@kitenet.net","avatar":"https://avatars.githubusercontent.com/u/16392?v=4"},"body":"The tutorial.txt file was renamed to gittutorial.txt some time ago, update\nREADME.\n\nSigned-off-by: Joey Hess \n---\n README | 2 +-\n 1 files changed, 1 insertions(+), 1 deletions(-)\n\ndiff --git a/README b/README\nindex 548142c..5fa41b7 100644\n--- a/README\n+++ b/README\n@@ -24,7 +24,7 @@ It was originally written by Linus Torvalds with help of a group of\n hackers around the net. It is currently maintained by Junio C Hamano.\n \n Please read the file INSTALL for installation instructions.\n-See Documentation/tutorial.txt to get started, then see\n+See Documentation/gittutorial.txt to get started, then see\n Documentation/everyday.txt for a useful minimum set of commands,\n and \"man git-commandname\" for documentation of each command.\n CVS users may also want to read Documentation/cvs-migration.txt.\n-- \n1.5.6.5\n\n-- \nsee shy jo\n"},{"id":"99542","messageId":"200901070628.38019.chriscool@tuxfamily.org","threadId":"17032","inReplyTo":"20090107042337.GA24735@gnu.kitenet.net","subject":"Re: [PATCH] tutorial.txt renamed","fromName":"Christian Couder","fromEmail":"chriscool@tuxfamily.org","sentAt":"2009-01-07T05:28:37Z","receivedAt":"2009-01-07T05:28:37Z","isPatch":true,"sender":{"key":"christian.couder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/208954?v=4"},"body":"Le mercredi 7 janvier 2009, Joey Hess a écrit :\n> The tutorial.txt file was renamed to gittutorial.txt some time ago,\n> update README.\n>\n> Signed-off-by: Joey Hess \n> ---\n> README | 2 +-\n> 1 files changed, 1 insertions(+), 1 deletions(-)\n>\n> diff --git a/README b/README\n> index 548142c..5fa41b7 100644\n> --- a/README\n> +++ b/README\n> @@ -24,7 +24,7 @@ It was originally written by Linus Torvalds with help\n> of a group of hackers around the net. It is currently maintained by Junio\n> C Hamano.\n>\n> Please read the file INSTALL for installation instructions.\n> -See Documentation/tutorial.txt to get started, then see\n> +See Documentation/gittutorial.txt to get started, \n\n\"man gittutorial\" and \"git help tutorial\" should work to display the \ntutorial, so perhaps we should advise to use them instead of the source, \nsince we are advising to use \"man git-commandname\" below to get help on \neach command.\n\n> then see \n> Documentation/everyday.txt for a useful minimum set of commands,\n\n(But the everyday.txt file has not been converted to a man page, so we \ncannot advise to use \"man giteveryday\".)\n\n> and \"man git-commandname\" for documentation of each command.\n\nYeah \"man git-commandname\" and \"git help commandname\" should work.\n\n> CVS users may also want to read Documentation/cvs-migration.txt.\n\nThe \"cvs-migration.txt\" was also renamed \"gitcvs-migration.txt\". It should \nbe available with \"man gitcvs-migration\" and \"git help cvs-migration\".\n\nThanks,\nChristian.\n\n> --\n> 1.5.6.5\n"},{"id":"99543","messageId":"DA6E1A83-FFBA-46BC-9BCF-ED8A2D8F12E7@silverinsanity.com","threadId":"17032","inReplyTo":"200901070628.38019.chriscool@tuxfamily.org","subject":"Re: [PATCH] tutorial.txt renamed","fromName":"Brian Gernhardt","fromEmail":"benji@silverinsanity.com","sentAt":"2009-01-07T05:36:26Z","receivedAt":"2009-01-07T05:36:26Z","isPatch":true,"sender":{"key":"benji@silverinsanity.com","avatar":"https://gravatar.com/avatar/e06c101dbc25c68114d859b4a9ec7cf8a2c52fd2b0270ef0eac0e2e63ff22311?d=mp&s=160"},"body":"\nOn Jan 7, 2009, at 12:28 AM, Christian Couder wrote:\n\n> Le mercredi 7 janvier 2009, Joey Hess a écrit :\n>> diff --git a/README b/README\n>> index 548142c..5fa41b7 100644\n>> --- a/README\n>> +++ b/README\n>> @@ -24,7 +24,7 @@ It was originally written by Linus Torvalds with \n>> help\n>> of a group of hackers around the net. It is currently maintained by \n>> Junio\n>> C Hamano.\n>>\n>> Please read the file INSTALL for installation instructions.\n>> -See Documentation/tutorial.txt to get started, then see\n>> +See Documentation/gittutorial.txt to get started,\n>\n> \"man gittutorial\" and \"git help tutorial\" should work to display the\n> tutorial, so perhaps we should advise to use them instead of the \n> source,\n> since we are advising to use \"man git-commandname\" below to get help \n> on\n> each command.\n\nThis is the README file for the project, so it should advise looking \nat the Documentation directory as neither the man pages or git command \nare likely installed at this point.\n\n>> CVS users may also want to read Documentation/cvs-migration.txt.\n>\n> The \"cvs-migration.txt\" was also renamed \"gitcvs-migration.txt\". It \n> should\n> be available with \"man gitcvs-migration\" and \"git help cvs-migration\".\n\nThis however is a valid point.\n\nI would also suggest that the patch have a different name, as I \nexpected it to be renaming tutorial.txt and I was going to ask why. \nPerhaps \"README: correct for renamed files\"?\n\n~~ Brian G."},{"id":"99544","messageId":"200901070707.36263.chriscool@tuxfamily.org","threadId":"17032","inReplyTo":"DA6E1A83-FFBA-46BC-9BCF-ED8A2D8F12E7@silverinsanity.com","subject":"Re: [PATCH] tutorial.txt renamed","fromName":"Christian Couder","fromEmail":"chriscool@tuxfamily.org","sentAt":"2009-01-07T06:07:35Z","receivedAt":"2009-01-07T06:07:35Z","isPatch":true,"sender":{"key":"christian.couder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/208954?v=4"},"body":"Le mercredi 7 janvier 2009, Brian Gernhardt a écrit :\n> On Jan 7, 2009, at 12:28 AM, Christian Couder wrote:\n> > Le mercredi 7 janvier 2009, Joey Hess a écrit :\n> >> diff --git a/README b/README\n> >> index 548142c..5fa41b7 100644\n> >> --- a/README\n> >> +++ b/README\n> >> @@ -24,7 +24,7 @@ It was originally written by Linus Torvalds with\n> >> help\n> >> of a group of hackers around the net. It is currently maintained by\n> >> Junio\n> >> C Hamano.\n> >>\n> >> Please read the file INSTALL for installation instructions.\n> >> -See Documentation/tutorial.txt to get started, then see\n> >> +See Documentation/gittutorial.txt to get started,\n> >\n> > \"man gittutorial\" and \"git help tutorial\" should work to display the\n> > tutorial, so perhaps we should advise to use them instead of the\n> > source,\n> > since we are advising to use \"man git-commandname\" below to get help\n> > on\n> > each command.\n>\n> This is the README file for the project, so it should advise looking\n> at the Documentation directory as neither the man pages or git command\n> are likely installed at this point.\n\nWell, this is debatable, because we first ask the user to read the INSTALL \nfile, and a tutorial for git may not be very usefull if you don't have it \ninstalled to try out the tutorial commands.\n\nRegards,\nChristian.\n"},{"id":"99545","messageId":"7vljtnbpha.fsf@gitster.siamese.dyndns.org","threadId":"17032","inReplyTo":"DA6E1A83-FFBA-46BC-9BCF-ED8A2D8F12E7@silverinsanity.com","subject":"Re: [PATCH] tutorial.txt renamed","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2009-01-07T06:27:13Z","receivedAt":"2009-01-07T06:27:13Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Brian Gernhardt writes:\n\n> This is the README file for the project, so it should advise looking \n> at the Documentation directory as neither the man pages or git command \n> are likely installed at this point.\n\nI think that is a sane suggestion. It is better to keep the number of\nprerequisites to the minimum for the user in order to follow README (and\nINSTALL, of course).\n"},{"id":"99688","messageId":"200901081021.46471.brian.foster@innova-card.com","threadId":"17032","inReplyTo":"7vljtnbpha.fsf@gitster.siamese.dyndns.org","subject":"Re: [PATCH] tutorial.txt renamed","fromName":"Brian Foster","fromEmail":"brian.foster@innova-card.com","sentAt":"2009-01-08T09:21:46Z","receivedAt":"2009-01-08T09:21:46Z","isPatch":true,"sender":{"key":"brian.foster@innova-card.com","avatar":null},"body":"On Wednesday 07 January 2009 07:27:13 Junio C Hamano wrote:\n> Brian Gernhardt writes:\n> > This is the README file for the project, so it should advise looking \n> > at the Documentation directory as neither the man pages or git command \n> > are likely installed at this point.\n> \n> I think that is a sane suggestion. It is better to keep the number of\n> prerequisites to the minimum for the user in order to follow README (and\n> INSTALL, of course).\n\n It is indeed a sane suggestion. However, there is no (obvious?)\n harm in *also* mentioning that ‘git help tutorial’ should also\n display the tutorial. Something like “If git has been correctly\n installed, then this tutorial can also be read with the command\n ‘git help tutorial’.”\n\ncheers!\n\t-blf-\n-- \n“How many surrealists does it take to | Brian Foster\n change a lightbulb? Three. One calms | somewhere in south of France\n the warthog, and two fill the bathtub | Stop E$$o (ExxonMobil)!\n with brightly-coloured machine tools.” | http://www.stopesso.com\n"}]}