{"thread":{"id":"31553","subject":"[PATCH 6/8] Doc add: link gitignore","startedAt":"2012-09-16T10:58:01Z","lastAt":"2012-09-17T22:01:30Z","messageCount":3,"participants":["Philip Oakley","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":8},"messages":[{"id":"199154","messageId":"1347793083-4136-7-git-send-email-philipoakley@iee.org","threadId":"31553","inReplyTo":null,"subject":"[PATCH 6/8] Doc add: link gitignore","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2012-09-16T10:58:01Z","receivedAt":"2012-09-16T10:58:01Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"Include the gitignore link with the paired gitrepository-\nlayout link.\n\nSigned-off-by: Philip Oakley <philipoakley@iee.org>\n---\n\nwithout the gitignore link users are unlikely to realise the\nsignificance of the repository layout link, nor what to look for\nwithin it\n\ndiff --git a/Documentation/git-add.txt b/Documentation/git-add.txt\nindex 9c1d395..311be9a 100644\n--- a/Documentation/git-add.txt\n+++ b/Documentation/git-add.txt\n@@ -155,7 +155,8 @@ Configuration\n The optional configuration variable `core.excludesfile` indicates a path to a\n file containing patterns of file names to exclude from git-add, similar to\n $GIT_DIR/info/exclude.  Patterns in the exclude file are used in addition to\n-those in info/exclude.  See linkgit:gitrepository-layout[5].\n+those in info/exclude.  See linkgit:gitrepository-layout[5] and\n+linkgit:gitignore[5].\n \n \n EXAMPLES\n-- \n1.7.8.msysgit.0\n"},{"id":"199191","messageId":"7vhaqxw635.fsf@alter.siamese.dyndns.org","threadId":"31553","inReplyTo":"1347793083-4136-7-git-send-email-philipoakley@iee.org","subject":"Re: [PATCH 6/8] Doc add: link gitignore","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2012-09-17T05:50:38Z","receivedAt":"2012-09-17T05:50:38Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Philip Oakley <philipoakley@iee.org> writes:\n\n> Include the gitignore link with the paired gitrepository-\n> layout link.\n>\n> Signed-off-by: Philip Oakley <philipoakley@iee.org>\n> ---\n>\n> without the gitignore link users are unlikely to realise the\n> significance of the repository layout link, nor what to look for\n> within it\n>\n> diff --git a/Documentation/git-add.txt b/Documentation/git-add.txt\n> index 9c1d395..311be9a 100644\n> --- a/Documentation/git-add.txt\n> +++ b/Documentation/git-add.txt\n> @@ -155,7 +155,8 @@ Configuration\n>  The optional configuration variable `core.excludesfile` indicates a path to a\n>  file containing patterns of file names to exclude from git-add, similar to\n>  $GIT_DIR/info/exclude.  Patterns in the exclude file are used in addition to\n> -those in info/exclude.  See linkgit:gitrepository-layout[5].\n> +those in info/exclude.  See linkgit:gitrepository-layout[5] and\n> +linkgit:gitignore[5].\n\nA reader of git-add shouldn't have to refer to gitrepository-layout[5]\nin the first place when we talk about \"add $pathspec\" may ignore\npaths that are configured to be ignored.  gitignore[5] should give\neverything necessary to him.\n\nThis section (even before the precontext we can see in the patch)\nmay need a bit larger rewrite so that it just refers to gitignore[5]\nand leave the details of where the exclude information comes to that\nmanual page.\n"},{"id":"199299","messageId":"6AB419E032004F8A890B01EC04731CD2@PhilipOakley","threadId":"31553","inReplyTo":"7vhaqxw635.fsf@alter.siamese.dyndns.org","subject":"Re: [PATCH 6/8] Doc add: link gitignore","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2012-09-17T22:01:30Z","receivedAt":"2012-09-17T22:01:30Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"From: \"Junio C Hamano\" <gitster@pobox.com>\n> Philip Oakley <philipoakley@iee.org> writes:\n>\n>> Include the gitignore link with the paired gitrepository-\n>> layout link.\n>>\n>> Signed-off-by: Philip Oakley <philipoakley@iee.org>\n>> ---\n>>\n>> without the gitignore link users are unlikely to realise the\n>> significance of the repository layout link, nor what to look for\n>> within it\n>>\n>> diff --git a/Documentation/git-add.txt b/Documentation/git-add.txt\n>> index 9c1d395..311be9a 100644\n>> --- a/Documentation/git-add.txt\n>> +++ b/Documentation/git-add.txt\n>> @@ -155,7 +155,8 @@ Configuration\n>>  The optional configuration variable `core.excludesfile` indicates a \n>> path to a\n>>  file containing patterns of file names to exclude from git-add, \n>> similar to\n>>  $GIT_DIR/info/exclude.  Patterns in the exclude file are used in \n>> addition to\n>> -those in info/exclude.  See linkgit:gitrepository-layout[5].\n>> +those in info/exclude.  See linkgit:gitrepository-layout[5] and\n>> +linkgit:gitignore[5].\n>\n> A reader of git-add shouldn't have to refer to gitrepository-layout[5]\n> in the first place when we talk about \"add $pathspec\" may ignore\n> paths that are configured to be ignored.  gitignore[5] should give\n> everything necessary to him.\n\nTrue. Now that 5/8 makes the details in gitignore clearer it should be \nOK to change from linking repository layout to the gitignor page.\n>\n> This section (even before the precontext we can see in the patch)\n> may need a bit larger rewrite so that it just refers to gitignore[5]\n> and leave the details of where the exclude information comes to that\n> manual page.\n\nI'll see if I can do something on that as a separate patch.\n\nPhilip \n"}]}