Merge branch 'bc/gc-crontab-fix'
[alt-git.git] / Documentation / RelNotes / 2.38.0.txt
blob71e1731ddbb90f3afb01bdc5490b61c71bd2e4d8
1 Git v2.38 Release Notes
2 =======================
4 UI, Workflows & Features
6  * "git remote show [-n] frotz" now pays attention to negative
7    pathspec.
9  * "git push" sometimes perform poorly when reachability bitmaps are
10    used, even in a repository where other operations are helped by
11    bitmaps.  The push.useBitmaps configuration variable is introduced
12    to allow disabling use of reachability bitmaps only for "git push".
14  * "git grep -m<max-hits>" is a way to limit the hits shown per file.
16  * "git merge-tree" learned a new mode where it takes two commits and
17    computes a tree that would result in the merge commit, if the
18    histories leading to these two commits were to be merged.
20  * "git mv A B" in a sparsely populated working tree can be asked to
21    move a path between directories that are "in cone" (i.e. expected
22    to be materialized in the working tree) and "out of cone"
23    (i.e. expected to be hidden).  The handling of such cases has been
24    improved.
26  * Earlier, HTTP transport clients learned to tell the server side
27    what locale they are in by sending Accept-Language HTTP header, but
28    this was done only for some requests but not others.
30  * Introduce a discovery.barerepository configuration variable that
31    allows users to forbid discovery of bare repositories.
33  * Various messages that come from the pack-bitmap codepaths have been
34    tweaked.
36  * "git rebase -i" learns to update branches whose tip appear in the
37    rebased range with "--update-refs" option.
39  * "git ls-files" learns the "--format" option to tweak its output.
41  * "git cat-file" learned an option to use the mailmap when showing
42    commit and tag objects.
44  * When "git merge" finds that it cannot perform a merge, it should
45    restore the working tree to the state before the command was
46    initiated, but in some corner cases it didn't.
48  * Operating modes like "--batch" of "git cat-file" command learned to
49    take NUL-terminated input, instead of one-item-per-line.
51  * "git rm" has become more aware of the sparse-index feature.
53  * "git rev-list --disk-usage" learned to take an optional value
54    "human" to show the reported value in human-readable format, like
55    "3.40MiB".
57  * The "diagnose" feature to create a zip archive for diagnostic
58    material has been lifted from "scalar" and made into a feature of
59    "git bugreport".
61  * The namespaces used by "log --decorate" from "refs/" hierarchy by
62    default has been tightened.
64  * "git rev-list --ancestry-path=C A..B" is a natural extension of
65    "git rev-list A..B"; instead of choosing a subset of A..B to those
66    that have ancestry relationship with A, it lets a subset with
67    ancestry relationship with C.
69  * "scalar" now enables built-in fsmonitor on enlisted repositories,
70    when able.
72  * The bash prompt (in contrib/) learned to optionally indicate when
73    the index is unmerged.
75  * "git clone" command learned the "--bundle-uri" option to coordinate
76    with hosting sites the use of pre-prepared bundle files.
79 Performance, Internal Implementation, Development Support etc.
81  * Collection of what is referenced by objects in promisor packs have
82    been optimized to inspect these objects in the in-pack order.
84  * Introduce a helper to see if a branch is already being worked on
85    (hence should not be newly checked out in a working tree), which
86    performs much better than the existing find_shared_symref() to
87    replace many uses of the latter.
89  * Teach "git archive" to (optionally and then by default) avoid
90    spawning an external "gzip" process when creating ".tar.gz" (and
91    ".tgz") archives.
93  * Allow large objects read from a packstream to be streamed into a
94    loose object file straight, without having to keep it in-core as a
95    whole.
97  * Further preparation to turn git-submodule.sh into a builtin
98    continues.
100  * Apply Coccinelle rule to turn raw memmove() into MOVE_ARRAY() cpp
101    macro, which would improve maintainability and readability.
103  * Teach "make all" to build gitweb as well.
105  * Tweak tests so that they still work when the "git init" template
106    did not create .git/info directory.
108  * Add Coccinelle rules to detect the pattern of initializing and then
109    finalizing a structure without using it in between at all, which
110    happens after code restructuring and the compilers fail to
111    recognize as an unused variable.
113  * The code to convert between GPG trust level strings and internal
114    constants we use to represent them have been cleaned up.
116  * Support for libnettle as SHA256 implementation has been added.
118  * The way "git multi-pack" uses parse-options API has been improved.
120  * A coccinelle rule (in contrib/) to encourage use of COPY_ARRAY
121    macro has been improved.
123  * API tweak to make it easier to run fuzz testing on commit-graph parser.
125  * Omit fsync-related trace2 entries when their values are all zero.
127  * The codepath to write multi-pack index has been taught to release a
128    large chunk of memory that holds an array of objects in the packs,
129    as soon as it is done with the array, to reduce memory consumption.
131  * Add a level of redirection to array allocation API in xdiff part,
132    to make it easier to share with the libgit2 project.
134  * "git fetch" client logs the partial clone filter used in the trace2
135    output.
137  * The "bundle URI" design gets documented.
139  * The common ancestor negotiation exchange during a "git fetch"
140    session now leaves trace log.
142  * Test portability improvements.
143    (merge 4d1d843be7 mt/rot13-in-c later to maint).
145  * The "subcommand" mode is introduced to parse-options API and update
146    the command line parser of Git commands with subcommands.
149 Fixes since v2.37
150 -----------------
152  * Rewrite of "git add -i" in C that appeared in Git 2.25 didn't
153    correctly record a removed file to the index, which was fixed.
155  * Certain diff options are currently ignored when combined-diff is
156    shown; mark them as incompatible with the feature.
158  * Adjust technical/bitmap-format to be formatted by AsciiDoc, and
159    add some missing information to the documentation.
161  * Fixes for tests when the source directory has unusual characters in
162    its path, e.g. whitespaces, double-quotes, etc.
164  * "git mktree --missing" lazily fetched objects that are missing from
165    the local object store, which was totally unnecessary for the purpose
166    of creating the tree object(s) from its input.
168  * Give _() markings to fatal/warning/usage: labels that are shown in
169    front of these messages.
171  * References to commands-to-be-typed-literally in "git rebase"
172    documentation mark-up have been corrected.
174  * In a non-bare repository, the behavior of Git when the
175    core.worktree configuration variable points at a directory that has
176    a repository as its subdirectory, regressed in Git 2.27 days.
178  * Recent update to vimdiff layout code has been made more robust
179    against different end-user vim settings.
181  * Plug various memory leaks, both in the main code and in test-tool
182    commands.
184  * Fixes a long-standing corner case bug around directory renames in
185    the merge-ort strategy.
187  * The resolve-undo information in the index was not protected against
188    GC, which has been corrected.
190  * A corner case bug where lazily fetching objects from a promisor
191    remote resulted in infinite recursion has been corrected.
193  * "git clone" from a repository with some ref whose HEAD is unborn
194    did not set the HEAD in the resulting repository correctly, which
195    has been corrected.
197  * An earlier attempt to plug leaks placed a clean-up label to jump to
198    at a bogus place, which as been corrected.
200  * Variable quoting fix in the vimdiff driver of "git mergetool"
202  * "git shortlog -n" relied on the underlying qsort() to be stable,
203    which shouldn't have.  Fixed.
205  * A fix for a regression in test framework.
207  * mkstemp() emulation on Windows has been improved.
209  * Add missing documentation for "include" and "includeIf" features in
210    "git config" file format, which incidentally teaches the command
211    line completion to include them in its offerings.
213  * Avoid "white/black-list" in documentation and code comments.
215  * Workaround for a compiler warning against use of die() in
216    osx-keychain (in contrib/).
218  * Workaround for a false positive compiler warning.
220  * "git p4" working on UTF-16 files on Windows did not implement
221    CRLF-to-LF conversion correctly, which has been corrected.
223  * "git p4" did not handle non-ASCII client name well, which has been
224    corrected.
226  * "rerere-train" script (in contrib/) used to honor commit.gpgSign
227    while recreating the throw-away merges.
229  * "git checkout" miscounted the paths it updated, which has been
230    corrected.
232  * Fix for a bug that makes write-tree to fail to write out a
233    non-existent index as a tree, introduced in 2.37.
235  * There was a bug in the codepath to upgrade generation information
236    in commit-graph from v1 to v2 format, which has been corrected.
238  * Gitweb had legacy URL shortener that is specific to the way
239    projects hosted on kernel.org used to (but no longer) work, which
240    has been removed.
242  * Fix build procedure for Windows that uses CMake so that it can pick
243    up the shell interpreter from local installation location.
245  * Conditionally allow building Python interpreter on Windows
247  * Fix to lstat() emulation on Windows.
249  * Older gcc with -Wall complains about the universal zero initializer
250    "struct s = { 0 };" idiom, which makes developers' lives
251    inconvenient (as -Werror is enabled by DEVELOPER=YesPlease).  The
252    build procedure has been tweaked to help these compilers.
254  * Plug memory leaks in the failure code path in the "merge-ort" merge
255    strategy backend.
257  * "git symbolic-ref symref non..sen..se" is now diagnosed as an error.
259  * A follow-up fix to a fix for a regression in 2.36 around hooks.
261  * Avoid repeatedly running getconf to ask libc version in the test
262    suite, and instead just as it once per script.
264  * Platform-specific code that determines if a directory is OK to use
265    as a repository has been taught to report more details, especially
266    on Windows.
268  * "vimdiff3" regression fix.
270  * "git fsck" reads mode from tree objects but canonicalizes the mode
271    before passing it to the logic to check object sanity, which has
272    hid broken tree objects from the checking logic.  This has been
273    corrected, but to help exiting projects with broken tree objects
274    that they cannot fix retroactively, the severity of anomalies this
275    code detects has been demoted to "info" for now.
277  * Fixes to sparse index compatibility work for "reset" and "checkout"
278    commands.
280  * An earlier optimization discarded a tree-object buffer that is
281    still in use, which has been corrected.
282    (merge 1490d7d82d jk/is-promisor-object-keep-tree-in-use later to maint).
284  * Fix deadlocks between main Git process and subprocess spawned via
285    the pipe_command() API, that can kill "git add -p" that was
286    reimplemented in C recently.
287    (merge 716c1f649e jk/pipe-command-nonblock later to maint).
289  * The sequencer machinery translated messages left in the reflog by
290    mistake, which has been corrected.
292  * xcalloc(), imitating calloc(), takes "number of elements of the
293    array", and "size of a single element", in this order.  A call that
294    does not follow this ordering has been corrected.
295    (merge c4bbd9bb8f sg/xcalloc-cocci-fix later to maint).
297  * The preload-index codepath made copies of pathspec to give to
298    multiple threads, which were left leaked.
299    (merge 23578904da ad/preload-plug-memleak later to maint).
301  * Update the version of Ubuntu used for GitHub Actions CI from 18.04
302    to 22.04.
303    (merge ef46584831 ds/github-actions-use-newer-ubuntu later to maint).
305  * The auto-stashed local changes created by "git merge --autostash"
306    was mixed into a conflicted state left in the working tree, which
307    has been corrected.
308    (merge d3a9295ada en/merge-unstash-only-on-clean-merge later to maint).
310  * Other code cleanup, docfix, build fix, etc.
311    (merge 77b9e85c0f vd/fix-perf-tests later to maint).