summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorPetr Baudis <pasky@suse.cz>2006-11-19 00:30:15 +0100
committerJunio C Hamano <junkio@cox.net>2006-11-18 16:29:46 -0800
commit198a4f4ff0694cb5b906278fc1c2b6e7db4d2737 (patch)
tree54a19616a6e16084a1b7c7e8d10297062c59e4ba /Documentation
parente3d457fb59f71dd40d24c82f48625a24492907d4 (diff)
downloadgit-198a4f4ff0694cb5b906278fc1c2b6e7db4d2737.tar.gz
Documentation: Correct alternates documentation, document http-alternates
For one, the documentation invalidly claimed that the paths have to be absolute when that's not the case and in fact there is a very valid reason not to use absolute paths (documented the reason as well). Signed-off-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Junio C Hamano <junkio@cox.net>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/repository-layout.txt17
1 files changed, 14 insertions, 3 deletions
diff --git a/Documentation/repository-layout.txt b/Documentation/repository-layout.txt
index 6d8c58ed20..e20fb7e74c 100644
--- a/Documentation/repository-layout.txt
+++ b/Documentation/repository-layout.txt
@@ -52,9 +52,20 @@ objects/info/packs::
by default.
objects/info/alternates::
- This file records absolute filesystem paths of alternate
- object stores that this object store borrows objects
- from, one pathname per line.
+ This file records paths to alternate object stores that
+ this object store borrows objects from, one pathname per
+ line. Note that not only native Git tools use it locally,
+ but the HTTP fetcher also tries to use it remotely; this
+ will usually work if you have relative paths (relative
+ to the object database, not to the repository!) in your
+ alternates file, but it will not work if you use absolute
+ paths unless the absolute path in filesystem and web URL
+ is the same. See also 'objects/info/http-alternates'.
+
+objects/info/http-alternates::
+ This file records URLs to alternate object stores that
+ this object store borrows objects from, to be used when
+ the repository is fetched over HTTP.
refs::
References are stored in subdirectories of this