diff options
| author |  Petr Baudis <pasky@suse.cz> | 2006-11-19 00:30:15 +0100 |
|---|---|---|
| committer |  Junio C Hamano <junkio@cox.net> | 2006-11-18 16:29:46 -0800 |
| commit | 198a4f4ff0694cb5b906278fc1c2b6e7db4d2737 (patch) | |
| tree | 54a19616a6e16084a1b7c7e8d10297062c59e4ba /Documentation | |
| parent | Documentation: Define symref and update HEAD description (diff) | |
| download | tgif-198a4f4ff0694cb5b906278fc1c2b6e7db4d2737.tar.xz | |
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.txt | 17 |
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 |