{"thread":{"id":"17995","subject":"[PATCH] README: fix path to \"gitcvs-migration.txt\" and be more consistent","startedAt":"2009-02-24T20:16:37Z","lastAt":"2009-02-25T09:54:08Z","messageCount":3,"participants":["Christian Couder","Brian Foster","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"106100","messageId":"20090224211637.07d764f5.chriscool@tuxfamily.org","threadId":"17995","inReplyTo":null,"subject":"[PATCH] README: fix path to \"gitcvs-migration.txt\" and be more consistent","fromName":"Christian Couder","fromEmail":"chriscool@tuxfamily.org","sentAt":"2009-02-24T20:16:37Z","receivedAt":"2009-02-24T20:16:37Z","isPatch":true,"sender":{"key":"christian.couder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/208954?v=4"},"body":"Before this patch the README suggested to look at\n\"Documentation/gittutorial.txt\" for the tutorial and to use\n\"man git-commandname\" for documentation of each command.\n\nThis was not consistent because the tutorial can also be available with\n\"man gittutorial\" if git is installed, and the documentation for each\ncommand can be available at \"Documentation/git-commandname.txt\" if git\nis not installed.\n\nSo this patch tries to be more consistent and also fix the path to\nthe cvs-migration documentation that changed from\n\"Documentation/cvs-migration.txt\" to \"Documentation/gitcvs-migration.txt\".\n\nSigned-off-by: Christian Couder <chriscool@tuxfamily.org>\n---\n README |   14 +++++++++++---\n 1 files changed, 11 insertions(+), 3 deletions(-)\n\n\tThis comes from this discussion:\n\n\thttp://thread.gmane.org/gmane.comp.version-control.git/104753/focus=104906\n\ndiff --git a/README b/README\nindex 5fa41b7..c932ab3 100644\n--- a/README\n+++ b/README\n@@ -24,10 +24,18 @@ 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+\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+Documentation/everyday.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+(\"man gitcvs-migration\" or \"git help cvs-migration\" if git is\n+installed).\n \n Many Git online resources are accessible from http://git.or.cz/\n including full documentation and Git related tools.\n-- \n1.6.2.rc1.257.g6c75\n"},{"id":"106181","messageId":"200902251025.14960.brian.foster@innova-card.com","threadId":"17995","inReplyTo":"20090224211637.07d764f5.chriscool@tuxfamily.org","subject":"Re: [PATCH] README: fix path to \"gitcvs-migration.txt\" and be more consistent","fromName":"Brian Foster","fromEmail":"brian.foster@innova-card.com","sentAt":"2009-02-25T09:25:13Z","receivedAt":"2009-02-25T09:25:13Z","isPatch":true,"sender":{"key":"brian.foster@innova-card.com","avatar":null},"body":"On Tuesday 24 February 2009 21:16:37 Christian Couder wrote:\n>[ ... ]\n> diff --git a/README b/README\n> index 5fa41b7..c932ab3 100644\n> --- a/README\n> +++ b/README\n> @@ -24,10 +24,18 @@ 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> +\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> +Documentation/everyday.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 seems Ok to me, with a caveat — the information is correct,\n but the presentation has a (very minor!) problem (IM(H?)O).\n I find a bit confusing that whilst you type (e.g.):\n\n    git help tutorial\n\n you don't type:\n\n    git help commandname\n\n but (e.g.):\n\n    git help log\n\n that is, the ‘commandname’ is a placeholder (variable), whilst\n the ‘tutorial’ is a literal (constant).  there doesn't seem to\n be a clear distinction made....?    if a clear distinction is\n to be made, it should be done in a consistent manner throughout\n the README.  however, after a brief glance, there does not seem\n to be any distinction made in the README, so this is minor nit.\n\ncheers!\n\t-blf-\n\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"},{"id":"106190","messageId":"7vhc2i6dvj.fsf@gitster.siamese.dyndns.org","threadId":"17995","inReplyTo":"20090224211637.07d764f5.chriscool@tuxfamily.org","subject":"Re: [PATCH] README: fix path to \"gitcvs-migration.txt\" and be more consistent","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2009-02-25T09:54:08Z","receivedAt":"2009-02-25T09:54:08Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thanks.\n"}]}