Documentation/BreakingChanges: announce removal of git-pack-redundant(1)
The git-pack-redundant(1) command is already in the process of being phased out and dies unless the user passes the `--i-still-use-this` flag since 4406522b76 (pack-redundant: escalate deprecation warning to an error, 2023-03-23). We haven't heard any complaints, so let's announce the removal of this command in Git 3.0 in our breaking changes document. Signed-off-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Patrick Steinhardt committed
Sep 2, 2024 at 10:13 UTC
53a92c9552ac83891c91f4b827e9b0d89c0adbba
1 file changed
+20
Documentation/BreakingChanges.txt
+20
@@ -115,6 +115,26 @@ info/grafts as outdated, 2014-03-05) and will be removed.
115
+
116
Cf. <20140304174806.GA11561@sigill.intra.peff.net>.
117
118
+* The git-pack-redundant(1) command can be used to remove redundant pack files.
119
+ The subcommand is unusably slow and the reason why nobody reports it as a
120
+ performance bug is suspected to be the absense of users. We have nominated
121
+ the command for removal and have started to emit a user-visible warning in
122
+ c3b58472be (pack-redundant: gauge the usage before proposing its removal,
123
+ 2020-08-25) whenever the command is executed.
124
++
125
+So far there was a single complaint about somebody still using the command, but
126
+that complaint did not cause us to reverse course. On the contrary, we have
127
+doubled down on the deprecation and starting with 4406522b76 (pack-redundant:
128
+escalate deprecation warning to an error, 2023-03-23), the command dies unless
129
+the user passes the `--i-still-use-this` option.
130
++
131
+There have not been any subsequent complaints, so this command will finally be
132
+removed.
133
++
134
+Cf. <xmqq1rjuz6n3.fsf_-_@gitster.c.googlers.com>,
135
+ <CAKvOHKAFXQwt4D8yUCCkf_TQL79mYaJ=KAKhtpDNTvHJFuX1NA@mail.gmail.com>,
136
+ <20230323204047.GA9290@coredump.intra.peff.net>,
137
+
138
== Superseded features that will not be deprecated
139
140
Some features have gained newer replacements that aim to improve the design in