300 lines
		
	
	
	
		
			13 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
			
		
		
	
	
			300 lines
		
	
	
	
		
			13 KiB
		
	
	
	
		
			Text
		
	
	
	
	
	
| Git v2.3 Release Notes
 | ||
| ======================
 | ||
| 
 | ||
| This one ended up to be a release with lots of small corrections and
 | ||
| improvements without big uncomfortably exciting features.  The recent
 | ||
| security fix that went to 2.2.1 and older maintenance tracks is also
 | ||
| contained in this update.
 | ||
| 
 | ||
| 
 | ||
| Updates since v2.2
 | ||
| ------------------
 | ||
| 
 | ||
| Ports
 | ||
| 
 | ||
|  * Recent gcc toolchain on Cygwin started throwing compilation warning,
 | ||
|    which has been squelched.
 | ||
| 
 | ||
|  * A few updates to build on platforms that lack tv_nsec,
 | ||
|    clock_gettime, CLOCK_MONOTONIC and HMAC_CTX_cleanup (e.g. older
 | ||
|    RHEL) have been added.
 | ||
| 
 | ||
| 
 | ||
| UI, Workflows & Features
 | ||
| 
 | ||
|  * It was cumbersome to use "GIT_SSH" mechanism when the user wanted
 | ||
|    to pass an extra set of arguments to the underlying ssh.  A new
 | ||
|    environment variable GIT_SSH_COMMAND can be used for this.
 | ||
| 
 | ||
|  * A request to store an empty note via "git notes" meant to remove
 | ||
|    note from the object but with --allow-empty we will store a
 | ||
|    (surprise!)  note that is empty.
 | ||
| 
 | ||
|  * "git interpret-trailers" learned to properly handle the
 | ||
|    "Conflicts:" block at the end.
 | ||
| 
 | ||
|  * "git am" learned "--message-id" option to copy the message ID of
 | ||
|    the incoming e-mail to the log message of resulting commit.
 | ||
| 
 | ||
|  * "git clone --reference=<over there>" learned the "--dissociate"
 | ||
|    option to go with it; it borrows objects from the reference object
 | ||
|    store while cloning only to reduce network traffic and then
 | ||
|    dissociates the resulting clone from the reference by performing
 | ||
|    local copies of borrowed objects.
 | ||
| 
 | ||
|  * "git send-email" learned "--transfer-encoding" option to force a
 | ||
|    non-fault Content-Transfer-Encoding header (e.g. base64).
 | ||
| 
 | ||
|  * "git send-email" normally identifies itself via X-Mailer: header in
 | ||
|    the message it sends out.  A new command line flag --no-xmailer
 | ||
|    allows the user to squelch the header.
 | ||
| 
 | ||
|  * "git push" into a repository with a working tree normally refuses
 | ||
|    to modify the branch that is checked out.  The command learned to
 | ||
|    optionally do an equivalent of "git reset --hard" only when there
 | ||
|    is no change to the working tree and the index instead, which would
 | ||
|    be useful to "deploy" by pushing into a repository.
 | ||
| 
 | ||
|  * "git new-workdir" (in contrib/) can be used to populate an empty
 | ||
|    and existing directory now.
 | ||
| 
 | ||
|  * Credential helpers are asked in turn until one of them give
 | ||
|    positive response, which is cumbersome to turn off when you need to
 | ||
|    run Git in an automated setting.  The credential helper interface
 | ||
|    learned to allow a helper to say "stop, don't ask other helpers."
 | ||
|    Also GIT_TERMINAL_PROMPT environment can be set to false to disable
 | ||
|    our built-in prompt mechanism for passwords.
 | ||
| 
 | ||
|  * "git branch -d" (delete) and "git branch -m" (move) learned to
 | ||
|    honor "-f" (force) flag; unlike many other subcommands, the way to
 | ||
|    force these have been with separate "-D/-M" options, which was
 | ||
|    inconsistent.
 | ||
| 
 | ||
|  * "diff-highlight" filter (in contrib/) allows its color output to be
 | ||
|    customized via configuration variables.
 | ||
| 
 | ||
|  * "git imap-send" learned to take "-v" (verbose) and "-q" (quiet)
 | ||
|    command line options.
 | ||
| 
 | ||
|  * "git remote add $name $URL" is now allowed when "url.$URL.insteadOf"
 | ||
|    is already defined.
 | ||
| 
 | ||
|  * "git imap-send" now can be built to use cURL library to talk to
 | ||
|    IMAP servers (if the library is recent enough, of course).
 | ||
|    This allows you to use authenticate method other than CRAM-MD5,
 | ||
|    among other things.
 | ||
| 
 | ||
|  * "git imap-send" now allows GIT_CURL_VERBOSE environment variable to
 | ||
|    control the verbosity when talking via the cURL library.
 | ||
| 
 | ||
|  * The prompt script (in contrib/) learned to optionally hide prompt
 | ||
|    when in an ignored directory by setting GIT_PS1_HIDE_IF_PWD_IGNORED
 | ||
|    shell variable.
 | ||
| 
 | ||
| 
 | ||
| Performance, Internal Implementation, Development Support etc.
 | ||
| 
 | ||
|  * Earlier we made "rev-list --object-edge" more aggressively list the
 | ||
|    objects at the edge commits, in order to reduce number of objects 
 | ||
|    fetched into a shallow repository, but the change affected cases
 | ||
|    other than "fetching into a shallow repository" and made it
 | ||
|    unusably slow (e.g. fetching into a normal repository should not
 | ||
|    have to suffer the overhead from extra processing).  Limit it to a
 | ||
|    more specific case by introducing --objects-edge-aggressive, a new
 | ||
|    option to rev-list.
 | ||
| 
 | ||
|  * Squelched useless compiler warnings on Mac OS X regarding the
 | ||
|    crypto API.
 | ||
| 
 | ||
|  * The procedure to generate unicode table has been simplified.
 | ||
| 
 | ||
|  * Some filesystems assign filemodes in a strange way, fooling then
 | ||
|    automatic "filemode trustability" check done during a new
 | ||
|    repository creation.  The initialization codepath has been hardened
 | ||
|    against this issue.
 | ||
| 
 | ||
|  * The codepath in "git remote update --prune" to drop many refs has
 | ||
|    been optimized.
 | ||
| 
 | ||
|  * The API into get_merge_bases*() family of functions was easy to
 | ||
|    misuse, which has been corrected to make it harder to do so.
 | ||
| 
 | ||
|  * Long overdue departure from the assumption that S_IFMT is shared by
 | ||
|    everybody made in 2005, which was necessary to port to z/OS.
 | ||
| 
 | ||
|  * "git push" and "git fetch" did not communicate an overlong refname
 | ||
|    correctly.  Now it uses 64kB sideband to accommodate longer ones.
 | ||
| 
 | ||
|  * Recent GPG changes the keyring format and drops support for RFC1991
 | ||
|    formatted signatures, breaking our existing tests.
 | ||
| 
 | ||
|  * "git-prompt" (in contrib/) used a variable from the global scope,
 | ||
|    possibly contaminating end-user's namespace.
 | ||
| 
 | ||
| 
 | ||
| Also contains various documentation updates and code clean-ups.
 | ||
| 
 | ||
| 
 | ||
| Fixes since v2.2
 | ||
| ----------------
 | ||
| 
 | ||
| Unless otherwise noted, all the fixes since v2.2 in the maintenance
 | ||
| track are contained in this release (see the maintenance releases'
 | ||
| notes for details).
 | ||
| 
 | ||
|  * "git http-push" over WebDAV (aka dumb http-push) was broken in
 | ||
|    v2.2.2 when parsing a symbolic ref, resulting in a bogus request
 | ||
|    that gets rejected by recent versions of cURL library.
 | ||
|    (merge f6786c8 jk/http-push-symref-fix later to maint).
 | ||
| 
 | ||
|  * The logic in "git bisect bad HEAD" etc. to avoid forcing the test
 | ||
|    of the common ancestor of bad and good commits was broken.
 | ||
|    (merge 07913d5 cc/bisect-rev-parsing later to maint).
 | ||
| 
 | ||
|  * "git checkout-index --temp=$target $path" did not work correctly
 | ||
|    for paths outside the current subdirectory in the project.
 | ||
|    (merge 74c4de5 es/checkout-index-temp later to maint).
 | ||
| 
 | ||
|  * The report from "git checkout" on a branch that builds on another
 | ||
|    local branch by setting its branch.*.merge to branch name (not a
 | ||
|    full refname) incorrectly said that the upstream is gone.
 | ||
|    (merge 05e7368 jc/checkout-local-track-report later to maint).
 | ||
| 
 | ||
|  * With The git-prompt support (in contrib/), using the exit status of
 | ||
|    the last command in the prompt, e.g.  PS1='$(__git_ps1) $? ', did
 | ||
|    not work well, because the helper function stomped on the exit
 | ||
|    status.
 | ||
|    (merge 6babe76 tf/prompt-preserve-exit-status later to maint).
 | ||
| 
 | ||
|  * Recent update to "git commit" broke amending an existing commit
 | ||
|    with bogus author/committer lines without a valid e-mail address.
 | ||
|    (merge c83a509 jk/commit-date-approxidate later to maint).
 | ||
| 
 | ||
|  * The lockfile API used to get confused which file to clean up when
 | ||
|    the process moved the $cwd after creating a lockfile.
 | ||
|    (merge fa137f6 nd/lockfile-absolute later to maint).
 | ||
| 
 | ||
|  * Traditionally we tried to avoid interpreting date strings given by
 | ||
|    the user as future dates, e.g. GIT_COMMITTER_DATE=2014-12-10 when
 | ||
|    used early November 2014 was taken as "October 12, 2014" because it
 | ||
|    is likely that a date in the future, December 10, is a mistake.
 | ||
|    This heuristics has been loosened to allow people to express future
 | ||
|    dates (most notably, --until=<date> may want to be far in the
 | ||
|    future) and we no longer tiebreak by future-ness of the date when
 | ||
| 
 | ||
|     (1) ISO-like format is used, and
 | ||
|     (2) the string can make sense interpreted as both y-m-d and y-d-m.
 | ||
| 
 | ||
|    Git may still have to use the heuristics to tiebreak between dd/mm/yy
 | ||
|    and mm/dd/yy, though.
 | ||
|    (merge d372395 jk/approxidate-avoid-y-d-m-over-future-dates later to maint).
 | ||
| 
 | ||
|  * Git did not correctly read an overlong refname from a packed refs
 | ||
|    file.
 | ||
|    (merge ea41783 jk/read-packed-refs-without-path-max later to maint).
 | ||
| 
 | ||
|  * "git apply" was described in the documentation to take --ignore-date
 | ||
|    option, which it does not.
 | ||
|    (merge 0cef4e7 rw/apply-does-not-take-ignore-date later to maint).
 | ||
| 
 | ||
|  * "git add -i" did not notice when the interactive command input
 | ||
|    stream went away and kept asking the same question.
 | ||
|    (merge a8bec7a jk/add-i-read-error later to maint).
 | ||
| 
 | ||
|  * "git send-email" did not handle RFC 2047 encoded headers quite
 | ||
|    right.
 | ||
|    (merge ab47e2a rd/send-email-2047-fix later to maint).
 | ||
| 
 | ||
|  * New tag object format validation added in 2.2 showed garbage after
 | ||
|    a tagname it reported in its error message.
 | ||
|    (merge a1e920a js/fsck-tag-validation later to maint).
 | ||
| 
 | ||
|  * The code that reads the reflog from the newer to the older entries
 | ||
|    did not handle an entry that crosses a boundary of block it uses to
 | ||
|    read them correctly.
 | ||
|    (merge 69216bf jk/for-each-reflog-ent-reverse later to maint).
 | ||
| 
 | ||
|  * "git diff -B -M" after making a new copy B out of an existing file
 | ||
|    A and then editing A extensively ought to report that B was created
 | ||
|    by copying A and A was modified, which is what "git diff -C"
 | ||
|    reports, but it instead said A was renamed to B and A was edited
 | ||
|    heavily in place.  This was not just incoherent but also failed to
 | ||
|    apply with "git apply".  The report has been corrected to match what
 | ||
|    "git diff -C" produces for this case.
 | ||
|    (merge 6936b58 jc/diff-b-m later to maint).
 | ||
| 
 | ||
|  * In files we pre-populate for the user to edit with commented hints,
 | ||
|    a line of hint that is indented with a tab used to show as '#' (or
 | ||
|    any comment char), ' ' (space), and then the hint text that began
 | ||
|    with the tab, which some editors flag as an indentation error (tab
 | ||
|    following space).  We now omit the space after the comment char in
 | ||
|    such a case.
 | ||
|    (merge d55aeb7 jc/strbuf-add-lines-avoid-sp-ht-sequence later to maint).
 | ||
| 
 | ||
|  * "git ls-tree" does not support path selection based on negative
 | ||
|    pathspecs, but did not error out when negative pathspecs are given.
 | ||
|    (merge f1f6224 nd/ls-tree-pathspec later to maint).
 | ||
| 
 | ||
|  * The function sometimes returned a non-freeable memory and some
 | ||
|    other times returned a piece of memory that must be freed, leading
 | ||
|    to inevitable leaks.
 | ||
|    (merge 59362e5 jc/exec-cmd-system-path-leak-fix later to maint).
 | ||
| 
 | ||
|  * The code to abbreviate an object name to its short unique prefix
 | ||
|    has been optimized when no abbreviation was requested.
 | ||
|    (merge 61e704e mh/find-uniq-abbrev later to maint).
 | ||
| 
 | ||
|  * "git add --ignore-errors ..." did not ignore an error to
 | ||
|    give a file that did not exist.
 | ||
|    (merge 1d31e5a mg/add-ignore-errors later to maint).
 | ||
| 
 | ||
|  * "git checkout $treeish $path", when $path in the index and the
 | ||
|    working tree already matched what is in $treeish at the $path,
 | ||
|    still overwrote the $path unnecessarily.
 | ||
|    (merge c5326bd jk/checkout-from-tree later to maint).
 | ||
| 
 | ||
|  * "git config --get-color" did not parse its command line arguments
 | ||
|    carefully.
 | ||
|    (merge cb35722 jk/colors-fix later to maint).
 | ||
| 
 | ||
|  * open() emulated on Windows platforms did not give EISDIR upon
 | ||
|    an attempt to open a directory for writing.
 | ||
|    (merge ba6fad0 js/windows-open-eisdir-error later to maint).
 | ||
| 
 | ||
|  * A few code paths used abs() when they should have used labs() on
 | ||
|    long integers.
 | ||
|    (merge 83915ba rs/maint-config-use-labs later to maint).
 | ||
|    (merge 31a8aa1 rs/receive-pack-use-labs later to maint).
 | ||
| 
 | ||
|  * "gitweb" used to depend on a behaviour recent CGI.pm deprecated.
 | ||
|    (merge 13dbf46 jk/gitweb-with-newer-cgi-multi-param later to maint).
 | ||
| 
 | ||
|  * "git init" (hence "git clone") initialized the per-repository
 | ||
|    configuration file .git/config with x-bit by mistake.
 | ||
|    (merge 1f32ecf mh/config-flip-xbit-back-after-checking later to maint).
 | ||
| 
 | ||
|  * Recent update in Git 2.2 started creating objects/info/packs and
 | ||
|    info/refs files with permission bits tighter than user's umask.
 | ||
|    (merge d91175b jk/prune-packed-server-info later to maint).
 | ||
| 
 | ||
|  * Git 2.0 was supposed to make the "simple" mode for the default of
 | ||
|    "git push", but it didn't.
 | ||
|    (merge 00a6fa0 jk/push-simple later to maint).
 | ||
| 
 | ||
|  * "Everyday" document had a broken link.
 | ||
|    (merge 366c8d4 po/everyday-doc later to maint).
 | ||
| 
 | ||
|  * A few test fixes.
 | ||
|    (merge 880ef58 jk/no-perl-tests later to maint).
 | ||
| 
 | ||
|  * The build procedure did not bother fixing perl and python scripts
 | ||
|    when NO_PERL and NO_PYTHON build-time configuration changed.
 | ||
|    (merge ca2051d jk/rebuild-perl-scripts-with-no-perl-seting-change later to maint).
 | ||
| 
 | ||
|  * The usage string of "git log" command was marked incorrectly for
 | ||
|    l10n.
 | ||
|    (merge e66dc0c km/log-usage-string-i18n later to maint).
 | ||
| 
 | ||
|  * "git for-each-ref" mishandled --format="%(upstream:track)" when a
 | ||
|    branch is marked to have forked from a non-existing branch.
 | ||
|    (merge b6160d9 rc/for-each-ref-tracking later to maint).
 |