| blob | 836fcb54333970d3837b27299ca1232816762532 |
1 Git v2.43 Release Notes
2 =======================
4 Backward Compatibility Notes
6 * The "--rfc" option of "git format-patch" used to be a valid way to
7 override an earlier "--subject-prefix=<something>" on the command
8 line and replace it with "[RFC PATCH]", but from this release, it
9 merely prefixes the string "RFC " in front of the given subject
10 prefix. If you are negatively affected by this change, please use
11 "--subject-prefix=PATCH --rfc" as a replacement.
13 * "git rev-list --stdin" learned to take non-revisions (like "--not")
14 recently from the standard input, but the way such a "--not" was
15 handled was quite confusing, which has been rethought. The updated
16 rule is that "--not" given from the command line only affects revs
17 given from the command line that comes but not revs read from the
18 standard input, and "--not" read from the standard input affects
19 revs given from the standard input and not revs given from the
20 command line.
22 UI, Workflows & Features
24 * A message written in olden time prevented a branch from getting
25 checked out saying it is already checked out elsewhere, but these
26 days, we treat a branch that is being bisected or rebased just like
27 a branch that is checked out and protect it. Rephrase the message
28 to say that the branch is in use.
30 * Hourly and other schedule of "git maintenance" jobs are randomly
31 distributed now.
33 * "git cmd -h" learned to signal which options can be negated by
34 listing such options like "--[no-]opt".
36 * The way authentication related data other than passwords (e.g.
37 oath token and password expiration data) are stored in libsecret
38 keyrings has been rethought.
40 * Update the libsecret and wincred credential helpers to correctly
41 match which credential to erase; they erased the wrong entry in
42 some cases.
44 * Git GUI updates.
46 * "git format-patch" learns a way to feed cover letter description,
47 that (1) can be used on detached HEAD where there is no branch
48 description available, and (2) also can override the branch
49 description if there is one.
51 * Use of --max-pack-size to allow multiple packfiles to be created is
52 now supported even when we are sending unreachable objects to cruft
53 packs.
55 * "git format-patch --rfc --subject-prefix=<foo>" used to ignore the
56 "--subject-prefix" option and used "[RFC PATCH]"; now we will add
57 "RFC" prefix to whatever subject prefix is specified.
59 * "git log --format" has been taught the %(decorate) placeholder.
61 * The default log message created by "git revert", when reverting a
62 commit that records a revert, has been tweaked, to encourage people
63 describe complex "revert of revert of revert" situation better in
64 their own words.
66 * The command-line completion support (in contrib/) learned to
67 complete "git commit --trailer=" for possible trailer keys.
69 * "git update-index" learns "--show-index-version" to inspect
70 the index format version used by the on-disk index file.
72 * "git diff" learned diff.statNameWidth configuration variable, to
73 give the default width for the name part in the "--stat" output.
75 * "git range-diff --notes=foo" compared "log --notes=foo --notes" of
76 the two ranges, instead of using just the specified notes tree.
78 * The command line completion script (in contrib/) can be told to
79 complete aliases by including ": git <cmd> ;" in the alias to tell
80 it that the alias should be completed similar to how "git <cmd>" is
81 completed. The parsing code for the alias as been loosened to
82 allow ';' without an extra space before it.
84 * "git for-each-ref" and friends learned to apply mailmap to
85 authorname and other fields.
87 * "git repack" machinery learns to pay attention to the "--filter="
88 option.
90 * "git repack" learned "--max-cruft-size" to prevent cruft packs from
91 growing without bounds.
93 * "git merge-tree" learned to take strategy backend specific options
94 via the "-X" option, like "git merge" does.
96 * "git log" and friends learned "--dd" that is a short-hand for
97 "--diff-merges=first-parent -p".
99 * The attribute subsystem learned to honor `attr.tree` configuration
100 that specifies which tree to read the .gitattributes files from.
103 Performance, Internal Implementation, Development Support etc.
105 * "git check-attr" has been taught to work better with sparse-index.
107 * It may be tempting to leave the help text NULL for a command line
108 option that is either hidden or too obvious, but "git subcmd -h"
109 and "git subcmd --help-all" would have segfaulted if done so. Now
110 the help text is optional.
112 * Tests that are known to pass with LSan are now marked as such.
114 * Flaky "git p4" tests, as well as "git svn" tests, are now skipped
115 in the (rather expensive) sanitizer CI job.
117 * Tests with LSan from time to time seem to emit harmless message
118 that makes our tests unnecessarily flaky; we work it around by
119 filtering the uninteresting output.
121 * Unused parameters to functions are marked as such, and/or removed,
122 in order to bring us closer to -Wunused-parameter clean.
124 * The code to keep track of existing packs in the repository while
125 repacking has been refactored.
127 * The "streaming" interface used for bulk-checkin codepath has been
128 narrowed to take only blob objects for now, with no real loss of
129 functionality.
131 * GitHub CI workflow has learned to trigger Coverity check.
133 * Test coverage for trailers has been improved.
135 * The code to iterate over loose references have been optimized to
136 reduce the number of lstat() system calls.
137 (merge 2cdb796101 vd/loose-ref-iteration-optimization later to maint).
139 * The codepaths that read "chunk" formatted files have been corrected
140 to pay attention to the chunk size and notice broken files.
143 Fixes since v2.42
144 -----------------
146 * Overly long label names used in the sequencer machinery are now
147 chopped to fit under filesystem limitation.
149 * Scalar updates.
151 * Tweak GitHub Actions CI so that pushing the same commit to multiple
152 branch tips at the same time will not waste building and testing
153 the same thing twice.
155 * The commit-graph verification code that detects mixture of zero and
156 non-zero generation numbers has been updated.
158 * "git diff -w --exit-code" with various options did not work
159 correctly, which is being addressed.
161 * transfer.unpackLimit ought to be used as a fallback, but overrode
162 fetch.unpackLimit and receive.unpackLimit instead.
164 * The use of API between two calls to require_clean_work_tree() from
165 the sequencer code has been cleaned up for consistency.
167 * "git diff --no-such-option" and other corner cases around the exit
168 status of the "diff" command has been corrected.
170 * "git for-each-ref --sort='contents:size'" sorts the refs according
171 to size numerically, giving a ref that points at a blob twelve-byte
172 (12) long before showing a blob hundred-byte (100) long.
174 * We now limit depth of the tree objects and maximum length of
175 pathnames recorded in tree objects.
176 (merge 4d5693ba05 jk/tree-name-and-depth-limit later to maint).
178 * Various fixes to the behavior of "rebase -i" when the command got
179 interrupted by conflicting changes.
181 * References from description of the `--patch` option in various
182 manual pages have been simplified and improved.
184 * "git grep -e A --no-or -e B" is accepted, even though the negation
185 of "or" did not mean anything, which has been tightened.
187 * The completion script (in contrib/) has been taught to treat the
188 "-t" option to "git checkout" and "git switch" just like the
189 "--track" option, to complete remote-tracking branches.
191 * "git diff --no-index -R <(one) <(two)" did not work correctly,
192 which has been corrected.
194 * Update "git maintenance" timers' implementation based on systemd
195 timers to work with WSL.
197 * "git diff --cached" codepath did not fill the necessary stat
198 information for a file when fsmonitor knows it is clean and ended
199 up behaving as if it is not clean, which has been corrected.
201 * Clarify how "alias.foo = : git cmd ; aliased-command-string" should
202 be spelled with necessary whitespaces around punctuation marks to
203 work.
205 * HTTP Header redaction code has been adjusted for a newer version of
206 cURL library that shows its traces differently from earlier
207 versions.
209 * An error message given by "git send-email" when given a malformed
210 address did not give correct information, which has been corrected.
212 * UBSan options were not propagated through the test framework to git
213 run via the httpd, unlike ASan options, which has been corrected.
215 * "checkout --merge -- path" and "update-index --unresolve path" did
216 not resurrect conflicted state that was resolved to remove path,
217 but now they do.
218 (merge 5bdedac3c7 jc/unresolve-removal later to maint).
220 * The display width table for unicode characters has been updated for
221 Unicode 15.1
222 (merge 872976c37e bb/unicode-width-table-15 later to maint).
224 * Update mailmap entry for Derrick.
225 (merge 6e5457d8c7 ds/mailmap-entry-update later to maint).
227 * In .gitmodules files, submodules are keyed by their names, and the
228 path to the submodule whose name is $name is specified by the
229 submodule.$name.path variable. There were a few codepaths that
230 mixed the name and path up when consulting the submodule database,
231 which have been corrected. It took long for these bugs to be found
232 as the name of a submodule initially is the same as its path, and
233 the problem does not surface until it is moved to a different path,
234 which apparently happens very rarely.
236 * "git diff --merge-base X other args..." insisted that X must be a
237 commit and errored out when given an annotated tag that peels to a
238 commit, but we only need it to be a committish. This has been
239 corrected.
240 (merge 4adceb5a29 ar/diff-index-merge-base-fix later to maint).
242 * Fix "git merge-tree" to stop segfaulting when the --attr-source
243 option is used.
244 (merge e95bafc52f jc/merge-ort-attr-index-fix later to maint).
246 * Unlike "git log --pretty=%D", "git log --pretty="%(decorate)" did
247 not auto-initialize the decoration subsystem, which has been
248 corrected.
250 * Feeding "git stash store" with a random commit that was not created
251 by "git stash create" now errors out.
252 (merge d9b6634589 jc/fail-stash-to-store-non-stash later to maint).
254 * The index file has room only for lower 32-bit of the file size in
255 the cached stat information, which means cached stat information
256 will have 0 in its sd_size member for a file whose size is multiple
257 of 4GiB. This is mistaken for a racily clean path. Avoid it by
258 storing a bogus sd_size value instead for such files.
259 (merge 5143ac07b1 bc/racy-4gb-files later to maint).
261 * "git p4" tried to store symlinks to LFS when told, but has been
262 fixed not to do so, because it does not make sense.
263 (merge 10c89a02b0 mm/p4-symlink-with-lfs later to maint).
265 * The codepath to handle recipient addresses `git send-email
266 --compose` learns from the user was completely broken, which has
267 been corrected.
268 (merge 3ec6167567 jk/send-email-fix-addresses-from-composed-messages later to maint).
270 * "cd sub && git grep -f patterns" tried to read "patterns" file at
271 the top level of the working tree; it has been corrected to read
272 "sub/patterns" instead.
275 * "git reflog expire --single-worktree" has been broken for the past
276 20 months or so, which has been corrected.
278 * "git send-email" did not have certain pieces of data computed yet
279 when it tried to validate the outging messages and its recipient
280 addresses, which has been sorted out.
282 * "git bugreport" learned to complain when it received a command line
283 argument that it will not use.
285 * Other code cleanup, docfix, build fix, etc.
286 (merge c2c349a15c xz/commit-title-soft-limit-doc later to maint).