Update draft release notes to 1.6.1
[git/jnareb-git.git] / Documentation / RelNotes-1.6.1.txt
blob4dc06342977c4ed5601541935afb54e343ed89ca
1 GIT v1.6.1 Release Notes
2 ========================
4 Updates since v1.6.0
5 --------------------
7 When some commands (e.g. "git log", "git diff") spawn pager internally, we
8 used to make the pager the parent process of the git command that produces
9 output.  This meant that the exit status of the whole thing comes from the
10 pager, not the underlying git command.  We swapped the order of the
11 processes around and you will see the exit code from the command from now
12 on.
14 (subsystems)
16 * gitk can call out to git-gui to view "git blame" output; git-gui in turn
17   can run gitk from its blame view.
19 * Various git-gui updates including updated translations.
21 * Various gitweb updates from repo.or.cz installation.
23 (portability)
25 * A few test scripts used nonportable "grep" that did not work well on
26   some platforms, e.g. Solaris.
28 * Sample pre-auto-gc script has OS X support.
30 (performance)
32 * The underlying diff machinery to produce textual output has been
33   optimized, which would result in faster "git blame" processing.
35 * Most of the test scripts (but not the ones that try to run servers)
36   can be run in parallel.
38 * Bash completion of refnames in a repository with massive number of
39   refs has been optimized.
41 * Cygwin port uses native stat/lstat implementations when applicable,
42   which leads to improved performance.
44 * "git push" pays attention to alternate repositories to avoid sending
45   unnecessary objects.
47 * "git svn" can rebuild an out-of-date rev_map file.
49 (usability, bells and whistles)
51 * When you mistype a command name, git helpfully suggests what it guesses
52   you might have meant to say.  help.autocorrect configuration can be set
53   to a non-zero value to accept the suggestion when git can uniquely
54   guess.
56 * "git add -N path..." adds the named paths as an empty blob, so that
57   subsequent "git diff" will show a diff as if they are creation events.
59 * "git apply" learned --include=paths option, similar to the existing
60   --exclude=paths option.
62 * "git bisect" is careful about a user mistake and suggests testing of
63   merge base first when good is not a strict ancestor of bad.
65 * "git checkout --track origin/hack" used to be a syntax error.  It now
66   DWIMs to create a corresponding local branch "hack", i.e. acts as if you
67   said "git checkout --track -b hack origin/hack".
69 * "git checkout --ours/--theirs" can be used to check out one side of a
70   conflicting merge during conflict resolution.
72 * "git checkout -m" can be used to recreate the initial conflicted state
73   during conflict resolution.
75 * "git cherry-pick" can also utilize rerere for conflict resolution.
77 * "git commit --author=$name" can look up author name from existing
78   commits.
80 * "git count-objects" reports the on-disk footprint for packfiles and
81   their corresponding idx files.
83 * "git daemon" learned --max-connections=<count> option.
85 * "git diff" learned to mimic --suppress-blank-empty from GNU diff via a
86   configuration option.
88 * "git diff" learned to put more sensible hunk headers for Python,
89   HTML and ObjC contents.
91 * "git diff" learned to vary the a/ vs b/ prefix depending on what are
92   being compared, controlled by diff.mnemonicprefix configuration.
94 * "git diff" learned --dirstat-by-file to count changed files, not number
95   of lines, when summarizing the global picture.
97 * "git for-each-ref" learned "refname:short" token that gives an
98   unambiguously abbreviated refname.
100 * "git grep" learned to accept -z similar to GNU grep.
102 * "git help" learned to use GIT_MAN_VIEWER environment variable before
103   using "man" program.
105 * "git imap-send" can optionally talk SSL.
107 * "git index-pack" is more careful against disk corruption while
108   completing a thin pack.
110 * "git log --check" and "git log --exit-code" passes their underlying diff
111   status with their exit status code.
113 * "git log" learned --simplify-merges, a milder variant of --full-history;
114   "gitk --simplify-merges" is easier to view than with --full-history.
116 * "git log --pretty=format:" learned "%d" format element that inserts
117   names of tags that point at the commit.
119 * "git merge --squash" and "git merge --no-ff" into an unborn branch are
120   noticed as user errors.
122 * "git merge -s $strategy" can use a custom built strategy if you have a
123   command "git-merge-$strategy" on your $PATH.
125 * "git reflog expire branch" can be used in place of "git reflog expire
126   refs/heads/branch".
128 * "git submodule foreach" subcommand allows you to iterate over checked
129   out submodules.
131 * "git submodule sync" subcommands allows you to update the origin URL
132   recorded in submodule directories from the toplevel .gitmodules file.
134 * "git svn branch" can create new branches on the other end.
136 (internal)
138 * "git hash-object" learned to lie about the path being hashed, so that
139   correct gitattributes processing can be done while hashing contents
140   stored in a temporary file.
142 * various callers of git-merge-recursive avoid forking it as an external
143   process.
146 Fixes since v1.6.0
147 ------------------
149 All of the fixes in v1.6.0.X maintenance series are included in this
150 release, unless otherwise noted.
152 * "git add" and "git update-index" incorrectly allowed adding S/F when S
153   is a tracked symlink that points at a directory D that has a path F in
154   it (we still need to fix a similar nonsense when S is a submodule and F
155   is a path in it).
157 * "git diff --stdin" used to take two trees on a line and compared them,
158   but we dropped support for such a use case long time ago.  This has
159   been resurrected.
161 * Giving 3 or more tree-ish to "git diff" is supposed to show the combined
162   diff from second and subsequent trees to the first one.  b75271d ("git
163   diff <tree>{3,}": do not reverse order of arguments, 2008-10-10) needs
164   to be cherry-picked to 'maint'.
166 * "git filter-branch" failed to rewrite a tag name with slashes in it.
168 * "git push --tags --all $there" failed with generic usage message without
169   telling saying these two options are incompatible.
171 * "git log --author/--committer" match used to potentially match the
172   timestamp part, exposing internal implementation detail.  Also these did
173   not work with --fixed-strings match at all.
176 exec >/var/tmp/1
177 O=v1.6.0.2-529-g769b008
178 echo O=$(git describe master)
179 git shortlog --no-merges $O..master ^maint