pack-redundant: document deprecation
Running the command itself has generated a warning for several versions, which has recently been upgraded to an error. Let's also make sure the documentation mentions what is going on. This also gives us a good spot to explain the reasoning and recommend alternatives. Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Jeff King committed
Mar 28, 2023 at 15:06 UTC
fcf31daae4cdb71ec367aac0d2cbeef779e97451
1 file changed
+14
Documentation/git-pack-redundant.txt
+14
@@ -11,6 +11,20 @@ SYNOPSIS
11
[verse]
12
'git pack-redundant' [--verbose] [--alt-odb] (--all | <pack-filename>...)
13
14
+WARNING
15
+-------
16
+`git pack-redundant` has been deprecated and is scheduled for removal in
17
+a future version of Git. Because it can only remove entire duplicate
18
+packs and not individual duplicate objects, it is generally not a useful
19
+tool for reducing repository size. You are better off using `git gc` to
20
+do so, which will put objects into a new pack, removing duplicates.
21
+
22
+Running `pack-redundant` without the `--i-still-use-this` flag will fail
23
+in this release. If you believe you have a use case for which
24
+`pack-redundant` is better suited and oppose this removal, please
25
+contact the Git mailing list at git@vger.kernel.org. More information
26
+about the list is available at https://git-scm.com/community.
27
+
28
DESCRIPTION
29
-----------
30
This program computes which packs in your repository