core.legacyheaders: Use the description used in RelNotes-1.5.0
authorSanti Béjar <sbejar@gmail.com>
Fri, 23 Feb 2007 16:03:43 +0000 (17:03 +0100)
committerJunio C Hamano <junkio@cox.net>
Sat, 24 Feb 2007 08:25:05 +0000 (00:25 -0800)
It explains what it does and why, and says how to use the new format.

Signed-off-by: Santi Béjar <sbejar@gmail.com>
Signed-off-by: Junio C Hamano <junkio@cox.net>
Documentation/config.txt
index 4a22a00b71d089f96603779324f71df774b3f1a6..9fec76935e299c5506ec3aab1aab942cefea972f 100644 (file)
@@ -192,10 +192,17 @@ core.compression::
        slowest.
 
 core.legacyheaders::
-       A boolean which enables the legacy object header format in case
-       you want to interoperate with old clients accessing the object
-       database directly (where the "http://" and "rsync://" protocols
-       count as direct access).
+       A boolean which
+       changes the format of loose objects so that they are more
+       efficient to pack and to send out of the repository over git
+       native protocol, since v1.4.2.  However, loose objects
+       written in the new format cannot be read by git older than
+       that version; people fetching from your repository using
+       older versions of git over dumb transports (e.g. http)
+       will also be affected.
++
+To let git use the new loose object format, you have to
+set core.legacyheaders to false.
 
 core.packedGitWindowSize::
        Number of bytes of a pack file to map into memory in a