Git Source Code Mirror - This is a publish-only repository and all pull requests are ignored. Please follow Documentation/SubmittingPatches procedure for any of your improvements.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

349 lines

  1. Git 2.23 Release Notes
  2. ======================
  3. Updates since v2.22
  4. -------------------
  5. Backward compatibility note
  6. * The "--base" option of "format-patch" computed the patch-ids for
  7. prerequisite patches in an unstable way, which has been updated to
  8. compute in a way that is compatible with "git patch-id --stable".
  9. * The "git log" command by default behaves as if the --mailmap option
  10. was given.
  11. UI, Workflows & Features
  12. * The "git fast-export/import" pair has been taught to handle commits
  13. with log messages in encoding other than UTF-8 better.
  14. * In recent versions of Git, per-worktree refs are exposed in
  15. refs/worktrees/<wtname>/ hierarchy, which means that worktree names
  16. must be a valid refname component. The code now sanitizes the names
  17. given to worktrees, to make sure these refs are well-formed.
  18. * "git merge" learned "--quit" option that cleans up the in-progress
  19. merge while leaving the working tree and the index still in a mess.
  20. * "git format-patch" learns a configuration to set the default for
  21. its --notes=<ref> option.
  22. * The code to show args with potential typo that cannot be
  23. interpreted as a commit-ish has been improved.
  24. * "git clone --recurse-submodules" learned to set up the submodules
  25. to ignore commit object names recorded in the superproject gitlink
  26. and instead use the commits that happen to be at the tip of the
  27. remote-tracking branches from the get-go, by passing the new
  28. "--remote-submodules" option.
  29. * The pattern "git diff/grep" use to extract funcname and words
  30. boundary for Matlab has been extend to cover Octave, which is more
  31. or less equivalent.
  32. * "git help git" was hard to discover (well, at least for some
  33. people).
  34. * The pattern "git diff/grep" use to extract funcname and words
  35. boundary for Rust has been added.
  36. * "git status" can be told a non-standard default value for the
  37. "--[no-]ahead-behind" option with a new configuration variable
  38. status.aheadBehind.
  39. * "git fetch" and "git pull" reports when a fetch results in
  40. non-fast-forward updates to let the user notice unusual situation.
  41. The commands learned "--no-show-forced-updates" option to disable
  42. this safety feature.
  43. * Two new commands "git switch" and "git restore" are introduced to
  44. split "checking out a branch to work on advancing its history" and
  45. "checking out paths out of the index and/or a tree-ish to work on
  46. advancing the current history" out of the single "git checkout"
  47. command.
  48. * "git branch --list" learned to always output the detached HEAD as
  49. the first item (when the HEAD is detached, of course), regardless
  50. of the locale.
  51. * The conditional inclusion mechanism learned to base the choice on
  52. the branch the HEAD currently is on.
  53. * "git rev-list --objects" learned the "--no-object-names" option to
  54. squelch the path to the object that is used as a grouping hint for
  55. pack-objects.
  56. * A new tag.gpgSign configuration variable turns "git tag -a" into
  57. "git tag -s".
  58. * "git multi-pack-index" learned expire and repack subcommands.
  59. * "git blame" learned to "ignore" commits in the history, whose
  60. effects (as well as their presence) get ignored.
  61. * "git cherry-pick/revert" learned a new "--skip" action.
  62. * The tips of refs from the alternate object store can be used as
  63. starting point for reachability computation now.
  64. * Extra blank lines in "git status" output have been reduced.
  65. * The commits in a repository can be described by multiple
  66. commit-graph files now, which allows the commit-graph files to be
  67. updated incrementally.
  68. * "git range-diff" output has been tweaked for easier identification
  69. of which part of what file the patch shown is about.
  70. Performance, Internal Implementation, Development Support etc.
  71. * Update supporting parts of "git rebase" to remove code that should
  72. no longer be used.
  73. * Developer support to emulate unsatisfied prerequisites in tests to
  74. ensure that the remainder of the tests still succeeds when tests
  75. with prerequisites are skipped.
  76. * "git update-server-info" learned not to rewrite the file with the
  77. same contents.
  78. * The way of specifying the path to find dynamic libraries at runtime
  79. has been simplified. The old default to pass -R/path/to/dir has been
  80. replaced with the new default to pass -Wl,-rpath,/path/to/dir,
  81. which is the more recent GCC uses. Those who need to build with an
  82. old GCC can still use "CC_LD_DYNPATH=-R"
  83. * Prepare use of reachability index in topological walker that works
  84. on a range (A..B).
  85. * A new tutorial targeting specifically aspiring git-core
  86. developers has been added.
  87. * Auto-detect how to tell HP-UX aCC where to use dynamically linked
  88. libraries from at runtime.
  89. * "git mergetool" and its tests now spawn fewer subprocesses.
  90. * Dev support update to help tracing out tests.
  91. * Support to build with MSVC has been updated.
  92. * "git fetch" that grabs from a group of remotes learned to run the
  93. auto-gc only once at the very end.
  94. * A handful of Windows build patches have been upstreamed.
  95. * The code to read state files used by the sequencer machinery for
  96. "git status" has been made more robust against a corrupt or stale
  97. state files.
  98. * "git for-each-ref" with multiple patterns have been optimized.
  99. * The tree-walk API learned to pass an in-core repository
  100. instance throughout more codepaths.
  101. * When one step in multi step cherry-pick or revert is reset or
  102. committed, the command line prompt script failed to notice the
  103. current status, which has been improved.
  104. * Many GIT_TEST_* environment variables control various aspects of
  105. how our tests are run, but a few followed "non-empty is true, empty
  106. or unset is false" while others followed the usual "there are a few
  107. ways to spell true, like yes, on, etc., and also ways to spell
  108. false, like no, off, etc." convention.
  109. * Adjust the dir-iterator API and apply it to the local clone
  110. optimization codepath.
  111. * We have been trying out a few language features outside c89; the
  112. coding guidelines document did not talk about them and instead had
  113. a blanket ban against them.
  114. * A test helper has been introduced to optimize preparation of test
  115. repositories with many simple commits, and a handful of test
  116. scripts have been updated to use it.
  117. Fixes since v2.22
  118. -----------------
  119. * A relative pathname given to "git init --template=<path> <repo>"
  120. ought to be relative to the directory "git init" gets invoked in,
  121. but it instead was made relative to the repository, which has been
  122. corrected.
  123. * "git worktree add" used to fail when another worktree connected to
  124. the same repository was corrupt, which has been corrected.
  125. * The ownership rule for the file descriptor to fast-import remote
  126. backend was mixed up, leading to an unrelated file descriptor getting
  127. closed, which has been fixed.
  128. * A "merge -c" instruction during "git rebase --rebase-merges" should
  129. give the user a chance to edit the log message, even when there is
  130. otherwise no need to create a new merge and replace the existing
  131. one (i.e. fast-forward instead), but did not. Which has been
  132. corrected.
  133. * Code cleanup and futureproof.
  134. * More parameter validation.
  135. * "git update-server-info" used to leave stale packfiles in its
  136. output, which has been corrected.
  137. * The server side support for "git fetch" used to show incorrect
  138. value for the HEAD symbolic ref when the namespace feature is in
  139. use, which has been corrected.
  140. * "git am -i --resolved" segfaulted after trying to see a commit as
  141. if it were a tree, which has been corrected.
  142. * "git bundle verify" needs to see if prerequisite objects exist in
  143. the receiving repository, but the command did not check if we are
  144. in a repository upfront, which has been corrected.
  145. * "git merge --squash" is designed to update the working tree and the
  146. index without creating the commit, and this cannot be countermanded
  147. by adding the "--commit" option; the command now refuses to work
  148. when both options are given.
  149. * The data collected by fsmonitor was not properly written back to
  150. the on-disk index file, breaking t7519 tests occasionally, which
  151. has been corrected.
  152. * Update to Unicode 12.1 width table.
  153. * The command line to invoke a "git cat-file" command from inside
  154. "git p4" was not properly quoted to protect a caret and running a
  155. broken command on Windows, which has been corrected.
  156. * "git request-pull" learned to warn when the ref we ask them to pull
  157. from in the local repository and in the published repository are
  158. different.
  159. * When creating a partial clone, the object filtering criteria is
  160. recorded for the origin of the clone, but this incorrectly used a
  161. hardcoded name "origin" to name that remote; it has been corrected
  162. to honor the "--origin <name>" option.
  163. * "git fetch" into a lazy clone forgot to fetch base objects that are
  164. necessary to complete delta in a thin packfile, which has been
  165. corrected.
  166. * The filter_data used in the list-objects-filter (which manages a
  167. lazily sparse clone repository) did not use the dynamic array API
  168. correctly---'nr' is supposed to point at one past the last element
  169. of the array in use. This has been corrected.
  170. * The description about slashes in gitignore patterns (used to
  171. indicate things like "anchored to this level only" and "only
  172. matches directories") has been revamped.
  173. * The URL decoding code has been updated to avoid going past the end
  174. of the string while parsing %-<hex>-<hex> sequence.
  175. * The list of for-each like macros used by clang-format has been
  176. updated.
  177. * "git branch --list" learned to show branches that are checked out
  178. in other worktrees connected to the same repository prefixed with
  179. '+', similar to the way the currently checked out branch is shown
  180. with '*' in front.
  181. (merge 6e9381469e nb/branch-show-other-worktrees-head later to maint).
  182. * Code restructuring during 2.20 period broke fetching tags via
  183. "import" based transports.
  184. * The commit-graph file is now part of the "files that the runtime
  185. may keep open file descriptors on, all of which would need to be
  186. closed when done with the object store", and the file descriptor to
  187. an existing commit-graph file now is closed before "gc" finalizes a
  188. new instance to replace it.
  189. * "git checkout -p" needs to selectively apply a patch in reverse,
  190. which did not work well.
  191. * Code clean-up to avoid signed integer wraparounds during binary search.
  192. * "git interpret-trailers" always treated '#' as the comment
  193. character, regardless of core.commentChar setting, which has been
  194. corrected.
  195. * "git stash show 23" used to work, but no more after getting
  196. rewritten in C; this regression has been corrected.
  197. * "git rebase --abort" used to leave refs/rewritten/ when concluding
  198. "git rebase -r", which has been corrected.
  199. * An incorrect list of options was cached after command line
  200. completion failed (e.g. trying to complete a command that requires
  201. a repository outside one), which has been corrected.
  202. * The code to parse scaled numbers out of configuration files has
  203. been made more robust and also easier to follow.
  204. * The codepath to compute delta islands used to spew progress output
  205. without giving the callers any way to squelch it, which has been
  206. fixed.
  207. * Protocol capabilities that go over wire should never be translated,
  208. but it was incorrectly marked for translation, which has been
  209. corrected. The output of protocol capabilities for debugging has
  210. been tweaked a bit.
  211. * Use "Erase in Line" CSI sequence that is already used in the editor
  212. support to clear cruft in the progress output.
  213. * "git submodule foreach" did not protect command line options passed
  214. to the command to be run in each submodule correctly, when the
  215. "--recursive" option was in use.
  216. * The configuration variable rebase.rescheduleFailedExec should be
  217. effective only while running an interactive rebase and should not
  218. affect anything when running a non-interactive one, which was not
  219. the case. This has been corrected.
  220. * The "git clone" documentation refers to command line options in its
  221. description in the short form; they have been replaced with long
  222. forms to make them more recognisable.
  223. * Generation of pack bitmaps are now disabled when .keep files exist,
  224. as these are mutually exclusive features.
  225. (merge 7328482253 ew/repack-with-bitmaps-by-default later to maint).
  226. * "git rm" to resolve a conflicted path leaked an internal message
  227. "needs merge" before actually removing the path, which was
  228. confusing. This has been corrected.
  229. * "git stash --keep-index" did not work correctly on paths that have
  230. been removed, which has been fixed.
  231. (merge b932f6a5e8 tg/stash-keep-index-with-removed-paths later to maint).
  232. * Window 7 update ;-)
  233. * A codepath that reads from GPG for signed object verification read
  234. past the end of allocated buffer, which has been fixed.
  235. * "git clean" silently skipped a path when it cannot lstat() it; now
  236. it gives a warning.
  237. * "git push --atomic" that goes over the transport-helper (namely,
  238. the smart http transport) failed to prevent refs to be pushed when
  239. it can locally tell that one of the ref update will fail without
  240. having to consult the other end, which has been corrected.
  241. * The internal diff machinery can be made to read out of bounds while
  242. looking for --function-context line in a corner case, which has been
  243. corrected.
  244. (merge b777f3fd61 jk/xdiff-clamp-funcname-context-index later to maint).
  245. * Other code cleanup, docfix, build fix, etc.
  246. (merge fbec05c210 cc/test-oidmap later to maint).
  247. (merge 7a06fb038c jk/no-system-includes-in-dot-c later to maint).
  248. (merge 81ed2b405c cb/xdiff-no-system-includes-in-dot-c later to maint).
  249. (merge d61e6ce1dd sg/fsck-config-in-doc later to maint).