Merge branch 'sb/mailmap-freeing-NULL-is-ok'
[git.git] / Documentation / RelNotes / 1.8.5.txt
blob49a1c6c36b29db70d9b8bddda261a78e2d424a2c
1 Git v1.8.5 Release Notes
2 ========================
4 Backward compatibility notes (for Git 2.0)
5 ------------------------------------------
7 When "git push [$there]" does not say what to push, we have used the
8 traditional "matching" semantics so far (all your branches were sent
9 to the remote as long as there already are branches of the same name
10 over there).  In Git 2.0, the default will change to the "simple"
11 semantics that pushes:
13  - only the current branch to the branch with the same name, and only
14    when the current branch is set to integrate with that remote
15    branch, if you are pushing to the same remote as you fetch from; or
17  - only the current branch to the branch with the same name, if you
18    are pushing to a remote that is not where you usually fetch from.
20 Use the user preference configuration variable "push.default" to
21 change this.  If you are an old-timer who is used to the "matching"
22 semantics, you can set the variable to "matching" to keep the
23 traditional behaviour.  If you want to live in the future early, you
24 can set it to "simple" today without waiting for Git 2.0.
26 When "git add -u" (and "git add -A") is run inside a subdirectory and
27 does not specify which paths to add on the command line, it
28 will operate on the entire tree in Git 2.0 for consistency
29 with "git commit -a" and other commands.  There will be no
30 mechanism to make plain "git add -u" behave like "git add -u .".
31 Current users of "git add -u" (without a pathspec) should start
32 training their fingers to explicitly say "git add -u ."
33 before Git 2.0 comes.  A warning is issued when these commands are
34 run without a pathspec and when you have local changes outside the
35 current directory, because the behaviour in Git 2.0 will be different
36 from today's version in such a situation.
38 In Git 2.0, "git add <path>" will behave as "git add -A <path>", so
39 that "git add dir/" will notice paths you removed from the directory
40 and record the removal.  Versions before Git 2.0, including this
41 release, will keep ignoring removals, but the users who rely on this
42 behaviour are encouraged to start using "git add --ignore-removal <path>"
43 now before 2.0 is released.
46 Updates since v1.8.4
47 --------------------
49 Foreign interfaces, subsystems and ports.
51  * remote-hg remote helper misbehaved when interacting with a local Hg
52    repository relative to the home directory, e.g. "clone hg::~/there".
54  * imap-send ported to OS X uses Apple's security framework instead of
55    OpenSSL one.
57  * Subversion 1.8.0 that was recently released breaks older subversion
58    clients coming over http/https in various ways.
60  * "git fast-import" treats an empty path given to "ls" as the root of
61    the tree.
64 UI, Workflows & Features
66  * Magic pathspecs like ":(icase)makefile" that matches both
67    Makefile and makefile can be used in more places.
69  * The "http.*" variables can now be specified per URL that the
70    configuration applies.  For example,
72    [http]
73        sslVerify = true
74    [http "https://weak.example.com/"]
75        sslVerify = false
77    would flip http.sslVerify off only when talking to that specified
78    site.
80  * "git mv A B" when moving a submodule A has been taught to
81    relocate its working tree and to adjust the paths in the
82    .gitmodules file.
84  * "git blame" can now take more than one -L option to discover the
85    origin of multiple blocks of the lines.
87  * The http transport clients can optionally ask to save cookies
88    with http.savecookies configuration variable.
90  * "git push" learned a more fine grained control over a blunt
91    "--force" when requesting a non-fast-forward update with the
92    "--force-with-lease=<refname>:<expected object name>" option.
94  * "git diff --diff-filter=<classes of changes>" can now take
95    lowercase letters (e.g. "--diff-filter=d") to mean "show
96    everything but these classes".  "git diff-files -q" is now a
97    deprecated synonym for "git diff-files --diff-filter=d".
99  * "git fetch" (hence "git pull" as well) learned to check
100    "fetch.prune" and "remote.*.prune" configuration variables and
101    to behave as if the "--prune" command line option was given.
103  * "git check-ignore -z" applied the NUL termination to both its input
104    (with --stdin) and its output, but "git check-attr -z" ignored the
105    option on the output side. Make both honor -z on the input and
106    output side the same way.
108  * "git whatchanged" may still be used by old timers, but mention of
109    it in documents meant for new users will only waste readers' time
110    wonderig what the difference is between it and "git log".  Make it
111    less prominent in the general part of the documentation and explain
112    that it is merely a "git log" with different default behaviour in
113    its own document.
116 Performance, Internal Implementation, etc.
118  * Many commands use --dashed-option as a operation mode selector
119    (e.g. "git tag --delete") that the user can use at most one
120    (e.g. "git tag --delete --verify" is a nonsense) and you cannot
121    negate (e.g. "git tag --no-delete" is a nonsense).  parse-options
122    API learned a new OPT_CMDMODE macro to make it easier to implement
123    such a set of options.
125  * OPT_BOOLEAN() in parse-options API was misdesigned to be "counting
126    up" but many subcommands expect it to behave as "on/off". Update
127    them to use OPT_BOOL() which is a proper boolean.
129  * "git gc" exits early without doing a double-work when it detects
130    that another instance of itself is already running.
132  * Under memory pressure and/or file descriptor pressure, we used to
133    close pack windows that are not used and also closed filehandle to
134    an open but unused packfiles. These are now controlled separately
135    to better cope with the load.
137 Also contains various documentation updates and code clean-ups.
140 Fixes since v1.8.4
141 ------------------
143 Unless otherwise noted, all the fixes since v1.8.4 in the maintenance
144 track are contained in this release (see release notes to them for
145 details).
147  * The mailmap support code read past the allocated buffer when the
148    mailmap file ended with an incomplete line.
149    (merge f972a16 jk/mailmap-incomplete-line later to maint).
151  * We used to send a large request to read(2)/write(2) as a single
152    system call, which was bad from the latency point of view when
153    the operation needs to be killed, and also triggered an error on
154    broken 64-bit systems that refuse to take more than 2GB read or
155    write in one go.
156    (merge a487916 sp/clip-read-write-to-8mb later to maint).
158  * "git fetch" that auto-followed tags incorrectly reused the
159    connection with Git-aware transport helper (like the sample "ext::"
160    helper shipped with Git).
161    (merge 0f73f8b jc/transport-do-not-use-connect-twice-in-fetch later to maint).
163  * "git log --full-diff -- <pathspec>" showed a huge diff for paths
164    outside the given <pathspec> for each commit, instead of showing
165    the change relative to the parent of the commit.  "git reflog -p"
166    had a similar problem.
167    (merge 838f9a1 tr/log-full-diff-keep-true-parents later to maint).
169  * Setting submodule.*.path configuration variable to true (without
170    giving "= value") caused Git to segfault.
171    (merge 4b05440 jl/some-submodule-config-are-not-boolean later to maint).
173  * "git rebase -i" (there could be others, as the root cause is pretty
174    generic) fed a random, data dependeant string to 'echo' and
175    expects it to come out literally, corrupting its error message.
176    (merge 89b0230 mm/no-shell-escape-in-die-message later to maint).
178  * Some people still use rather old versions of bash, which cannot
179    grok some constructs like 'printf -v varname' the prompt and
180    completion code started to use recently.
181    (merge a44aa69 bc/completion-for-bash-3.0 later to maint).
183  * Code to read configuration from a blob object did not compile on
184    platforms with fgetc() etc. implemented as macros.
185    (merge 49d6cfa hv/config-from-blob later to maint-1.8.3).
187  * The recent "short-cut clone connectivity check" topic broke a
188    shallow repository when a fetch operation tries to auto-follow tags.
189    (merge 6da8bdc nd/fetch-pack-shallow-fix later to maint-1.8.3).