repack: introduce repack.writeBitmaps config option
[git.git] / Documentation / RelNotes / 1.8.5.txt
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.
45 The default prefix for "git svn" will change in Git 2.0.  For a long
46 time, "git svn" created its remote-tracking branches directly under
47 refs/remotes, but it will place them under refs/remotes/origin/ unless
48 it is told otherwise with its --prefix option.
51 Updates since v1.8.4
52 --------------------
54 Foreign interfaces, subsystems and ports.
56  * "git-svn" used with SVN 1.8.0 when talking over https:// connection
57    dumped core due to a bug in the serf library that SVN uses.  Work
58    it around on our side, even though the SVN side is being fixed.
60  * On MacOS X, we detected if the filesystem needs the "pre-composed
61    unicode strings" workaround, but did not automatically enable it.
62    Now we do.
64  * remote-hg remote helper misbehaved when interacting with a local Hg
65    repository relative to the home directory, e.g. "clone hg::~/there".
67  * imap-send ported to OS X uses Apple's security framework instead of
68    OpenSSL one.
70  * Subversion 1.8.0 that was recently released breaks older subversion
71    clients coming over http/https in various ways.
73  * "git fast-import" treats an empty path given to "ls" as the root of
74    the tree.
77 UI, Workflows & Features
79  * "git grep" and "git show" pays attention to "--textconv" option
80    when these commands are told to operate on blob objects (e.g. "git
81    grep -e pattern HEAD:Makefile").
83  * "git replace" helper no longer allows an object to be replaced with
84    another object of a different type to avoid confusion (you can
85    still manually craft such replacement using "git update-ref", as an
86    escape hatch).
88  * "git status" no longer prints dirty status information for
89    submodules for which submodule.$name.ignore is set to "all".
91  * "git rebase -i" honours core.abbrev when preparing the insn sheet
92    for editing.
94  * "git status" during a cherry-pick shows what original commit is
95    being picked.
97  * Instead of typing four capital letters "HEAD", you can say "@" now,
98    e.g. "git log @".
100  * "git check-ignore" follows the same rule as "git add" and "git
101    status" in that the ignore/exclude mechanism does not take effect
102    on paths that are already tracked.  With "--no-index" option, it
103    can be used to diagnose which paths that should have been ignored
104    have been mistakenly added to the index.
106  * Some irrelevant "advice" messages that are shared with "git status"
107    output have been removed from the commit log template.
109  * "update-refs" learnt a "--stdin" option to read multiple update
110    requests and perform them in an all-or-none fashion.
112  * Just like "make -C <directory>", "git -C <directory> ..." tells Git
113    to go there before doing anything else.
115  * Just like "git checkout -" knows to check out and "git merge -"
116    knows to merge the branch you were previously on, "git cherry-pick"
117    now understands "git cherry-pick -" to pick from the previous
118    branch.
120  * "git status" now omits the prefix to make its output a comment in a
121    commit log editor, which is not necessary for human consumption.
122    Scripts that parse the output of "git status" are advised to use
123    "git status --porcelain" instead, as its format is stable and easier
124    to parse.
126  * Make "foo^{tag}" to peel a tag to itself, i.e. no-op., and fail if
127    "foo" is not a tag.  "git rev-parse --verify v1.0^{tag}" would be
128    a more convenient way to say "test $(git cat-file -t v1.0) = tag".
130  * "git branch -v -v" (and "git status") did not distinguish among a
131    branch that does not build on any other branch, a branch that is in
132    sync with the branch it builds on, and a branch that is configured
133    to build on some other branch that no longer exists.
135  * A packfile that stores the same object more than once is broken and
136    will be rejected by "git index-pack" that is run when receiving
137    data over the wire.
139  * Earlier we started rejecting an attempt to add 0{40} object name to
140    the index and to tree objects, but it sometimes is necessary to
141    allow so to be able to use tools like filter-branch to correct such
142    broken tree objects.  "filter-branch" can again be used to to do
143    so.
145  * "git config" did not provide a way to set or access numbers larger
146    than a native "int" on the platform; it now provides 64-bit signed
147    integers on all platforms.
149  * "git pull --rebase" always chose to do the bog-standard flattening
150    rebase.  You can tell it to run "rebase --preserve-merges" by
151    setting "pull.rebase" configuration to "preserve".
153  * "git push --no-thin" actually disables the "thin pack transfer"
154    optimization.
156  * Magic pathspecs like ":(icase)makefile" that matches both
157    Makefile and makefile can be used in more places.
159  * The "http.*" variables can now be specified per URL that the
160    configuration applies.  For example,
162    [http]
163        sslVerify = true
164    [http ""]
165        sslVerify = false
167    would flip http.sslVerify off only when talking to that specified
168    site.
170  * "git mv A B" when moving a submodule A has been taught to
171    relocate its working tree and to adjust the paths in the
172    .gitmodules file.
174  * "git blame" can now take more than one -L option to discover the
175    origin of multiple blocks of the lines.
177  * The http transport clients can optionally ask to save cookies
178    with http.savecookies configuration variable.
180  * "git push" learned a more fine grained control over a blunt
181    "--force" when requesting a non-fast-forward update with the
182    "--force-with-lease=<refname>:<expected object name>" option.
184  * "git diff --diff-filter=<classes of changes>" can now take
185    lowercase letters (e.g. "--diff-filter=d") to mean "show
186    everything but these classes".  "git diff-files -q" is now a
187    deprecated synonym for "git diff-files --diff-filter=d".
189  * "git fetch" (hence "git pull" as well) learned to check
190    "fetch.prune" and "remote.*.prune" configuration variables and
191    to behave as if the "--prune" command line option was given.
193  * "git check-ignore -z" applied the NUL termination to both its input
194    (with --stdin) and its output, but "git check-attr -z" ignored the
195    option on the output side. Make both honor -z on the input and
196    output side the same way.
198  * "git whatchanged" may still be used by old timers, but mention of
199    it in documents meant for new users will only waste readers' time
200    wonderig what the difference is between it and "git log".  Make it
201    less prominent in the general part of the documentation and explain
202    that it is merely a "git log" with different default behaviour in
203    its own document.
206 Performance, Internal Implementation, etc.
208  * "git repack" is now written in C.
210  * Build procedure for MSVC has been updated.
212  * If a build-time fallback is set to "cat" instead of "less", we
213    should apply the same "no subprocess or pipe" optimization as we
214    apply to user-supplied GIT_PAGER=cat.
216  * Many commands use --dashed-option as a operation mode selector
217    (e.g. "git tag --delete") that the user can use at most one
218    (e.g. "git tag --delete --verify" is a nonsense) and you cannot
219    negate (e.g. "git tag --no-delete" is a nonsense).  parse-options
220    API learned a new OPT_CMDMODE macro to make it easier to implement
221    such a set of options.
223  * OPT_BOOLEAN() in parse-options API was misdesigned to be "counting
224    up" but many subcommands expect it to behave as "on/off". Update
225    them to use OPT_BOOL() which is a proper boolean.
227  * "git gc" exits early without doing a double-work when it detects
228    that another instance of itself is already running.
230  * Under memory pressure and/or file descriptor pressure, we used to
231    close pack windows that are not used and also closed filehandle to
232    an open but unused packfiles. These are now controlled separately
233    to better cope with the load.
235 Also contains various documentation updates and code clean-ups.
238 Fixes since v1.8.4
239 ------------------
241 Unless otherwise noted, all the fixes since v1.8.4 in the maintenance
242 track are contained in this release (see release notes to them for
243 details).
245  * "git clone" gave some progress messages to the standard output, not
246    to the standard error, and did not allow suppressing them with the
247    --no-progress option.
248    (merge 643f918 jk/clone-progress-to-stderr later to maint).
250  * "format-patch --from=<whom>" forgot to omit unnecessary in-body
251    from line, i.e. when <whom> is the same as the real author.
252    (merge 662cc30 jk/format-patch-from later to maint).
254  * "git shortlog" used to choke and die when there is a malformed
255    commit (e.g. missing authors); it now simply ignore such a commit
256    and keeps going.
257    (merge cd4f09e jk/shortlog-tolerate-broken-commit later to maint).
259  * "git merge-recursive" did not parse its "--diff-algorithm=" command
260    line option correctly.
261    (merge 6562928 jk/diff-algo later to maint).
263  * When running "fetch -q", a long silence while the sender side
264    computes the set of objects to send can be mistaken by proxies as
265    dropped connection.  The server side has been taught to send a
266    small empty messages to keep the connection alive.
267    (merge 115dedd jk/upload-pack-keepalive later to maint).
269  * "git rebase" had a portability regression in v1.8.4 to trigger a
270    bug in some BSD shell implementations.
271    (merge 99855dd mm/rebase-continue-freebsd-WB later to maint).
273  * "git branch --track" had a minor regression in v1.8.3.2 and later
274    that made it impossible to base your local work on anything but a
275    local branch of the upstream repository you are tracking from.
276    (merge b0f49ff jh/checkout-auto-tracking later to maint).
278  * When the webserver responds with "405 Method Not Allowed", "git
279    http-backend" should tell the client what methods are allowed with
280    the "Allow" header.
281    (merge 9247be0 bc/http-backend-allow-405 later to maint).
283  * When there is no sufficient overlap between old and new history
284    during a "git fetch" into a shallow repository, objects that the
285    sending side knows the receiving end has were unnecessarily sent.
286    (merge f21d2a7 nd/fetch-into-shallow later to maint).
288  * "git cvsserver" computed the permission mode bits incorrectly for
289    executable files.
290    (merge 1b48d56 jc/cvsserver-perm-bit-fix later to maint).
292  * When send-email comes up with an error message to die with upon
293    failure to start an SSL session, it tried to read the error string
294    from a wrong place.
295    (merge 6cb0c88 bc/send-email-ssl-die-message-fix later to maint).
297  * The implementation of "add -i" has a crippling code to work around
298    ActiveState Perl limitation but it by mistake also triggered on Git
299    for Windows where MSYS perl is used.
300    (merge df17e77 js/add-i-mingw later to maint).
302  * We made sure that we notice the user-supplied GIT_DIR is actually a
303    gitfile, but did not do the same when the default ".git" is a
304    gitfile.
305    (merge 487a2b7 nd/git-dir-pointing-at-gitfile later to maint).
307  * When an object is not found after checking the packfiles and then
308    loose object directory, read_sha1_file() re-checks the packfiles to
309    prevent racing with a concurrent repacker; teach the same logic to
310    has_sha1_file().
311    (merge 45e8a74 jk/has-sha1-file-retry-packed later to maint).
313  * "git commit --author=$name", when $name is not in the canonical
314    "A. U. Thor <au.thor@example.xz>" format, looks for a matching name
315    from existing history, but did not consult mailmap to grab the
316    preferred author name.
317    (merge ea16794 ap/commit-author-mailmap later to maint).
319  * "git ls-files -k" needs to crawl only the part of the working tree
320    that may overlap the paths in the index to find killed files, but
321    shared code with the logic to find all the untracked files, which
322    made it unnecessarily inefficient.
323    (merge 680be04 jc/ls-files-killed-optim later to maint).
325  * The commit object names in the insn sheet that was prepared at the
326    beginning of "rebase -i" session can become ambiguous as the
327    rebasing progresses and the repository gains more commits. Make
328    sure the internal record is kept with full 40-hex object names.
329    (merge 75c6976 es/rebase-i-no-abbrev later to maint).
331  * "git rebase --preserve-merges" internally used the merge machinery
332    and as a side effect, left merge summary message in the log, but
333    when rebasing, there should not be a need for merge summary.
334    (merge a9f739c rt/rebase-p-no-merge-summary later to maint).
336  * A call to xread() was used without a loop around to cope with short
337    read in the codepath to stream new contents to a pack.
338    (merge e92527c js/xread-in-full later to maint).
340  * "git rebase -i" forgot that the comment character can be
341    configurable while reading its insn sheet.
342    (merge 7bca7af es/rebase-i-respect-core-commentchar later to maint).
344  * The mailmap support code read past the allocated buffer when the
345    mailmap file ended with an incomplete line.
346    (merge f972a16 jk/mailmap-incomplete-line later to maint).
348  * We used to send a large request to read(2)/write(2) as a single
349    system call, which was bad from the latency point of view when
350    the operation needs to be killed, and also triggered an error on
351    broken 64-bit systems that refuse to take more than 2GB read or
352    write in one go.
353    (merge a487916 sp/clip-read-write-to-8mb later to maint).
355  * "git fetch" that auto-followed tags incorrectly reused the
356    connection with Git-aware transport helper (like the sample "ext::"
357    helper shipped with Git).
358    (merge 0f73f8b jc/transport-do-not-use-connect-twice-in-fetch later to maint).
360  * "git log --full-diff -- <pathspec>" showed a huge diff for paths
361    outside the given <pathspec> for each commit, instead of showing
362    the change relative to the parent of the commit.  "git reflog -p"
363    had a similar problem.
364    (merge 838f9a1 tr/log-full-diff-keep-true-parents later to maint).
366  * Setting submodule.*.path configuration variable to true (without
367    giving "= value") caused Git to segfault.
368    (merge 4b05440 jl/some-submodule-config-are-not-boolean later to maint).
370  * "git rebase -i" (there could be others, as the root cause is pretty
371    generic) fed a random, data dependeant string to 'echo' and
372    expects it to come out literally, corrupting its error message.
373    (merge 89b0230 mm/no-shell-escape-in-die-message later to maint).
375  * Some people still use rather old versions of bash, which cannot
376    grok some constructs like 'printf -v varname' the prompt and
377    completion code started to use recently.
378    (merge a44aa69 bc/completion-for-bash-3.0 later to maint).
380  * Code to read configuration from a blob object did not compile on
381    platforms with fgetc() etc. implemented as macros.
382    (merge 49d6cfa hv/config-from-blob later to maint-1.8.3).
384  * The recent "short-cut clone connectivity check" topic broke a
385    shallow repository when a fetch operation tries to auto-follow tags.
386    (merge 6da8bdc nd/fetch-pack-shallow-fix later to maint-1.8.3).