Documentation/RelNotes/2.44.0.txt

   1 Git v2.44 Release Notes
   2 =======================
   3
   4 Backward Compatibility Notes
   5
   6  * "git chekcout -B <branch>" used to allow switching to a branch that
   7    is in use on another worktree, but this was by mistake.  The users
   8    need to use "--ignore-other-worktrees" option.
   9
  10
  11 UI, Workflows & Features
  12
  13  * "git add" and "git stash" learned to support the ":(attr:...)"
  14    magic pathspec.
  15
  16  * "git rebase --autosquash" is now enabled for non-interactive rebase,
  17    but it is still incompatible with the apply backend.
  18
  19  * Introduce "git replay", a tool meant on the server side without
  20    working tree to recreate a history.
  21
  22  * "git merge-file" learned to take the "--diff-algorithm" option to
  23    use algorithm different from the default "myers" diff.
  24
  25  * Command line completion (in contrib/) learned to complete path
  26    arguments to the "add/set" subcommands of "git sparse-checkout"
  27    better.
  28
  29  * "git checkout -B <branch> [<start-point>]" allowed a branch that is
  30    in use in another worktree to be updated and checked out, which
  31    might be a bit unexpected.  The rule has been tightened, which is a
  32    breaking change.  "--ignore-other-worktrees" option is required to
  33    unbreak you, if you are used to the current behaviour that "-B"
  34    overrides the safety.
  35
  36  * The builtin_objectmode attribute is populated for each path
  37    without adding anything in .gitattributes files, which would be
  38    useful in magic pathspec, e.g., ":(attr:builtin_objectmode=100755)"
  39    to limit to executables.
  40
  41  * "git fetch" learned to pay attention to "fetch.all" configuration
  42    variable, which pretends as if "--all" was passed from the command
  43    line when no remote parameter was given.
  44
  45  * In addition to (rather cryptic) Security Identifiers, show username
  46    and domain in the error message when we barf on mismatch between
  47    the Git directory and the current user on Windows.
  48
  49  * The error message given when "git branch -d branch" fails due to
  50    commits unique to the branch has been split into an error and a new
  51    conditional advice message.
  52
  53  * When given an existing but unreadable file as a configuration file,
  54    gitweb behaved as if the file did not exist at all, but now it
  55    errors out.  This is a change that may break backward compatibility.
  56
  57  * When $HOME/.gitignore is missing but XDG config file available, we
  58    should write into the latter, not former.  "git gc" and "git
  59    maintenance" wrote into a wrong "global config" file, which have
  60    been corrected.
  61
  62  * Define "special ref" as a very narrow set that consists of
  63    FETCH_HEAD and MERGE_HEAD, and clarify everything else that used to
  64    be classified as such are actually just pseudorefs.
  65
  66
  67 Performance, Internal Implementation, Development Support etc.
  68
  69  * Process to add some form of low-level unit tests has started.
  70
  71  * Add support for GitLab CI.
  72
  73  * "git for-each-ref --no-sort" still sorted the refs alphabetically
  74    which paid non-trivial cost.  It has been redefined to show output
  75    in an unspecified order, to allow certain optimizations to take
  76    advantage of.
  77
  78  * Simplify API implementation to delete references by eliminating
  79    duplication.
  80
  81  * Subject approxidate() and show_date() machinery to OSS-Fuzz.
  82
  83  * A new helper to let us pretend that we called lstat() when we know
  84    our cache_entry is up-to-date via fsmonitor.
  85
  86  * The optimization based on fsmonitor in the "diff --cached"
  87    codepath is resurrected with the "fake-lstat" introduced earlier.
  88
  89  * Test balloon to use C99 "bool" type from <stdbool.h> has been
  90    added.
  91
  92  * "git clone" has been prepared to allow cloning a repository with
  93    non-default hash function into a repository that uses the reftable
  94    backend.
  95
  96  * Streaming spans of packfile data used to be done only from a
  97    single, primary, pack in a repository with multiple packfiles.  It
  98    has been extended to allow reuse from other packfiles, too.
  99
 100  * Comment updates to help developers not to attempt to modify
 101    messages from plumbing commands that must stay constant.
 102
 103    It might make sense to reassess the plumbing needs every few years,
 104    but that should be done as a separate effort.
 105
 106  * Move test-ctype helper to the unit-test framework.
 107
 108  * Instead of manually creating refs/ hierarchy on disk upon a
 109    creation of a secondary worktree, which is only usable via the
 110    files backend, use the refs API to populate it.
 111
 112  * CI for GitLab learned to drive macOS jobs.
 113
 114  * A few tests to "git commit -o <pathspec>" and "git commit -i
 115    <pathspec>" has been added.
 116
 117
 118 Fixes since v2.43
 119 -----------------
 120
 121  * The way CI testing used "prove" could lead to running the test
 122    suite twice needlessly, which has been corrected.
 123    (merge e7e03ef995 js/ci-discard-prove-state later to maint).
 124
 125  * Update ref-related tests.
 126
 127  * "git format-patch --encode-email-headers" ignored the option when
 128    preparing the cover letter, which has been corrected.
 129
 130  * Newer versions of Getopt::Long started giving warnings against our
 131    (ab)use of it in "git send-email".  Bump the minimum version
 132    requirement for Perl to 5.8.1 (from September 2002) to allow
 133    simplifying our implementation.
 134    (merge 6ff658cc78 tz/send-email-negatable-options later to maint).
 135
 136  * Earlier we stopped relying on commit-graph that (still) records
 137    information about commits that are lost from the object store,
 138    which has negative performance implications.  The default has been
 139    flipped to disable this pessimization.
 140    (merge b1df3b3867 ps/commit-graph-less-paranoid later to maint).
 141
 142  * Stale URLs have been updated to their current counterparts (or
 143    archive.org) and HTTP links are replaced with working HTTPS links.
 144    (merge 62b4f7b9c6 js/update-urls-in-doc-and-comment later to maint).
 145
 146  * trace2 streams used to record the URLs that potentially embed
 147    authentication material, which has been corrected.
 148    (merge 16fa3eebc0 jh/trace2-redact-auth later to maint).
 149
 150  * The sample pre-commit hook that tries to catch introduction of new
 151    paths that use potentially non-portable characters did not notice
 152    an existing path getting renamed to such a problematic path, when
 153    rename detection was enabled.
 154    (merge d9fd71fa2a jp/use-diff-index-in-pre-commit-sample later to maint).
 155
 156  * The command line parser for the "log" family of commands was too
 157    loose when parsing certain numbers, e.g., silently ignoring the
 158    extra 'q' in "git log -n 1q" without complaining, which has been
 159    tightened up.
 160    (merge 71a1e94821 jc/revision-parse-int later to maint).
 161
 162  * "git $cmd --end-of-options --rev -- --path" for some $cmd failed
 163    to interpret "--rev" as a rev, and "--path" as a path.  This was
 164    fixed for many programs like "reset" and "checkout".
 165    (merge 9385174627 jk/end-of-options later to maint).
 166
 167  * "git bisect reset" has been taught to clean up state files and refs
 168    even when BISECT_START file is gone.
 169    (merge daaa03e54c jk/bisect-reset-fix later to maint).
 170
 171  * Some codepaths did not correctly parse configuration variables
 172    specified with valueless "true", which has been corrected.
 173    (merge d49cb162fa jk/implicit-true later to maint).
 174
 175  * Code clean-up for sanity checking of command line options for "git
 176    show-ref".
 177    (merge 7382497372 rs/show-ref-incompatible-options later to maint).
 178
 179  * The code to parse the From e-mail header has been updated to avoid
 180    recursion.
 181    (merge dee182941f jk/mailinfo-iterative-unquote-comment later to maint).
 182
 183  * "git fetch --atomic" issued an unnecessary empty error message,
 184    which has been corrected.
 185    (merge 18ce48918c jx/fetch-atomic-error-message-fix later to maint).
 186
 187  * Command line completion script (in contrib/) learned to work better
 188    with the reftable backend.
 189    (merge 44dbb3bf29 sh/completion-with-reftable later to maint).
 190
 191  * "git status" is taught to show both the branch being bisected and
 192    being rebased when both are in effect at the same time.
 193    (merge 990adccbdf rj/status-bisect-while-rebase later to maint).
 194
 195  * "git archive --list extra garbage" silently ignored excess command
 196    line parameters, which has been corrected.
 197    (merge d6b6cd1393 jc/archive-list-with-extra-args later to maint).
 198
 199  * "git sparse-checkout set" added default patterns even when the
 200    patterns are being fed from the standard input, which has been
 201    corrected.
 202    (merge 53ded839ae jc/sparse-checkout-set-default-fix later to maint).
 203
 204  * "git sparse-checkout (add|set) --[no-]cone --end-of-options" did
 205    not handle "--end-of-options" correctly after a recent update.
 206
 207  * Unlike other environment variables that took the usual
 208    true/false/yes/no as well as 0/1, GIT_FLUSH only understood 0/1,
 209    which has been corrected.
 210    (merge 556e68032f cp/git-flush-is-an-env-bool later to maint).
 211
 212  * Clearing in-core repository (happens during e.g., "git fetch
 213    --recurse-submodules" with commit graph enabled) made in-core
 214    commit object in an inconsistent state by discarding the necessary
 215    data from commit-graph too early, which has been corrected.
 216    (merge d70f554cdf jk/commit-graph-slab-clear-fix later to maint).
 217
 218  * Update to a new feature recently added, "git show-ref --exists".
 219    (merge 0aabeaa562 tc/show-ref-exists-fix later to maint).
 220
 221  * oss-fuzz tests are built and run in CI.
 222    (merge c4a9cf1df3 js/oss-fuzz-build-in-ci later to maint).
 223
 224  * Rename detection logic ignored the final line of a file if it is an
 225    incomplete line.
 226    (merge 1c5bc6971e en/diffcore-delta-final-line-fix later to maint).
 227
 228  * Other code cleanup, docfix, build fix, etc.
 229    (merge 50f1abcff6 js/packfile-h-typofix later to maint).
 230    (merge cbf498eb53 jb/reflog-expire-delete-dry-run-options later to maint).
 231    (merge 7854bf4960 rs/i18n-cannot-be-used-together later to maint).
 232    (merge cd3c28c53a rs/column-leakfix later to maint).
 233    (merge 866a1b9026 ps/ref-tests-update-more later to maint).
 234    (merge e4299d26d4 mk/doc-gitfile-more later to maint).
 235    (merge 792b86283b rs/incompatible-options-messages later to maint).
 236    (merge ea8f9494ab jk/config-cleanup later to maint).
 237    (merge d1bd3a8c34 jk/mailinfo-oob-read-fix later to maint).
 238    (merge c0cadb0576 ps/reftable-fixes later to maint).
 239    (merge 647b5e0998 ps/chainlint-self-check-update later to maint).
 240    (merge 68fcebfb1a es/add-doc-list-short-form-of-all-in-synopsis later to maint).
 241    (merge bc62d27d5c jc/doc-most-refs-are-not-that-special later to maint).
 242    (merge 6d6f1cd7ee jc/doc-misspelt-refs-fix later to maint).
 243    (merge 37e8d795be sp/test-i18ngrep later to maint).
 244    (merge fbc6526ea6 rs/t6300-compressed-size-fix later to maint).
 245    (merge 45184afb4d rs/rebase-use-strvec-pushf later to maint).
 246    (merge a762af3dfd jc/retire-cas-opt-name-constant later to maint).
 247    (merge de7c27a186 la/trailer-cleanups later to maint).
 248    (merge d44b517137 jc/orphan-unborn later to maint).
 249    (merge 63956c553d ml/doc-merge-updates later to maint).
 250    (merge d57c671a51 en/header-cleanup later to maint).
 251    (merge 5b7eec4bc5 rs/fast-import-simplify-mempool-allocation later to maint).
 252    (merge 291873e5d6 js/contributor-docs-updates later to maint).
 253    (merge 54d8a2531b jk/t1006-cat-file-objectsize-disk later to maint).
 254    (merge 7033d5479b jx/sideband-chomp-newline-fix later to maint).
 255    (merge 9cd30af991 ms/rebase-insnformat-doc-fix later to maint).
 256    (merge 03bcc93769 cp/sideband-array-index-comment-fix later to maint).
 257    (merge 993d38a066 jk/index-pack-lsan-false-positive-fix later to maint).
 258    (merge 25aec06326 ib/rebase-reschedule-doc later to maint).
 259    (merge 5aea3955bc rj/clarify-branch-doc-m later to maint).
 260    (merge 9cce3be2df bk/bisect-doc-fix later to maint).
 261    (merge 8f50984cf4 ne/doc-filter-blob-limit-fix later to maint).
 262    (merge f10b0989b8 la/strvec-comment-fix later to maint).
 263    (merge 8430b438f6 vd/fsck-submodule-url-test later to maint).
 264    (merge f10031fadd nb/rebase-x-shell-docfix later to maint).
 265    (merge af3d2c160f jc/majordomo-to-subspace later to maint).