| blob | c1121b7a58058153f890085c5e16f039b3ff57c5 |
1 Git 2.34 Release Notes
2 ======================
4 Updates since Git 2.33
5 ----------------------
7 Backward compatibility notes
9 * The "--preserve-merges" option of "git rebase" has been removed.
12 UI, Workflows & Features
14 * Pathname expansion (like "~username/") learned a way to specify a
15 location relative to Git installation (e.g. its $sharedir which is
16 $(prefix)/share), with "%(prefix)".
18 * Use `ort` instead of `recursive` as the default merge strategy.
20 * The userdiff pattern for "java" language has been updated.
22 * "git rebase" by default skips changes that are equivalent to
23 commits that are already in the history the branch is rebased onto;
24 give messages when this happens to let the users be aware of
25 skipped commits, and also teach them how to tell "rebase" to keep
26 duplicated changes.
28 * The advice message that "git cherry-pick" gives when it asks
29 conflicted replay of a commit to be resolved by the end user has
30 been updated.
32 * After "git clone --recurse-submodules", all submodules are cloned
33 but they are not by default recursed into by other commands. With
34 submodule.stickyRecursiveClone configuration set, submodule.recurse
35 configuration is set to true in a repository created by "clone"
36 with "--recurse-submodules" option.
38 * The logic for auto-correction of misspelt subcommands learned to go
39 interactive when the help.autocorrect configuration variable is set
40 to 'prompt'.
42 * "git maintenance" scheduler learned to use systemd timers as a
43 possible backend.
45 * "git diff --submodule=diff" showed failure from run_command() when
46 trying to run diff inside a submodule, when the user manually
47 removes the submodule directory.
49 * "git bundle unbundle" learned to show progress display.
51 * In cone mode, the sparse-index code path learned to remove ignored
52 files (like build artifacts) outside the sparse cone, allowing the
53 entire directory outside the sparse cone to be removed, which is
54 especially useful when the sparse patterns change.
56 * Taking advantage of the CGI interface, http-backend has been
57 updated to enable protocol v2 automatically when the other side
58 asks for it.
60 * The credential-cache helper has been adjusted to Windows.
62 * The error in "git help no-such-git-command" is handled better.
64 * The unicode character width table (used for output alignment) has
65 been updated.
67 * The ref iteration code used to optionally allow dangling refs to be
68 shown, which has been tightened up.
70 * "git add", "git mv", and "git rm" have been adjusted to avoid
71 updating paths outside of the sparse-checkout definition unless
72 the user specifies a "--sparse" option.
74 * "git repack" has been taught to generate multi-pack reachability
75 bitmaps.
77 * "git fsck" has been taught to report mismatch between expected and
78 actual types of an object better.
80 * Use ssh public crypto for object and push-cert signing.
83 Performance, Internal Implementation, Development Support etc.
85 * "git bisect" spawned "git show-branch" only to pretty-print the
86 title of the commit after checking out the next version to be
87 tested; this has been rewritten in C.
89 * "git add" can work better with the sparse index.
91 * Support for ancient versions of cURL library (pre 7.19.4) has been
92 dropped.
94 * A handful of tests that assumed implementation details of files
95 backend for refs have been cleaned up.
97 * trace2 logs learned to show parent process name to see in what
98 context Git was invoked.
100 * Loading of ref tips to prepare for common ancestry negotiation in
101 "git fetch-pack" has been optimized by taking advantage of the
102 commit graph when available.
104 * Remind developers that the userdiff patterns should be kept simple
105 and permissive, assuming that the contents they apply are always
106 syntactically correct.
108 * The current implementation of GIT_TEST_FAIL_PREREQS is broken in
109 that checking for the lack of a prerequisite would not work. Avoid
110 the use of "if ! test_have_prereq X" in a test script.
112 * The revision traversal API has been optimized by taking advantage
113 of the commit-graph, when available, to determine if a commit is
114 reachable from any of the existing refs.
116 * "git fetch --quiet" optimization to avoid useless computation of
117 info that will never be displayed.
119 * Callers from older advice_config[] based API has been updated to
120 use the newer advice_if_enabled() and advice_enabled() API.
122 * Teach "test_pause" and "debug" helpers to allow using the HOME and
123 TERM environment variables the user usually uses.
125 * "make INSTALL_STRIP=-s install" allows the installation step to use
126 "install -s" to strip the binaries as they get installed.
128 * Code that handles large number of refs in the "git fetch" code
129 path has been optimized.
131 * The reachability bitmap file used to be generated only for a single
132 pack, but now we've learned to generate bitmaps for history that
133 span across multiple packfiles.
135 * The code to make "git grep" recurse into submodules has been
136 updated to migrate away from the "add submodule's object store as
137 an alternate object store" mechanism (which is suboptimal).
139 * The tracing of process ancestry information has been enhanced.
141 * Reduce number of write(2) system calls while sending the
142 ref advertisement.
144 * Update the build procedure to use the "-pedantic" build when
145 DEVELOPER makefile macro is in effect.
147 * Large part of "git submodule add" gets rewritten in C.
149 * The run-command API has been updated so that the callers can easily
150 ask the file descriptors open for packfiles to be closed immediately
151 before spawning commands that may trigger auto-gc.
153 * An oddball OPTION_ARGUMENT feature has been removed from the
154 parse-options API.
156 * The mergesort implementation used to sort linked list has been
157 optimized.
159 * Remove external declaration of functions that no longer exist.
161 * "git multi-pack-index write --bitmap" learns to propagate the
162 hashcache from original bitmap to resulting bitmap.
164 * CI learns to run the leak sanitizer builds.
166 * "git grep --recurse-submodules" takes trees and blobs from the
167 submodule repository, but the textconv settings when processing a
168 blob from the submodule is not taken from the submodule repository.
169 A test is added to demonstrate the issue, without fixing it.
171 * Teach "git help -c" into helping the command line completion of
172 configuration variables.
174 * When "git cmd -h" shows more than one line of usage text (e.g.
175 the cmd subcommand may take sub-sub-command), parse-options API
176 learned to align these lines, even across i18n/l10n.
178 * Prevent "make sparse" from running for the source files that
179 haven't been modified.
181 * The codepath to write a new version of .midx multi-pack index files
182 has learned to release the mmaped memory holding the current
183 version of .midx before removing them from the disk, as some
184 platforms do not allow removal of a file that still has mapping.
186 * A new feature has been added to abort early in the test framework.
189 Fixes since v2.33
190 -----------------
192 * Input validation of "git pack-objects --stdin-packs" has been
193 corrected.
195 * Bugfix for common ancestor negotiation recently introduced in "git
196 push" code path.
198 * "git pull" had various corner cases that were not well thought out
199 around its --rebase backend, e.g. "git pull --ff-only" did not stop
200 but went ahead and rebased when the history on other side is not a
201 descendant of our history. The series tries to fix them up.
203 * "git apply" miscounted the bytes and failed to read to the end of
204 binary hunks.
206 * "git range-diff" code clean-up.
208 * "git commit --fixup" now works with "--edit" again, after it was
209 broken in v2.32.
211 * Use upload-artifacts v1 (instead of v2) for 32-bit linux, as the
212 new version has a blocker bug for that architecture.
214 * Checking out all the paths from HEAD during the last conflicted
215 step in "git rebase" and continuing would cause the step to be
216 skipped (which is expected), but leaves MERGE_MSG file behind in
217 $GIT_DIR and confuses the next "git commit", which has been
218 corrected.
220 * Various bugs in "git rebase -r" have been fixed.
222 * mmap() imitation used to call xmalloc() that dies upon malloc()
223 failure, which has been corrected to just return an error to the
224 caller to be handled.
226 * "git diff --relative" segfaulted and/or produced incorrect result
227 when there are unmerged paths.
229 * The delayed checkout code path in "git checkout" etc. were chatty
230 even when --quiet and/or --no-progress options were given.
232 * "git branch -D <branch>" used to refuse to remove a broken branch
233 ref that points at a missing commit, which has been corrected.
235 * Build update for Apple clang.
237 * The parser for the "--nl" option of "git column" has been
238 corrected.
240 * "git upload-pack" which runs on the other side of "git fetch"
241 forgot to take the ref namespaces into account when handling
242 want-ref requests.
244 * The sparse-index support can corrupt the index structure by storing
245 a stale and/or uninitialized data, which has been corrected.
247 * Buggy tests could damage repositories outside the throw-away test
248 area we created. We now by default export GIT_CEILING_DIRECTORIES
249 to limit the damage from such a stray test.
251 * Even when running "git send-email" without its own threaded
252 discussion support, a threading related header in one message is
253 carried over to the subsequent message to result in an unwanted
254 threading, which has been corrected.
256 * The output from "git fast-export", when its anonymization feature
257 is in use, showed an annotated tag incorrectly.
259 * Doc update plus improved error reporting.
261 * Recent "diff -m" changes broke "gitk", which has been corrected.
263 * Regression fix.
265 * The "git apply -3" code path learned not to bother the lower level
266 merge machinery when the three-way merge can be trivially resolved
267 without the content level merge. This fixes a regression caused by
268 recent "-3way first and fall back to direct application" change.
270 * The code that optionally creates the *.rev reverse index file has
271 been optimized to avoid needless computation when it is not writing
272 the file out.
274 * "git range-diff -I... <range> <range>" segfaulted, which has been
275 corrected.
277 * The order in which various files that make up a single (conceptual)
278 packfile has been reevaluated and straightened up. This matters in
279 correctness, as an incomplete set of files must not be shown to a
280 running Git.
282 * The "mode" word is useless in a call to open(2) that does not
283 create a new file. Such a call in the files backend of the ref
284 subsystem has been cleaned up.
286 * "git update-ref --stdin" failed to flush its output as needed,
287 which potentially led the conversation to a deadlock.
289 * When "git am --abort" fails to abort correctly, it still exited
290 with exit status of 0, which has been corrected.
292 * Correct nr and alloc members of strvec struct to be of type size_t.
294 * "git stash", where the tentative change involves changing a
295 directory to a file (or vice versa), was confused, which has been
296 corrected.
298 * "git clone" from a repository whose HEAD is unborn into a bare
299 repository didn't follow the branch name the other side used, which
300 is corrected.
302 * "git cvsserver" had a long-standing bug in its authentication code,
303 which has finally been corrected (it is unclear and is a separate
304 question if anybody is seriously using it, though).
306 * "git difftool --dir-diff" mishandled symbolic links.
308 * Sensitive data in the HTTP trace were supposed to be redacted, but
309 we failed to do so in HTTP/2 requests.
311 * "make clean" has been updated to remove leftover .depend/
312 directories, even when it is not told to use them to compute header
313 dependencies.
315 * Protocol v0 clients can get stuck parsing a malformed feature line.
317 * A few kinds of changes "git status" can show were not documented.
318 (merge d2a534c515 ja/doc-status-types-and-copies later to maint).
320 * The mergesort implementation used to sort linked list has been
321 optimized.
322 (merge c90cfc225b rs/mergesort later to maint).
324 * An editor session launched during a Git operation (e.g. during 'git
325 commit') can leave the terminal in a funny state. The code path
326 has updated to save the terminal state before, and restore it
327 after, it spawns an editor.
328 (merge 3d411afabc cm/save-restore-terminal later to maint).
330 * "git cat-file --batch" with the "--batch-all-objects" option is
331 supposed to iterate over all the objects found in a repository, but
332 it used to translate these object names using the replace mechanism,
333 which defeats the point of enumerating all objects in the repository.
334 This has been corrected.
335 (merge bf972896d7 jk/cat-file-batch-all-wo-replace later to maint).
337 * Recent sparse-index work broke safety against attempts to add paths
338 with trailing slashes to the index, which has been corrected.
339 (merge c8ad9d04c6 rs/make-verify-path-really-verify-again later to maint).
341 * The "--color-lines" and "--color-by-age" options of "git blame"
342 have been missing, which are now documented.
343 (merge 8c32856133 bs/doc-blame-color-lines later to maint).
345 * The PATH used in CI job may be too wide and let incompatible dlls
346 to be grabbed, which can cause the build&test to fail. Tighten it.
347 (merge 7491ef6198 js/windows-ci-path-fix later to maint).
349 * Avoid performance measurements from getting ruined by gc and other
350 housekeeping pauses interfering in the middle.
351 (merge be79131a53 rs/disable-gc-during-perf-tests later to maint).
353 * Stop "git add --dry-run" from creating new blob and tree objects.
354 (merge e578d0311d rs/add-dry-run-without-objects later to maint).
356 * "git commit" gave duplicated error message when the object store
357 was unwritable, which has been corrected.
358 (merge 4ef91a2d79 ab/fix-commit-error-message-upon-unwritable-object-store later to maint).
360 * Recent sparse-index addition, namely any use of index_name_pos(),
361 can expand sparse index entries and breaks any code that walks
362 cache-tree or existing index entries. One such instance of such a
363 breakage has been corrected.
365 * The xxdiff difftool backend can exit with status 128, which the
366 difftool-helper that launches the backend takes as a significant
367 failure, when it is not significant at all. Work it around.
368 (merge 571f4348dd da/mergetools-special-case-xxdiff-exit-128 later to maint).
370 * Improve test framework around unwritable directories.
371 (merge 5d22e18965 ab/test-cleanly-recreate-trash-directory later to maint).
373 * "git push" client talking to an HTTP server did not diagnose the
374 lack of the final status report from the other side correctly,
375 which has been corrected.
376 (merge c5c3486f38 jk/http-push-status-fix later to maint).
378 * Update "git archive" documentation and give explicit mention on the
379 compression level for both zip and tar.gz format.
380 (merge c4b208c309 bs/archive-doc-compression-level later to maint).
382 * Drop "git sparse-index" from the list of common commands.
383 (merge 6a9a50a8af sg/sparse-index-not-that-common-a-command later to maint).
385 * "git branch -c/-m new old" was not described to copy config, which
386 has been corrected.
387 (merge 8252ec300e jc/branch-copy-doc later to maint).
389 * Squelch over-eager warning message added during this cycle.
390 (merge 9e8fe7b1c7 jk/log-warn-on-bogus-encoding later to maint).
392 * Fix long-standing shell syntax error in the completion script.
393 (merge 46b0585286 re/completion-fix-test-equality later to maint).
395 * Other code cleanup, docfix, build fix, etc.
396 (merge f188160be9 ab/bundle-remove-verbose-option later to maint).
397 (merge 8c6b4332b4 rs/close-pack-leakfix later to maint).
398 (merge 51b04c05b7 bs/difftool-msg-tweak later to maint).
399 (merge dd20e4a6db ab/make-compdb-fix later to maint).
400 (merge 6ffb990dc4 os/status-docfix later to maint).
401 (merge 100c2da2d3 rs/p3400-lose-tac later to maint).
402 (merge 76f3b69896 tb/aggregate-ignore-leading-whitespaces later to maint).
403 (merge 6e4fd8bfcd tz/doc-link-to-bundle-format-fix later to maint).
404 (merge f6c013dfa1 jc/doc-commit-header-continuation-line later to maint).
405 (merge ec9a37d69b ab/pkt-line-cleanup later to maint).
406 (merge 8650c6298c ab/fix-make-lint-docs later to maint).
407 (merge 1c720357ce ab/test-lib-diff-cleanup later to maint).
408 (merge 6b615dbece ks/submodule-add-message-fix later to maint).
409 (merge 82a57cd13f ma/doc-git-version later to maint).