Merge branch 'rs/commit-graph-code-simplification'
[git/debian.git] / Documentation / RelNotes / 2.26.0.txt
blob30ef134eecf908032f03676ff7d60c39b80f625d
1 Git 2.26 Release Notes
2 ======================
4 Updates since v2.25
5 -------------------
7 UI, Workflows & Features
9  * Sample credential helper for using .netrc has been updated to work
10    out of the box.
12  * gpg.minTrustLevel configuration variable has been introduced to
13    tell various signature verification codepaths the required minimum
14    trust level.
16  * The command line completion (in contrib/) learned to complete
17    subcommands and arguments to "git worktree".
19  * Disambiguation logic to tell revisions and pathspec apart has been
20    tweaked so that backslash-escaped glob special characters do not
21    count in the "wildcards are pathspec" rule.
23  * One effect of specifying where the GIT_DIR is (either with the
24    environment variable, or with the "git --git-dir=<where> cmd"
25    option) is to disable the repository discovery.  This has been
26    placed a bit more stress in the documentation, as new users often
27    get confused.
29  * Two help messages given when "git add" notices the user gave it
30    nothing to add have been updated to use advise() API.
32  * A new version of fsmonitor-watchman hook has been introduced, to
33    avoid races.
35  * "git config" learned to show in which "scope", in addition to in
36    which file, each config setting comes from.
38  * The basic 7 colors learned the brighter counterparts
39    (e.g. "brightred").
42 Performance, Internal Implementation, Development Support etc.
44  * Tell .editorconfig that in this project, *.txt files are indented
45    with tabs.
47  * The test-lint machinery knew to check "VAR=VAL shell_function"
48    construct, but did not check "VAR= shell_funciton", which has been
49    corrected.
51  * Replace "git config --bool" calls with "git config --type=bool" in
52    sample templates.
54  * The effort to move "git-add--interactive" to C continues.
56  * Improve error message generation for "git submodule add".
58  * Preparation of test scripts for the day when the object names will
59    use SHA-256 continues.
61  * Warn programmers about pretend_object_file() that allows the code
62    to tentatively use in-core objects.
64  * The way "git pack-objects" reuses objects stored in existing pack
65    to generate its result has been improved.
67  * The transport protocol version 2 becomes the default one.
69  * Traditionally, we avoided threaded grep while searching in objects
70    (as opposed to files in the working tree) as accesses to the object
71    layer is not thread-safe.  This limitation is getting lifted.
73  * "git rebase -i" (and friends) used to unnecessarily check out the
74    tip of the branch to be rebased, which has been corrected.
76  * A low-level API function get_oid(), that accepts various ways to
77    name an object, used to issue end-user facing error messages
78    without l10n, which has been updated to be translatable.
80  * Unneeded connectivity check is now disabled in a partial clone when
81    fetching into it.
83  * Some rough edges in the sparse-checkout feature, especially around
84    the cone mode, have been cleaned up.
86  * The diff-* plumbing family of subcommands now pay attention to the
87    diff.wsErrorHighlight configuration, which has been ignored before;
88    this allows "git add -p" to also show the whitespace problems to
89    the end user.
91  * Some codepaths were given a repository instance as a parameter to
92    work in the repository, but passed the_repository instance to its
93    callees, which has been cleaned up (somewhat).
95  * Memory footprint and performance of "git name-rev" has been
96    improved.
98  * The object reachability bitmap machinery and the partial cloning
99    machinery were not prepared to work well together, because some
100    object-filtering criteria that partial clones use inherently rely
101    on object traversal, but the bitmap machinery is an optimization
102    to bypass that object traversal.  There however are some cases
103    where they can work together, and they were taught about them.
105  * "git rebase" has learned to use the merge backend (i.e. the
106    machinery that drives "rebase -i") by default, while allowing
107    "--apply" option to use the "apply" backend (e.g. the moral
108    equivalent of "format-patch piped to am").  The rebase.backend
109    configuration variable can be set to customize.
112 Fixes since v2.25
113 -----------------
115  * "git commit" gives output similar to "git status" when there is
116    nothing to commit, but without honoring the advise.statusHints
117    configuration variable, which has been corrected.
119  * has_object_file() said "no" given an object registered to the
120    system via pretend_object_file(), making it inconsistent with
121    read_object_file(), causing lazy fetch to attempt fetching an
122    empty tree from promisor remotes.
124  * Complete an update to tutorial that encourages "git switch" over
125    "git checkout" that was done only half-way.
127  * C pedantry ;-) fix.
129  * The code that tries to skip over the entries for the paths in a
130    single directory using the cache-tree was not careful enough
131    against corrupt index file.
133  * Reduce unnecessary round-trip when running "ls-remote" over the
134    stateless RPC mechanism.
136  * "git restore --staged" did not correctly update the cache-tree
137    structure, resulting in bogus trees to be written afterwards, which
138    has been corrected.
140  * The code recently added to move to the entry beyond the ones in the
141    same directory in the index in the sparse-cone mode did not count
142    the number of entries to skip over incorrectly, which has been
143    corrected.
145  * Rendering by "git log --graph" of ancestry lines leading to a merge
146    commit were made suboptimal to waste vertical space a bit with a
147    recent update, which has been corrected.
149  * Work around test breakages caused by custom regex engine used in
150    libasan, when address sanitizer is used with more recent versions
151    of gcc and clang.
153  * Minor bugfixes to "git add -i" that has recently been rewritten in C.
154    (merge 849e43cc18 js/builtin-add-i-cmds later to maint).
156  * "git fetch --refmap=" option has got a better documentation.
158  * "git checkout X" did not correctly fail when X is not a local
159    branch but could name more than one remote-tracking branches
160    (i.e. to be dwimmed as the starting point to create a corresponding
161    local branch), which has been corrected.
162    (merge fa74180d08 am/checkout-file-and-ref-ref-ambiguity later to maint).
164  * Corner case bugs in "git clean" that stems from a (necessarily for
165    performance reasons) awkward calling convention in the directory
166    enumeration API has been corrected.
168  * A fetch that is told to recursively fetch updates in submodules
169    inevitably produces reams of output, and it becomes hard to spot
170    error messages.  The command has been taught to enumerate
171    submodules that had errors at the end of the operation.
172    (merge 0222540827 es/fetch-show-failed-submodules-atend later to maint).
174  * The "--recurse-submodules" option of various subcommands did not
175    work well when run in an alternate worktree, which has been
176    corrected.
177    (merge a9472afb63 pb/recurse-submodule-in-worktree-fix later to maint).
179  * Futureproofing a test not to depend on the current implementation
180    detail.
182  * Running "git rm" on a submodule failed unnecessarily when
183    .gitmodules is only cache-dirty, which has been corrected.
184    (merge 7edee32985 dt/submodule-rm-with-stale-cache later to maint).
186  * C pedantry ;-) fix.
187    (merge cf82bff73f jk/clang-sanitizer-fixes later to maint).
189  * "git grep --no-index" should not get affected by the contents of
190    the .gitmodules file but when "--recurse-submodules" is given or
191    the "submodule.recurse" variable is set, it did.  Now these
192    settings are ignored in the "--no-index" mode.
194  * Technical details of the bundle format has been documented.
196  * Unhelpful warning messages during documentation build have been squelched.
198  * "git rebase -i" identifies existing commits in its todo file with
199    their abbreviated object name, which could become ambigous as it
200    goes to create new commits, and has a mechanism to avoid ambiguity
201    in the main part of its execution.  A few other cases however were
202    not covered by the protection against ambiguity, which has been
203    corrected.
204    (merge 26027625dd js/rebase-i-with-colliding-hash later to maint).
206  * Allow the rebase.missingCommitsCheck configuration to kick in when
207    "rebase --edit-todo" and "rebase --continue" restarts the procedure.
208    (merge 5a5445d878 ag/edit-todo-drop-check later to maint).
210  * The way "git submodule status" reports an initialized but not yet
211    populated submodule has not been reimplemented correctly when a
212    part of the "git submodule" command was rewritten in C, which has
213    been corrected.
214    (merge f38c92452d pk/status-of-uncloned-submodule later to maint).
216  * The code to automatically shrink the fan-out in the notes tree had
217    an off-by-one bug, which has been killed.
218    (merge dbc27477ff jh/notes-fanout-fix later to maint).
220  * The index-pack code now diagnoses a bad input packstream that
221    records the same object twice when it is used as delta base; the
222    code used to declare a software bug when encountering such an
223    input, but it is an input error.
224    (merge a21781011f jk/index-pack-dupfix later to maint).
226  * The code to compute the commit-graph has been taught to use a more
227    robust way to tell if two object directories refer to the same
228    thing.
229    (merge a7df60cac8 tb/commit-graph-object-dir later to maint).
231  * "git remote rename X Y" needs to adjust configuration variables
232    (e.g. branch.<name>.remote) whose value used to be X to Y.
233    branch.<name>.pushRemote is now also updated.
235  * Update to doc-diff.
236    (merge 2607d39da3 jk/doc-diff-parallel later to maint).
238  * Doc markup fix.
239    (merge 0aa6ce3094 jk/push-option-doc-markup-fix later to maint).
241  * "git check-ignore" did not work when the given path is explicitly
242    marked as not ignored with a negative entry in the .gitignore file.
243    (merge 7ec8125fba en/check-ignore later to maint).
245  * The merge-recursive machinery failed to refresh the cache entry for
246    a merge result in a couple of places, resulting in an unnecessary
247    merge failure, which has been fixed.
248    (merge fb1c18fc46 en/t3433-rebase-stat-dirty-failure later to maint).
250  * Fix for a bug revealed by a recent change to make the protocol v2
251    the default.
252    (merge 3e96c66805 ds/partial-clone-fixes later to maint).
254  * Other code cleanup, docfix, build fix, etc.
255    (merge 26f924d50e en/simplify-check-updates-in-unpack-trees later to maint).
256    (merge d0d0a357a1 am/update-pathspec-f-f-tests later to maint).
257    (merge f94f7bd00d am/test-pathspec-f-f-error-cases later to maint).
258    (merge c513a958b6 ss/t6025-modernize later to maint).
259    (merge b441717256 dl/test-must-fail-fixes later to maint).
260    (merge d031049da3 mt/sparse-checkout-doc-update later to maint).
261    (merge 145136a95a jc/skip-prefix later to maint).
262    (merge 5290d45134 jk/alloc-cleanups later to maint).
263    (merge 7a9f8ca805 rs/parse-options-concat-dup later to maint).
264    (merge 517b60564e rs/strbuf-insertstr later to maint).
265    (merge f696a2b1c8 jk/mailinfo-cleanup later to maint).
266    (merge 076ee3e8a2 js/test-write-junit-xml-fix later to maint).
267    (merge de26f02db1 js/test-avoid-pipe later to maint).
268    (merge bfe2bbb47f js/test-unc-fetch later to maint).
269    (merge 08809c09aa js/mingw-open-in-gdb later to maint).
270    (merge cc4f2eb828 jk/doc-credential-helper later to maint).
271    (merge e0020b2f82 es/outside-repo-errmsg-hints later to maint).
272    (merge a2dc43414c es/doc-mentoring later to maint).
273    (merge 539052f42f jk/run-command-formatfix later to maint).
274    (merge 02bbbe9df9 es/worktree-cleanup later to maint).
275    (merge 2ce6d075fa rs/micro-cleanups later to maint).
276    (merge 27f182b3fc rs/blame-typefix-for-fingerprint later to maint).
277    (merge 3c29e21eb0 ma/test-cleanup later to maint).