Merge branch 'jk/shortlog'
[git.git] / Documentation / RelNotes / 2.8.0.txt
blob5d953134aab363007095e0697d63ad6c3e0c9b9d
1 Git 2.8 Release Notes
2 =====================
4 Updates since v2.7
5 ------------------
7 UI, Workflows & Features
9  * "branch --delete" has "branch -d" but "push --delete" does not.
10    (merge 38a2559 ps/push-delete-option later to maint).
12  * "git blame" learned to produce the progress eye-candy when it takes
13    too much time before emitting the first line of the result.
15  * "git grep" can now be configured (or told from the command line)
16    how many threads to use when searching in the working tree files.
18  * Some "git notes" operations, e.g. "git log --notes=<note>", should
19    be able to read notes from any tree-ish that is shaped like a notes
20    tree, but the notes infrastructure required that the argument must
21    be a ref under refs/notes/.  Loosen it to require a valid ref only
22    when the operation would update the notes (in which case we must
23    have a place to store the updated notes tree, iow, a ref).
25  * "git grep" by default does not fall back to its "--no-index"
26    behaviour outside a directory under Git's control (otherwise the
27    user may by mistake end up running a huge recursive search); with a
28    new configuration (set in $HOME/.gitconfig--by definition this
29    cannot be set in the config file per project), this safety can be
30    disabled.
32  * "git pull --rebase" has been extended to allow invoking
33    "rebase -i".
35  * "git p4" learned to cope with the type of a file getting changed.
37  * "git format-patch" learned to notice format.outputDirectory
38    configuration variable.  This allows "-o <dir>" option to be
39    omitted on the command line if you always use the same directory in
40    your workflow.
43 Performance, Internal Implementation, Development Support etc.
45  * Add a framework to spawn a group of processes in parallel, and use
46    it to run "git fetch --recurse-submodules" in parallel.
48  * A slight update to the Makefile to mark "phoney" targets
49    as such correctly.
51  * In-core storage of the reverse index for .pack files (which lets
52    you go from a pack offset to an object name) has been streamlined.
54  * d95138e6 (setup: set env $GIT_WORK_TREE when work tree is set, like
55    $GIT_DIR, 2015-06-26) attempted to work around a glitch in alias
56    handling by overwriting GIT_WORK_TREE environment variable to
57    affect subprocesses when set_git_work_tree() gets called, which
58    resulted in a rather unpleasant regression to "clone" and "init".
59    Try to address the same issue by always restoring the environment
60    and respawning the real underlying command when handling alias.
62  * The low-level code that is used to create symbolic references has
63    been updated to share more code with the code that deals with
64    normal references.
65    (merge 2859dcd jk/symbolic-ref later to maint).
67 Also contains various documentation updates and code clean-ups.
70 Fixes since v2.7
71 ----------------
73 Unless otherwise noted, all the fixes since v2.7 in the maintenance
74 track are contained in this release (see the maintenance releases'
75 notes for details).
77  * An earlier change in 2.5.x-era broke users' hooks and aliases by
78    exporting GIT_WORK_TREE to point at the root of the working tree,
79    interfering when they tried to use a different working tree without
80    setting GIT_WORK_TREE environment themselves.
81    (merge df1e6ea nd/stop-setenv-work-tree later to maint).
83  * The "exclude_list" structure has the usual "alloc, nr" pair of
84    fields to be used by ALLOC_GROW(), but clear_exclude_list() forgot
85    to reset 'alloc' to 0 when it cleared 'nr' to discard the managed
86    array.
87    (merge 2653a8c nd/dir-exclude-cleanup later to maint).
89  * Paths that have been told the index about with "add -N" are not
90    quite yet in the index, but a few commands behaved as if they
91    already are in a harmful way.
92    (merge 4d55200 nd/ita-cleanup later to maint).
94  * "git send-email" was confused by escaped quotes stored in the alias
95    files saved by "mutt", which has been corrected.
96    (merge 2c510f2 ew/send-email-mutt-alias-fix later to maint).
98  * A few unportable C construct have been spotted by clang compiler
99    and have been fixed.
100    (merge a0df2e5 jk/clang-pedantic later to maint).
102  * The documentation has been updated to hint the connection between
103    the '--signoff' option and DCO.
104    (merge b2c150d dw/signoff-doc later to maint).
106  * "git reflog" incorrectly assumed that all objects that used to be
107    at the tip of a ref must be commits, which caused it to segfault.
108    (merge aecad37 dk/reflog-walk-with-non-commit later to maint).
110  * The ignore mechanism saw a few regressions around untracked file
111    listing and sparse checkout selection areas in 2.7.0; the change
112    that is responsible for the regression has been reverted.
113    (merge 8c72236 nd/exclusion-regression-fix later to maint).
115  * Some codepaths used fopen(3) when opening a fixed path in $GIT_DIR
116    (e.g. COMMIT_EDITMSG) that is meant to be left after the command is
117    done.  This however did not work well if the repository is set to
118    be shared with core.sharedRepository and the umask of the previous
119    user is tighter.  They have been made to work better by calling
120    unlink(2) and retrying after fopen(3) fails with EPERM.
121    (merge ea56518 js/fopen-harder later to maint).
123  * Asking gitweb for a nonexistent commit left a warning in the server
124    log.
126    Somebody may want to follow this up with an additional test, perhaps?
127    IIRC, we do test that no Perl warnings are given to the server log,
128    so this should have been caught if our test coverage were good.
129    (merge a9eb90a ho/gitweb-squelch-undef-warning later to maint).
131  * "git rebase", unlike all other callers of "gc --auto", did not
132    ignore the exit code from "gc --auto".
133    (merge 8c24f5b jk/ok-to-fail-gc-auto-in-rebase later to maint).
135  * Many codepaths that run "gc --auto" before exiting kept packfiles
136    mapped and left the file descriptors to them open, which was not
137    friendly to systems that cannot remove files that are open.  They
138    now close the packs before doing so.
139    (merge d562102 js/close-packs-before-gc later to maint).
141  * Other minor clean-ups and documentation updates
142    (merge 99487cf ss/user-manual later to maint).
143    (merge e914ef0 ew/for-each-ref-doc later to maint).
144    (merge 36fc7d8 sg/t6050-failing-editor-test-fix later to maint).
145    (merge 60253a6 ss/clone-depth-single-doc later to maint).