Documentation/RelNotes/2.21.0.txt

   1 Git 2.21 Release Notes
   2 ======================
   3
   4 Backward Compatibility Notes
   5 ----------------------------
   6
   7
   8 Updates since v2.20
   9 -------------------
  10
  11 UI, Workflows & Features
  12
  13  * The "http.version" configuration variable can be used with recent
  14    enough cURL library to force the version of HTTP used to talk when
  15    fetching and pushing.
  16
  17  * Small fixes and features for fast-export and fast-import, mostly on
  18    the fast-export side.
  19
  20  * "git push $there $src:$dst" rejects when $dst is not a fully
  21    qualified refname and not clear what the end user meant.  The
  22    codepath has been taught to give a clearer error message, and also
  23    guess where the push should go by taking the type of the pushed
  24    object into account (e.g. a tag object would want to go under
  25    refs/tags/).
  26
  27  * "git checkout [<tree-ish>] path..." learned to report the number of
  28    paths that have been checked out of the index or the tree-ish,
  29    which gives it the same degree of noisy-ness as the case in which
  30    the command checks out a branch.
  31
  32  * "git quiltimport" learned "--keep-non-patch" option.
  33
  34  * "git worktree remove" and "git worktree move" refused to work when
  35    there is a submodule involved.  This has been loosened to ignore
  36    uninitialized submodules.
  37
  38  * "git cherry-pick -m1" was forbidden when picking a non-merge
  39    commit, even though there _is_ parent number 1 for such a commit.
  40    This was done to avoid mistakes back when "cherry-pick" was about
  41    picking a single commit, but is no longer useful with "cherry-pick"
  42    that can pick a range of commits.  Now the "-m$num" option is
  43    allowed when picking any commit, as long as $num names an existing
  44    parent of the commit.
  45
  46  * Update "git multimail" from the upstream.
  47
  48  * "git p4" update.
  49
  50  * The "--format=<placeholder>" option of for-each-ref, branch and tag
  51    learned to show a few more traits of objects that can be learned by
  52    the object_info API.
  53
  54  * "git rebase -i" learned to re-execute a command given with 'exec'
  55    to run after it failed the last time.
  56
  57  * "git diff --color-moved-ws" updates.
  58
  59  * Custom userformat "log --format" learned %S atom that stands for
  60    the tip the traversal reached the commit from, i.e. --source.
  61
  62
  63 Performance, Internal Implementation, Development Support etc.
  64
  65  * Code clean-up with optimization for the codepath that checks
  66    (non-)existence of loose objects.
  67
  68  * More codepaths become aware of working with in-core repository
  69    instance other than the default "the_repository".
  70
  71  * The "strncat()" function is now among the banned functions.
  72
  73  * Portability updates for the HPE NonStop platform.
  74
  75  * Earlier we added "-Wformat-security" to developer builds, assuming
  76    that "-Wall" (which includes "-Wformat" which in turn is required
  77    to use "-Wformat-security") is always in effect.  This is not true
  78    when config.mak.autogen is in use, unfortunately.  This has been
  79    fixed by unconditionally adding "-Wall" to developer builds.
  80
  81  * The loose object cache used to optimize existence look-up has been
  82    updated.
  83
  84  * Flaky tests can now be repeatedly run under load with the
  85    "--stress" option.
  86    (merge fb7d1e3ac8 sg/stress-test later to maint).
  87
  88  * Documentation/Makefile is getting prepared for manpage
  89    localization.
  90
  91  * "git fetch-pack" now can talk the version 2 protocol.
  92
  93  * sha-256 hash has been added and plumbed through the code to allow
  94    building Git with the "NewHash".
  95
  96  * Debugging help for http transport.
  97
  98  * "git fetch --deepen=<more>" has been corrected to work over v2
  99    protocol.
 100
 101  * The code to walk tree objects has been taught that we may be
 102    working with object names that are not computed with SHA-1.
 103
 104
 105 Fixes since v2.20
 106 -----------------
 107
 108  * Updates for corner cases in merge-recursive.
 109    (merge cc4cb0902c en/merge-path-collision later to maint).
 110
 111  * "git checkout frotz" (without any double-dash) avoids ambiguity by
 112    making sure 'frotz' cannot be interpreted as a revision and as a
 113    path at the same time.  This safety has been updated to check also
 114    a unique remote-tracking branch 'frotz' in a remote, when dwimming
 115    to create a local branch 'frotz' out of a remote-tracking branch
 116    'frotz' from a remote.
 117    (merge be4908f103 nd/checkout-dwim-fix later to maint).
 118
 119  * Refspecs configured with "git -c var=val clone" did not propagate
 120    to the resulting repository, which has been corrected.
 121    (merge 7eae4a3ac4 sg/clone-initial-fetch-configuration later to maint).
 122
 123  * A properly configured username/email is required under
 124    user.useConfigOnly in order to create commits; now "git stash"
 125    (even though it creates commit objects to represent stash entries)
 126    command is exempt from the requirement.
 127    (merge 3bc2111fc2 sd/stash-wo-user-name later to maint).
 128
 129  * The http-backend CGI process did not correctly clean up the child
 130    processes it spawns to run upload-pack etc. when it dies itself,
 131    which has been corrected.
 132    (merge 02818a98d7 mk/http-backend-kill-children-before-exit later to maint).
 133
 134  * "git rev-list --exclude-promisor-objects" had to take an object
 135    that does not exist locally (and is lazily available) from the
 136    command line without barfing, but the code dereferenced NULL.
 137    (merge 4cf67869b2 md/list-lazy-objects-fix later to maint).
 138
 139  * The traversal over tree objects has learned to honor
 140    ":(attr:label)" pathspec match, which has been implemented only for
 141    enumerating paths on the filesystem.
 142    (merge 5a0b97b34c nd/attr-pathspec-in-tree-walk later to maint).
 143
 144  * BSD port updates.
 145    (merge 4e3ecbd439 cb/openbsd-allows-reading-directory later to maint).
 146    (merge b6bdc2a0f5 cb/t5004-empty-tar-archive-fix later to maint).
 147    (merge 82cbc8cde2 cb/test-lint-cp-a later to maint).
 148
 149  * Lines that begin with a certain keyword that come over the wire, as
 150    well as lines that consist only of one of these keywords, ought to
 151    be painted in color for easier eyeballing, but the latter was
 152    broken ever since the feature was introduced in 2.19, which has
 153    been corrected.
 154    (merge 1f67290450 hn/highlight-sideband-keywords later to maint).
 155
 156  * "git log -G<regex>" looked for a hunk in the "git log -p" patch
 157    output that contained a string that matches the given pattern.
 158    Optimize this code to ignore binary files, which by default will
 159    not show any hunk that would match any pattern (unless textconv or
 160    the --text option is in effect, that is).
 161    (merge e0e7cb8080 tb/log-G-binary later to maint).
 162
 163  * "git submodule update" ought to use a single job unless asked, but
 164    by mistake used multiple jobs, which has been fixed.
 165    (merge e3a9d1aca9 sb/submodule-fetchjobs-default-to-one later to maint).
 166
 167  * "git stripspace" should be usable outside a git repository, but
 168    under the "-s" or "-c" mode, it didn't.
 169    (merge 957da75802 jn/stripspace-wo-repository later to maint).
 170
 171  * Some of the documentation pages formatted incorrectly with
 172    Asciidoctor, which have been fixed.
 173    (merge b62eb1d2f4 ma/asciidoctor later to maint).
 174
 175  * The core.worktree setting in a submodule repository should not be
 176    pointing at a directory when the submodule loses its working tree
 177    (e.g. getting deinit'ed), but the code did not properly maintain
 178    this invariant.
 179
 180  * With zsh, "git cmd path<TAB>" was completed to "git cmd path name"
 181    when the completed path has a special character like SP in it,
 182    without any attempt to keep "path name" a single filename.  This
 183    has been fixed to complete it to "git cmd path\ name" just like
 184    Bash completion does.
 185
 186  * The test suite tried to see if it is run under bash, but the check
 187    itself failed under some other implementations of shell (notably
 188    under NetBSD).  This has been corrected.
 189    (merge 54ea72f09c sg/test-bash-version-fix later to maint).
 190
 191  * "git gc" and "git repack" did not close the open packfiles that
 192    they found unneeded before removing them, which didn't work on a
 193    platform incapable of removing an open file.  This has been
 194    corrected.
 195    (merge 5bdece0d70 js/gc-repack-close-before-remove later to maint).
 196
 197  * The code to drive GIT_EXTERNAL_DIFF command relied on the string
 198    returned from getenv() to be non-volatile, which is not true, that
 199    has been corrected.
 200    (merge 6776a84dae kg/external-diff-save-env later to maint).
 201
 202  * There were many places the code relied on the string returned from
 203    getenv() to be non-volatile, which is not true, that have been
 204    corrected.
 205    (merge 0da0e9268b jk/save-getenv-result later to maint).
 206
 207  * The v2 upload-pack protocol implementation failed to honor
 208    hidden-ref configuration, which has been corrected.
 209    (merge e20b4192a3 jk/proto-v2-hidden-refs-fix later to maint).
 210
 211  * "git fetch --recurse-submodules" may not fetch the necessary commit
 212    that is bound to the superproject, which is getting corrected.
 213    (merge be76c21282 sb/submodule-recursive-fetch-gets-the-tip later to maint).
 214
 215  * "git rebase" internally runs "checkout" to switch between branches,
 216    and the command used to call the post-checkout hook, but the
 217    reimplementation stopped doing so, which is getting fixed.
 218
 219  * "git add -e" got confused when the change it wants to let the user
 220    edit is smaller than the previous change that was left over in a
 221    temporary file.
 222    (merge fa6f225e01 js/add-e-clear-patch-before-stating later to maint).
 223
 224  * Code cleanup, docfix, build fix, etc.
 225    (merge 89ba9a79ae hb/t0061-dot-in-path-fix later to maint).
 226    (merge d173e799ea sb/diff-color-moved-config-option-fixup later to maint).
 227    (merge a8f5a59067 en/directory-renames-nothanks-doc-update later to maint).
 228    (merge ec36c42a63 nd/indentation-fix later to maint).
 229    (merge f116ee21cd do/gitweb-strict-export-conf-doc later to maint).
 230    (merge 112ea42663 fd/gitweb-snapshot-conf-doc-fix later to maint).
 231    (merge 1cadad6f65 tb/use-common-win32-pathfuncs-on-cygwin later to maint).
 232    (merge 57e9dcaa65 km/rebase-doc-typofix later to maint).
 233    (merge b8b4cb27e6 ds/gc-doc-typofix later to maint).
 234    (merge 3b3357626e nd/style-opening-brace later to maint).
 235    (merge b4583d5595 es/doc-worktree-guessremote-config later to maint).
 236    (merge cce99cd8c6 ds/commit-graph-assert-missing-parents later to maint).
 237    (merge 0650614982 cy/completion-typofix later to maint).
 238    (merge 6881925ef5 rs/sha1-file-close-mapped-file-on-error later to maint).
 239    (merge bd8d6f0def en/show-ref-doc-fix later to maint).
 240    (merge 1747125e2c cc/parial-clone-doc-typofix later to maint).
 241    (merge e01378753d cc/fetch-error-message-fix later to maint).
 242    (merge 54e8c11215 jk/remote-insteadof-cleanup later to maint).