| 1 | Git v2.55 Release Notes |
| 2 | ======================= |
| 3 | |
| 4 | UI, Workflows & Features |
| 5 | ------------------------ |
| 6 | |
| 7 | * Hook scripts defined via the configuration system can now be |
| 8 | configured to run in parallel. |
| 9 | |
| 10 | * The userdiff driver for the Scheme language has been extended to |
| 11 | cover other Lisp dialects. |
| 12 | |
| 13 | * Terminal control sequences coming over the sideband while talking |
| 14 | to a remote repository are mostly disabled by default, except for |
| 15 | ANSI color escape sequences. |
| 16 | |
| 17 | * "ort" merge backend improvements. |
| 18 | |
| 19 | * "git checkout -m another-branch" was invented to deal with local |
| 20 | changes to paths that are different between the current and the new |
| 21 | branch, but it gave only one chance to resolve conflicts. The command |
| 22 | was taught to create a stash to save the local changes. |
| 23 | |
| 24 | * A new builtin "git format-rev" is introduced for pretty formatting |
| 25 | one revision expression per line or commit object names found in |
| 26 | running text. |
| 27 | |
| 28 | * "git history" learned "fixup" command. |
| 29 | |
| 30 | * The internal URL parsing logic has been made accessible via a new |
| 31 | subcommand "git url-parse". |
| 32 | |
| 33 | * Misspelt proxy URL (e.g., httt://...) did not trigger any warning |
| 34 | or failure, which has been corrected. |
| 35 | |
| 36 | * Document the fact that .git/info/exclude is shared across worktrees |
| 37 | linked to the same repository. |
| 38 | |
| 39 | * The command line parser for "git diff" learned a few options take |
| 40 | only non-negative integers. |
| 41 | |
| 42 | * The graph output from commands like "git log --graph" can now be |
| 43 | limited to a specified number of lanes, preventing overly wide output |
| 44 | in repositories with many branches. |
| 45 | |
| 46 | * The fsmonitor daemon has been implemented for Linux. |
| 47 | |
| 48 | * "git cat-file --batch" learns an in-line command "mailmap" |
| 49 | that lets the user toggle use of mailmap. |
| 50 | |
| 51 | * The "git pack-objects --path-walk" traversal has been integrated |
| 52 | with several object filters, including blobless and sparse filters. |
| 53 | |
| 54 | * "git push" learned to take a "remote group" name to push to, which |
| 55 | causes pushes to multiple places, just like "git fetch" would do. |
| 56 | |
| 57 | * The 'git-jump' command (in contrib/) has been taught to automatically |
| 58 | pick a mode (merge, diff, or ws) when invoked without arguments. |
| 59 | |
| 60 | * The documentation for `push.default = simple` has been clarified to |
| 61 | better explain its behavior, making it clear that it pushes the |
| 62 | current branch to a same-named branch on the remote, and detailing |
| 63 | the upstream requirements for centralized workflows. |
| 64 | |
| 65 | * The documentation for "--word-diff" has been extended with a bit of |
| 66 | implementation detail of where these different words come from. |
| 67 | |
| 68 | * "git config foo.bar=baz" is not likely to be a request to read the |
| 69 | value of such a variable with '=' in its name; rather it is plausible |
| 70 | that the user meant "git config set foo.bar baz". Give advice when |
| 71 | giving an error message. |
| 72 | |
| 73 | * "git rev-list" (and "git log" family of commands) learned a new "--max-count-oldest" |
| 74 | that picks oldest N commits in the range instead of the usual newest. |
| 75 | |
| 76 | * Various AsciiDoc markup fixes in 'git config' documentation and |
| 77 | related files to ensure lists and formatting are rendered correctly. |
| 78 | |
| 79 | |
| 80 | Performance, Internal Implementation, Development Support etc. |
| 81 | -------------------------------------------------------------- |
| 82 | |
| 83 | * Promisor remote handling has been refactored and fixed in |
| 84 | preparation for auto-configuration of advertised remotes. |
| 85 | |
| 86 | * Rust support is enabled by default (but still allows opting out) in |
| 87 | some future version of Git. |
| 88 | |
| 89 | * Preparation of the xdiff/ codebase to work with Rust. |
| 90 | |
| 91 | * Use a larger buffer size in the code paths to ingest pack stream. |
| 92 | |
| 93 | * Refactor service routines in the ref subsystem backends. |
| 94 | |
| 95 | * Shrink wasted memory in Myers diff that does not account for common |
| 96 | prefix and suffix removal. |
| 97 | |
| 98 | * Enable expensive tests to catch topics that may cause breakages on |
| 99 | integration branches closer to their origin in the contributor PR |
| 100 | builds. |
| 101 | |
| 102 | * "git merge-base" optimization. |
| 103 | |
| 104 | * The limit_list() function that is one of the core part of the |
| 105 | revision traversal infrastructure has been optimized by replacing |
| 106 | its use of linear list with priority queue. |
| 107 | |
| 108 | * In a lazy clone, "git cherry" and "git grep" often fetch necessary |
| 109 | blob objects one by one from promisor remotes. It has been corrected |
| 110 | to collect necessary object names and fetch them in bulk to gain |
| 111 | reasonable performance. |
| 112 | |
| 113 | * The logic to determine that branches in an octopus merge are |
| 114 | independent has been optimized. |
| 115 | |
| 116 | * The consistency checks for the files reference backend have been updated |
| 117 | to skip lock files earlier, avoiding unnecessary parsing of |
| 118 | intermediate files. |
| 119 | |
| 120 | * The negotiation tip options in "git fetch" have been reworked to |
| 121 | allow requiring certain refs to be sent as "have" lines, and to |
| 122 | restrict negotiation to a specific set of refs. |
| 123 | |
| 124 | * The repacking code has been refactored and compaction of MIDX layers |
| 125 | have been implemented, and incremental strategy that does not require |
| 126 | all-into-one repacking has been introduced. |
| 127 | |
| 128 | * ODB transaction interface is being reworked to explicitly handle |
| 129 | object writes. |
| 130 | |
| 131 | * Add a new odb "in-memory" source that is meant to only hold |
| 132 | tentative objects (like the virtual blob object that represents the |
| 133 | working tree file used by "git blame"). |
| 134 | |
| 135 | * Many uses of the_repository has been updated to use a more |
| 136 | appropriate struct repository instance in setup.c codepath. |
| 137 | |
| 138 | * Revision traversal optimization. |
| 139 | |
| 140 | * Build update. |
| 141 | |
| 142 | * The logic to lazy-load trees from the commit-graph has been made |
| 143 | more robust by falling back to reading the commit object when |
| 144 | the commit-graph is no longer available. |
| 145 | |
| 146 | * The "name" argument in git_connect() and related functions has been |
| 147 | converted to a "service" enum to improve type safety and clarify its |
| 148 | purpose. |
| 149 | |
| 150 | * 'git restore --staged' has been optimized to avoid unnecessarily expanding |
| 151 | the sparse index when operating on paths within the sparse checkout |
| 152 | definition, by handling sparse directory entries at the tree level. |
| 153 | |
| 154 | * "git stash -p" has been optimized by reusing cached index |
| 155 | entries in its temporary index, avoiding unnecessary lstat() |
| 156 | calls on unchanged files. |
| 157 | |
| 158 | * The check for non-stale commits in the priority queue used by |
| 159 | `paint_down_to_common` and `ahead_behind` has been optimized by |
| 160 | replacing an O(N) scan with an O(1) counter, yielding performance |
| 161 | improvements in repositories with wide histories. |
| 162 | |
| 163 | * Reachability bitmap generation has been significantly optimized. By |
| 164 | reordering tree traversal, caching object positions, and refining how |
| 165 | pseudo-merge bitmaps are constructed, the performance of "git repack |
| 166 | --write-midx-bitmaps" is improved, especially for large repositories |
| 167 | and when using pseudo-merges. |
| 168 | |
| 169 | * Adding a decimal integer with strbuf_addf("%u") appears commonly; |
| 170 | they have been optimized by using a custom formatter. |
| 171 | |
| 172 | * Formatting object name in full hexadecimal form has been optimized |
| 173 | by using a new strbuf_add_oid_hex() helper function. |
| 174 | |
| 175 | * Encourage original authors to monitor the CI status. |
| 176 | |
| 177 | * The `git log -L` implementation has been refactored to use the |
| 178 | standard diff output pipeline, enabling pickaxe and diff-filter to |
| 179 | work as expected. Additionally, metadata-only diff formats like |
| 180 | --raw and --name-only are now supported with -L. |
| 181 | |
| 182 | * The loose object source has been refactored into a proper `struct |
| 183 | odb_source`. |
| 184 | |
| 185 | * Guidelines on how to write a cover letter for a multi-patch series |
| 186 | have been added to SubmittingPatches, which also got a new marker |
| 187 | to separate the section for typofixes. |
| 188 | |
| 189 | * The setup logic to discover and configure repositories has been |
| 190 | refactored, and the initialization of the object database has been |
| 191 | centralized. |
| 192 | |
| 193 | * Many core configuration variables have been migrated from global |
| 194 | variables into 'repo_config_values' to tie them to a specific |
| 195 | repository instance, avoiding cross-repository state leakage. |
| 196 | |
| 197 | * Streaming revision walks have been optimized by using a priority queue |
| 198 | for date-sorting commits, speeding up walks repositories with many |
| 199 | merges. |
| 200 | |
| 201 | * A recent regression in t7527 that broke TAP output has been fixed, |
| 202 | some other test noise that also broke TAP output has been silenced, |
| 203 | and 'prove' is now configured to fail on invalid TAP output to |
| 204 | prevent future regressions. |
| 205 | |
| 206 | * A handful of inappropriate uses of the_repository have been |
| 207 | rewritten to use the right repository structure instance in the |
| 208 | unpack-trees.c codepath. |
| 209 | |
| 210 | * "git index-pack" has been optimized by retaining child bases in the |
| 211 | delta cache instead of immediately freeing them, letting the existing |
| 212 | cache limit policy decide eviction. |
| 213 | |
| 214 | * `git ls-files --modified` and `git ls-files --deleted` have been |
| 215 | optimized to filter with pathspec before calling lstat() when there is |
| 216 | only a single pathspec item, avoiding unnecessary filesystem access |
| 217 | for entries that will not be shown. |
| 218 | |
| 219 | * The UNUSED macro in 'compat/posix.h' has been updated to use a |
| 220 | newly introduced GIT_CLANG_PREREQ macro for compiler version |
| 221 | checks, and the existing GIT_GNUC_PREREQ macro has been modernized |
| 222 | to use explicit major/minor comparisons rather than bit-shifting. |
| 223 | |
| 224 | |
| 225 | Fixes since v2.54 |
| 226 | ----------------- |
| 227 | |
| 228 | * Code clean-up to use the right instance of a repository instance in |
| 229 | calls inside refs subsystem. |
| 230 | (merge 57c590feb9 sp/refs-reduce-the-repository later to maint). |
| 231 | |
| 232 | * The check that implements the logic to see if an in-core cache-tree |
| 233 | is fully ready to write out a tree object was broken, which has |
| 234 | been corrected. |
| 235 | (merge 521731213c dl/cache-tree-fully-valid-fix later to maint). |
| 236 | |
| 237 | * The test suite harness and many individual test scripts have been |
| 238 | updated to work correctly when 'set -e' is in effect, which helps |
| 239 | detect misspelled test commands. |
| 240 | (merge ffe8005b9d ps/test-set-e-clean later to maint). |
| 241 | |
| 242 | * Revert a recent change that introduced a regression to help mksh users. |
| 243 | |
| 244 | * Update various GitHub Actions versions. |
| 245 | |
| 246 | * Avoid hitting the pathname limit for socks proxy socket during the |
| 247 | test.. |
| 248 | |
| 249 | * To help Windows 10 installations, avoid removing files whose |
| 250 | contents are still mmap()'ed. |
| 251 | |
| 252 | * The 'git backfill' command now rejects revision-limiting options that |
| 253 | are incompatible with its operation, uses standard documentation for |
| 254 | revision ranges, and includes blobs from boundary commits by default |
| 255 | to improve performance of subsequent operations. |
| 256 | (merge a1ad4a0fca en/backfill-fixes-and-edges later to maint). |
| 257 | |
| 258 | * "git grep" update. |
| 259 | (merge 9ff4b5ab1b rs/grep-column-only-match-fix later to maint). |
| 260 | |
| 261 | * Headers from glibc 2.43 when used with clang does not allow |
| 262 | disabling C11 language features, causing build failures.. |
| 263 | |
| 264 | * The 'http.emptyAuth=auto' configuration now correctly attempts |
| 265 | Negotiate authentication before falling back to manual credentials. |
| 266 | This allows seamless Kerberos ticket-based authentication without |
| 267 | requiring users to explicitly set 'http.emptyAuth=true'. |
| 268 | (merge 4919938d28 mc/http-emptyauth-negotiate-fix later to maint). |
| 269 | |
| 270 | * Ramifications of turning off commit-graph has been documented a bit |
| 271 | more clearly. |
| 272 | (merge 48c855bb8f kh/doc-commit-graph later to maint). |
| 273 | |
| 274 | * "git rebase --update-refs", when used with an rebase.instructionFormat |
| 275 | with "%d" (describe) in it, tried to update local branch HEAD by |
| 276 | mistake, which has been corrected. |
| 277 | (merge 106b6885c7 ag/rebase-update-refs-limit-to-branches later to maint). |
| 278 | |
| 279 | * Tweak the way how sideband messages from remote are printed while |
| 280 | we talk with a remote repository to avoid tickling terminal |
| 281 | emulator glitches. |
| 282 | (merge 31e8fcabd8 rs/sideband-clear-line-before-print later to maint). |
| 283 | |
| 284 | * The configuration variable submodule.fetchJobs was not read correctly, |
| 285 | which has been corrected. |
| 286 | (merge aa45a5902f sj/submodule-update-clone-config-fix later to maint). |
| 287 | |
| 288 | * Update code paths that assumed "unsigned long" was long enough for |
| 289 | "size_t". |
| 290 | (merge 7a094d68a2 js/objects-larger-than-4gb-on-windows later to maint). |
| 291 | |
| 292 | * Stop using unmaintained custom allocator in Windows build which was |
| 293 | the last user of the code. |
| 294 | |
| 295 | * The computation to shorten the filenames shown in diffstat measured |
| 296 | width of individual UTF-8 characters to add up, but forgot to take |
| 297 | into account error cases (e.g., an invalid UTF-8 sequence, or a |
| 298 | control character). |
| 299 | (merge 09d86a3b98 en/diffstat-utf8-truncation-fix later to maint). |
| 300 | |
| 301 | * Some tests assume that bare repository accesses are by default |
| 302 | allowed; rewrite some of them to avoid the assumption, rewrite |
| 303 | others to explicitly set safe.bareRepository to allow them. |
| 304 | (merge 985b38ca6c js/adjust-tests-to-explicitly-access-bare-repo later to maint). |
| 305 | |
| 306 | * Signing commit with custom encoding was passing the data to be |
| 307 | signed at a wrong stage in the pipeline, which has been corrected. |
| 308 | (merge 7735d7eee3 bc/sign-commit-with-custom-encoding later to maint). |
| 309 | |
| 310 | * Further update to the i18n alias support to avoid regressions. |
| 311 | |
| 312 | * "git fetch --deepen=<n>" in a full clone truncated the history to <n> |
| 313 | commits deep, which has been corrected to be a no-op instead. |
| 314 | (merge 2431f5e0e5 sp/shallow-deepen-on-non-shallow-repo-fix later to maint). |
| 315 | |
| 316 | * "git maintenance" that goes background did not use the lockfile to |
| 317 | prevent multiple maintenance processes from running at the same |
| 318 | time, which has been corrected. |
| 319 | (merge 29364f1624 ps/maintenance-daemonize-lockfix later to maint). |
| 320 | |
| 321 | * Remove ineffective strbuf presizing that would have computed an |
| 322 | allocation that would not have fit in the available memory anyway, |
| 323 | or too small due to integer wraparound to cause immediate automatic |
| 324 | growing. |
| 325 | (merge a9ce8526dc jk/pretty-no-strbuf-presizing later to maint). |
| 326 | |
| 327 | * The HTTP walker misinterpreted the alternates file that gives an |
| 328 | absolute path when the server URL does not have the final slash |
| 329 | (i.e., "https://example.com" not "https://example.com/"). |
| 330 | (merge b92387cd55 jk/dumb-http-alternate-fix later to maint). |
| 331 | |
| 332 | * "git bisect" now uses the selected terms (e.g., old/new) more |
| 333 | consistently in its output. |
| 334 | (merge cb55991825 jr/bisect-custom-terms-in-output later to maint). |
| 335 | |
| 336 | * Update GitLab CI jobs that exercise macOS. |
| 337 | (merge 62319b49bb ps/gitlab-ci-macOS-improvements later to maint). |
| 338 | |
| 339 | * "Friday noon" asked in the morning on Sunday was parsed to be one |
| 340 | day before the specified time, which has been corrected. |
| 341 | (merge b809304101 ta/approxidate-noon-fix later to maint). |
| 342 | |
| 343 | * The GIT_WORK_TREE variable prepared to invoke the push-to-checkout |
| 344 | hook was leaking into the environment even when there was no hook |
| 345 | used and broke the default push-to-deploy (i.e., let "git checkout" |
| 346 | update the working tree only when the working tree is clean). |
| 347 | (merge 44d04e4426 ar/receive-pack-worktree-env later to maint). |
| 348 | |
| 349 | * A batch of documentation pages has been updated to use the modern |
| 350 | synopsis style. |
| 351 | (merge 2ef248ae45 ja/doc-synopsis-style-again later to maint). |
| 352 | |
| 353 | * The "promisor.quiet" configuration variable was not used from |
| 354 | relevant submodules when commands like "grep --recurse-submodules" |
| 355 | triggered a lazy fetch, which has been corrected. |
| 356 | (merge fa1468a1f7 th/promisor-quiet-per-repo later to maint). |
| 357 | |
| 358 | * Correct use of sockaddr API in "git daemon". |
| 359 | (merge 422a5bf575 st/daemon-sockaddr-fixes later to maint). |
| 360 | |
| 361 | * A memory leak in `fetch_and_setup_pack_index()` when verification of |
| 362 | the downloaded pack index fails has been plugged. Also an obsolete |
| 363 | `unlink()` call on parse failure has been cleaned up. |
| 364 | |
| 365 | * In t3070-wildmatch, "via ls-files" test variants with patterns |
| 366 | containing backslash escapes are now skipped on Windows, avoiding 36 |
| 367 | test failures caused by pathspec separator conversion. |
| 368 | (merge 8c84e6802c kk/wildmatch-windows-ls-files-prereq later to maint). |
| 369 | |
| 370 | * A linker warning on macOS when building with Xcode 16.3 or newer has |
| 371 | been avoided by passing -fno-common to the compiler when a |
| 372 | sufficiently new linker is detected. |
| 373 | (merge 5cd4d0d850 hn/macos-linker-warning later to maint). |
| 374 | |
| 375 | * Documentation and tests have been added to clarify that Git's internal |
| 376 | raw timestamp format requires a `@` prefix for values less than |
| 377 | 100,000,000 to prevent ambiguity with other formats like YYYYMMDD. |
| 378 | (merge 4018dc29ee ls/doc-raw-timestamp-prefix later to maint). |
| 379 | |
| 380 | * Wording used in "format-patch --subject-prefix" documentation |
| 381 | has been improved. |
| 382 | (merge 4a1eb9304a lo/doc-format-patch-subject-prefix later to maint). |
| 383 | |
| 384 | * Advanced emulation of kill() used on Windows in GfW has been |
| 385 | upstreamed to improve the symptoms like left-behind .lock files and |
| 386 | that fails to let the child clean-up itself when it gets killed. |
| 387 | (merge 363f1d8b3a js/win-kill-child-more-gently later to maint). |
| 388 | |
| 389 | * The 'git describe --contains --all' command has been fixed to |
| 390 | properly honor the '--match' and '--exclude' options by passing |
| 391 | them down to 'git name-rev' with the appropriate reference |
| 392 | prefixes. |
| 393 | (merge 1891707d1b jk/describe-contains-all-match-fix later to maint). |
| 394 | |
| 395 | * Various typos, grammatical errors, and duplicated words in both |
| 396 | documentation and code comments have been corrected. |
| 397 | (merge dc6068df67 wy/docs-typofixes later to maint). |
| 398 | |
| 399 | * The subprocess handshake during startup has been made gentler by using |
| 400 | packet_read_line_gently() instead of packet_read_line() to prevent the |
| 401 | parent Git process from dying abruptly when a configured subprocess |
| 402 | (e.g., a clean/smudge filter) fails to start. |
| 403 | (merge 061a68e443 mm/subprocess-handshake-fix later to maint). |
| 404 | |
| 405 | * The TSAN race in transfer_debug() within transport-helper.c has been |
| 406 | resolved by initializing the debug flag early in |
| 407 | bidirectional_transfer_loop() before spawning worker threads, allowing |
| 408 | the removal of a TSAN suppression. |
| 409 | (merge 85704eda18 ps/transport-helper-tsan-fix later to maint). |
| 410 | |
| 411 | * 'git describe' has been taught to pass the 'refs/tags/' prefix down to |
| 412 | the ref iterator when '--all' is not requested, avoiding unnecessary |
| 413 | iteration over non-tag refs. |
| 414 | (merge 55088ac8a4 td/describe-tag-iteration later to maint). |
| 415 | |
| 416 | * compute_reachable_generation_numbers() in commit-graph used a 32-bit |
| 417 | integer to accumulate parent generations, which is OK for generation |
| 418 | number v1 (topological levels), but with generation number v2 |
| 419 | (adjusted committer timestamps), it truncated timestamps beyond |
| 420 | 2106. Fixed by widening the accumulator to timestamp_t. |
| 421 | (merge fbcc5408fc en/commit-graph-timestamp-fix later to maint). |
| 422 | |
| 423 | * Other code cleanup, docfix, build fix, etc. |
| 424 | (merge 80f4b802e9 ja/doc-difftool-synopsis-style later to maint). |
| 425 | (merge b96490241e jc/doc-timestamps-in-stat later to maint). |
| 426 | (merge ef85286e51 ss/t7004-unhide-git-failures later to maint). |
| 427 | (merge 7584d10bc2 mf/format-patch-cover-letter-format-docfix later to maint). |
| 428 | (merge 8547908eb3 pw/rename-to-get-current-worktree later to maint). |
| 429 | (merge 890229b3f3 sg/t6112-unwanted-tilde-expansion-fix later to maint). |
| 430 | (merge ab9753e7bc kh/doc-restore-double-underscores-fix later to maint). |
| 431 | (merge 4a9e097228 za/t2000-modernise-more later to maint). |
| 432 | (merge b635fd0725 kh/doc-log-decorate-list later to maint). |
| 433 | (merge 65ea197dca jk/commit-sign-overflow-fix later to maint). |
| 434 | (merge 3ccb16052a jk/apply-leakfix later to maint). |
| 435 | (merge 5e6e8dc786 tb/pseudo-merge-bugfixes later to maint). |
| 436 | (merge 6d09e798bc pb/doc-diff-format-updates later to maint). |
| 437 | (merge 34a891a2d3 rs/trailer-fold-optim later to maint). |
| 438 | (merge 499f9048e0 ps/t3903-cover-stash-include-untracked later to maint). |
| 439 | (merge b56ab270aa jk/sq-dequote-cleanup later to maint). |
| 440 | (merge 29d9fdcf10 rs/use-builtin-add-overflow-explicitly-on-clang later to maint). |
| 441 | (merge d9982e8290 ed/check-connected-close-err-fd-2.53 later to maint). |
| 442 | (merge 1740cc35d0 ed/check-connected-close-err-fd later to maint). |
| 443 | (merge f4d7eb3d1c sp/doc-range-diff-takes-notes later to maint). |
| 444 | (merge 83e7f3bd2b kh/free-commit-list later to maint). |
| 445 | (merge d1b72b29e9 am/doc-tech-hash-typofix later to maint). |
| 446 | (merge 014c454799 ak/typofixes later to maint). |
| 447 | (merge 522ea8ef7d js/osxkeychain-build-wo-rust later to maint). |
| 448 | (merge e8f12e0e95 jc/t1400-fifo-cleanup later to maint). |