RelNotes/2.46.0.txt

   1 Git v2.46 Release Notes
   2 =======================
   3
   4 Backward Compatibility Notes
   5
   6  (None at this moment)
   7
   8 UI, Workflows & Features
   9
  10  * The "--rfc" option of "git format-patch" learned to take an
  11    optional string value to be used in place of "RFC" to tweak the
  12    "[PATCH]" on the subject header.
  13
  14  * The credential helper protocol, together with the HTTP layer, have
  15    been enhanced to support authentication schemes different from
  16    username & password pair, like Bearer and NTLM.
  17
  18  * Command line completion script (in contrib/) learned to complete
  19    "git symbolic-ref" a bit better (you need to enable plumbing
  20    commands to be completed with GIT_COMPLETION_SHOW_ALL_COMMANDS).
  21
  22  * When the user responds to a prompt given by "git add -p" with an
  23    unsupported command, list of available commands were given, which
  24    was too much if the user knew what they wanted to type but merely
  25    made a typo.  Now the user gets a much shorter error message.
  26
  27  * The color parsing code learned to handle 12-bit RGB colors, spelled
  28    as "#RGB" (in addition to "#RRGGBB" that is already supported).
  29
  30  * The operation mode options (like "--get") the "git config" command
  31    uses have been deprecated and replaced with subcommands (like "git
  32    config get").
  33
  34  * "git tag" learned the "--trailer" option to futz with the trailers
  35    in the same way as "git commit" does.
  36
  37  * A new global "--no-advice" option can be used to disable all advice
  38    messages, which is meant to be used only in scripts.
  39
  40  * Updates to symbolic refs can now be made as a part of ref
  41    transaction.
  42
  43  * The trailer API has been reshuffled a bit.
  44
  45  * Terminology to call various ref-like things are getting
  46    straightened out.
  47
  48  * The command line completion script (in contrib/) has been adjusted
  49    to the recent update to "git config" that adopted subcommand based
  50    UI.
  51
  52  * The knobs to tweak how reftable files are written have been made
  53    available as configuration variables.
  54
  55  * When "git push" notices that the commit at the tip of the ref on
  56    the other side it is about to overwrite does not exist locally, it
  57    used to first try fetching it if the local repository is a partial
  58    clone. The command has been taught not to do so and immediately
  59    fail instead.
  60
  61  * The promisor.quiet configuration knob can be set to true to make
  62    lazy fetching from promisor remotes silent.
  63
  64  * The inter/range-diff output has been moved to the end of the patch
  65    when format-patch adds it to a single patch, instead of writing it
  66    before the patch text, to be consistent with what is done for a
  67    cover letter for a multi-patch series.
  68
  69  * A new command has been added to migrate a repository that uses the
  70    files backend for its ref storage to use the reftable backend, with
  71    limitations.
  72
  73  * "git diff --exit-code --ext-diff" learned to take the exit status
  74    of the external diff driver into account when deciding the exit
  75    status of the overall "git diff" invocation when configured to do
  76    so.
  77
  78  * "git update-ref --stdin" learned to handle transactional updates of
  79    symbolic-refs.
  80
  81  * "git format-patch --interdiff" for multi-patch series learned to
  82    turn on cover letters automatically (unless told never to enable
  83    cover letter with "--no-cover-letter" and such).
  84
  85  * The "--heads" option of "ls-remote" and "show-ref" has been been
  86    deprecated; "--branches" replaces "--heads".
  87
  88  * For over a year, setting add.interactive.useBuiltin configuration
  89    variable did nothing but giving a "this does not do anything"
  90    warning.  The warning has been removed.
  91
  92
  93 Performance, Internal Implementation, Development Support etc.
  94
  95  * Advertise "git contacts", a tool for newcomers to find people to
  96    ask review for their patches, a bit more in our developer
  97    documentation.
  98
  99  * In addition to building the objects needed, try to link the objects
 100    that are used in fuzzer tests, to make sure at least they build
 101    without bitrot, in Linux CI runs.
 102
 103  * Code to write out reftable has seen some optimization and
 104    simplification.
 105
 106  * Tests to ensure interoperability between reftable written by jgit
 107    and our code have been added and enabled in CI.
 108
 109  * The singleton index_state instance "the_index" has been eliminated
 110    by always instantiating "the_repository" and replacing references
 111    to "the_index"  with references to its .index member.
 112
 113  * Git-GUI has a new maintainer, Johannes Sixt.
 114
 115  * The "test-tool" has been taught to run testsuite tests in parallel,
 116    bypassing the need to use the "prove" tool.
 117
 118  * The "whitespace check" task that was enabled for GitHub Actions CI
 119    has been ported to GitLab CI.
 120
 121  * The refs API lost functions that implicitly assumes to work on the
 122    primary ref_store by forcing the callers to pass a ref_store as an
 123    argument.
 124
 125  * Code clean-up to reduce inter-function communication inside
 126    builtin/config.c done via the use of global variables.
 127
 128  * The pack bitmap code saw some clean-up to prepare for a follow-up topic.
 129
 130  * Preliminary code clean-up for "git send-email".
 131
 132  * The default "creation-factor" used by "git format-patch" has been
 133    raised to make it more aggressively find matching commits.
 134
 135  * Before discovering the repository details, We used to assume SHA-1
 136    as the "default" hash function, which has been corrected. Hopefully
 137    this will smoke out codepaths that rely on such an unwarranted
 138    assumptions.
 139
 140  * The project decision making policy has been documented.
 141
 142  * The strcmp-offset tests have been rewritten using the unit test
 143    framework.
 144
 145  * "git add -p" learned to complain when an answer with more than one
 146    letter is given to a prompt that expects a single letter answer.
 147
 148  * The alias-expanded command lines are logged to the trace output.
 149
 150  * A new test was added to ensure git commands that are designed to
 151    run outside repositories do work.
 152
 153  * Basic unit tests for reftable have been reimplemented under the
 154    unit test framework.
 155
 156  * A pair of test helpers that essentially are unit tests on hash
 157    algorithms have been rewritten using the unit-tests framework.
 158
 159  * A test helper that essentially is unit tests on the "decorate"
 160    logic has been rewritten using the unit-tests framework.
 161
 162  * Many memory leaks in the sparse-checkout code paths have been
 163    plugged.
 164
 165  * "make check-docs" noticed problems and reported to its output but
 166    failed to signal its findings with its exit status, which has been
 167    corrected.
 168
 169  * Building with "-Werror -Wwrite-strings" is now supported.
 170
 171  * To help developers, the build procedure now allows builders to use
 172    CFLAGS_APPEND to specify additional CFLAGS.
 173
 174  * "oidtree" tests were rewritten to use the unit test framework.
 175
 176  * The structure of the document that records longer-term project
 177    decisions to deprecate/remove/update various behaviour has been
 178    outlined.
 179
 180  * The pseudo-merge reachability bitmap to help more efficient storage
 181    of the reachability bitmap in a repository with too many refs has
 182    been added.
 183
 184  * When "git merge" sees that the index cannot be refreshed (e.g. due
 185    to another process doing the same in the background), it died but
 186    after writing MERGE_HEAD etc. files, which was useless for the
 187    purpose to recover from the failure.
 188
 189  * The output from "git cat-file --batch-check" and "--batch-command
 190    (info)" should not be unbuffered, for which some tests have been
 191    added.
 192
 193  * A CPP macro USE_THE_REPOSITORY_VARIABLE is introduced to help
 194    transition the codebase to rely less on the availability of the
 195    singleton the_repository instance.
 196
 197  * "git version --build-options" reports the version information of
 198    OpenSSL and other libraries (if used) in the build.
 199
 200  * Memory ownership rules for the in-core representation of
 201    remote.*.url configuration values have been straightened out, which
 202    resulted in a few leak fixes and code clarification.
 203
 204  * When bundleURI interface fetches multiple bundles, Git failed to
 205    take full advantage of all bundles and ended up slurping duplicated
 206    objects, which has been corrected..
 207
 208  * The code to deal with modified paths that are out-of-cone in a
 209    sparsely checked out working tree has been optimized.
 210
 211
 212 Fixes since v2.45
 213 -----------------
 214
 215  * "git rebase --signoff" used to forget that it needs to add a
 216    sign-off to the resulting commit when told to continue after a
 217    conflict stops its operation.
 218
 219  * The procedure to build multi-pack-index got confused by the
 220    replace-refs mechanism, which has been corrected by disabling the
 221    latter.
 222
 223  * The "-k" and "--rfc" options of "format-patch" will now error out
 224    when used together, as one tells us not to add anything to the
 225    title of the commit, and the other one tells us to add "RFC" in
 226    addition to "PATCH".
 227
 228  * "git stash -S" did not handle binary files correctly, which has
 229    been corrected.
 230
 231  * A scheduled "git maintenance" job is expected to work on all
 232    repositories it knows about, but it stopped at the first one that
 233    errored out.  Now it keeps going.
 234
 235  * zsh can pretend to be a normal shell pretty well except for some
 236    glitches that we tickle in some of our scripts. Work them around
 237    so that "vimdiff" and our test suite works well enough with it.
 238
 239  * Command line completion support for zsh (in contrib/) has been
 240    updated to stop exposing internal state to end-user shell
 241    interaction.
 242
 243  * Tests that try to corrupt in-repository files in chunked format did
 244    not work well on macOS due to its broken "mv", which has been
 245    worked around.
 246
 247  * The maximum size of attribute files is enforced more consistently.
 248
 249  * Unbreak CI jobs so that we do not attempt to use Python 2 that has
 250    been removed from the platform.
 251
 252  * Git 2.43 started using the tree of HEAD as the source of attributes
 253    in a bare repository, which has severe performance implications.
 254    For now, revert the change, without ripping out a more explicit
 255    support for the attr.tree configuration variable.
 256
 257  * The "--exit-code" option of "git diff" command learned to work with
 258    the "--ext-diff" option.
 259
 260  * Windows CI running in GitHub Actions started complaining about the
 261    order of arguments given to calloc(); the imported regex code uses
 262    the wrong order almost consistently, which has been corrected.
 263
 264  * Expose "name conflict" error when a ref creation fails due to D/F
 265    conflict in the ref namespace, to improve an error message given by
 266    "git fetch".
 267    (merge 9339fca23e it/refs-name-conflict later to maint).
 268
 269  * The SubmittingPatches document now refers folks to manpages
 270    translation project.
 271
 272  * The documentation for "git diff --name-only" has been clarified
 273    that it is about showing the names in the post-image tree.
 274
 275  * The credential helper that talks with osx keychain learned to avoid
 276    storing back the authentication material it just got received from
 277    the keychain.
 278    (merge e1ab45b2da kn/osxkeychain-skip-idempotent-store later to maint).
 279
 280  * The chainlint script (invoked during "make test") did nothing when
 281    it failed to detect the number of available CPUs.  It now falls
 282    back to 1 CPU to avoid the problem.
 283
 284  * Revert overly aggressive "layered defence" that went into 2.45.1
 285    and friends, which broke "git-lfs", "git-annex", and other use
 286    cases, so that we can rebuild necessary counterparts in the open.
 287
 288  * "git init" in an already created directory, when the user
 289    configuration has includeif.onbranch, started to fail recently,
 290    which has been corrected.
 291
 292  * Memory leaks in "git mv" has been plugged.
 293
 294  * The safe.directory configuration knob has been updated to
 295    optionally allow leading path matches.
 296
 297  * An overly large ".gitignore" files are now rejected silently.
 298
 299  * Upon expiration event, the credential subsystem forgot to clear
 300    in-core authentication material other than password (whose support
 301    was added recently), which has been corrected.
 302
 303  * Fix for an embarrassing typo that prevented Python2 tests from running
 304    anywhere.
 305
 306  * Varargs functions that are unannotated as printf-like or execl-like
 307    have been annotated as such.
 308
 309  * "git am" has a safety feature to prevent it from starting a new
 310    session when there already is a session going.  It reliably
 311    triggers when a mbox is given on the command line, but it has to
 312    rely on the tty-ness of the standard input.  Add an explicit way to
 313    opt out of this safety with a command line option.
 314    (merge 62c71ace44 jk/am-retry later to maint).
 315
 316  * A leak in "git imap-send" that somehow escapes LSan has been
 317    plugged.
 318
 319  * Setting core.abbrev too early before the repository set-up
 320    (typically in "git clone") caused segfault, which as been
 321    corrected.
 322
 323  * When the user adds to "git rebase -i" instruction to "pick" a merge
 324    commit, the error experience is not pleasant.  Such an error is now
 325    caught earlier in the process that parses the todo list.
 326
 327  * We forgot to normalize the result of getcwd() to NFC on macOS where
 328    all other paths are normalized, which has been corrected.  This still
 329    does not address the case where core.precomposeUnicode configuration
 330    is not defined globally.
 331
 332  * Earlier we stopped using the tree of HEAD as the default source of
 333    attributes in a bare repository, but failed to document it.  This
 334    has been corrected.
 335
 336  * "git update-server-info" and "git commit-graph --write" have been
 337    updated to use the tempfile API to avoid leaving cruft after
 338    failing.
 339
 340  * An unused extern declaration for mingw has been removed to prevent
 341    it from causing build failure.
 342
 343  * A helper function shared between two tests had a copy-paste bug,
 344    which has been corrected.
 345
 346  * "git fetch-pack -k -k" without passing "--lock-pack" (which we
 347    never do ourselves) did not work at all, which has been corrected.
 348
 349  * CI job to build minimum fuzzers learned to pass NO_CURL=NoThanks to
 350    the build procedure, as its build environment does not offer, or
 351    the rest of the build needs, anything cURL.
 352    (merge 4e66b5a990 jc/fuzz-sans-curl later to maint).
 353
 354  * "git diff --no-ext-diff" when diff.external is configured ignored
 355    the "--color-moved" option.
 356    (merge 0f4b0d4cf0 rs/diff-color-moved-w-no-ext-diff-fix later to maint).
 357
 358  * "git archive --add-virtual-file=<path>:<contents>" never paid
 359    attention to the --prefix=<prefix> option but the documentation
 360    said it would. The documentation has been corrected.
 361    (merge 72c282098d jc/archive-prefix-with-add-virtual-file later to maint).
 362
 363  * When GIT_PAGER failed to spawn, depending on the code path taken,
 364    we failed immediately (correct) or just spew the payload to the
 365    standard output (incorrect).  The code now always fail immediately
 366    when GIT_PAGER fails.
 367    (merge 78f0a5d187 rj/pager-die-upon-exec-failure later to maint).
 368
 369  * date parser updates to be more careful about underflowing epoch
 370    based timestamp.
 371    (merge 9d69789770 db/date-underflow-fix later to maint).
 372
 373  * The Bloom filter used for path limited history traversal was broken
 374    on systems whose "char" is unsigned; update the implementation and
 375    bump the format version to 2.
 376    (merge 9c8a9ec787 tb/path-filter-fix later to maint).
 377
 378  * Other code cleanup, docfix, build fix, etc.
 379    (merge 493fdae046 ew/object-convert-leakfix later to maint).
 380    (merge 00f3661a0a ss/doc-eol-attr-fix later to maint).