Documentation/RelNotes/2.45.0.txt

   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
  15  * Variants of vimdiff learned to honor mergetool.<variant>.layout
  16    settings.
  17
  18  * "git reflog" learned a "list" subcommand that enumerates known reflogs.
  19
  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
  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
  37  * Platform specific tweaks for OS/390 has been added to
  38    config.mak.uname.
  39
  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
  48
  49 Performance, Internal Implementation, Development Support etc.
  50
  51  * The code to iterate over refs with the reftable backend has seen
  52    some optimization.
  53
  54  * More tests that are marked as "ref-files only" have been updated to
  55    improve test coverage of reftable backend.
  56
  57  * Some parts of command line completion script (in contrib/) have
  58    been micro-optimized.
  59
  60  * The way placeholders are to be marked-up in documentation have been
  61    specified; use "_<placeholder>_" to typeset the word inside a pair
  62    of <angle-brakets> emphasized.
  63
  64  * "git --no-lazy-fetch cmd" allows to run "cmd" while disabling lazy
  65    fetching of objects from the promisor remote, which may be handy
  66    for debugging.
  67
  68  * The implementation in "git clean" that makes "-n" and "-i" ignore
  69    clean.requireForce has been simplified, together with the
  70    documentation.
  71
  72  * The code to iterate over refs with the reftable backend has seen
  73    some optimization.
  74
  75  * Uses of xwrite() helper have been audited and updated for better
  76    error checking and simpler code.
  77
  78  * Some trace2 events that lacked def_param have learned to show it,
  79    enriching the output.
  80
  81  * The parse-options code that deals with abbreviated long option
  82    names have been cleaned up.
  83
  84  * The code in reftable backend that creates new table files works
  85    better with the tempfile framework to avoid leaving cruft after a
  86    failure.
  87
  88  * The reftable code has its own custom binary search function whose
  89    comparison callback has an unusual interface, which caused the
  90    binary search to degenerate into a linear search, which has been
  91    corrected.
  92
  93  * The code to iterate over reflogs in the reftable has been optimized
  94    to reduce memory allocation and deallocation.
  95
  96
  97 Fixes since v2.44
  98 -----------------
  99
 100  * "git apply" on a filesystem without filemode support have learned
 101    to take a hint from what is in the index for the path, even when
 102    not working with the "--index" or "--cached" option, when checking
 103    the executable bit match what is required by the preimage in the
 104    patch.
 105    (merge 45b625142d cp/apply-core-filemode later to maint).
 106
 107  * "git column" has been taught to reject negative padding value, as
 108    it would lead to nonsense behaviour including division by zero.
 109    (merge 76fb807faa kh/column-reject-negative-padding later to maint).
 110
 111  * "git am --help" now tells readers what actions are available in
 112    "git am --whitespace=<action>", in addition to saying that the
 113    option is passed through to the underlying "git apply".
 114    (merge a171dac734 jc/am-whitespace-doc later to maint).
 115
 116  * "git tag --column" failed to check the exit status of its "git
 117    column" invocation, which has been corrected.
 118    (merge 92e66478fc rj/tag-column-fix later to maint).
 119
 120  * Credential helper based on libsecret (in contrib/) has been updated
 121    to handle an empty password correctly.
 122    (merge 8f1f2023b7 mh/libsecret-empty-password-fix later to maint).
 123
 124  * "git difftool --dir-diff" learned to honor the "--trust-exit-code"
 125    option; it used to always exit with 0 and signalled success.
 126    (merge eb84c8b6ce ps/difftool-dir-diff-exit-code later to maint).
 127
 128  * The code incorrectly attempted to use textconv cache when asked,
 129    even when we are not running in a repository, which has been
 130    corrected.
 131    (merge affe355fe7 jk/textconv-cache-outside-repo-fix later to maint).
 132
 133  * Remove an empty file that shouldn't have been added in the first
 134    place.
 135    (merge 4f66942215 js/remove-cruft-files later to maint).
 136
 137  * The logic to access reflog entries by date and number had ugly
 138    corner cases at the boundaries, which have been cleaned up.
 139    (merge 5edd126720 jk/reflog-special-cases-fix later to maint).
 140
 141  * An error message from "git upload-pack", which responds to "git
 142    fetch" requests, had a trialing NUL in it, which has been
 143    corrected.
 144    (merge 3f4c7a0805 sg/upload-pack-error-message-fix later to maint).
 145
 146  * Clarify wording in the CodingGuidelines that requires <git-compat-util.h>
 147    to be the first header file.
 148    (merge 4e89f0e07c jc/doc-compat-util later to maint).
 149
 150  * "git commit -v --cleanup=scissors" used to add the scissors line
 151    twice in the log message buffer, which has been corrected.
 152    (merge e90cc075cc jt/commit-redundant-scissors-fix later to maint).
 153
 154  * A custom remote helper no longer cannot access the newly created
 155    repository during "git clone", which is a regression in Git 2.44.
 156    This has been corrected.
 157    (merge 199f44cb2e ps/remote-helper-repo-initialization-fix later to maint).
 158
 159  * Various parts of upload-pack has been updated to bound the resource
 160    consumption relative to the size of the repository to protect from
 161    abusive clients.
 162    (merge 6cd05e768b jk/upload-pack-bounded-resources later to maint).
 163
 164  * The upload-pack program, when talking over v2, accepted the
 165    packfile-uris protocol extension from the client, even if it did
 166    not advertise the capability, which has been corrected.
 167    (merge a922bfa3b5 jk/upload-pack-v2-capability-cleanup later to maint).
 168
 169  * Make sure failure return from merge_bases_many() is properly caught.
 170    (merge 25fd20eb44 js/merge-base-with-missing-commit later to maint).
 171
 172  * FSMonitor client code was confused when FSEvents were given in a
 173    different case on a case-insensitive filesystem, which has been
 174    corrected.
 175    (merge 29c139ce78 jh/fsmonitor-icase-corner-case-fix later to maint).
 176
 177  * The "core.commentChar" configuration variable only allows an ASCII
 178    character, which was not clearly documented, which has been
 179    corrected.
 180    (merge fb7c556f58 kh/doc-commentchar-is-a-byte later to maint).
 181
 182  * With release 2.44 we got rid of all uses of test_i18ngrep and there
 183    is no in-flight topic that adds a new use of it.  Make a call to
 184    test_i18ngrep a hard failure, so that we can remove it at the end
 185    of this release cycle.
 186    (merge 381a83dfa3 jc/test-i18ngrep later to maint).
 187
 188  * The command line completion script (in contrib/) learned to
 189    complete "git reflog" better.
 190    (merge 1284f9cc11 rj/complete-reflog later to maint).
 191
 192  * The logic to complete the command line arguments to "git worktree"
 193    subcommand (in contrib/) has been updated to correctly honor things
 194    like "git -C dir" etc.
 195    (merge 3574816d98 rj/complete-worktree-paths-fix later to maint).
 196
 197  * When git refuses to create a branch because the proposed branch
 198    name is not a valid refname, an advice message is given to refer
 199    the user to exact naming rules.
 200    (merge 8fbd903e58 kh/branch-ref-syntax-advice later to maint).
 201
 202  * Code simplification by getting rid of code that sets an environment
 203    variable that is no longer used.
 204    (merge 72a8d3f027 pw/rebase-i-ignore-cherry-pick-help-environment later to maint).
 205
 206  * The code to find the effective end of log message can fall into an
 207    endless loop, which has been corrected.
 208    (merge 2541cba2d6 fs/find-end-of-log-message-fix later to maint).
 209
 210  * Mark-ups used in the documentation has been improved for
 211    consistency.
 212    (merge 45d5ed3e50 ja/doc-markup-fixes later to maint).
 213
 214  * The status.showUntrackedFiles configuration variable was
 215    incorrectly documented to accept "false", which has been corrected.
 216
 217  * Leaks from "git restore" have been plugged.
 218    (merge 2f64da0790 rj/restore-plug-leaks later to maint).
 219
 220  * "git bugreport --no-suffix" was not supported and instead
 221    segfaulted, which has been corrected.
 222    (merge b3b57c69da js/bugreport-no-suffix-fix later to maint).
 223
 224  * The documentation for "%(trailers[:options])" placeholder in the
 225    "--pretty" option of commands in the "git log" family has been
 226    updated.
 227    (merge bff85a338c bl/doc-key-val-sep-fix later to maint).
 228
 229  * Other code cleanup, docfix, build fix, etc.
 230    (merge f0e578c69c rs/use-xstrncmpz later to maint).
 231    (merge 83e6eb7d7a ba/credential-test-clean-fix later to maint).
 232    (merge 64562d784d jb/doc-interactive-singlekey-do-not-need-perl later to maint).
 233    (merge c431a235e2 cp/t9146-use-test-path-helpers later to maint).
 234    (merge 82d75402d5 ds/doc-send-email-capitalization later to maint).
 235    (merge 41bff66e35 jc/doc-add-placeholder-fix later to maint).
 236    (merge 6835f0efe9 jw/remote-doc-typofix later to maint).
 237    (merge 244001aa20 hs/rebase-not-in-progress later to maint).
 238    (merge 2ca6c07db2 jc/no-include-of-compat-util-from-headers later to maint).
 239    (merge 87bd7fbb9c rs/fetch-simplify-with-starts-with later to maint).
 240    (merge f39addd0d9 rs/name-rev-with-mempool later to maint).
 241    (merge 9a97b43e03 rs/submodule-prefix-simplify later to maint).
 242    (merge 40b8076462 ak/rebase-autosquash later to maint).
 243    (merge 3223204456 eg/add-uflags later to maint).
 244    (merge 5f78d52dce es/config-doc-sort-sections later to maint).
 245    (merge 781fb7b4c2 as/option-names-in-messages later to maint).
 246    (merge 51d41dc243 jk/doc-remote-helpers-markup-fix later to maint).
 247    (merge e1aaf309db pb/ci-win-artifact-names-fix later to maint).
 248    (merge ad538c61da jc/index-pack-fsck-levels later to maint).
 249    (merge 67471bc704 ja/doc-formatting-fix later to maint).
 250    (merge 86f9ce7dd6 bl/doc-config-fixes later to maint).