]>
Commit | Line | Data |
---|---|---|
a2082dbd JH |
1 | Git v2.45 Release Notes |
2 | ======================= | |
3 | ||
4 | Backward Compatibility Notes | |
5 | ||
6 | UI, Workflows & Features | |
7 | ||
8 | * Integrate the reftable code into the refs framework as a backend. | |
9 | With "git init --ref-format=reftable", hopefully it would be a lot | |
10 | more efficient to manage a repository with many references. | |
11 | ||
12 | * "git checkout -p" and friends learned that that "@" is a synonym | |
13 | for "HEAD". | |
14 | ||
0f9d4d28 JH |
15 | * Variants of vimdiff learned to honor mergetool.<variant>.layout |
16 | settings. | |
17 | ||
b387623c JH |
18 | * "git reflog" learned a "list" subcommand that enumerates known reflogs. |
19 | ||
43072b4c JH |
20 | * When a merge conflicted at a submodule, merge-ort backend used to |
21 | unconditionally give a lengthy message to suggest how to resolve | |
22 | it. Now the message can be squelched as an advice message. | |
23 | ||
24 | * "git for-each-ref" learned "--include-root-refs" option to show | |
25 | even the stuff outside the 'refs/' hierarchy. | |
26 | ||
e09f1254 JH |
27 | * "git rev-list --missing=print" has learned to optionally take |
28 | "--allow-missing-tips", which allows the objects at the starting | |
29 | points to be missing. | |
30 | ||
31 | * "git merge-tree" has learned that the three trees involved in the | |
32 | 3-way merge only need to be trees, not necessarily commits. | |
33 | ||
34 | * "git log --merge" learned to pay attention to CHERRY_PICK_HEAD and | |
35 | other kinds of *_HEAD pseudorefs. | |
36 | ||
2953d95d JH |
37 | * Platform specific tweaks for OS/390 has been added to |
38 | config.mak.uname. | |
39 | ||
11c821f2 JH |
40 | * Users with safe.bareRepository=explicit can still work from within |
41 | $GIT_DIR of a seconary worktree (which resides at .git/worktrees/$name/) | |
42 | of the primary worktree without explicitly specifying the $GIT_DIR | |
43 | environment variable or the --git-dir=<path> option. | |
44 | ||
45 | * The output format for dates "iso-strict" has been tweaked to show | |
46 | a time in the Zulu timezone with "Z" suffix, instead of "+00:00". | |
47 | ||
d6fd0437 JH |
48 | * "git diff" and friends learned two extra configuration variables, |
49 | diff.srcPrefix and diff.dstPrefix. | |
50 | ||
51 | * The status.showUntrackedFiles configuration variable had a name | |
52 | that tempts users to set a Boolean value expressed in our usual | |
53 | "false", "off", and "0", but it only took "no". This has been | |
54 | corrected so "true" and its synonyms are taken as "normal", while | |
55 | "false" and its synonyms are taken as "no". | |
56 | ||
57 | * Remove an ancient and not well maintained Hg-to-git migration | |
58 | script from contrib/. | |
59 | ||
c2cbfbd2 JH |
60 | * Hints that suggest what to do after resolving conflicts can now be |
61 | squelched by disabling advice.mergeConflict. | |
62 | ||
7774cfed JH |
63 | * Allow git-cherry-pick(1) to automatically drop redundant commits via |
64 | a new `--empty` option, similar to the `--empty` options for | |
65 | git-rebase(1) and git-am(1). Includes a soft deprecation of | |
66 | `--keep-redundant-commits` as well as some related docs changes and | |
67 | sequencer code cleanup. | |
68 | ||
19981dae JH |
69 | * "git config" learned "--comment=<message>" option to leave a |
70 | comment immediately after the "variable = value" on the same line | |
71 | in the configuration file. | |
72 | ||
73 | * core.commentChar used to be limited to a single byte, but has been | |
74 | updated to allow an arbitrary multi-byte sequence. | |
75 | ||
91ec36f2 JH |
76 | * "git add -p" and other "interactive hunk selection" UI has learned to |
77 | skip showing the hunk immediately after it has already been shown, and | |
78 | an additional action to explicitly ask to reshow the current hunk. | |
79 | ||
bbeb7978 PS |
80 | * "git pack-refs" learned the "--auto" option, which defers the decision of |
81 | whether and how to pack to the ref backend. This is used by the reftable | |
82 | backend to avoid repacking of an already-optimal ref database. The new mode | |
83 | is triggered from "git gc --auto". | |
a2082dbd | 84 | |
548fe359 JH |
85 | * "git add -u <pathspec>" and "git commit [-i] <pathspec>" did not |
86 | diagnose a pathspec element that did not match any files in certain | |
87 | situations, unlike "git add <pathspec>" did. | |
88 | ||
21306a09 JH |
89 | * The userdiff patterns for C# has been updated. |
90 | ||
548fe359 | 91 | |
a2082dbd JH |
92 | Performance, Internal Implementation, Development Support etc. |
93 | ||
94 | * The code to iterate over refs with the reftable backend has seen | |
95 | some optimization. | |
96 | ||
97 | * More tests that are marked as "ref-files only" have been updated to | |
98 | improve test coverage of reftable backend. | |
99 | ||
0f9d4d28 JH |
100 | * Some parts of command line completion script (in contrib/) have |
101 | been micro-optimized. | |
102 | ||
b387623c JH |
103 | * The way placeholders are to be marked-up in documentation have been |
104 | specified; use "_<placeholder>_" to typeset the word inside a pair | |
bf3fe4f1 | 105 | of <angle-brackets> emphasized. |
b387623c | 106 | |
e09f1254 JH |
107 | * "git --no-lazy-fetch cmd" allows to run "cmd" while disabling lazy |
108 | fetching of objects from the promisor remote, which may be handy | |
109 | for debugging. | |
110 | ||
4f9b731b JH |
111 | * The implementation in "git clean" that makes "-n" and "-i" ignore |
112 | clean.requireForce has been simplified, together with the | |
113 | documentation. | |
114 | ||
2953d95d JH |
115 | * Uses of xwrite() helper have been audited and updated for better |
116 | error checking and simpler code. | |
117 | ||
3bd955d2 JH |
118 | * Some trace2 events that lacked def_param have learned to show it, |
119 | enriching the output. | |
120 | ||
11c821f2 JH |
121 | * The parse-options code that deals with abbreviated long option |
122 | names have been cleaned up. | |
123 | ||
124 | * The code in reftable backend that creates new table files works | |
125 | better with the tempfile framework to avoid leaving cruft after a | |
126 | failure. | |
127 | ||
128 | * The reftable code has its own custom binary search function whose | |
129 | comparison callback has an unusual interface, which caused the | |
130 | binary search to degenerate into a linear search, which has been | |
131 | corrected. | |
132 | ||
133 | * The code to iterate over reflogs in the reftable has been optimized | |
134 | to reduce memory allocation and deallocation. | |
135 | ||
d6fd0437 JH |
136 | * Work to support a repository that work with both SHA-1 and SHA-256 |
137 | hash algorithms has started. | |
138 | ||
139 | * A new fuzz target that exercises config parsing code has been | |
140 | added. | |
141 | ||
c2cbfbd2 JH |
142 | * Fix the way recently added tests interpolate variables defined |
143 | outside them, and document the best practice to help future | |
144 | developers. | |
145 | ||
7774cfed JH |
146 | * Introduce an experimental protocol for contributors to propose the |
147 | topic description to be used in the "What's cooking" report, the | |
148 | merge commit message for the topic, and in the release notes and | |
149 | document it in the SubmittingPatches document. | |
150 | ||
151 | * The t/README file now gives a hint on running individual tests in | |
152 | the "t/" directory with "make t<num>-*.sh t<num>-*.sh". | |
153 | (merge 8d383806fc pb/test-scripts-are-build-targets later to maint). | |
154 | ||
91ec36f2 JH |
155 | * The "hint:" messages given by the advice mechanism, when given a |
156 | message with a blank line, left a line with trailing whitespace, | |
157 | which has been cleansed. | |
158 | ||
159 | * Documentation rules has been explicitly described how to mark-up | |
160 | literal parts and a few manual pages have been updated as examples. | |
161 | ||
162 | * The .editorconfig file has been taught that a Makefile uses HT | |
163 | indentation. | |
164 | ||
8f7582d9 JH |
165 | * t-prio-queue test has been cleaned up by using C99 compound |
166 | literals; this is meant to also serve as a weather-balloon to smoke | |
167 | out folks with compilers who have trouble compiling code that uses | |
168 | the feature. | |
169 | ||
548fe359 JH |
170 | * Windows binary used to decide the use of unix-domain socket at |
171 | build time, but it learned to make the decision at runtime instead. | |
172 | ||
173 | * The "shared repository" test in the t0610 reftable test failed | |
174 | under restrictive umask setting (e.g. 007), which has been | |
175 | corrected. | |
176 | ||
21306a09 JH |
177 | * Document and apply workaround for a buggy version of dash that |
178 | mishandles "local var=val" construct. | |
179 | ||
180 | * The codepaths that reach date_mode_from_type() have been updated to | |
181 | pass "struct date_mode" by value to make them thread safe. | |
182 | ||
183 | * The strategy to compact multiple tables of reftables after many | |
184 | operations accumulate many entries has been improved to avoid | |
185 | accumulating too many tables uncollected. | |
186 | ||
a2082dbd JH |
187 | |
188 | Fixes since v2.44 | |
189 | ----------------- | |
190 | ||
191 | * "git apply" on a filesystem without filemode support have learned | |
192 | to take a hint from what is in the index for the path, even when | |
193 | not working with the "--index" or "--cached" option, when checking | |
194 | the executable bit match what is required by the preimage in the | |
195 | patch. | |
196 | (merge 45b625142d cp/apply-core-filemode later to maint). | |
197 | ||
198 | * "git column" has been taught to reject negative padding value, as | |
199 | it would lead to nonsense behaviour including division by zero. | |
200 | (merge 76fb807faa kh/column-reject-negative-padding later to maint). | |
201 | ||
0f9d4d28 JH |
202 | * "git am --help" now tells readers what actions are available in |
203 | "git am --whitespace=<action>", in addition to saying that the | |
204 | option is passed through to the underlying "git apply". | |
205 | (merge a171dac734 jc/am-whitespace-doc later to maint). | |
206 | ||
207 | * "git tag --column" failed to check the exit status of its "git | |
208 | column" invocation, which has been corrected. | |
209 | (merge 92e66478fc rj/tag-column-fix later to maint). | |
210 | ||
211 | * Credential helper based on libsecret (in contrib/) has been updated | |
212 | to handle an empty password correctly. | |
213 | (merge 8f1f2023b7 mh/libsecret-empty-password-fix later to maint). | |
214 | ||
b387623c JH |
215 | * "git difftool --dir-diff" learned to honor the "--trust-exit-code" |
216 | option; it used to always exit with 0 and signalled success. | |
217 | (merge eb84c8b6ce ps/difftool-dir-diff-exit-code later to maint). | |
218 | ||
43072b4c JH |
219 | * The code incorrectly attempted to use textconv cache when asked, |
220 | even when we are not running in a repository, which has been | |
221 | corrected. | |
222 | (merge affe355fe7 jk/textconv-cache-outside-repo-fix later to maint). | |
223 | ||
224 | * Remove an empty file that shouldn't have been added in the first | |
225 | place. | |
226 | (merge 4f66942215 js/remove-cruft-files later to maint). | |
227 | ||
228 | * The logic to access reflog entries by date and number had ugly | |
229 | corner cases at the boundaries, which have been cleaned up. | |
230 | (merge 5edd126720 jk/reflog-special-cases-fix later to maint). | |
231 | ||
232 | * An error message from "git upload-pack", which responds to "git | |
233 | fetch" requests, had a trialing NUL in it, which has been | |
234 | corrected. | |
235 | (merge 3f4c7a0805 sg/upload-pack-error-message-fix later to maint). | |
236 | ||
237 | * Clarify wording in the CodingGuidelines that requires <git-compat-util.h> | |
238 | to be the first header file. | |
239 | (merge 4e89f0e07c jc/doc-compat-util later to maint). | |
240 | ||
e09f1254 JH |
241 | * "git commit -v --cleanup=scissors" used to add the scissors line |
242 | twice in the log message buffer, which has been corrected. | |
243 | (merge e90cc075cc jt/commit-redundant-scissors-fix later to maint). | |
244 | ||
245 | * A custom remote helper no longer cannot access the newly created | |
246 | repository during "git clone", which is a regression in Git 2.44. | |
247 | This has been corrected. | |
248 | (merge 199f44cb2e ps/remote-helper-repo-initialization-fix later to maint). | |
249 | ||
250 | * Various parts of upload-pack has been updated to bound the resource | |
251 | consumption relative to the size of the repository to protect from | |
252 | abusive clients. | |
253 | (merge 6cd05e768b jk/upload-pack-bounded-resources later to maint). | |
254 | ||
255 | * The upload-pack program, when talking over v2, accepted the | |
256 | packfile-uris protocol extension from the client, even if it did | |
257 | not advertise the capability, which has been corrected. | |
258 | (merge a922bfa3b5 jk/upload-pack-v2-capability-cleanup later to maint). | |
259 | ||
94511502 JH |
260 | * Make sure failure return from merge_bases_many() is properly caught. |
261 | (merge 25fd20eb44 js/merge-base-with-missing-commit later to maint). | |
262 | ||
4f9b731b JH |
263 | * FSMonitor client code was confused when FSEvents were given in a |
264 | different case on a case-insensitive filesystem, which has been | |
265 | corrected. | |
266 | (merge 29c139ce78 jh/fsmonitor-icase-corner-case-fix later to maint). | |
267 | ||
268 | * The "core.commentChar" configuration variable only allows an ASCII | |
269 | character, which was not clearly documented, which has been | |
270 | corrected. | |
271 | (merge fb7c556f58 kh/doc-commentchar-is-a-byte later to maint). | |
272 | ||
273 | * With release 2.44 we got rid of all uses of test_i18ngrep and there | |
274 | is no in-flight topic that adds a new use of it. Make a call to | |
275 | test_i18ngrep a hard failure, so that we can remove it at the end | |
276 | of this release cycle. | |
277 | (merge 381a83dfa3 jc/test-i18ngrep later to maint). | |
278 | ||
279 | * The command line completion script (in contrib/) learned to | |
280 | complete "git reflog" better. | |
281 | (merge 1284f9cc11 rj/complete-reflog later to maint). | |
282 | ||
283 | * The logic to complete the command line arguments to "git worktree" | |
284 | subcommand (in contrib/) has been updated to correctly honor things | |
285 | like "git -C dir" etc. | |
286 | (merge 3574816d98 rj/complete-worktree-paths-fix later to maint). | |
287 | ||
2953d95d JH |
288 | * When git refuses to create a branch because the proposed branch |
289 | name is not a valid refname, an advice message is given to refer | |
290 | the user to exact naming rules. | |
291 | (merge 8fbd903e58 kh/branch-ref-syntax-advice later to maint). | |
292 | ||
3bd955d2 JH |
293 | * Code simplification by getting rid of code that sets an environment |
294 | variable that is no longer used. | |
295 | (merge 72a8d3f027 pw/rebase-i-ignore-cherry-pick-help-environment later to maint). | |
296 | ||
11c821f2 JH |
297 | * The code to find the effective end of log message can fall into an |
298 | endless loop, which has been corrected. | |
299 | (merge 2541cba2d6 fs/find-end-of-log-message-fix later to maint). | |
300 | ||
301 | * Mark-ups used in the documentation has been improved for | |
302 | consistency. | |
303 | (merge 45d5ed3e50 ja/doc-markup-fixes later to maint). | |
304 | ||
305 | * The status.showUntrackedFiles configuration variable was | |
306 | incorrectly documented to accept "false", which has been corrected. | |
307 | ||
c75fd8d8 JH |
308 | * Leaks from "git restore" have been plugged. |
309 | (merge 2f64da0790 rj/restore-plug-leaks later to maint). | |
310 | ||
311 | * "git bugreport --no-suffix" was not supported and instead | |
312 | segfaulted, which has been corrected. | |
313 | (merge b3b57c69da js/bugreport-no-suffix-fix later to maint). | |
314 | ||
315 | * The documentation for "%(trailers[:options])" placeholder in the | |
316 | "--pretty" option of commands in the "git log" family has been | |
317 | updated. | |
318 | (merge bff85a338c bl/doc-key-val-sep-fix later to maint). | |
319 | ||
c2cbfbd2 JH |
320 | * "git checkout --conflict=bad" reported a bad conflictStyle as if it |
321 | were given to a configuration variable; it has been corrected to | |
322 | report that the command line option is bad. | |
323 | (merge 5a99c1ac1a pw/checkout-conflict-errorfix later to maint). | |
324 | ||
325 | * Code clean-up in the "git log" machinery that implements custom log | |
326 | message formatting. | |
327 | (merge 1c10b8e5b0 jk/pretty-subject-cleanup later to maint). | |
328 | ||
329 | * "git config" corrupted literal HT characters written in the | |
330 | configuration file as part of a value, which has been corrected. | |
331 | (merge e6895c3f97 ds/config-internal-whitespace-fix later to maint). | |
332 | ||
333 | * A unit test for reftable code tried to enumerate all files in a | |
334 | directory after reftable operations and expected to see nothing but | |
335 | the files it wanted to leave there, but was fooled by .nfs* cruft | |
336 | files left, which has been corrected. | |
337 | (merge 0068aa7946 ps/reftable-unit-test-nfs-workaround later to maint). | |
338 | ||
7774cfed JH |
339 | * The implementation and documentation of "object-format" option |
340 | exchange between the Git itself and its remote helpers did not | |
341 | quite match, which has been corrected. | |
342 | ||
343 | * The "--pretty=<shortHand>" option of the commands in the "git log" | |
344 | family, defined as "[pretty] shortHand = <expansion>" should have | |
345 | been looked up case insensitively, but was not, which has been | |
346 | corrected. | |
347 | (merge f999d5188b bl/pretty-shorthand-config-fix later to maint). | |
348 | ||
91ec36f2 JH |
349 | * "git apply" failed to extract the filename the patch applied to, |
350 | when the change was about an empty file created in or deleted from | |
351 | a directory whose name ends with a SP, which has been corrected. | |
352 | (merge 776ffd1a30 jc/apply-parse-diff-git-header-names-fix later to maint). | |
353 | ||
354 | * Update a more recent tutorial doc. | |
355 | (merge 95ab557b4b dg/myfirstobjectwalk-updates later to maint). | |
356 | ||
357 | * The test script had an incomplete and ineffective attempt to avoid | |
358 | clobbering the testing user's real crontab (and its equivalents), | |
359 | which has been completed. | |
360 | (merge 73cb87773b es/test-cron-safety later to maint). | |
361 | ||
362 | * Use advice_if_enabled() API to rewrite a simple pattern to | |
363 | call advise() after checking advice_enabled(). | |
364 | (merge 6412d01527 rj/use-adv-if-enabled later to maint). | |
365 | ||
436d4e5b JH |
366 | * Another "set -u" fix for the bash prompt (in contrib/) script. |
367 | (merge d7805bc743 vs/complete-with-set-u-fix later to maint). | |
368 | ||
8f7582d9 JH |
369 | * "git checkout/switch --detach foo", after switching to the detached |
370 | HEAD state, gave the tracking information for the 'foo' branch, | |
371 | which was pointless. | |
372 | ||
548fe359 JH |
373 | * "git apply" has been updated to lift the hardcoded pathname length |
374 | limit, which in turn allowed a mksnpath() function that is no | |
375 | longer used. | |
376 | (merge 708f7e0590 rs/apply-lift-path-length-limit later to maint). | |
377 | ||
378 | * A file descriptor leak in an error codepath, used when "git apply | |
379 | --reject" fails to create the *.rej file, has been corrected. | |
380 | (merge 2b1f456adf rs/apply-reject-fd-leakfix later to maint). | |
381 | ||
382 | * A config parser callback function fell through instead of returning | |
383 | after recognising and processing a variable, wasting cycles, which | |
384 | has been corrected. | |
385 | (merge a816ccd642 ds/fetch-config-parse-microfix later to maint). | |
386 | ||
387 | * Fix was added to work around a regression in libcURL 8.7.0 (which has | |
388 | already been fixed in their tip of the tree). | |
389 | (merge 92a209bf24 jk/libcurl-8.7-regression-workaround later to maint). | |
390 | ||
391 | * The variable that holds the value read from the core.excludefile | |
392 | configuration variable used to leak, which has been corrected. | |
393 | (merge 0e0fefb29f jc/unleak-core-excludesfile later to maint). | |
394 | ||
21306a09 JH |
395 | * vreportf(), which is usede by error() and friends, has been taught |
396 | to give the error message printf-format string when its vsnprintf() | |
397 | call fails, instead of showing nothing useful to identify the | |
398 | nature of the error. | |
399 | (merge c63adab961 rs/usage-fallback-to-show-message-format later to maint). | |
400 | ||
401 | * Adjust to an upcoming changes to GNU make that breaks our Makefiles. | |
402 | (merge 227b8fd902 tb/make-indent-conditional-with-non-spaces later to maint). | |
403 | ||
a2082dbd JH |
404 | * Other code cleanup, docfix, build fix, etc. |
405 | (merge f0e578c69c rs/use-xstrncmpz later to maint). | |
0f9d4d28 JH |
406 | (merge 83e6eb7d7a ba/credential-test-clean-fix later to maint). |
407 | (merge 64562d784d jb/doc-interactive-singlekey-do-not-need-perl later to maint). | |
b387623c JH |
408 | (merge c431a235e2 cp/t9146-use-test-path-helpers later to maint). |
409 | (merge 82d75402d5 ds/doc-send-email-capitalization later to maint). | |
410 | (merge 41bff66e35 jc/doc-add-placeholder-fix later to maint). | |
411 | (merge 6835f0efe9 jw/remote-doc-typofix later to maint). | |
412 | (merge 244001aa20 hs/rebase-not-in-progress later to maint). | |
43072b4c JH |
413 | (merge 2ca6c07db2 jc/no-include-of-compat-util-from-headers later to maint). |
414 | (merge 87bd7fbb9c rs/fetch-simplify-with-starts-with later to maint). | |
415 | (merge f39addd0d9 rs/name-rev-with-mempool later to maint). | |
416 | (merge 9a97b43e03 rs/submodule-prefix-simplify later to maint). | |
417 | (merge 40b8076462 ak/rebase-autosquash later to maint). | |
e09f1254 | 418 | (merge 3223204456 eg/add-uflags later to maint). |
94511502 | 419 | (merge 5f78d52dce es/config-doc-sort-sections later to maint). |
2953d95d | 420 | (merge 781fb7b4c2 as/option-names-in-messages later to maint). |
3bd955d2 | 421 | (merge 51d41dc243 jk/doc-remote-helpers-markup-fix later to maint). |
11c821f2 | 422 | (merge e1aaf309db pb/ci-win-artifact-names-fix later to maint). |
c75fd8d8 JH |
423 | (merge ad538c61da jc/index-pack-fsck-levels later to maint). |
424 | (merge 67471bc704 ja/doc-formatting-fix later to maint). | |
425 | (merge 86f9ce7dd6 bl/doc-config-fixes later to maint). | |
7774cfed JH |
426 | (merge 0d527842b7 az/grep-group-error-message-update later to maint). |
427 | (merge 7c43bdf07b rs/strbuf-expand-bad-format later to maint). | |
436d4e5b | 428 | (merge 8b68b48d5c ds/typofix-core-config-doc later to maint). |
8f7582d9 | 429 | (merge 39bb692152 rs/imap-send-use-xsnprintf later to maint). |
548fe359 | 430 | (merge 8d320cec60 jc/t2104-style-fixes later to maint). |
21306a09 | 431 | (merge b4454d5a7b pw/t3428-cleanup later to maint). |
ae3196a5 JH |
432 | (merge 84a7c33a4b pf/commitish-committish later to maint). |
433 | (merge 8882ee9d68 la/mailmap-entry later to maint). |