353 lines
17 KiB
Plaintext
353 lines
17 KiB
Plaintext
Git v2.56 Release Notes
|
|
=======================
|
|
|
|
UI, Workflows & Features
|
|
------------------------
|
|
|
|
* Advice shown by "git status" when the local branch is behind or has
|
|
diverged from its push branch has been updated to suggest "git pull
|
|
<remote> <branch>".
|
|
|
|
* The handling of promisor-remote protocol capability has been updated
|
|
to allow the other side to add to the list of promisor remotes via the
|
|
'promisor.acceptFromServerURL' configuration variable.
|
|
|
|
* The 'ort' merge backend has been hardened against corrupt trees by
|
|
ensuring it aborts under appropriate error conditions.
|
|
|
|
* The `fetch.followRemoteHEAD` configuration variable has been added to
|
|
provide a default for the per-remote `remote.<name>.followRemoteHEAD`
|
|
setting.
|
|
|
|
* "git log --follow" has been updated to better handle non-linear
|
|
history, in which the path being tracked gets renamed differently in
|
|
multiple history lines.
|
|
|
|
* The "git repo info" command has been taught new keys to output both
|
|
absolute and relative paths for "gitdir" and "commondir", supported by
|
|
a new path-formatting helper extracted from "git rev-parse".
|
|
|
|
* When 'git push origin/main' or 'git branch origin main' is run, the
|
|
command is now recognized as a potential typo, and advice has been
|
|
added to offer a typo fix.
|
|
|
|
* The 'git refs' toolbox has been extended with new 'create', 'delete',
|
|
'update', and 'rename' subcommands to create, delete, update, and
|
|
rename references, respectively.
|
|
|
|
* The experimental 'git history' command has been taught a new 'drop'
|
|
subcommand to remove a commit, with its descendants replayed onto its
|
|
parent.
|
|
|
|
* The alignment of commit object name abbreviations in 'git blame'
|
|
output has been optimized to reserve a column for marks (caret,
|
|
question mark, or asterisk) only when such marks are actually shown.
|
|
|
|
* Option parsing with 'git rev-parse --parseopt' and in most 'git'
|
|
subcommands has been updated to exit with 0 (instead of 129) when the
|
|
help option ('-h' or '--help') is requested directly by the user,
|
|
aligning with standard Unix convention.
|
|
|
|
* The '[includeIf "condition"]' conditional inclusion facility for
|
|
configuration files has been taught to use the location of the
|
|
worktree in its condition.
|
|
|
|
* The usage string and SYNOPSIS for 'git fast-export' have been
|
|
standardized to make them consistent with each other and with other
|
|
commands.
|
|
|
|
|
|
Performance, Internal Implementation, Development Support etc.
|
|
--------------------------------------------------------------
|
|
|
|
* The refactoring of 'setup.c' has been continued to drop remaining
|
|
global state (`git_work_tree_cfg`, `is_bare_repository_cfg`), updating
|
|
`is_bare_repository()` to no longer implicitly rely on
|
|
`the_repository`.
|
|
|
|
* Project-specific configuration for b4 has been introduced, and the
|
|
documentation has been updated to recommend using it as a
|
|
streamlined method for submitting patches.
|
|
|
|
* The default format path of git cat-file --batch has been optimized
|
|
to use strbuf_add_oid_hex() and strbuf_add_uint() instead of
|
|
strbuf_addf(), yielding a noticeable speedup.
|
|
|
|
* Commands that list branches and tags (like git branch and git tag)
|
|
have been optimized to pass the namespace prefix when initializing
|
|
their ref iterator, avoiding a loose-ref scaling regression in
|
|
repositories with many unrelated loose references.
|
|
|
|
* The packed object source has been refactored into a proper struct
|
|
odb_source.
|
|
|
|
* The global configuration variables protect_hfs and protect_ntfs have
|
|
been migrated into struct repo_config_values to tie them to
|
|
per-repository configuration state.
|
|
|
|
* The trailer sections in SubmittingPatches have been updated to
|
|
encourage use of standard trailers.
|
|
|
|
* The documentation in SubmittingPatches has been updated to clarify how
|
|
patch contributors should respond to design and viability critiques,
|
|
and how the resolution of such critiques should be recorded in the
|
|
final commit messages.
|
|
|
|
* The pack-objects command has been updated to support reachability
|
|
bitmaps and delta-islands concurrently with the `--path-walk` option,
|
|
allowing faster packaging by falling back to path-walk when bitmaps
|
|
cannot fully satisfy the request.
|
|
|
|
* Documentation on community contribution guidelines has been updated to
|
|
encourage replying to review comments before rerolling, and to advise
|
|
a default limit of at most one reroll per day to give reviewers across
|
|
different time zones enough time to participate.
|
|
|
|
* The lazy priority queue optimization pattern (deferring actual removal
|
|
in 'prio_queue_get()' to allow get+put fusion) has been folded
|
|
directly into 'prio_queue' itself, speeding up commit traversal
|
|
workflows and simplifying callers.
|
|
|
|
* The 'reprepare()' callback for object database sources has been
|
|
generalized into a 'prepare()' callback with an optional flush cache
|
|
flag, and a new 'odb_prepare()' wrapper has been introduced to allow
|
|
pre-opening object database sources.
|
|
|
|
* The 'whence' field in 'struct object_info' has been removed. The
|
|
backend-specific object information retrieval has been refactored into
|
|
an opt-in 'struct object_info_source' structure.
|
|
|
|
* A racy build failure under Meson has been corrected by ensuring that
|
|
the generated header file 'hook-list.h' is built before compiling
|
|
files in 'builtin_sources' that depend on it.
|
|
|
|
* The repository discovery and repository configuration phases, which
|
|
were previously intertwined in 'setup.c', have been split. Repository
|
|
discovery has been updated to populate a 'struct repo_discovery'
|
|
without modifying the repository state, which is then taken by
|
|
repository configuration to initialize the repository, paving the way
|
|
for clean unification of repository configuration.
|
|
|
|
* The 'SubmittingPatches' document has been updated to explicitly
|
|
describe the expectation for contributors to retract or abandon their
|
|
patch series when they are no longer pursuing it.
|
|
|
|
* The contributor guide has been updated to advise new contributors to
|
|
trim irrelevant quoted text when replying to review comments, matching
|
|
the existing advice given to reviewers.
|
|
|
|
* The build system has been updated to support building universal macOS
|
|
binaries when 'Rust' is enabled, by compiling separate static archives
|
|
for each target triple listed in 'RUST_TARGETS' and combining them
|
|
using the macOS 'lipo' tool. The 'git-credential-osxkeychain' helper
|
|
has been updated to link against '$(RUST_LIB)' when 'Rust' is enabled.
|
|
|
|
* The test suite has been updated to use the 'test_grep' helper instead
|
|
of bare 'grep' for test assertions, allowing file contents to be
|
|
printed on failure for easier debugging. A new 'greplint' linter has
|
|
been introduced to detect and prevent new bare 'grep' assertions from
|
|
being added to the test suite.
|
|
|
|
* The pipelines in 't1410-reflog.sh' have been replaced with the
|
|
'test_stdout_line_count' helper to avoid suppressing the exit code of
|
|
'git' commands, ensuring failures are not hidden from the test suite.
|
|
|
|
* The cache-scanning loop in 'next_cache_entry()' has been optimized
|
|
to avoid rescanning already-unpacked index entries, preventing a
|
|
quadratic performance slow-down when diffing the working tree
|
|
against a commit with a pathspec matching early index entries.
|
|
|
|
* The global configuration variable 'ignore_case' (representing the
|
|
'core.ignorecase' configuration) has been migrated into 'struct
|
|
repo_config_values' to tie it to a specific repository instance.
|
|
|
|
* The performance of ref updates and reads using the 'reftable' backend
|
|
in the presence of many deletion tombstone records has been optimized
|
|
by removing the tombstone suppression flag from the merged iterator
|
|
and instead skipping tombstones at higher-level call sites where
|
|
iteration bounds are known.
|
|
|
|
* Various code paths have been hardened against potential NULL-pointer
|
|
dereferences and invalid file descriptor accesses flagged by
|
|
Coverity.
|
|
|
|
* The in-tree 'b4' cover letter template has been updated to include the
|
|
'change-id' trailer, ensuring that sent tags generated by 'b4' contain
|
|
the required tracking information for subsequent runs.
|
|
|
|
* 'git receive-pack' has been refactored to use ODB transaction
|
|
interfaces instead of directly managing 'tmp_objdir' for staging
|
|
incoming objects, bringing it closer to being ODB backend agnostic.
|
|
|
|
* The test script 't/t9811-git-p4-label-import.sh' has been
|
|
modernized to use 'test_path_is_file' and 'test_path_is_missing'
|
|
instead of raw 'test -f' and '! test -f' calls.
|
|
|
|
* A redundant strbuf_reset() call in the 'HAVE_GETDELIM' path of
|
|
strbuf_getwholeline() has been removed, as getdelim() overwrites the
|
|
buffer and the length is updated afterward.
|
|
|
|
* The object database enumeration interface odb_for_each_object() has
|
|
been taught to accept object filters, allowing the underlying backends
|
|
to optimize the traversal by using reachability bitmaps when
|
|
available. 'git cat-file --batch-all-objects' has been updated to use
|
|
this generic interface, simplifying its code and avoiding direct
|
|
access to ODB backend internals.
|
|
|
|
* The test script 't/t1100-commit-tree-options.sh' has been modernized
|
|
by converting test cases to the modern style (using single quotes and
|
|
tab indentation) and moving the creation of the expected file inside
|
|
the setup test so it runs under the protection of the test harness.
|
|
|
|
* The test script 't/t7614-merge-signoff.sh' has been updated to avoid
|
|
suppressing the exit code of 'git' commands in a pipe.
|
|
|
|
* The 'git rev-list --no-walk' command has been corrected to restore
|
|
pathspec filtering, which was lost when the streaming walk was
|
|
refactored.
|
|
|
|
|
|
Fixes since v2.55
|
|
-----------------
|
|
|
|
* A regression in the error diagnosis code for invalid .git files has
|
|
been fixed, avoiding a potential NULL-pointer crash when reporting
|
|
that a .git file does not point to a valid repository.
|
|
(merge 54a441bcea jk/setup-gitfile-diag-fix later to maint).
|
|
|
|
* Support for hashing loose or packed objects larger than 4GB on Windows
|
|
and other LLP64 platforms has been improved by converting object header
|
|
buffers and data-handling functions from 'unsigned long' to 'size_t'.
|
|
(merge d99e13d0be po/hash-object-size-t later to maint).
|
|
|
|
* The display of the rebase todo list in "git status" has been
|
|
improved to correctly abbreviate object IDs for more commands and
|
|
avoid misinterpreting refs as object IDs.
|
|
(merge 6f34e5f9e3 pw/status-rebase-todo later to maint).
|
|
|
|
* Reference backend configuration has been updated to load lazily to
|
|
avoid recursive calls during repository initialization when 'onbranch'
|
|
configuration conditions are evaluated. This has also fixed a memory
|
|
leak and allowed the unused `chdir_notify_reparent()` machinery to be
|
|
dropped.
|
|
(merge d6522d01df ps/refs-onbranch-fixes later to maint).
|
|
|
|
* The connectivity check has been refactored to search for promisor
|
|
objects in a generic way using the object database interface,
|
|
rather than iterating packfiles directly. This allows connectivity
|
|
checks to work properly in repositories that do not use packfiles.
|
|
(merge 66ee9cb930 ps/connected-generic-promisor-checks later to maint).
|
|
|
|
* A test checking interactions between git rebase --quit and
|
|
autostash in t3420-rebase-autostash.sh has been corrected to use
|
|
test_path_is_missing instead of ! grep on a file that shouldn't
|
|
exist in the conflicted state.
|
|
(merge eaad121fef sg/t3420-do-not-grep-in-missing-file later to maint).
|
|
|
|
* The GPG and SSH signature parsing code has been corrected to strip
|
|
carriage return characters only when they immediately precede line
|
|
feeds, instead of unconditionally stripping all carriage returns.
|
|
(merge 5dea8b690b ad/gpg-strip-cr-before-lf later to maint).
|
|
|
|
* A memory leak in the 'reftable_writer_new()' initialization function
|
|
has been fixed by delaying the allocation of 'struct reftable_writer'
|
|
until after input options are validated.
|
|
(merge c6fb3b9c3e jk/reftable-leakfix later to maint).
|
|
|
|
* A memory leak in the '--base' handling of 'git format-patch' has been
|
|
plugged, and the leak reporting of the test suite when running under a
|
|
TAP harness has been improved.
|
|
(merge 973a0373ff jk/format-patch-leakfix later to maint).
|
|
|
|
* A write file stream resource leak has been fixed as part of a code
|
|
cleanup.
|
|
(merge ebb4d2ffa3 jc/history-message-prep-fix later to maint).
|
|
|
|
* Various memory leaks in the Bloom-filter code paths that are exposed
|
|
when running tests with the 'GIT_TEST_COMMIT_GRAPH_CHANGED_PATHS=1'
|
|
environment variable have been plugged.
|
|
(merge 459088ec2e jk/bloom-leak-fixes later to maint).
|
|
|
|
* The wincred credential helper has been updated to avoid memory
|
|
corruption when erasing credentials and to prevent silent
|
|
credential loss when storing OAuth tokens, by correcting buffer
|
|
allocations and arguments passed to safe-CRT APIs.
|
|
(merge f635ab9ab4 js/wincred-fixes later to maint).
|
|
|
|
* Various code paths that initialize a cryptographic hash context but
|
|
bail out or finish without calling 'git_hash_final()' have been taught
|
|
to call 'git_hash_discard()' to release allocated resources, fixing
|
|
memory leaks when Git is built with non-default backends like
|
|
'OpenSSL' or 'libgcrypt'.
|
|
(merge 600588d2aa jk/hash-algo-leak-fixes later to maint).
|
|
|
|
* Various resource leaks, invalid file descriptor closures, and process
|
|
handle ownership issues flagged by Coverity have been fixed.
|
|
(merge 9184231173 js/coverity-fixes later to maint).
|
|
|
|
* Dockerized CI jobs running in private GitHub repositories have been
|
|
adjusted to use explicit process and file limits, preventing resource
|
|
exhaustion errors on private runners.
|
|
(merge bad766fbac js/ci-dockerized-pid-limit later to maint).
|
|
|
|
* Various test scripts have been updated to clean up large temporary
|
|
files and repositories, reducing peak disk usage during testing.
|
|
Also, expensive tests have been disabled on platforms that lack
|
|
sufficient resources (like 32-bit platforms and Windows CI runners),
|
|
and the long test suite has been enabled in GitLab CI.
|
|
(merge 84248444ad ps/t-fixes-for-git-test-long later to maint).
|
|
|
|
* The UTF-8 precomposition wrapper on macOS has been updated to use a
|
|
flexible array member to represent the name of a directory entry,
|
|
preventing fortified libc checks from failing when the name is
|
|
reallocated to be larger than 'NAME_MAX' bytes.
|
|
(merge 1eb281159f ih/precompose-flex-array later to maint).
|
|
|
|
* The 'git_hash_*()' wrappers have been updated to be used consistently
|
|
across the codebase instead of direct calls to members of 'struct
|
|
git_hash_algo', and 'git_hash_discard()' has been made idempotent to
|
|
simplify cleanups.
|
|
(merge 9e396aa553 jk/git-hash-cleanups later to maint).
|
|
|
|
* The sideband demultiplexer has been updated to recognize ANSI SGR
|
|
escape sequences that use colon-separated subfields (e.g., for
|
|
256-color or true-color codes).
|
|
(merge 3792b2aea4 mm/sideband-ansi-sgr-colon-fix later to maint).
|
|
|
|
* The 'reftable' code has been hardened against corrupted tables by
|
|
fixing out-of-bounds writes, out-of-bounds reads, and abort calls
|
|
during parsing.
|
|
(merge ca93c27328 ps/reftable-hardening later to maint).
|
|
|
|
* A description in the release notes for Git 2.55.0 has been
|
|
retroactively updated to clarify that Rust support is enabled by
|
|
default, but still optional, and will become mandatory in Git 3.0.
|
|
(merge 18b2009d14 jc/relnotes-2.55-rust-fix later to maint).
|
|
|
|
* The early-exit optimization in 'paint_down_to_common()' has been
|
|
gated on the queue being generation-ordered, fixing a bug where
|
|
'git merge-base' (without '--all') could return incorrect results
|
|
on repositories with v1 commit graphs and clock skew.
|
|
(merge ae68032a8d kk/commit-reach-find-all-fix later to maint).
|
|
|
|
* The client-side parser of the server-advertised bundle-URI list has
|
|
been updated to drain the remaining response in order to avoid
|
|
protocol desynchronization when the server sends a misconfigured list.
|
|
Also, the server-side has been taught to omit empty configuration
|
|
values instead of sending invalid key-value lines.
|
|
(merge 50de1169e4 tc/bundle-uri-empty-fix later to maint).
|
|
|
|
* The 'topo_levels' slab was propagated only to the topmost layer of a
|
|
split commit-graph chain, causing topological levels for commits in
|
|
base layers to be recomputed during incremental writes. This has been
|
|
corrected.
|
|
|
|
* The stream-based object signature verification path has been
|
|
corrected to avoid double-closing the stream on read errors.
|
|
(merge cfd52a74a0 ps/odb-stream-double-close-fix later to maint).
|
|
|
|
* The '-i' shorthand for the '--init' option, which was accepted by the
|
|
'git submodule update' command until it was broken in a modernization
|
|
of the option-parsing code, has been restored.
|
|
(merge ff1da37f58 dm/submodule-update-i-shorthand later to maint).
|