Documentation/RelNotes/2.23.0.txt

   1 Git 2.23 Release Notes
   2 ======================
   3
   4 Updates since v2.22
   5 -------------------
   6
   7 Backward compatibility note
   8
   9  * The "--base" option of "format-patch" computed the patch-ids for
  10    prerequisite patches in an unstable way, which has been updated to
  11    compute in a way that is compatible with "git patch-id --stable".
  12
  13
  14 UI, Workflows & Features
  15
  16  * The "git fast-export/import" pair has been taught to handle commits
  17    with log messages in encoding other than UTF-8 better.
  18
  19  * In recent versions of Git, per-worktree refs are exposed in
  20    refs/worktrees/<wtname>/ hierarchy, which means that worktree names
  21    must be a valid refname component.  The code now sanitizes the names
  22    given to worktrees, to make sure these refs are well-formed.
  23
  24  * "git merge" learned "--quit" option that cleans up the in-progress
  25    merge while leaving the working tree and the index still in a mess.
  26
  27  * "git format-patch" learns a configuration to set the default for
  28    its --notes=<ref> option.
  29
  30  * The code to show args with potential typo that cannot be
  31    interpreted as a commit-ish has been improved.
  32
  33  * "git clone --recurse-submodules" learned to set up the submodules
  34    to ignore commit object names recorded in the superproject gitlink
  35    and instead use the commits that happen to be at the tip of the
  36    remote-tracking branches from the get-go, by passing the new
  37    "--remote-submodules" option.
  38
  39  * The pattern "git diff/grep" use to extract funcname and words
  40    boundary for Matlab has been extend to cover Octave, which is more
  41    or less equivalent.
  42
  43  * "git help git" was hard to discover (well, at least for some
  44    people).
  45
  46  * The pattern "git diff/grep" use to extract funcname and words
  47    boundary for Rust has been added.
  48
  49  * "git status" can be told a non-standard default value for the
  50    "--[no-]ahead-behind" option with a new configuration variable
  51    status.aheadBehind.
  52
  53  * "git fetch" and "git pull" reports when a fetch results in
  54    non-fast-forward updates to let the user notice unusual situation.
  55    The commands learned "--no-shown-forced-updates" option to disable
  56    this safety feature.
  57
  58  * Two new commands "git switch" and "git restore" are introduced to
  59    split "checking out a branch to work on advancing its history" and
  60    "checking out paths out of the index and/or a tree-ish to work on
  61    advancing the current history" out of the single "git checkout"
  62    command.
  63
  64  * "git branch --list" learned to always output the detached HEAD as
  65    the first item (when the HEAD is detached, of course), regardless
  66    of the locale.
  67
  68  * The conditional inclusion mechanism learned to base the choice on
  69    the branch the HEAD currently is on.
  70
  71  * "git rev-list --objects" learned with "--no-object-names" option to
  72    squelch the path to the object that is used as a grouping hint for
  73    pack-objects.
  74
  75  * A new tag.gpgSign configuration variable turns "git tag -a" into
  76    "git tag -s".
  77
  78  * "git multi-pack-index" learned expire and repack subcommands.
  79
  80  * "git blame" learned to "ignore" commits in the history, whose
  81    effects (as well as their presence) get ignored.
  82
  83  * "git cherry-pick/revert" learned a new "--skip" action.
  84
  85  * The tips of refs from the alternate object store can be used as
  86    starting point for reachability computation now.
  87
  88  * Extra blank lines in "git status" output have been reduced.
  89
  90  * The commits in a repository can be described by multiple
  91    commit-graph files now, which allows the commit-graph files to be
  92    updated incrementally.
  93
  94
  95 Performance, Internal Implementation, Development Support etc.
  96
  97  * Update supporting parts of "git rebase" to remove code that should
  98    no longer be used.
  99
 100  * Developer support to emulate unsatisfied prerequisites in tests to
 101    ensure that the remainer of the tests still succeeds when tests
 102    with prerequisites are skipped.
 103
 104  * "git update-server-info" learned not to rewrite the file with the
 105    same contents.
 106
 107  * The way of specifying the path to find dynamic libraries at runtime
 108    has been simplified.  The old default to pass -R/path/to/dir has been
 109    replaced with the new default to pass -Wl,-rpath,/path/to/dir,
 110    which is the more recent GCC uses.  Those who need to build with an
 111    old GCC can still use "CC_LD_DYNPATH=-R"
 112
 113  * Prepare use of reachability index in topological walker that works
 114    on a range (A..B).
 115
 116  * A new tutorial targetting specifically aspiring git-core
 117    developers has been added.
 118
 119  * Auto-detect how to tell HP-UX aCC where to use dynamically linked
 120    libraries from at runtime.
 121
 122  * "git mergetool" and its tests now spawn fewer subprocesses.
 123
 124  * Dev support update to help tracing out tests.
 125
 126  * Support to build with MSVC has been updated.
 127
 128  * "git fetch" that grabs from a group of remotes learned to run the
 129    auto-gc only once at the very end.
 130
 131  * A handful of Windows build patches have been upstreamed.
 132
 133  * The code to read state files used by the sequencer machinery for
 134    "git status" has been made more robust against a corrupt or stale
 135    state files.
 136
 137  * "git for-each-ref" with multiple patterns have been optimized.
 138
 139  * The tree-walk API learned to pass an in-core repository
 140    instance throughout more codepaths.
 141
 142  * When one step in multi step cherry-pick or revert is reset or
 143    committed, the command line prompt script failed to notice the
 144    current status, which has been improved.
 145
 146
 147 Fixes since v2.22
 148 -----------------
 149
 150  * A relative pathname given to "git init --template=<path> <repo>"
 151    ought to be relative to the directory "git init" gets invoked in,
 152    but it instead was made relative to the repository, which has been
 153    corrected.
 154    (merge e1df7fe43f nd/init-relative-template-fix later to maint).
 155
 156  * "git worktree add" used to fail when another worktree connected to
 157    the same repository was corrupt, which has been corrected.
 158    (merge 105df73e71 nd/corrupt-worktrees later to maint).
 159
 160  * The ownership rule for the file descriptor to fast-import remote
 161    backend was mixed up, leading to unrelated file descriptor getting
 162    closed, which has been fixed.
 163    (merge 3203566a71 mh/import-transport-fd-fix later to maint).
 164
 165  * A "merge -c" instruction during "git rebase --rebase-merges" should
 166    give the user a chance to edit the log message, even when there is
 167    otherwise no need to create a new merge and replace the existing
 168    one (i.e. fast-forward instead), but did not.  Which has been
 169    corrected.
 170
 171  * Code cleanup and futureproof.
 172    (merge 31f5256c82 ds/object-info-for-prefetch-fix later to maint).
 173
 174  * More parameter validation.
 175    (merge de99eb0c24 es/grep-require-name-when-needed later to maint).
 176
 177  * "git update-server-info" used to leave stale packfiles in its
 178    output, which has been corrected.
 179    (merge e941c48d49 ew/server-info-remove-crufts later to maint).
 180
 181  * The server side support for "git fetch" used to show incorrect
 182    value for the HEAD symbolic ref when the namespace feature is in
 183    use, which has been corrected.
 184    (merge 533e088250 jk/HEAD-symref-in-xfer-namespaces later to maint).
 185
 186  * "git am -i --resolved" segfaulted after trying to see a commit as
 187    if it were a tree, which has been corrected.
 188    (merge 7663e438c5 jk/am-i-resolved-fix later to maint).
 189
 190  * "git bundle verify" needs to see if prerequisite objects exist in
 191    the receiving repository, but the command did not check if we are
 192    in a repository upfront, which has been corrected.
 193    (merge 3bbbe467f2 js/bundle-verify-require-object-store later to maint).
 194
 195  * "git merge --squash" is designed to update the working tree and the
 196    index without creating the commit, and this cannot be countermanded
 197    by adding the "--commit" option; the command now refuses to work
 198    when both options are given.
 199    (merge 1d14d0c994 vv/merge-squash-with-explicit-commit later to maint).
 200
 201  * The data collected by fsmonitor was not properly written back to
 202    the on-disk index file, breaking t7519 tests occasionally, which
 203    has been corrected.
 204    (merge b5a8169752 js/fsmonitor-unflake later to maint).
 205
 206  * Update to Unicode 12.1 width table.
 207    (merge 5817f9caa3 bb/unicode-12.1-reiwa later to maint).
 208
 209  * The command line to invoke a "git cat-file" command from inside
 210    "git p4" was not properly quoted to protect a caret and running a
 211    broken command on Windows, which has been corrected.
 212    (merge c3f2358de3 mm/p4-unshelve-windows-fix later to maint).
 213
 214  * "git request-pull" learned to warn when the ref we ask them to pull
 215    from in the local repository and in the published repository are
 216    different.
 217    (merge 0454220d66 pb/request-pull-verify-remote-ref later to maint).
 218
 219  * When creating a partial clone, the object filtering criteria is
 220    recorded for the origin of the clone, but this incorrectly used a
 221    hardcoded name "origin" to name that remote; it has been corrected
 222    to honor the "--origin <name>" option.
 223    (merge 1c4a9f9114 xl/record-partial-clone-origin later to maint).
 224
 225  * "git fetch" into a lazy clone forgot to fetch base objects that are
 226    necessary to complete delta in a thin packfile, which has been
 227    corrected.
 228    (merge 810e19322d jt/partial-clone-missing-ref-delta-base later to maint).
 229
 230  * The filter_data used in the list-objects-filter (which manages a
 231    lazily sparse clone repository) did not use the dynamic array API
 232    correctly---'nr' is supposed to point at one past the last element
 233    of the array in use.  This has been corrected.
 234    (merge 7140600e2e md/list-objects-filter-memfix later to maint).
 235
 236  * The description about slashes in gitignore patterns (used to
 237    indicate things like "anchored to this level only" and "only
 238    matches directories") has been revamped.
 239    (merge 1a58bad014 an/ignore-doc-update later to maint).
 240
 241  * The URL decoding code has been updated to avoid going past the end
 242    of the string while parsing %-<hex>-<hex> sequence.
 243    (merge d37dc239a4 md/url-parse-harden later to maint).
 244
 245  * The list of for-each like macros used by clang-format has been
 246    updated.
 247    (merge fc7e03aace mo/clang-format-for-each-update later to maint).
 248
 249  * "git branch --list" learned to show branches that are checked out
 250    in other worktrees connected to the same repository prefixed with
 251    '+', similar to the way the currently checked out branch is shown
 252    with '*' in front.
 253    (merge 6e9381469e nb/branch-show-other-worktrees-head later to maint).
 254
 255  * Code restructuring during 2.20 period broke fetching tags via
 256    "import" based transports.
 257    (merge f80d922355 fc/fetch-with-import-fix later to maint).
 258
 259  * The commit-graph file is now part of the "files that the runtime
 260    may keep open file descriptors on, all of which would need to be
 261    closed when done with the object store", and the file descriptor to
 262    an existing commit-graph file now is closed before "gc" finalizes a
 263    new instance to replace it.
 264    (merge 2d511cfc0b ds/close-object-store later to maint).
 265
 266  * "git checkout -p" needs to selectively apply a patch in reverse,
 267    which did not work well.
 268    (merge 2bd69b9024 pw/add-p-recount later to maint).
 269
 270  * Code clean-up to avoid signed integer wraparounds during binary search.
 271    (merge 568a05c5ec rs/avoid-overflow-in-midpoint-computation later to maint).
 272
 273  * "git interpret-trailers" always treated '#' as the comment
 274    character, regardless of core.commentChar setting, which has been
 275    corrected.
 276    (merge 29c83fc23f jk/trailers-use-config later to maint).
 277
 278  * "git stash show 23" used to work, but no more after getting
 279    rewritten in C; this regression has been corrected.
 280    (merge 63b50c8ffe tg/stash-ref-by-index-fix later to maint).
 281
 282  * "git rebase --abort" used to leave refs/rewritten/ when concluding
 283    "git rebase -r", which has been corrected.
 284    (merge d559f502c5 pw/rebase-abort-clean-rewritten later to maint).
 285
 286  * An incorrect list of options was cached after command line
 287    completion failed (e.g. trying to complete a command that requires
 288    a repository outside one), which has been corrected.
 289    (merge 69702523af nd/completion-no-cache-failure later to maint).
 290
 291  * The code to parse scaled numbers out of configuration files has
 292    been made more robust and also easier to follow.
 293    (merge 39c575c969 rs/config-unit-parsing later to maint).
 294
 295  * The codepath to compute delta islands used to spew progress output
 296    without giving the callers any way to squelch it, which has been
 297    fixed.
 298    (merge bdbdf42f8a jk/delta-islands-progress-fix later to maint).
 299
 300  * Protocol capabilities that go over wire should never be translated,
 301    but it was incorrectly marked for translation, which has been
 302    corrected.  The output of protocol capabilities for debugging has
 303    been tweaked a bit.
 304
 305  * Use "Erase in Line" CSI sequence that is already used in the editor
 306    support to clear cruft in the progress output.
 307    (merge 5b12e3123b sg/rebase-progress later to maint).
 308
 309  * "git submodule foreach" did not protect command line options passed
 310    to the command to be run in each submodule correctly, when the
 311    "--recursive" option was in use.
 312    (merge 30db18b148 ms/submodule-foreach-fix later to maint).
 313
 314  * The configuration variable rebase.rescheduleFailedExec should be
 315    effective only while running an interactive rebase and should not
 316    affect anything when running an non-interactive one, which was not
 317    the case.  This has been corrected.
 318    (merge 906b63942a js/rebase-reschedule-applies-only-to-interactive later to maint).
 319
 320  * The "git clone" documentation refers to command line options in its
 321    description in the short form; they have been replaced with long
 322    forms to make them more recognisable.
 323    (merge bfc8c84ed5 qn/clone-doc-use-long-form later to maint).
 324
 325  * Generation of pack bitmaps are now disabled when .keep files exist,
 326    as these are mutually exclusive features.
 327    (merge 7328482253 ew/repack-with-bitmaps-by-default later to maint).
 328
 329  * Other code cleanup, docfix, build fix, etc.
 330    (merge f547101b26 es/git-debugger-doc later to maint).
 331    (merge 7877ac3d7b js/bisect-helper-check-get-oid-return-value later to maint).
 332    (merge 0108f47eb3 sw/git-p4-unshelve-branched-files later to maint).
 333    (merge 9df8f734fd cm/send-email-document-req-modules later to maint).
 334    (merge afc3bf6eb1 ab/hash-object-doc later to maint).
 335    (merge 1fde99cfc7 po/doc-branch later to maint).
 336    (merge 459842e1c2 dl/config-alias-doc later to maint).
 337    (merge 5d137fc2c7 cb/fsmonitor-intfix later to maint).
 338    (merge 921d49be86 rs/copy-array later to maint).
 339    (merge cc8d872e69 js/t3404-typofix later to maint).
 340    (merge 729a9b558b cb/mkstemps-uint-type-fix later to maint).
 341    (merge 9dae4fe79f js/gcc-8-and-9 later to maint).
 342    (merge ed33bd8f30 js/t0001-case-insensitive later to maint).
 343    (merge dfa880e336 jw/gitweb-sample-update later to maint).
 344    (merge e532a90a9f sg/t5551-fetch-smart-error-is-translated later to maint).
 345    (merge 8d45ad8c29 jt/t5551-test-chunked later to maint).
 346    (merge 1a64e07d23 sg/git-C-empty-doc later to maint).
 347    (merge 37a2e35395 sg/ci-brew-gcc-workaround later to maint).
 348    (merge 24df0d49c4 js/trace2-signo-typofix later to maint).
 349    (merge fbec05c210 cc/test-oidmap later to maint).