[PATCH] provide advance warning of some future pack default changes
Signed-off-by: Nicolas Pitre <nico@cam.org>
---
On Mon, 3 Dec 2007, Junio C Hamano wrote:
Show 19 quoted lines
> Nicolas Pitre <nico@cam.org> writes:
>
> > Two things I would like to see in the next version (1.5.5) as well, for
> > which we could provide early warnings now:
> >
> > - repack.usedeltabaseoffset defaulting to true
> >
> > - pack.indexversion defaulting to 2
>
> I think the former would be sensible, the latter I fear might be a bit
> too new but I do not recall the exact version dependency.
>
> Could you draft a patch to ReleaseNotes to explain the consequences of
> these changes using ordinary user's vocabulary, like:
>
> Starting v1.5.5, repack.usedeltabaseoffset will default to true,
> which will give denser packfile (i.e. more efficient storage).
> The downside is that git older than version X will not be able
> to use a repository packed using this setting.
diff --git a/Documentation/RelNotes-1.5.4.txt b/Documentation/RelNotes-1.5.4.txt
index 6645565..d6fd3dd 100644
--- a/Documentation/RelNotes-1.5.4.txt
+++ b/Documentation/RelNotes-1.5.4.txt
@@ -43,6 +43,17 @@ Deprecation notices
* "git peek-remote" is deprecated, as "git ls-remote" was written in C
and works for all transports, and will be removed in the future.
+ * From v1.5.5, the repack.usedeltabaseoffset config option will default
+ to true, which will give denser packfile (i.e. more efficient storage).
+ The downside is that git older than version 1.4.4 will not be able
+ to directly use a repository packed using this setting.
+
+ * From v1.5.5, the pack.indexversion config option will default to 2,
+ which is slightly more efficient, and makes repacking more immune to
+ data corruptions. Git older than version 1.5.2 may revert to version 1
+ of the pack index with a manual "git index-pack" to be able to directly
+ access corresponding pack files.
+
Updates since v1.5.3
--------------------
Nicolas Pitre <nico@cam.org>