Autogenerated HTML docs for v1.4.4-gef06

diff --git a/repository-layout.html b/repository-layout.html
index b3bff63befe1d0290eb7733958d0c3c8dca80910..6dda03f7d41b3aff7d6486f05afcaa9ee293c572 100644 (file)
--- a/repository-layout.html
+++ b/repository-layout.html
@@ -352,9 +352,25 @@ objects/info/alternates
 </dt>\r
 <dd>\r
 <p>\r
-        This file records absolute filesystem paths of alternate\r
-        object stores that this object store borrows objects\r
-        from, one pathname per line.\r
+        This file records paths to alternate object stores that\r
+        this object store borrows objects from, one pathname per\r
+        line. Note that not only native Git tools use it locally,\r
+        but the HTTP fetcher also tries to use it remotely; this\r
+        will usually work if you have relative paths (relative\r
+        to the object database, not to the repository!) in your\r
+        alternates file, but it will not work if you use absolute\r
+        paths unless the absolute path in filesystem and web URL\r
+        is the same. See also <em>objects/info/http-alternates</em>.\r
+</p>\r
+</dd>\r
+<dt>\r
+objects/info/http-alternates\r
+</dt>\r
+<dd>\r
+<p>\r
+        This file records URLs to alternate object stores that\r
+        this object store borrows objects from, to be used when\r
+        the repository is fetched over HTTP.\r
 </p>\r
 </dd>\r
 <dt>\r
@@ -527,7 +543,7 @@ logs/refs/tags/<tt>name</tt>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 18-Nov-2006 22:17:50 UTC\r
+Last updated 20-Nov-2006 03:17:36 UTC\r
 </div>\r
 </div>\r
 </body>\r

diff --git a/repository-layout.txt b/repository-layout.txt
index 6d8c58ed205cb051cf2a1f8f495d37405cabd398..e20fb7e74c22390e810a392f2625a3ba6b325477 100644 (file)
--- a/repository-layout.txt
+++ b/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