{"thread":{"id":"43419","subject":"[PATCH] Documentation: Correct alternates documentation, document http-alternates","startedAt":"2006-11-18T23:30:15Z","lastAt":"2006-11-18T23:30:15Z","messageCount":1,"participants":["Petr Baudis"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"294679","messageId":"20061118233015.16808.4484.stgit@machine.or.cz","threadId":"43419","inReplyTo":null,"subject":"[PATCH] Documentation: Correct alternates documentation, document http-alternates","fromName":"Petr Baudis","fromEmail":"pasky@suse.cz","sentAt":"2006-11-18T23:30:15Z","receivedAt":"2006-11-18T23:30:15Z","isPatch":true,"sender":{"key":"pasky@ucw.cz","avatar":"https://avatars.githubusercontent.com/u/18439?v=4"},"body":"For one, the documentation invalidly claimed that the paths have to be\nabsolute when that's not the case and in fact there is a very valid reason\nnot to use absolute paths (documented the reason as well).\n\nSigned-off-by: Petr Baudis <pasky@suse.cz>\n---\n\n Documentation/repository-layout.txt |   17 ++++++++++++++---\n 1 files changed, 14 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/repository-layout.txt b/Documentation/repository-layout.txt\nindex fd9f406..73a025b 100644\n--- a/Documentation/repository-layout.txt\n+++ b/Documentation/repository-layout.txt\n@@ -52,9 +52,20 @@ objects/info/packs::\n \tby default.\n \n objects/info/alternates::\n-\tThis file records absolute filesystem paths of alternate\n-\tobject stores that this object store borrows objects\n-\tfrom, one pathname per line.\n+\tThis file records paths to alternate object stores that\n+\tthis object store borrows objects from, one pathname per\n+\tline. Note that not only native Git tools use it locally,\n+\tbut the HTTP fetcher also tries to use it remotely; this\n+\twill usually work if you have relative paths (relative\n+\tto the object database, not to the repository!) in your\n+\talternates file, but it will not work if you use absolute\n+\tpaths unless the absolute path in filesystem and web URL\n+\tis the same. See also 'objects/info/http-alternates'.\n+\n+objects/info/http-alternates::\n+\tThis file records URLs to alternate object stores that\n+\tthis object store borrows objects from, to be used when\n+\tthe repository is fetched over HTTP.\n \n refs::\n"}]}