[PATCH] repack: document there is no need to avoid delta-base-offset

From

Junio C Hamano <gitster@pobox.com>

Date

Jul 19, 2022, 21:48 UTC

Message-ID

<xmqqbktk93kl.fsf_-_@gitster.g>

In-Reply-To

<220719.8635exwje8.gmgdl@evledraar.gmail.com>

Signed-off-by: Junio C Hamano <gitster@pobox.com>
---

 * Instead of outright removing, it probably is a good idea to hint
   the reason why the now seemingly useless configuration variable
   is there, perhaps.

 Documentation/git-repack.txt | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git c/Documentation/git-repack.txt w/Documentation/git-repack.txt
index 0bf13893d8..882904fc7b 100644
--- c/Documentation/git-repack.txt
+++ w/Documentation/git-repack.txt
@@ -218,15 +218,11 @@ CONFIGURATION
 Various configuration variables affect packing, see
 linkgit:git-config[1] (search for "pack" and "delta").
 
-By default, the command passes `--delta-base-offset` option to
-'git pack-objects'; this typically results in slightly smaller packs,
-but the generated packs are incompatible with versions of Git older than
-version 1.4.4. If you need to share your repository with such ancient Git
-versions, either directly or via the dumb http protocol, then you
-need to set the configuration variable `repack.UseDeltaBaseOffset` to
-"false" and repack. Access from old Git versions over the native protocol
-is unaffected by this option as the conversion is performed on the fly
-as needed in that case.
+By default, the command passes `--delta-base-offset` option to 'git
+pack-objects', which results in packs smaller by a few per-cent.
+The configuration variable `repack.UseDeltaBaseOffset` can be set to
+`false` to disable it, but these days there hardly is any reason to
+do so.
 
 Delta compression is not used on objects larger than the
 `core.bigFileThreshold` configuration variable and on files with the