Merge branch 'jx/i18n-1.7.11'
[git/jnareb-git.git] / Documentation / RelNotes / 1.7.12.txt
blob786a702420c21d2915beb8b9d224b03bc1cdb7e9
1 Git v1.7.12 Release Notes
2 =========================
4 Updates since v1.7.11
5 ---------------------
7 UI, Workflows & Features
9  * Git can be told to normalize pathnames it read from readdir(3) and
10    all arguments it got from the command line into precomposed UTF-8
11    (assuming that they come as decomposed UTF-8), in order to work
12    around issues on Mac OS.
14    I think there still are other places that need conversion
15    (e.g. paths that are read from stdin for some commands), but this
16    should be a good first step in the right direction.
18  * Per-user $HOME/.gitconfig file can optionally be stored in
19    $HOME/.config/git/config instead, which is in line with XDG.
21  * The value of core.attributesfile and core.excludesfile default to
22    $HOME/.config/git/attributes and $HOME/.config/git/ignore respectively
23    when these files exist.
25  * Logic to disambiguate abbreviated object names have been taught to
26    take advantage of object types that are expected in the context,
27    e.g. XXXXXX in the "git describe" output v1.2.3-gXXXXXX must be a
28    commit object, not a blob nor a tree.  This will help us prolong
29    the lifetime of abbreviated object names.
31  * "git apply" learned to wiggle the base version and perform three-way
32    merge when a patch does not exactly apply to the version you have.
34  * Scripted Porcelain writers now have access to the credential API via
35    the "git credential" plumbing command.
37  * "git help" used to always default to "man" format even on platforms
38    where "man" viewer is not widely available.
40  * "git clone --local $path" started its life as an experiment to
41    optionally use link/copy when cloning a repository on the disk, but
42    we didn't deprecate it after we made the option a no-op to always
43    use the optimization.  The command learned "--no-local" option to
44    turn this off, as a more explicit alternative over use of file://
45    URL.
47  * "git fetch" and friends used to say "remote side hung up
48    unexpectedly" when they failed to get response they expect from the
49    other side, but one common reason why they don't get expected
50    response is that the remote repository does not exist or cannot be
51    read. The error message in this case was updated to give better
52    hints to the user.
54  * git native protocol agents learned to show software version over
55    the wire, so that the server log can be examined to see the vintage
56    distribution of clients.
58  * "git help -w $cmd" can show HTML version of documentation for
59    "git-$cmd" by setting help.htmlpath to somewhere other than the
60    default location where the build procedure installs them locally;
61    the variable can even point at a http:// URL.
63  * "git rebase [-i] --root $tip" can now be used to rewrite all the
64    history leading to "$tip" down to the root commit.
66  * "git rebase -i" learned "-x <cmd>" to insert "exec <cmd>" after
67    each commit in the resulting history.
69  * "git status" gives finer classification to various states of paths
70    in conflicted state and offer advice messages in its output.
72  * "git submodule" learned to deal with nested submodule structure
73    where a module is contained within a module whose origin is
74    specified as a relative URL to its superproject's origin.
76  * A rather heavy-ish "git completion" script has been split to create
77    a separate "git prompting" script, to help lazy-autoloading of the
78    completion part while making prompting part always available.
80  * "gitweb" pays attention to various forms of credits that are
81    similar to "Signed-off-by:" lines in the commit objects and
82    highlights them accordingly.
85 Foreign Interface
87  * "mediawiki" remote helper (in contrib/) learned to handle file
88    attachments.
90  * "git p4" now uses "Jobs:" and "p4 move" when appropriate.
92  * vcs-svn has been updated to clean-up compilation, lift 32-bit
93    limitations, etc.
96 Performance, Internal Implementation, etc. (please report possible regressions)
98  * Some tests showed false failures caused by a bug in ecryptofs.
100  * We no longer use AsciiDoc7 syntax in our documentation and favor a
101    more modern style.
103  * "git am --rebasing" codepath was taught to grab authorship, log
104    message and the patch text directly out of existing commits.  This
105    will help rebasing commits that have confusing "diff" output in
106    their log messages.
108  * "git index-pack" and "git pack-objects" use streaming API to read
109    from the object store to avoid having to hold a large blob object
110    in-core while they are doing their thing.
112  * Code to match paths with exclude patterns learned to avoid calling
113    fnmatch() by comparing fixed leading substring literally when
114    possible.
116  * "git log -n 1 -- rarely-touched-path" was spending unnecessary
117    cycles after showing the first change to find the next one, only to
118    discard it.
120  * "git svn" got a large-looking code reorganization at the last
121    minute before the code freeze.
123 Also contains minor documentation updates and code clean-ups.
126 Fixes since v1.7.11
127 -------------------
129 Unless otherwise noted, all the fixes since v1.7.11 in the maintenance
130 releases are contained in this release (see release notes to them for
131 details).
133  * "git grep" stopped spawning an external "grep" long time ago, but a
134    duplicated test to check internal and external "grep" was left
135    behind.
136    (merge 4ca9453 rj/maint-grep-remove-redundant-test later to maint).
138  * The code to avoid mistaken attempt to add the object directory
139    itself as its own alternate could read beyond end of a string while
140    comparison.
141    (merge cb2912c hv/link-alt-odb-entry later to maint).
143  * "git checkout <branchname>" to come back from a detached HEAD state
144    incorrectly computed reachability of the detached HEAD, resulting
145    in unnecessary warnings.
146    (merge add416a jk/maint-checkout-orphan-check-fix later to maint).
148  * The documentation for revision range specifiers (e.g. A..B, A^@)
149    has been updated.
150    (merge ca5ee2d mh/maint-revisions-doc later to maint).
152  * "git submodule add" was confused when the superproject did not have
153    its repository in its usual place in the working tree and GIT_DIR
154    and GIT_WORK_TREE was used to access it.
156  * "git mergetool" did not support --tool-help option to give the list
157    of supported backends, like "git difftool" does.
158    (merge 109859e jc/mergetool-tool-help later to maint).
160  * "git commit --amend" let the user edit the log message and then died
161    when the human-readable committer name was given insufficiently by
162    getpwent(3).