Merge branch 'pw/xdiff-classify-record-in-histogram'
[alt-git.git] / Documentation / RelNotes / 2.35.0.txt
blobb1d8145dd923cc9e35a6cd7da735cb1e67b8824e
1 Git 2.35 Release Notes
2 ======================
4 Updates since Git 2.34
5 ----------------------
7 Backward compatibility warts
9  * "_" is now treated as any other URL-valid characters in an URL when
10    matching the per-URL configuration variable names.
13 UI, Workflows & Features
15  * "git status --porcelain=v2" now show the number of stash entries
16    with --show-stash like the normal output does.
18  * "git stash" learned the "--staged" option to stash away what has
19    been added to the index (and nothing else).
21  * "git var GIT_DEFAULT_BRANCH" is a way to see what name is used for
22    the newly created branch if "git init" is run.
24  * Various operating modes of "git reset" have been made to work
25    better with the sparse index.
27  * "git submodule deinit" for a submodule whose .git metadata
28    directory is embedded in its working tree refused to work, until
29    the submodule gets converted to use the "absorbed" form where the
30    metadata directory is stored in superproject, and a gitfile at the
31    top-level of the working tree of the submodule points at it.  The
32    command is taught to convert such submodules to the absorbed form
33    as needed.
35  * The completion script (in contrib/) learns that the "--date"
36    option of commands from the "git log" family takes "human" and
37    "auto" as valid values.
39  * "Zealous diff3" style of merge conflict presentation has been added.
41  * The "git log --format=%(describe)" placeholder has been extended to
42    allow passing selected command-line options to the underlying "git
43    describe" command.
45  * "default" and "reset" have been added to our color palette.
48 Performance, Internal Implementation, Development Support etc.
50  * The use of errno as a means to carry the nature of error in the ref
51    API implementation has been reworked and reduced.
53  * Teach and encourage first-time contributors to this project to
54    state the base commit when they submit their topic.
56  * The command line complation for "git send-email" options have been
57    tweaked to make it easier to keep it in sync with the command itself.
60  * Ensure that the sparseness of the in-core index matches the
61    index.sparse configuration specified by the repository immediately
62    after the on-disk index file is read.
64  * Code clean-up to eventually allow information on remotes defined
65    for an arbitrary repository to be read.
67  * Build optimization.
69  * Tighten code for testing pack-bitmap.
71  * Weather balloon to break people with compilers that do not support
72    C99.
74  * The "reftable" backend for the refs API, without integrating into
75    the refs subsystem, has been added.
77  * More tests are marked as leak-free.
79  * The test framework learns to list unsatisfied test prerequisites,
80    and optionally error out when prerequisites that are expected to be
81    satisfied are not.
83  * The default setting for trace2 event nesting was too low to cause
84    test failures, which is worked around by bumping it up in the test
85    framework.
87  * Drop support for TravisCI and update test workflows at GitHub.
89  * Many tests that used to need GIT_TEST_DEFAULT_INITIAL_BRANCH_NAME
90    mechanism to force "git" to use 'master' as the default name for
91    the initial branch no longer need it; the use of the mechanism from
92    them have been removed.
94  * Allow running our tests while disabling fsync.
96  * Document the parameters given to the reflog entry iterator callback
97    functions.
98    (merge e6e94f34b2 jc/reflog-iterator-callback-doc later to maint).
100  * The test helper for refs subsystem learned to write bogus and/or
101    nonexistent object name to refs to simulate error situations we
102    want to test Git in.
105 Fixes since v2.34
106 -----------------
108  * "git grep" looking in a blob that has non-UTF8 payload was
109    completely broken when linked with certain versions of PCREv2
110    library in the latest release.
112  * Other code cleanup, docfix, build fix, etc.
114  * "git pull" with any strategy when the other side is behind us
115    should succeed as it is a no-op, but doesn't.
117  * An earlier change in 2.34.0 caused JGit application (that abused
118    GIT_EDITOR mechanism when invoking "git config") to get stuck with
119    a SIGTTOU signal; it has been reverted.
121  * An earlier change that broke .gitignore matching has been reverted.
123  * Things like "git -c branch.sort=bogus branch new HEAD", i.e. the
124    operation modes of the "git branch" command that do not need the
125    sort key information, no longer errors out by seeing a bogus sort
126    key.
127    (merge 98e7ab6d42 jc/fix-ref-sorting-parse later to maint).
129  * The compatibility implementation for unsetenv(3) were written to
130    mimic ancient, non-POSIX, variant seen in an old glibc; it has been
131    changed to return an integer to match the more modern era.
132    (merge a38989bd5b jc/unsetenv-returns-an-int later to maint).
134  * The clean/smudge conversion code path has been prepared to better
135    work on platforms where ulong is narrower than size_t.
136    (merge 596b5e77c9 mc/clean-smudge-with-llp64 later to maint).
138  * Redact the path part of packfile URI that appears in the trace output.
139    (merge 0ba558ffb1 if/redact-packfile-uri later to maint).
141  * CI has been taught to catch some Unicode directional formatting
142    sequence that can be used in certain mischief.
143    (merge 0e7696c64d js/ci-no-directional-formatting later to maint).
145  * The "--date=format:<strftime>" gained a workaround for the lack of
146    system support for a non-local timezone to handle "%s" placeholder.
147    (merge 9b591b9403 jk/strbuf-addftime-seconds-since-epoch later to maint).
149  * The "merge" subcommand of "git jump" (in contrib/) silently ignored
150    pathspec and other parameters.
151    (merge 67ba13e5a4 jk/jump-merge-with-pathspec later to maint).
153  * The code to decode the length of packed object size has been
154    corrected.
155    (merge 34de5b8eac jt/pack-header-lshift-overflow later to maint).
157  * The advice message given by "git pull" when the user hasn't made a
158    choice between merge and rebase still said that the merge is the
159    default, which no longer is the case.  This has been corrected.
160    (merge 71076d0edd ah/advice-pull-has-no-preference-between-rebase-and-merge later to maint).
162  * "git fetch", when received a bad packfile, can fail with SIGPIPE.
163    This wasn't wrong per-se, but we now detect the situation and fail
164    in a more predictable way.
165    (merge 2a4aed42ec jk/fetch-pack-avoid-sigpipe-to-index-pack later to maint).
167  * The function to cull a child process and determine the exit status
168    had two separate code paths for normal callers and callers in a
169    signal handler, and the latter did not yield correct value when the
170    child has caught a signal.  The handling of the exit status has
171    been unified for these two code paths.  An existing test with
172    flakiness has also been corrected.
173    (merge 5263e22cba jk/t7006-sigpipe-tests-fix later to maint).
175  * When a non-existent program is given as the pager, we tried to
176    reuse an uninitialized child_process structure and crashed, which
177    has been fixed.
178    (merge f917f57f40 em/missing-pager later to maint).
180  * The single-key-input mode in "git add -p" had some code to handle
181    keys that generate a sequence of input via ReadKey(), which did not
182    handle end-of-file correctly, which has been fixed.
183    (merge fc8a8126df cb/add-p-single-key-fix later to maint).
185  * "git rebase -x" added an unnecessary 'exec' instructions before
186    'noop', which has been corrected.
187    (merge cc9dcdee61 en/rebase-x-fix later to maint).
189  * When the "git push" command is killed while the receiving end is
190    trying to report what happened to the ref update proposals, the
191    latter used to die, due to SIGPIPE.  The code now ignores SIGPIPE
192    to increase our chances to run the post-receive hook after it
193    happens.
194    (merge d34182b9e3 rj/receive-pack-avoid-sigpipe-during-status-reporting later to maint).
196  * "git worktree add" showed "Preparing worktree" message to the
197    standard output stream, but when it failed, the message from die()
198    went to the standard error stream.  Depending on the order the
199    stdio streams are flushed at the program end, this resulted in
200    confusing output.  It has been corrected by sending all the chatty
201    messages to the standard error stream.
202    (merge b50252484f es/worktree-chatty-to-stderr later to maint).
204  * Coding guideline document has been updated to clarify what goes to
205    standard error in our system.
206    (merge e258eb4800 es/doc-stdout-vs-stderr later to maint).
208  * The sparse-index/sparse-checkout feature had a bug in its use of
209    the matching code to determine which path is in or outside the
210    sparse checkout patterns.
211    (merge 8c5de0d265 ds/sparse-deep-pattern-checkout-fix later to maint).
213  * Other code cleanup, docfix, build fix, etc.
214    (merge 74db416c9c cw/protocol-v2-doc-fix later to maint).
215    (merge f9b2b6684d ja/doc-cleanup later to maint).
216    (merge 7d1b866778 jc/fix-first-object-walk later to maint).
217    (merge 538ac74604 js/trace2-avoid-recursive-errors later to maint).
218    (merge 152923b132 jk/t5319-midx-corruption-test-deflake later to maint).
219    (merge 9081a421a6 ab/checkout-branch-info-leakfix later to maint).
220    (merge 42c456ff81 rs/mergesort later to maint).
221    (merge ad506e6780 tl/midx-docfix later to maint).
222    (merge bf5b83fd8a hk/ci-checkwhitespace-commentfix later to maint).
223    (merge 49f1eb3b34 jk/refs-g11-workaround later to maint).
224    (merge 7d3fc7df70 jt/midx-doc-fix later to maint).
225    (merge 7b089120d9 hn/create-reflog-simplify later to maint).
226    (merge 9e12400da8 cb/mingw-gmtime-r later to maint).
227    (merge 0bf0de6cc7 tb/pack-revindex-on-disk-cleanup later to maint).
228    (merge 2c68f577fc ew/cbtree-remove-unused-and-broken-cb-unlink later to maint).
229    (merge eafd6e7e55 ab/die-with-bug later to maint).