Merge branch 'ab/sha-makefile-doc'
[git/gitster.git] / Documentation / RelNotes / 2.39.0.txt
blobf9bc29f7d29cf96aaece6936d8398e2544cb6a45
1 Git v2.39 Release Notes
2 =======================
4 UI, Workflows & Features
5 ------------------------
7  * "git grep" learned to expand the sparse-index more lazily and on
8    demand in a sparse checkout.
10  * By default, use of fsmonitor on a repository on networked
11    filesystem is disabled. Add knobs to make it workable on macOS.
13  * After checking out a "branch" that is a symbolic-ref that points at
14    another branch, "git symbolic-ref HEAD" reports the underlying
15    branch, not the symbolic-ref the user gave checkout as argument.
16    The command learned the "--no-recurse" option to stop after
17    dereferencing a symbolic-ref only once.
19  * "git branch --edit-description @{-1}" is now a way to edit branch
20    description of the branch you were on before switching to the
21    current branch.
23  * "git merge-tree --stdin" is a new way to request a series of merges
24    and report the merge results.
26  * "git shortlog" learned to group by the "format" string.
28  * A new "--include-whitespace" option is added to "git patch-id", and
29    existing bugs in the internal patch-id logic that did not match
30    what "git patch-id" produces have been corrected.
32  * Enable gc.cruftpacks by default for those who opt into
33    feature.experimental setting.
35 Performance, Internal Implementation, Development Support etc.
36 --------------------------------------------------------------
38  * With a bit of header twiddling, use the native regexp library on
39    macOS instead of the compat/ one.
41  * Prepare for GNU [ef]grep that throw warning of their uses.
43  * Sources related to fuzz testing have been moved down to their own
44    directory.
46  * Most credential helpers ignored unknown entries in a credential
47    description, but a few died upon seeing them.  The latter were
48    taught to ignore them, too
50  * "scalar unregister" in a repository that is already been
51    unregistered reported an error.
53  * Remove error detection from a function that fetches from promisor
54    remotes, and make it die when such a fetch fails to bring all the
55    requested objects, to give an early failure to various operations.
57  * Update CodingGuidelines to clarify what features to use and avoid
58    in C99.
60  * Avoid false-positive from LSan whose assumption may be broken with
61    higher optimization levels.
63  * Enable address and undefined sanitizer tasks at GitHub Actions CI.
65  * More UNUSED annotation to help using -Wunused option with the
66    compiler.
67    (merge 4b992f0a24 jk/unused-anno-more later to maint).
69  * Rewrite a deep recursion in the skipping negotiator to use a loop
70    with on-heap prio queue to avoid stack wastage.
72  * Add documentation for message IDs in fsck error messages.
74  * Define the logical elements of a "bundle list", data structure to
75    store them in-core, format to transfer them, and code to parse
76    them.
78  * The role the security mailing list plays in an embargoed release
79    has been documented.
81  * Two new facilities, "timer" and "counter", are introduced to the
82    trace2 API.
84  * Code simplification by using strvec_pushf() instead of building an
85    argument in a separate strbuf.
87  * Make sure generated dependency file is stably sorted to help
88    developers debugging their build issues.
90  * The glossary entries for "commit-graph file" and "reachability
91    bitmap" have been added.
93  * Various tests exercising the transfer.credentialsInUrl
94    configuration are taught to avoid making requests which require
95    resolving localhost to reduce CI-flakiness.
97  * A redundant diagnostic message is dropped from test_path_is_missing().
99  * Simplify the run-command API.
101  * Update the actions/github-script dependency in CI to avoid a
102    deprecation warning.
104  * Progress on being able to initialize a rev_info struct with a
105    macro.
107  * Add trace2 counters to the region to clear skip worktree bits in a
108    sparse checkout.
110  * Modernize test script to avoid "test -f" and friends.
112 Fixes since v2.38
113 -----------------
115  * The codepath that reads from the index v4 had unaligned memory
116    accesses, which has been corrected.
118  * Fix messages incorrectly marked for translation.
120  * "git fsck" failed to release contents of tree objects already used
121    from the memory, which has been fixed.
123  * "git clone" did not like to see the "--bare" and the "--origin"
124    options used together without a good reason.
126  * "git remote rename" failed to rename a remote without fetch
127    refspec, which has been corrected.
129  * Documentation on various Boolean GIT_* environment variables have
130    been clarified.
132  * "git rebase -i" can mistakenly attempt to apply a fixup to a commit
133    itself, which has been corrected.
135  * "git multi-pack-index repack/expire" used to repack unreachable
136    cruft into a new pack, which have been corrected.
138  * In read-only repositories, "git merge-tree" tried to come up with a
139    merge result tree object, which it failed (which is not wrong) and
140    led to a segfault (which is bad), which has been corrected.
142  * Force C locale while running tests around httpd to make sure we can
143    find expected error messages in the log.
145  * Fix a logic in "mailinfo -b" that miscomputed the length of a
146    substring, which lead to an out-of-bounds access.
148  * The codepath to sign learned to report errors when it fails to read
149    from "ssh-keygen".
151  * Code clean-up that results in plugging a leak.
153  * "GIT_EDITOR=: git branch --edit-description" resulted in failure,
154    which has been corrected.
156  * The code to clean temporary object directories (used for
157    quarantine) tried to remove them inside its signal handler, which
158    was a no-no.
160  * Update comment in the Makefile about the RUNTIME_PREFIX config knob.
162  * Clarify that "the sentence after <area>: prefix does not begin with
163    a capital letter" rule applies only to the commit title.
165  * "git branch --edit-description" on an unborh branch misleadingly
166    said that no such branch exists, which has been corrected.
168  * Work around older clang that warns against C99 zero initialization
169    syntax for struct.
171  * Giving "--invert-grep" and "--all-match" without "--grep" to the
172    "git log" command resulted in an attempt to access grep pattern
173    expression structure that has not been allocated, which has been
174    corrected.
175    (merge db84376f98 ab/grep-simplify-extended-expression later to maint).
177  * "git diff rev^!" did not show combined diff to go to the rev from
178    its parents.
179    (merge a79c6b6081 rs/diff-caret-bang-with-parents later to maint).
181  * Allow configuration files in "protected" scopes to include other
182    configuration files.
183    (merge ecec57b3c9 gc/bare-repo-discovery later to maint).
185  * Give a bit more diversity to macOS CI by using sha1dc in one of the
186    jobs (the other one tests Apple Common Crypto).
187    (merge 1ad5c3df35 jc/ci-osx-with-sha1dc later to maint).
189  * A bugfix with tracing support in midx codepath
190    (merge e9c3839944 tb/midx-bitmap-selection-fix later to maint).
192  * When geometric repacking feature is in use together with the
193    --pack-kept-objects option, we lost packs marked with .keep files.
194    (merge 197443e80a tb/save-keep-pack-during-geometric-repack later to maint).
196  * Move a global variable added as a hack during regression fixes to
197    its proper place in the API.
198    (merge 0b0ab95f17 ab/run-hook-api-cleanup later to maint).
200  * Update to build procedure with VS using CMake/CTest.
201    (merge c858750b41 js/cmake-updates later to maint).
203  * The short-help text shown by "git cmd -h" and the synopsis text
204    shown at the beginning of "git help cmd" have been made more
205    consistent.
207  * When creating a multi-pack bitmap, remove per-pack bitmap files
208    unconditionally as they will never be consulted.
209    (merge 55d902cd61 tb/remove-unused-pack-bitmap later to maint).
211  * Fix a longstanding syntax error in Git.pm error codepath.
213  * "git diff --stat" etc. were invented back when everything was ASCII
214    and strlen() was a way to measure the display width of a string;
215    adjust them to compute the display width assuming UTF-8 pathnames.
216    (merge ce8529b2bb tb/diffstat-with-utf8-strwidth later to maint).
218  * "git branch --edit-description" can exit with status -1 which is
219    not a good practice; it learned to use 1 as everybody else instead.
221  * "git apply" limits its input to a bit less than 1 GiB.
223  * Merging a branch with directory renames into a branch that changes
224    the directory to a symlink was mishandled by the ort merge
225    strategy, which has been corrected.
227  * A bugfix to "git subtree" in its split and merge features.
229  * Fix some bugs in the reflog messages when rebasing and changes the
230    reflog messages of "rebase --apply" to match "rebase --merge" with
231    the aim of making the reflog easier to parse.
233  * "git rebase --keep-base" used to discard the commits that are
234    already cherry-picked to the upstream, even when "keep-base" meant
235    that the base, on top of which the history is being rebuilt, does
236    not yet include these cherry-picked commits.  The --keep-base
237    option now implies --reapply-cherry-picks and --no-fork-point
238    options.
240  * The way "git repack" creared temporary files when it received a
241    signal was prone to deadlocking, which has been corrected.
243  * Various tests exercising the transfer.credentialsInUrl
244    configuration are taught to avoid making requests which require
245    resolving localhost to reduce CI-flakiness.
247  * The adjust_shared_perm() helper function learned to refrain from
248    setting the "g+s" bit on directories when it is not necessary.
250  * "git archive" mistakenly complained twice about a missing
251    executable, which has been corrected.
253  * Other code cleanup, docfix, build fix, etc.
254    (merge 413bc6d20a ds/cmd-main-reorder later to maint).
255    (merge 8d2863e4ed nw/t1002-cleanup later to maint).