{"thread":{"id":"34986","subject":"[PATCH V3 1/2] doc: command line interface (cli) dot-repository dwimmery","startedAt":"2013-09-21T15:11:07Z","lastAt":"2013-10-16T06:53:05Z","messageCount":5,"participants":["Philip Oakley","Junio C Hamano"],"isPatch":true,"patchVersion":3,"patchTotal":2},"messages":[{"id":"227991","messageId":"1379776269-4496-1-git-send-email-philipoakley@iee.org","threadId":"34986","inReplyTo":null,"subject":"[PATCH V3 0/2] Extend dot repository documentation","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2013-09-21T15:11:07Z","receivedAt":"2013-09-21T15:11:07Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"This completes the patch series on adding short notes about\nthe dot repository capability in git, which is a consequence of\nthe relative path '.' being used as a repository URL.\n\nThe previous 2/3 was accepted and is not repeated here.\nPatch 3/3 is now an ammendment 1/2 \nPatch 1/3 is corrected and is now 2/2\n\nThe first patch is a minor update that give the dot repository note\nits own bullet, and updates the wording to imply repository discovery\nfrom the current directory.\n\nThe second patch updates the Git URLs section to include a specific\nnote about relative paths and its use as a dot repository.\n\nIt should be noted that repository discovery is not well covered in\nthe documentation but is distributed among a number sections. This\ncould do with a small section somewhere..\n\nPhilip Oakley (2):\n doc: command line interface (cli) dot-repository dwimmery\n Doc URLs: relative paths imply the dot-respository\n\n Documentation/gitcli.txt | 8 ++++----\n Documentation/urls.txt | 8 ++++++++\n 2 files changed, 12 insertions(+), 4 deletions(-)\n\n-- \n1.8.1.msysgit.1\n"},{"id":"227990","messageId":"1379776269-4496-2-git-send-email-philipoakley@iee.org","threadId":"34986","inReplyTo":"1379776269-4496-1-git-send-email-philipoakley@iee.org","subject":"[PATCH V3 1/2] doc: command line interface (cli) dot-repository dwimmery","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2013-09-21T15:11:08Z","receivedAt":"2013-09-21T15:11:08Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"The Git cli will accept dot '.' (period) as the relative path,\nand thus the current repository. Explain this action.\n\nSigned-off-by: Philip Oakley \n---\n\nThis updates 431260cc8dd\n\n Documentation/gitcli.txt | 8 ++++----\n 1 file changed, 4 insertions(+), 4 deletions(-)\n\ndiff --git a/Documentation/gitcli.txt b/Documentation/gitcli.txt\nindex b065c0e..50e4ce0 100644\n--- a/Documentation/gitcli.txt\n+++ b/Documentation/gitcli.txt\n@@ -58,10 +58,10 @@ the paths in the index that match the pattern to be checked out to your\n working tree. After running `git add hello.c; rm hello.c`, you will _not_\n see `hello.c` in your working tree with the former, but with the latter\n you will.\n-+\n-Just as the filesystem '.' (period) refers to the current directory,\n-using a '.' as a repository name in Git (a dot-repository) is a relative\n-path for your current repository.\n+\n+ * Just as the filesystem '.' (period) refers to the current directory,\n+ using a '.' as a repository name in Git (a dot-repository) is a relative\n+ path and hence will be your current repository.\n \n Here are the rules regarding the \"flags\" that you should follow when you are\n scripting Git:\n-- \n1.8.1.msysgit.1\n"},{"id":"227992","messageId":"1379776269-4496-3-git-send-email-philipoakley@iee.org","threadId":"34986","inReplyTo":"1379776269-4496-1-git-send-email-philipoakley@iee.org","subject":"[PATCH V3 2/2] Doc URLs: relative paths imply the dot-respository","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2013-09-21T15:11:09Z","receivedAt":"2013-09-21T15:11:09Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"Signed-off-by: Philip Oakley \n---\n Documentation/urls.txt | 8 ++++++++\n 1 file changed, 8 insertions(+)\n\ndiff --git a/Documentation/urls.txt b/Documentation/urls.txt\nindex 9ccb246..3469e8b 100644\n--- a/Documentation/urls.txt\n+++ b/Documentation/urls.txt\n@@ -55,6 +55,14 @@ These two syntaxes are mostly equivalent, except the former implies\n --local option.\n endif::git-clone[]\n \n+Relative paths are relative to the current directory. Hence while the\n+path:\n+\n+- '.'\n+\n+is the current directory, it is also the current repository and acts\n+as if it were a repository named `'.'`.\n+\n When Git doesn't know how to handle a certain transport protocol, it\n attempts to use the 'remote-' remote helper, if one\n exists. To explicitly request a remote helper, the following syntax\n-- \n1.8.1.msysgit.1\n"},{"id":"229027","messageId":"xmqqhacici3t.fsf@gitster.dls.corp.google.com","threadId":"34986","inReplyTo":"1379776269-4496-2-git-send-email-philipoakley@iee.org","subject":"Re: [PATCH V3 1/2] doc: command line interface (cli) dot-repository dwimmery","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-10-15T21:57:42Z","receivedAt":"2013-10-15T21:57:42Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Philip Oakley writes:\n\n> The Git cli will accept dot '.' (period) as the relative path,\n> and thus the current repository. Explain this action.\n>\n> Signed-off-by: Philip Oakley \n> ---\n>\n> This updates 431260cc8dd\n\nIt appears that the original has already been merged to 'next', so\nwe need to make this incremental on top. I'll queue this on top.\n\n-- >8 --\nFrom: Philip Oakley \nSubject: doc/cli: make \"dot repository\" an independent bullet point\n\nThe way to spell the current repository with a '.' dot is\nindependent from how the pathspec allows globs expanded by Git.\n\nMake them two separate bullet items in the enumeration.\n\nSigned-off-by: Philip Oakley \nSigned-off-by: Junio C Hamano \n---\n Documentation/gitcli.txt | 8 ++++----\n 1 file changed, 4 insertions(+), 4 deletions(-)\n\ndiff --git a/Documentation/gitcli.txt b/Documentation/gitcli.txt\nindex 1672842..24e1784 100644\n--- a/Documentation/gitcli.txt\n+++ b/Documentation/gitcli.txt\n@@ -58,10 +58,10 @@ the paths in the index that match the pattern to be checked out to your\n working tree. After running `git add hello.c; rm hello.c`, you will _not_\n see `hello.c` in your working tree with the former, but with the latter\n you will.\n-+\n-Just as the filesystem '.' (period) refers to the current directory,\n-using a '.' as a repository name in Git (a dot-repository) is a relative\n-path for your current repository.\n+\n+ * Just as the filesystem '.' (period) refers to the current directory,\n+ using a '.' as a repository name in Git (a dot-repository) is a relative\n+ path and means your current repository.\n \n Here are the rules regarding the \"flags\" that you should follow when you are\n scripting Git:\n"},{"id":"229059","messageId":"48EF6E550D1745E0BEC830BE5CB2E88F@PhilipOakley","threadId":"34986","inReplyTo":"xmqqhacici3t.fsf@gitster.dls.corp.google.com","subject":"Re: [PATCH V3 1/2] doc: command line interface (cli) dot-repository dwimmery","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2013-10-16T06:53:05Z","receivedAt":"2013-10-16T06:53:05Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"From: \"Junio C Hamano\" \n> Philip Oakley writes:\n>\n>> The Git cli will accept dot '.' (period) as the relative path,\n>> and thus the current repository. Explain this action.\n>>\n>> Signed-off-by: Philip Oakley \n>> ---\n>>\n>> This updates 431260cc8dd\n>\n> It appears that the original has already been merged to 'next', so\n> we need to make this incremental on top. I'll queue this on top.\n\nThank you, that looks good.\n\n\n>\n> -- >8 --\n> From: Philip Oakley \n> Subject: doc/cli: make \"dot repository\" an independent bullet point\n>\n> The way to spell the current repository with a '.' dot is\n> independent from how the pathspec allows globs expanded by Git.\n>\n> Make them two separate bullet items in the enumeration.\n>\n> Signed-off-by: Philip Oakley \n> Signed-off-by: Junio C Hamano \n> ---\n> Documentation/gitcli.txt | 8 ++++----\n> 1 file changed, 4 insertions(+), 4 deletions(-)\n>\n> diff --git a/Documentation/gitcli.txt b/Documentation/gitcli.txt\n> index 1672842..24e1784 100644\n> --- a/Documentation/gitcli.txt\n> +++ b/Documentation/gitcli.txt\n> @@ -58,10 +58,10 @@ the paths in the index that match the pattern to \n> be checked out to your\n> working tree. After running `git add hello.c; rm hello.c`, you will \n> _not_\n> see `hello.c` in your working tree with the former, but with the \n> latter\n> you will.\n> -+\n> -Just as the filesystem '.' (period) refers to the current directory,\n> -using a '.' as a repository name in Git (a dot-repository) is a \n> relative\n> -path for your current repository.\n> +\n> + * Just as the filesystem '.' (period) refers to the current \n> directory,\n> + using a '.' as a repository name in Git (a dot-repository) is a \n> relative\n> + path and means your current repository.\n>\n> Here are the rules regarding the \"flags\" that you should follow when \n> you are\n> scripting Git:\n>\n> --\n"}]}