Merge branch 'jc/am-mailinfo-direct'
[git/git.git] / Documentation / RelNotes / 2.7.0.txt
CommitLineData
24a00ef6
JH
1Git 2.7 Release Notes
2=====================
3
4Updates since v2.6
5------------------
6
7UI, Workflows & Features
8
9 * "git remote" learned "get-url" subcommand to show the URL for a
10 given remote name used for fetching and pushing.
11
12 * There was no way to defeat a configured rebase.autostash variable
13 from the command line, as "git rebase --no-autostash" was missing.
14
15 * "git log --date=local" used to only show the normal (default)
16 format in the local timezone. The command learned to take 'local'
17 as an instruction to use the local timezone with other formats,
18
19 * The refs used during a "git bisect" session is now per-worktree so
20 that independent bisect sessions can be done in different worktrees
21 created with "git worktree add".
22
23 * Users who are too busy to type three extra keystrokes to ask for
24 "git stash show -p" can now set stash.showPatch configuration
25 varible to true to always see the actual patch, not just the list
26 of paths affected with feel for the extent of damage via diffstat.
27
28 * "quiltimport" allows to specify the series file by honoring the
29 $QUILT_SERIES environment and also --series command line option.
30
31 * The use of 'good/bad' in "git bisect" made it confusing to use when
32 hunting for a state change that is not a regression (e.g. bugfix).
33 The command learned 'old/new' and then allows the end user to
906c32b9 34 say e.g. "bisect start --term-old=fast --term-new=slow" to find a
24a00ef6
JH
35 performance regression.
36
37 * "git interpret-trailers" can now run outside of a Git repository.
38
f5b60798
JH
39 * "git p4" learned to reencode the pathname it uses to communicate
40 with the p4 depot with a new option.
41
42 * Give progress meter to "git filter-branch".
43
44 * Allow a later "!/abc/def" to override an earlier "/abc" that
45 appears in the same .gitignore file to make it easier to express
46 "everything in /abc directory is ignored, except for ...".
47
a838ae9d
JH
48 * Teach "git p4" to send large blobs outside the repository by
49 talking to Git LFS.
50
37023ba3
JH
51 * Prepare for Git on-disk repository representation to undergo
52 backward incompatible changes by introducing a new repository
53 format version "1", with an extension mechanism.
54 (merge 067fbd4 jk/repository-extension later to maint).
55
56 * "git worktree" learned a "list" subcommand.
57
24a00ef6
JH
58
59Performance, Internal Implementation, Development Support etc.
60
61 * The infrastructure to rewrite "git submodule" in C is being built
62 incrementally. Let's polish these early parts well enough and make
63 them graduate to 'next' and 'master', so that the more involved
64 follow-up can start cooking on a solid ground.
65
66 * Some features from "git tag -l" and "git branch -l" have been made
67 available to "git for-each-ref" so that eventually the unified
37023ba3
JH
68 implementation can be shared across all three. The version merged
69 to the 'master' branch earlier had a performance regression in "tag
70 --contains", which has since been corrected.
24a00ef6
JH
71
72 * Because "test_when_finished" in our test framework queues the
73 clean-up tasks to be done in a shell variable, it should not be
74 used inside a subshell. Add a mechanism to allow 'bash' to catch
75 such uses, and fix the ones that were found.
76 (merge 0968f12 jk/test-lint-forbid-when-finished-in-subshell later to maint).
77
78 * The debugging infrastructure for pkt-line based communication has
79 been improved to mark the side-band communication specifically.
80 (merge fd89433 jk/async-pkt-line later to maint).
81
a838ae9d
JH
82 * Update "git branch" that list existing branches, using the
83 ref-filter API that is shared with "git tag" and "git
84 for-each-ref".
85
bca92e88
JH
86 * The test for various line-ending conversions has been enhanced.
87
88 * A few test scripts around "git p4" have been improved for
89 portability.
90
91 * Many allocations that is manually counted (correctly) that are
92 followed by strcpy/sprintf have been replaced with a less error
93 prone constructs such as xstrfmt.
94
37023ba3
JH
95 * The internal stripspace() function has been moved to where it
96 logically belongs to, i.e. strbuf API, and the command line parser
97 of "git stripspace" has been updated to use the parse_options API.
98 (merge bed4452 tk/stripspace later to maint).
99
24a00ef6
JH
100
101Also contains various documentation updates and code clean-ups.
102
103
104Fixes since v2.6
105----------------
106
107Unless otherwise noted, all the fixes since v2.6 in the maintenance
108track are contained in this release (see the maintenance releases'
109notes for details).
110
111 * Very small number of options take a parameter that is optional
112 (which is not a great UI element as they can only appear at the end
113 of the command line). Add notice to documentation of each and
114 every one of them.
115 (merge 2b594bf mm/keyid-docs later to maint).
116
117 * "git blame --first-parent v1.0..v2.0" was not rejected but did not
118 limit the blame to commits on the first parent chain.
119 (merge 95a4fb0 jk/blame-first-parent later to maint).
120
121 * "git subtree" (in contrib/) now can take whitespaces in the
122 pathnames, not only in the in-tree pathname but the name of the
123 directory that the repository is in. (merge 5b6ab38
124 as/subtree-with-spaces later to maint).
125
126 * The ssh transport, just like any other transport over the network,
127 did not clear GIT_* environment variables, but it is possible to
128 use SendEnv and AcceptEnv to leak them to the remote invocation of
129 Git, which is not a good idea at all. Explicitly clear them just
130 like we do for the local transport.
131 (merge a48b409 jk/connect-clear-env later to maint).
132
133 * Correct "git p4 --detect-labels" so that it does not fail to create
134 a tag that points at a commit that is also being imported.
135 (merge b43702a ld/p4-import-labels later to maint).
136
137 * The Makefile always runs the library archiver with hardcoded "crs"
138 options, which was inconvenient for exotic platforms on which
139 people want to use programs with totally different set of command
140 line options.
141 (merge ac179b4 jw/make-arflags-customizable later to maint).
142
143 * Customization to change the behaviour with "make -w" and "make -s"
144 in our Makefile was broken when they were used together.
145 (merge ef49e05 jk/make-findstring-makeflags-fix later to maint).
146
f5b60798
JH
147 * Allocation related functions and stdio are unsafe things to call
148 inside a signal handler, and indeed killing the pager can cause
149 glibc to deadlock waiting on allocation mutex as our signal handler
150 tries to free() some data structures in wait_for_pager(). Reduce
151 these unsafe calls.
152 (merge 507d780 ti/glibc-stdio-mutex-from-signal-handler later to maint).
153
b27dacc1
JH
154 * The way how --ref/--notes to specify the notes tree reference are
155 DWIMmed was not clearly documented.
156 (merge e14c92e jk/notes-dwim-doc later to maint).
157
a838ae9d
JH
158 * "git gc" used to barf when a symbolic ref has gone dangling
159 (e.g. the branch that used to be your upstream's default when you
160 cloned from it is now gone, and you did "fetch --prune").
161 (merge 14886b4 js/gc-with-stale-symref later to maint).
162
163 * "git clone --dissociate" runs a big "git repack" process at the
164 end, and it helps to close file descriptors that are open on the
165 packs and their idx files before doing so on filesystems that
166 cannot remove a file that is still open.
167 (merge 786b150 js/clone-dissociate later to maint).
168
169 * Description of the "log.follow" configuration variable in "git log"
170 documentation is now also copied to "git config" documentation.
171 (merge fd8d07e dt/log-follow-config later to maint).
172
173 * "git rebase -i" had a minor regression recently, which stopped
174 considering a line that begins with an indented '#' in its insn
175 sheet not a comment, which is now fixed.
176 (merge 1db168e gr/rebase-i-drop-warn later to maint).
177
178 * After "git checkout --detach", "git status" reported a fairly
179 useless "HEAD detached at HEAD", instead of saying at which exact
180 commit.
181 (merge 0eb8548 mm/detach-at-HEAD-reflog later to maint).
182
183 * When "git send-email" wanted to talk over Net::SMTP::SSL,
184 Net::Cmd::datasend() did not like to be fed too many bytes at the
185 same time and failed to send messages. Send the payload one line
186 at a time to work around the problem.
187 (merge f60c483 sa/send-email-smtp-batch-data-limit later to maint).
188
189 * When "git am" was rewritten as a built-in, it stopped paying
190 attention to user.signingkey, which was fixed.
191 (merge 434c64d pt/am-builtin later to maint).
192
193 * It was not possible to use a repository-lookalike created by "git
194 worktree add" as a local source of "git clone".
195 (merge d78db84 nd/clone-linked-checkout later to maint).
196
197 * On a case insensitive filesystems, setting GIT_WORK_TREE variable
198 using a random cases that does not agree with what the filesystem
199 thinks confused Git that it wasn't inside the working tree.
200 (merge 63ec5e1 js/icase-wt-detection later to maint).
201
202 * Performance-measurement tests did not work without an installed Git.
203 (merge 31cd128 sb/perf-without-installed-git later to maint).
204
205 * A test script for the HTTP service had a timing dependent bug,
206 which was fixed.
207 (merge 362d8b6 sb/http-flaky-test-fix later to maint).
208
209 * There were some classes of errors that "git fsck" diagnosed to its
210 standard error that did not cause it to exit with non-zero status.
211 (merge 122f76f jc/fsck-dropped-errors later to maint).
212
213 * Work around "git p4" failing when the P4 depot records the contents
214 in UTF-16 without UTF-16 BOM.
215 (merge 1f5f390 ls/p4-translation-failure later to maint).
216
217 * When "git gc --auto" is backgrounded, its diagnosis message is
218 lost. Save it to a file in $GIT_DIR and show it next time the "gc
219 --auto" is run.
220 (merge 329e6e8 nd/gc-auto-background-fix later to maint).
221
222 * The submodule code has been taught to work better with separate
223 work trees created via "git worktree add".
224 (merge 11f9dd7 mk/submodule-gitdir-path later to maint).
225
906c32b9
JH
226 * "git gc" is safe to run anytime only because it has the built-in
227 grace period to protect young objects. In order to run with no
228 grace period, the user must make sure that the repository is
229 quiescent.
230 (merge fae1a90 jc/doc-gc-prune-now later to maint).
231
232 * A recent "filter-branch --msg-filter" broke skipping of the commit
233 object header, which is fixed.
234 (merge a5a4b3f jk/filter-branch-use-of-sed-on-incomplete-line later to maint).
235
236 * The normalize_ceiling_entry() function does not muck with the end
237 of the path it accepts, and the real world callers do rely on that,
238 but a test insisted that the function drops a trailing slash.
239 (merge b2a7123 rd/test-path-utils later to maint).
240
37023ba3
JH
241 * A test for interaction between untracked cache and sparse checkout
242 added in Git 2.5 days were flaky.
243 (merge 9b680fb dt/t7063-fix-flaky-test later to maint).
244
245 * A couple of commands still showed "[options]" in their usage string
246 to note where options should come on their command line, but we
247 spell that "[<options>]" in most places these days.
248 (merge d96a031 rt/placeholder-in-usage later to maint).
249
250 * The synopsis text and the usage string of subcommands that read
251 list of things from the standard input are often shown as if they
252 only take input from a file on a filesystem, which was misleading.
253 (merge 33e8fc8 jc/usage-stdin later to maint).
254
255 * "git am -3" had a small regression where it is aborted in its error
256 handling codepath when underlying merge-recursive failed in certain
257 ways, as it assumed that the internal call to merge-recursive will
258 never die, which is not the case (yet).
259 (merge c63d4b2 jc/am-3-fallback-regression-fix later to maint).
260
24a00ef6
JH
261 * Code clean-up and minor fixes.
262 (merge 15ed07d jc/rerere later to maint).
bca92e88 263 (merge e7a7401 pt/pull-builtin later to maint).
b27dacc1
JH
264 (merge 29bc480 nd/ls-remote-does-not-have-u-option later to maint).
265 (merge be510e0 jk/asciidoctor-section-heading-markup-fix later to maint).
266 (merge 83e6bda tk/typofix-connect-unknown-proto-error later to maint).
a838ae9d
JH
267 (merge a43eb67 tk/doc-interpret-trailers-grammo later to maint).
268 (merge ba128e2 es/worktree-add-cleanup later to maint).
269 (merge 44cd91e cc/quote-comments later to maint).
906c32b9 270 (merge 147875f sb/submodule-config-parse later to maint).
37023ba3 271 (merge ae9f274 es/worktree-add later to maint).