Merge branch 'cn/branch-set-upstream-to'
[git] / Documentation / RelNotes / 1.8.0.txt
1 Git v1.8.0 Release Notes
2 ========================
3
4 Backward compatibility notes
5 ----------------------------
6
7 In the next major release, we will change the behaviour of the "git
8 push" command.  When "git push [$there]" does not say what to push, we
9 have used the traditional "matching" semantics (all your branches were
10 sent to the remote as long as there already are branches of the same
11 name over there).  We will use the "simple" semantics, that pushes the
12 current branch to the branch with the same name only when the current
13 branch is set to integrate with that remote branch.  There is a user
14 preference configuration variable "push.default" to change this, and
15 "git push" will warn about the upcoming change until you set this
16 variable.
17
18 "git branch --set-upstream" is deprecated and may be removed in a
19 relatively distant future.  "git branch [-u|--set-upstream-to]" has
20 been introduced with a saner order of arguments.
21
22
23 Updates since v1.7.12
24 ---------------------
25
26 UI, Workflows & Features
27
28  * A credential helper for Win32 to allow access to the keychain of
29    the logged-in user has been added.
30
31  * A credential helper to allow access to the Gnome keyring has been
32    added.
33
34  * It was tempting to say "git branch --set-upstream origin/master",
35    but that tells Git to arrange the local branch "origin/master" to
36    integrate with the currently checked out branch, which is highly
37    unlikely what the user meant.  The option is deprecated; use the
38    new "--set-upstream-to" (with a short-and-sweet "-u") option
39    instead.
40
41  * "git cherry-pick" learned the "--allow-empty-message" option to
42    allow it to replay a commit without any log message.
43
44  * "git daemon" learned the "--access-hook" option to allow an
45    external command to decline service based on the client address,
46    repository path, etc.
47
48  * "git difftool --dir-diff" learned to use symbolic links to prepare
49    temporary copy of the working tree when available.
50
51  * "git grep" learned to use a non-standard pattern type by default if
52    a configuration variable tells it to.
53
54  * "git merge-base" learned "--is-ancestor A B" option to tell if A is
55    an ancestor of B.  The result is indicated by its exit status code.
56
57
58 Foreign Interface
59
60  * "git svn" has been updated to work with SVN 1.7.
61
62
63 Performance, Internal Implementation, etc. (please report possible regressions)
64
65  * Git ships with a fall-back regexp implementation for platforms with
66    buggy regexp library, but it was easy for people to keep using their
67    platform regexp.  A new test has been added to check this.
68
69  * The "check-docs" build target has been updated and greatly
70    simplified.
71
72  * The documentation in the TeXinfo format was using indented output
73    for materials meant to be examples that are better typeset in
74    monospace.
75
76  * Compatibility wrapper around some mkdir(2) implementations that
77    reject parameter with trailing slash has been introduced.
78
79  * Compatibility wrapper for systems that lack usable setitimer() has
80    been added.
81
82  * The option parsing of "git checkout" had error checking, dwim and
83    defaulting missing options, all mixed in the code, and issuing an
84    appropriate error message with useful context was getting harder.
85    The code has been reorganized to allow giving a proper diagnosis
86    when the user says "git checkout -b -t foo bar" (e.g. "-t" is not a
87    good name for a branch).
88
89  * Many internal uses of "git merge-base" equivalent were only to see
90    if one commit fast-forwards to the other, which did not need the
91    full set of merge bases to be computed. They have been updated to
92    use less expensive checks.
93
94  * The heuristics to detect and silently convert latin1 to utf8 when
95    we were told to use utf-8 in the log message has been transplanted
96    from "mailinfo" to "commit" and "commit-tree".
97
98  * Messages given by "git <subcommand> -h" from many subcommands have
99    been marked for translation.
100
101
102 Also contains minor documentation updates and code clean-ups.
103
104
105 Fixes since v1.7.12
106 -------------------
107
108 Unless otherwise noted, all the fixes since v1.7.12 in the
109 maintenance track are contained in this release (see release notes
110 to them for details).
111
112  * "git fetch --all", when passed "--no-tags", did not honor the
113    "--no-tags" option while fetching from individual remotes (the same
114    issue existed with "--tags", but combination "--all --tags" makes
115    much less sense than "--all --no-tags").
116    (merge 8556646 dj/fetch-all-tags later to maint).
117
118  * The subcommand in "git remote" to remove a defined remote was
119    "rm" and the command did not take a fully-spelled "remove".
120    (merge e17dba8 nd/maint-remote-remove later to maint).
121
122  * After "gitk" showed the contents of a tag, neither "Reread
123    references" nor "Reload" did not update what is shown as the
124    contents of it, when the user overwrote the tag with "git tag -f".
125
126  * "git cvsimport" did not thoroughly cleanse tag names that it
127    inferred from the names of the tags it obtained from CVS, which
128    caused "git tag" to barf and stop the import in the middle.
129
130  * "git show --format='%ci'" did not give timestamp correctly for
131    commits created without human readable name on "committer" line.
132    (merge e27ddb6 jc/maint-ident-missing-human-name later to maint).
133
134  * "git cherry-pick A C B" used to replay changes in A and then B and
135    then C if these three commits had committer timestamps in that
136    order, which is not what the user who said "A C B" naturally
137    expects.
138    (merge a73e22e mz/cherry-pick-cmdline-order later to maint).
139
140  * "git show --quiet" ought to be a synonym for "git show -s", but
141    wasn't.
142    (merge f9c75d8 jk/maint-quiet-is-synonym-to-s-in-log later to maint).
143
144  * "git p4", when "--use-client-spec" and "--detect-branches" are used
145    together, misdetected branches.
146    (merge 21ef5df pw/p4-use-client-spec-branch-detection later to maint).
147
148  * Output from "git branch -v" contains "(no branch)" that could be
149    localized, but the code to align it along with the names of
150    branches were counting in bytes, not in display columns.
151    (merge 1452bd6 nd/branch-v-alignment later to maint).
152
153  * When looking for $HOME/.gitconfig etc., it is OK if we cannot read
154    them because they do not exist, but we did not diagnose existing
155    files that we cannot read.
156
157  * The interactive prompt "git send-email" gives was error prone. It
158    asked "What e-mail address do you want to use?" with the address it
159    guessed (correctly) the user would want to use in its prompt,
160    tempting the user to say "y". But the response was taken as "No,
161    please use 'y' as the e-mail address instead", which is most
162    certainly not what the user meant.
163    (merge 6183749 sb/send-email-reconfirm-fix later to maint).