Documentation/RelNotes/2.37.0.txt

   1 Git v2.37 Release Notes
   2 =======================
   3
   4 UI, Workflows & Features
   5
   6  * "vimdiff[123]" mergetool drivers have been reimplemented with a
   7    more generic layout mechanism.
   8
   9  * "git -v" and "git -h" are now understood as "git --version" and
  10    "git --help".
  11
  12  * The temporary files fed to external diff command are now generated
  13    inside a new temporary directory under the same basename.
  14
  15  * "git log --since=X" will stop traversal upon seeing a commit that
  16    is older than X, but there may be commits behind it that is younger
  17    than X when the commit was created with a faulty clock.  A new
  18    option is added to keep digging without stopping, and instead
  19    filter out commits with timestamp older than X.
  20
  21  * "git -c branch.autosetupmerge=simple branch $A $B" will set the $B
  22    as $A's upstream only when $A and $B shares the same name, and "git
  23    -c push.default=simple" on branch $A would push to update the
  24    branch $A at the remote $B came from.  Also more places use the
  25    sole remote, if exists, before defaulting to 'origin'.
  26
  27  * A new doc has been added that lists tips for tools to work with
  28    Git's codebase.
  29
  30  * "git remote -v" now shows the list-objects-filter used during
  31    fetching from the remote, if available.
  32
  33  * With the new http.curloptResolve configuration, the CURLOPT_RESOLVE
  34    mechanism that allows cURL based applications to use pre-resolved
  35    IP addresses for the requests is exposed to the scripts.
  36
  37  * "git add -i" was rewritten in C some time ago and has been in
  38    testing; the reimplementation is now exposed to general public by
  39    default.
  40
  41  * Deprecate non-cone mode of the sparse-checkout feature.
  42
  43  * Introduce a filesystem-dependent mechanism to optimize the way the
  44    bits for many loose object files are ensured to hit the disk
  45    platter.
  46
  47  * The "do not remove the directory the user started Git in" logic,
  48    when Git cannot tell where that directory is, is disabled.  Earlier
  49    we refused to run in such a case.
  50
  51  * A mechanism to pack unreachable objects into a "cruft pack",
  52    instead of ejecting them into loose form to be reclaimed later, has
  53    been introduced.
  54
  55  * Update the doctype written in gitweb output to xhtml5.
  56
  57  * The "fetch.credentialsInUrl" configuration variable controls what
  58    happens when a URL with embedded login credential is used.
  59
  60
  61 Performance, Internal Implementation, Development Support etc.
  62
  63  * The performance of the "untracked cache" feature has been improved
  64    when "--untracked-files=<mode>" and "status.showUntrackedFiles"
  65    are combined.
  66
  67  * "git stash" works better with sparse index entries.
  68
  69  * "git show :<path>" learned to work better with the sparse-index
  70    feature.
  71
  72  * Introduce and apply coccinelle rule to discourage an explicit
  73    comparison between a pointer and NULL, and applies the clean-up to
  74    the maintenance track.
  75
  76  * Preliminary code refactoring around transport and bundle code.
  77
  78  * "sparse-checkout" learns to work better with the sparse-index
  79    feature.
  80
  81  * A workflow change for translators are being proposed.  git.pot is
  82    no longer version controlled and it is local responsibility of
  83    translaters to generate it.
  84
  85  * Plug the memory leaks from the trickiest API of all, the revision
  86    walker.
  87
  88  * Rename .env_array member to .env in the child_process structure.
  89
  90  * More fsmonitor--daemon.
  91
  92  * A new bug() and BUG_if_bug() API is introduced to make it easier to
  93    uniformly log "detect multiple bugs and abort in the end" pattern.
  94
  95
  96 Fixes since v2.36
  97 -----------------
  98
  99  * "git submodule update" without pathspec should silently skip an
 100    uninitialized submodule, but it started to become noisy by mistake.
 101    (merge 4f1ccef87c gc/submodule-update-part2 later to maint).
 102
 103  * "diff-tree --stdin" has been broken for about a year, but 2.36
 104    release broke it even worse by breaking running the command with
 105    <pathspec>, which in turn broke "gitk" and got noticed.  This has
 106    been corrected by aligning its behaviour to that of "log".
 107    (merge f8781bfda3 jc/diff-tree-stdin-fix later to maint).
 108
 109  * Regression fix for 2.36 where "git name-rev" started to sometimes
 110    reference strings after they are freed.
 111    (merge 45a14f578e rs/name-rev-fix-free-after-use later to maint).
 112
 113  * "git show <commit1> <commit2>... -- <pathspec>" lost the pathspec
 114    when showing the second and subsequent commits, which has been
 115    corrected.
 116    (merge 5cdb38458e jc/show-pathspec-fix later to maint).
 117
 118  * "git fast-export -- <pathspec>" lost the pathspec when showing the
 119    second and subsequent commits, which has been corrected.
 120    (merge d1c25272f5 rs/fast-export-pathspec-fix later to maint).
 121
 122  * "git format-patch <args> -- <pathspec>" lost the pathspec when
 123    showing the second and subsequent commits, which has been
 124    corrected.
 125    (merge 91f8f7e46f rs/format-patch-pathspec-fix later to maint).
 126
 127  * "git clone --origin X" leaked piece of memory that held value read
 128    from the clone.defaultRemoteName configuration variable, which has
 129    been plugged.
 130    (merge 6dfadc8981 jc/clone-remote-name-leak-fix later to maint).
 131
 132  * Get rid of a bogus and over-eager coccinelle rule.
 133    (merge 08bdd3a185 jc/cocci-xstrdup-or-null-fix later to maint).
 134
 135  * The path taken by "git multi-pack-index" command from the end user
 136    was compared with path internally prepared by the tool withut first
 137    normalizing, which lead to duplicated paths not being noticed,
 138    which has been corrected.
 139    (merge 11f9e8de3d ds/midx-normalize-pathname-before-comparison later to maint).
 140
 141  * Correct choices of C compilers used in various CI jobs.
 142    (merge 3506cae04f ab/cc-package-fixes later to maint).
 143
 144  * Various cleanups to "git p4".
 145    (merge 4ff0108d9e jh/p4-various-fixups later to maint).
 146
 147  * The progress meter of "git blame" was showing incorrect numbers
 148    when processing only parts of the file.
 149    (merge e5f5d7d42e ea/progress-partial-blame later to maint).
 150
 151  * "git rebase --keep-base <upstream> <branch-to-rebase>" computed the
 152    commit to rebase onto incorrectly, which has been corrected.
 153    (merge 9e5ebe9668 ah/rebase-keep-base-fix later to maint).
 154
 155  * Fix a leak of FILE * in an error codepath.
 156    (merge c0befa0c03 kt/commit-graph-plug-fp-leak-on-error later to maint).
 157
 158  * Avoid problems from interaction between malloc_check and address
 159    sanitizer.
 160    (merge 067109a5e7 pw/test-malloc-with-sanitize-address later to maint).
 161
 162  * The commit summary shown after making a commit is matched to what
 163    is given in "git status" not to use the break-rewrite heuristics.
 164    (merge 84792322ed rs/commit-summary-wo-break-rewrite later to maint).
 165
 166  * Update a few end-user facing messages around eol conversion.
 167    (merge c970d30c2c ah/convert-warning-message later to maint).
 168
 169  * Trace2 documentation updates.
 170    (merge a6c80c313c js/trace2-doc-fixes later to maint).
 171
 172  * Build procedure fixup.
 173    (merge 1fbfd96f50 mg/detect-compiler-in-c-locale later to maint).
 174
 175  * "git pull" without "--recurse-submodules=<arg>" made
 176    submodule.recurse take precedence over fetch.recurseSubmodules by
 177    mistake, which has been corrected.
 178    (merge 5819417365 gc/pull-recurse-submodules later to maint).
 179
 180  * "git bisect" was too silent before it is ready to start computing
 181    the actual bisection, which has been corrected.
 182    (merge f11046e6de cd/bisect-messages-from-pre-flight-states later to maint).
 183
 184  * macOS CI jobs have been occasionally flaky due to tentative version
 185    skew between perforce and the homebrew packager.  Instead of
 186    failing the whole CI job, just let it skip the p4 tests when this
 187    happens.
 188    (merge f15e00b463 cb/ci-make-p4-optional later to maint).
 189
 190  * A bit of test framework fixes with a few fixes to issues found by
 191    valgrind.
 192    (merge 7c898554d7 ab/valgrind-fixes later to maint).
 193
 194  * "git archive --add-file=<path>" picked up the raw permission bits
 195    from the path and propagated to zip output in some cases, without
 196    normalization, which has been corrected (tar output did not have
 197    this issue).
 198    (merge 6a61661967 jc/archive-add-file-normalize-mode later to maint).
 199
 200  * "make coverage-report" without first running "make coverage" did
 201    not produce any meaningful result, which has been corrected.
 202    (merge 96ddfecc5b ep/coverage-report-wants-test-to-have-run later to maint).
 203
 204  * The "--current" option of "git show-branch" should have been made
 205    incompatible with the "--reflog" mode, but this was not enforced,
 206    which has been corrected.
 207    (merge 41c64ae0e7 jc/show-branch-g-current later to maint).
 208
 209  * "git fetch" unnecessarily failed when an unexpected optional
 210    section appeared in the output, which has been corrected.
 211    (merge 7709acf7be jt/fetch-peek-optional-section later to maint).
 212
 213  * The way "git fetch" without "--update-head-ok" ensures that HEAD in
 214    no worktree points at any ref being updated was too wasteful, which
 215    has been optimized a bit.
 216    (merge f7400da800 os/fetch-check-not-current-branch later to maint).
 217
 218  * "git fetch --recurse-submodules" from multiple remotes (either from
 219    a remote group, or "--all") used to make one extra "git fetch" in
 220    the submodules, which has been corrected.
 221    (merge 0353c68818 jc/avoid-redundant-submodule-fetch later to maint).
 222
 223  * With a recent update to refuse access to repositories of other
 224    people by default, "sudo make install" and "sudo git describe"
 225    stopped working.  This series intends to loosen it while keeping
 226    the safety.
 227    (merge b9063afda1 cb/path-owner-check-with-sudo later to maint).
 228
 229  * The tests that ensured merges stop when interfering local changes
 230    are present did not make sure that local changes are preserved; now
 231    they do.
 232    (merge 4b317450ce jc/t6424-failing-merge-preserve-local-changes later to maint).
 233
 234  * Some real problems noticed by gcc 12 have been fixed, while false
 235    positives have been worked around.
 236
 237  * Update the version of FreeBSD image used in Cirrus CI.
 238    (merge c58bebd4c6 pb/use-freebsd-12.3-in-cirrus-ci later to maint).
 239
 240  * The multi-pack-index code did not protect the packfile it is going
 241    to depend on from getting removed while in use, which has been
 242    corrected.
 243    (merge 4090511e40 tb/midx-race-in-pack-objects later to maint).
 244
 245  * Teach "git repack --geometric" work better with "--keep-pack" and
 246    avoid corrupting the repository when packsize limit is used.
 247    (merge 66731ff921 tb/geom-repack-with-keep-and-max later to maint).
 248
 249  * The documentation on the interaction between "--add-file" and
 250    "--prefix" options of "git archive" has been improved.
 251    (merge a75910602a rs/document-archive-prefix later to maint).
 252
 253  * A git subcommand like "git add -p" spawns a separate git process
 254    while relaying its command line arguments.  A pathspec with only
 255    negative elements was mistakenly passed with an empty string, which
 256    has been corrected.
 257    (merge b02fdbc80a jc/all-negative-pathspec later to maint).
 258
 259  * With a more targetted workaround in http.c in another topic, we may
 260    be able to lift this blanket "GCC12 dangling-pointer warning is
 261    broken and unsalvageable" workaround.
 262    (merge 419141e495 cb/buggy-gcc-12-workaround later to maint).
 263
 264  * A misconfigured 'branch..remote' led to a bug in configuration
 265    parsing.
 266    (merge f1dfbd9ee0 gc/zero-length-branch-config-fix later to maint).
 267
 268  * "git -c diff.submodule=log range-diff" did not show anything for
 269    submodules that changed in the ranges being compared, and
 270    "git -c diff.submodule=diff range-diff" did not work correctly.
 271    Fix this by including the "--submodule=short" output
 272    unconditionally to be compared.
 273
 274  * In Git 2.36 we revamped the way how hooks are invoked.  One change
 275    that is end-user visible is that the output of a hook is no longer
 276    directly connected to the standard output of "git" that spawns the
 277    hook, which was noticed post release.  This is getting corrected.
 278    (merge a082345372 ab/hooks-regression-fix later to maint).
 279
 280  * Updating the graft information invalidates the list of parents of
 281    in-core commit objects that used to be in the graft file.
 282
 283  * "git show-ref --heads" (and "--tags") still iterated over all the
 284    refs only to discard refs outside the specified area, which has
 285    been corrected.
 286    (merge c0c9d35e27 tb/show-ref-optim later to maint).
 287
 288  * Remove redundant copying (with index v3 and older) or possible
 289    over-reading beyond end of mmapped memory (with index v4) has been
 290    corrected.
 291    (merge 6d858341d2 zh/read-cache-copy-name-entry-fix later to maint).
 292
 293  * Sample watchman interface hook sometimes failed to produce
 294    correctly formatted JSON message, which has been corrected.
 295    (merge 134047b500 sn/fsmonitor-missing-clock later to maint).
 296
 297  * Use-after-free (with another forget-to-free) fix.
 298    (merge 323822c72b ab/remote-free-fix later to maint).
 299
 300  * Other code cleanup, docfix, build fix, etc.
 301    (merge e6b2582da3 cm/reftable-0-length-memset later to maint).
 302    (merge 0b75e5bf22 ab/misc-cleanup later to maint).
 303    (merge 52e1ab8a76 ea/rebase-code-simplify later to maint).
 304    (merge 756d15923b sg/safe-directory-tests-and-docs later to maint).
 305    (merge d097a23bfa ds/do-not-call-bug-on-bad-refs later to maint).
 306    (merge c36c27e75c rs/t7812-pcre2-ws-bug-test later to maint).
 307    (merge 1da312742d gf/unused-includes later to maint).
 308    (merge 465b30a92d pb/submodule-recurse-mode-enum later to maint).
 309    (merge 82b28c4ed8 km/t3501-use-test-helpers later to maint).
 310    (merge 72315e431b sa/t1011-use-helpers later to maint).
 311    (merge 95b3002201 cg/vscode-with-gdb later to maint).
 312    (merge fbe5f6b804 tk/p4-utf8-bom later to maint).
 313    (merge 17f273ffba tk/p4-with-explicity-sync later to maint).
 314    (merge 944db25c60 kf/p4-multiple-remotes later to maint).
 315    (merge b014cee8de jc/update-ozlabs-url later to maint).
 316    (merge 4ec5008062 pb/ggg-in-mfc-doc later to maint).
 317    (merge af845a604d tb/receive-pack-code-cleanup later to maint).
 318    (merge 2acf4cf001 js/ci-gcc-12-fixes later to maint).
 319    (merge 05e280c0a6 jc/http-clear-finished-pointer later to maint).
 320    (merge 8c49d704ef fh/transport-push-leakfix later to maint).
 321    (merge 1d232d38bd tl/ls-tree-oid-only later to maint).
 322    (merge db7961e6a6 gc/document-config-worktree-scope later to maint).