Merge branch 'mo/clang-format-for-each-update'
[git] / Documentation / RelNotes / 2.23.0.txt
1 Git 2.23 Release Notes
2 ======================
3
4 Updates since v2.22
5 -------------------
6
7 Backward compatibility note
8
9  * The "--base" option of "format-patch" computed the patch-ids for
10    prerequisite patches in an unstable way, which has been updated to
11    compute in a way that is compatible with "git patch-id --stable".
12
13
14 UI, Workflows & Features
15
16  * The "git fast-export/import" pair has been taught to handle commits
17    with log messages in encoding other than UTF-8 better.
18
19  * In recent versions of Git, per-worktree refs are exposed in
20    refs/worktrees/<wtname>/ hierarchy, which means that worktree names
21    must be a valid refname component.  The code now sanitizes the names
22    given to worktrees, to make sure these refs are well-formed.
23
24  * "git merge" learned "--quit" option that cleans up the in-progress
25    merge while leaving the working tree and the index still in a mess.
26
27  * "git format-patch" learns a configuration to set the default for
28    its --notes=<ref> option.
29
30  * The code to show args with potential typo that cannot be
31    interpreted as a commit-ish has been improved.
32
33  * "git clone --recurse-submodules" learned to set up the submodules
34    to ignore commit object names recorded in the superproject gitlink
35    and instead use the commits that happen to be at the tip of the
36    remote-tracking branches from the get-go, by passing the new
37    "--remote-submodules" option.
38
39  * The pattern "git diff/grep" use to extract funcname and words
40    boundary for Matlab has been extend to cover Octave, which is more
41    or less equivalent.
42
43  * "git help git" was hard to discover (well, at least for some
44    people).
45
46
47 Performance, Internal Implementation, Development Support etc.
48
49  * Update supporting parts of "git rebase" to remove code that should
50    no longer be used.
51
52  * Developer support to emulate unsatisfied prerequisites in tests to
53    ensure that the remainer of the tests still succeeds when tests
54    with prerequisites are skipped.
55
56  * "git update-server-info" learned not to rewrite the file with the
57    same contents.
58
59  * The way of specifying the path to find dynamic libraries at runtime
60    has been simplified.  The old default to pass -R/path/to/dir has been
61    replaced with the new default to pass -Wl,-rpath,/path/to/dir,
62    which is the more recent GCC uses.  Those who need to build with an
63    old GCC can still use "CC_LD_DYNPATH=-R"
64
65  * Prepare use of reachability index in topological walker that works
66    on a range (A..B).
67
68  * A new tutorial targetting specifically aspiring git-core
69    developers has been added.
70
71
72
73 Fixes since v2.22
74 -----------------
75
76  * A relative pathname given to "git init --template=<path> <repo>"
77    ought to be relative to the directory "git init" gets invoked in,
78    but it instead was made relative to the repository, which has been
79    corrected.
80    (merge e1df7fe43f nd/init-relative-template-fix later to maint).
81
82  * "git worktree add" used to fail when another worktree connected to
83    the same repository was corrupt, which has been corrected.
84    (merge 105df73e71 nd/corrupt-worktrees later to maint).
85
86  * The ownership rule for the file descriptor to fast-import remote
87    backend was mixed up, leading to unrelated file descriptor getting
88    closed, which has been fixed.
89    (merge 3203566a71 mh/import-transport-fd-fix later to maint).
90
91  * A "merge -c" instruction during "git rebase --rebase-merges" should
92    give the user a chance to edit the log message, even when there is
93    otherwise no need to create a new merge and replace the existing
94    one (i.e. fast-forward instead), but did not.  Which has been
95    corrected.
96
97  * Code cleanup and futureproof.
98    (merge 31f5256c82 ds/object-info-for-prefetch-fix later to maint).
99
100  * More parameter validation.
101    (merge de99eb0c24 es/grep-require-name-when-needed later to maint).
102
103  * "git update-server-info" used to leave stale packfiles in its
104    output, which has been corrected.
105    (merge e941c48d49 ew/server-info-remove-crufts later to maint).
106
107  * The server side support for "git fetch" used to show incorrect
108    value for the HEAD symbolic ref when the namespace feature is in
109    use, which has been corrected.
110    (merge 533e088250 jk/HEAD-symref-in-xfer-namespaces later to maint).
111
112  * "git am -i --resolved" segfaulted after trying to see a commit as
113    if it were a tree, which has been corrected.
114    (merge 7663e438c5 jk/am-i-resolved-fix later to maint).
115
116  * "git bundle verify" needs to see if prerequisite objects exist in
117    the receiving repository, but the command did not check if we are
118    in a repository upfront, which has been corrected.
119    (merge 3bbbe467f2 js/bundle-verify-require-object-store later to maint).
120
121  * "git merge --squash" is designed to update the working tree and the
122    index without creating the commit, and this cannot be countermanded
123    by adding the "--commit" option; the command now refuses to work
124    when both options are given.
125    (merge 1d14d0c994 vv/merge-squash-with-explicit-commit later to maint).
126
127  * The data collected by fsmonitor was not properly written back to
128    the on-disk index file, breaking t7519 tests occasionally, which
129    has been corrected.
130    (merge b5a8169752 js/fsmonitor-unflake later to maint).
131
132  * Update to Unicode 12.1 width table.
133    (merge 5817f9caa3 bb/unicode-12.1-reiwa later to maint).
134
135  * The command line to invoke a "git cat-file" command from inside
136    "git p4" was not properly quoted to protect a caret and running a
137    broken command on Windows, which has been corrected.
138    (merge c3f2358de3 mm/p4-unshelve-windows-fix later to maint).
139
140  * "git request-pull" learned to warn when the ref we ask them to pull
141    from in the local repository and in the published repository are
142    different.
143    (merge 0454220d66 pb/request-pull-verify-remote-ref later to maint).
144
145  * When creating a partial clone, the object filtering criteria is
146    recorded for the origin of the clone, but this incorrectly used a
147    hardcoded name "origin" to name that remote; it has been corrected
148    to honor the "--origin <name>" option.
149    (merge 1c4a9f9114 xl/record-partial-clone-origin later to maint).
150
151  * Other code cleanup, docfix, build fix, etc.
152    (merge f547101b26 es/git-debugger-doc later to maint).
153    (merge 7877ac3d7b js/bisect-helper-check-get-oid-return-value later to maint).
154    (merge 0108f47eb3 sw/git-p4-unshelve-branched-files later to maint).