Merge branch 'jk/filter-branch-use-of-sed-on-incomplete-line'
[git] / Documentation / RelNotes / 2.7.0.txt
1 Git 2.7 Release Notes
2 =====================
3
4 Updates since v2.6
5 ------------------
6
7 UI, 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
34    say e.g. "bisect start --term-old=fast --term=new=slow" to find a
35    performance regression.
36
37  * "git interpret-trailers" can now run outside of a Git repository.
38
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
48  * Teach "git p4" to send large blobs outside the repository by
49    talking to Git LFS.
50
51
52 Performance, Internal Implementation, Development Support etc.
53
54  * The infrastructure to rewrite "git submodule" in C is being built
55    incrementally.  Let's polish these early parts well enough and make
56    them graduate to 'next' and 'master', so that the more involved
57    follow-up can start cooking on a solid ground.
58
59  * Some features from "git tag -l" and "git branch -l" have been made
60    available to "git for-each-ref" so that eventually the unified
61    implementation can be shared across all three.
62
63  * Because "test_when_finished" in our test framework queues the
64    clean-up tasks to be done in a shell variable, it should not be
65    used inside a subshell.  Add a mechanism to allow 'bash' to catch
66    such uses, and fix the ones that were found.
67    (merge 0968f12 jk/test-lint-forbid-when-finished-in-subshell later to maint).
68
69  * The debugging infrastructure for pkt-line based communication has
70    been improved to mark the side-band communication specifically.
71    (merge fd89433 jk/async-pkt-line later to maint).
72
73  * Update "git branch" that list existing branches, using the
74    ref-filter API that is shared with "git tag" and "git
75    for-each-ref".
76
77
78 Also contains various documentation updates and code clean-ups.
79
80
81 Fixes since v2.6
82 ----------------
83
84 Unless otherwise noted, all the fixes since v2.6 in the maintenance
85 track are contained in this release (see the maintenance releases'
86 notes for details).
87
88  * Very small number of options take a parameter that is optional
89    (which is not a great UI element as they can only appear at the end
90    of the command line).  Add notice to documentation of each and
91    every one of them.
92    (merge 2b594bf mm/keyid-docs later to maint).
93
94  * "git blame --first-parent v1.0..v2.0" was not rejected but did not
95    limit the blame to commits on the first parent chain.
96    (merge 95a4fb0 jk/blame-first-parent later to maint).
97
98  * "git subtree" (in contrib/) now can take whitespaces in the
99    pathnames, not only in the in-tree pathname but the name of the
100    directory that the repository is in.  (merge 5b6ab38
101    as/subtree-with-spaces later to maint).
102
103  * The ssh transport, just like any other transport over the network,
104    did not clear GIT_* environment variables, but it is possible to
105    use SendEnv and AcceptEnv to leak them to the remote invocation of
106    Git, which is not a good idea at all.  Explicitly clear them just
107    like we do for the local transport.
108    (merge a48b409 jk/connect-clear-env later to maint).
109
110  * Correct "git p4 --detect-labels" so that it does not fail to create
111    a tag that points at a commit that is also being imported.
112    (merge b43702a ld/p4-import-labels later to maint).
113
114  * The Makefile always runs the library archiver with hardcoded "crs"
115    options, which was inconvenient for exotic platforms on which
116    people want to use programs with totally different set of command
117    line options.
118    (merge ac179b4 jw/make-arflags-customizable later to maint).
119
120  * Customization to change the behaviour with "make -w" and "make -s"
121    in our Makefile was broken when they were used together.
122    (merge ef49e05 jk/make-findstring-makeflags-fix later to maint).
123
124  * Allocation related functions and stdio are unsafe things to call
125    inside a signal handler, and indeed killing the pager can cause
126    glibc to deadlock waiting on allocation mutex as our signal handler
127    tries to free() some data structures in wait_for_pager().  Reduce
128    these unsafe calls.
129    (merge 507d780 ti/glibc-stdio-mutex-from-signal-handler later to maint).
130
131  * The way how --ref/--notes to specify the notes tree reference are
132    DWIMmed was not clearly documented.
133    (merge e14c92e jk/notes-dwim-doc later to maint).
134
135  * "git gc" used to barf when a symbolic ref has gone dangling
136    (e.g. the branch that used to be your upstream's default when you
137    cloned from it is now gone, and you did "fetch --prune").
138    (merge 14886b4 js/gc-with-stale-symref later to maint).
139
140  * "git clone --dissociate" runs a big "git repack" process at the
141    end, and it helps to close file descriptors that are open on the
142    packs and their idx files before doing so on filesystems that
143    cannot remove a file that is still open.
144    (merge 786b150 js/clone-dissociate later to maint).
145
146  * Description of the "log.follow" configuration variable in "git log"
147    documentation is now also copied to "git config" documentation.
148    (merge fd8d07e dt/log-follow-config later to maint).
149
150  * "git rebase -i" had a minor regression recently, which stopped
151    considering a line that begins with an indented '#' in its insn
152    sheet not a comment, which is now fixed.
153    (merge 1db168e gr/rebase-i-drop-warn later to maint).
154
155  * After "git checkout --detach", "git status" reported a fairly
156    useless "HEAD detached at HEAD", instead of saying at which exact
157    commit.
158    (merge 0eb8548 mm/detach-at-HEAD-reflog later to maint).
159
160  * When "git send-email" wanted to talk over Net::SMTP::SSL,
161    Net::Cmd::datasend() did not like to be fed too many bytes at the
162    same time and failed to send messages.  Send the payload one line
163    at a time to work around the problem.
164    (merge f60c483 sa/send-email-smtp-batch-data-limit later to maint).
165
166  * When "git am" was rewritten as a built-in, it stopped paying
167    attention to user.signingkey, which was fixed.
168    (merge 434c64d pt/am-builtin later to maint).
169
170  * It was not possible to use a repository-lookalike created by "git
171    worktree add" as a local source of "git clone".
172    (merge d78db84 nd/clone-linked-checkout later to maint).
173
174  * On a case insensitive filesystems, setting GIT_WORK_TREE variable
175    using a random cases that does not agree with what the filesystem
176    thinks confused Git that it wasn't inside the working tree.
177    (merge 63ec5e1 js/icase-wt-detection later to maint).
178
179  * Performance-measurement tests did not work without an installed Git.
180    (merge 31cd128 sb/perf-without-installed-git later to maint).
181
182  * A test script for the HTTP service had a timing dependent bug,
183    which was fixed.
184    (merge 362d8b6 sb/http-flaky-test-fix later to maint).
185
186  * There were some classes of errors that "git fsck" diagnosed to its
187    standard error that did not cause it to exit with non-zero status.
188    (merge 122f76f jc/fsck-dropped-errors later to maint).
189
190  * Work around "git p4" failing when the P4 depot records the contents
191    in UTF-16 without UTF-16 BOM.
192    (merge 1f5f390 ls/p4-translation-failure later to maint).
193
194  * When "git gc --auto" is backgrounded, its diagnosis message is
195    lost.  Save it to a file in $GIT_DIR and show it next time the "gc
196    --auto" is run.
197    (merge 329e6e8 nd/gc-auto-background-fix later to maint).
198
199  * The submodule code has been taught to work better with separate
200    work trees created via "git worktree add".
201    (merge 11f9dd7 mk/submodule-gitdir-path later to maint).
202
203  * Code clean-up and minor fixes.
204    (merge 15ed07d jc/rerere later to maint).
205    (merge b744767 pt/pull-builtin later to maint).
206    (merge 29bc480 nd/ls-remote-does-not-have-u-option later to maint).
207    (merge be510e0 jk/asciidoctor-section-heading-markup-fix later to maint).
208    (merge 83e6bda tk/typofix-connect-unknown-proto-error later to maint).
209    (merge a43eb67 tk/doc-interpret-trailers-grammo later to maint).
210    (merge ba128e2 es/worktree-add-cleanup later to maint).
211    (merge 44cd91e cc/quote-comments later to maint).