Documentation / RelNotes / 1.7.10.txton commit Update draft release notes to 1.7.10 (42e52e3)
   1Git v1.7.10 Release Notes
   2=========================
   3
   4Compatibility Notes
   5-------------------
   6
   7 * From this release on, the "git merge" command in an interactive
   8   session will start an editor when it automatically resolves the
   9   merge for the user to explain the resulting commit, just like the
  10   "git commit" command does when it wasn't given a commit message.
  11
  12   If you have a script that runs "git merge" and keeps its standard
  13   input and output attached to the user's terminal, and if you do not
  14   want the user to explain the resulting merge commits, you can
  15   export GIT_MERGE_AUTOEDIT environment variable set to "no", like
  16   this:
  17
  18        #!/bin/sh
  19        GIT_MERGE_AUTOEDIT=no
  20        export GIT_MERGE_AUTOEDIT
  21
  22   to disable this behaviour (if you want your users to explain their
  23   merge commits, you do not have to do anything).  Alternatively, you
  24   can give the "--no-edit" option to individual invocations of the
  25   "git merge" command if you know everybody who uses your script has
  26   Git v1.7.8 or newer.
  27
  28
  29Updates since v1.7.9
  30--------------------
  31
  32UI, Workflows & Features
  33
  34 * Teams for localizing the messages from the Porcelain layer of
  35   commands are starting to form, thanks to Jiang Xin who volunteered
  36   to be the localization coordinator.  An initial set of translated
  37   messages for simplified chinese is available.
  38
  39 * The configuration mechanism learned an "include" facility; an
  40   assignment to the include.path pseudo-variable causes the named
  41   file to be included in-place when Git looks up configuration
  42   variables.
  43
  44 * A content filter (clean/smudge) used to be just a way to make the
  45   recorded contents "more useful", and allowed to fail; a filter can
  46   now optionally be marked as "required".
  47
  48 * Options whose names begin with "--no-" (e.g. the "--no-verify"
  49   option of the "git commit" command) can be negated by omitting
  50   "no-" from its name, e.g. "git commit --verify".
  51
  52 * "git am" learned to pass "-b" option to underlying "git mailinfo", so
  53   that a bracketed string other than "PATCH" at the beginning can be kept.
  54
  55 * "git clone" learned "--single-branch" option to limit cloning to a
  56   single branch (surprise!); tags that do not point into the history
  57   of the branch are not fetched.
  58
  59 * "git clone" learned to detach the HEAD in the resulting repository
  60   when the user specifies a tag with "--branch" (e.g., "--branch=v1.0").
  61   Clone also learned to print the usual "detached HEAD" advice in such
  62   a case, similar to "git checkout v1.0".
  63
  64 * When showing a patch while ignoring whitespace changes, the context
  65   lines are taken from the postimage, in order to make it easier to
  66   view the output.
  67
  68 * "git diff --stat" learned to adjust the width of the output on
  69   wider terminals, and give more columns to pathnames as needed.
  70
  71 * "diff-highlight" filter (in contrib/) was updated to produce more
  72   aesthetically pleasing output.
  73
  74 * "fsck" learned "--no-dangling" option to omit dangling object
  75   information.
  76
  77 * "git log -G" and "git log -S" learned to pay attention to the "-i"
  78   option.  With "-i", "log -G" ignores the case when finding patch
  79   hunks that introduce or remove a string that matches the given
  80   pattern.  Similarly with "-i", "log -S" ignores the case when
  81   finding the commit the given block of text appears or disappears
  82   from the file.
  83
  84 * "git merge" in an interactive session learned to spawn the editor
  85   by default to let the user edit the auto-generated merge message,
  86   to encourage people to explain their merges better. Legacy scripts
  87   can export GIT_MERGE_AUTOEDIT=no to retain the historical behavior.
  88   Both "git merge" and "git pull" can be given --no-edit from the
  89   command line to accept the auto-generated merge message.
  90
  91 * The advice message given when the user didn't give enough clue on
  92   what to merge to "git pull" and "git merge" has been updated to
  93   be more concise and easier to understand.
  94
  95 * "git push" learned the "--prune" option, similar to "git fetch".
  96
  97 * The whole directory that houses a top-level superproject managed by
  98   "git submodule" can be moved to another place.
  99
 100 * "git symbolic-ref" learned the "--short" option to abbreviate the
 101   refname it shows unambiguously.
 102
 103 * "git tag --list" can be given "--points-at <object>" to limit its
 104   output to those that point at the given object.
 105
 106 * "gitweb" allows intermediate entries in the directory hierarchy
 107   that leads to a project to be clicked, which in turn shows the
 108   list of projects inside that directory.
 109
 110 * "gitweb" learned to read various pieces of information for the
 111   repositories lazily, instead of reading everything that could be
 112   needed (including the ones that are not necessary for a specific
 113   task).
 114
 115 * Project search in "gitweb" shows the substring that matched in the
 116   project name and description highlighted.
 117
 118Foreign Interface
 119
 120 * Improved handling of views, labels and branches in "git-p4" (in contrib).
 121
 122 * "git-p4" (in contrib) suffered from unnecessary merge conflicts when
 123   p4 expanded the embedded $RCS$-like keywords; it can be now told to
 124   unexpand them.
 125
 126 * Some "git-svn" updates.
 127
 128 * "vcs-svn"/"svn-fe" learned to read dumps with svn-deltas and
 129   support incremental imports.
 130
 131 * "git difftool/mergetool" learned to drive DeltaWalker.
 132
 133Performance
 134
 135 * Unnecessary calls to parse_object() "git upload-pack" makes in
 136   response to "git fetch", have been eliminated, to help performance
 137   in repositories with excessive number of refs.
 138
 139Internal Implementation (please report possible regressions)
 140
 141 * Recursive call chains in "git index-pack" to deal with long delta
 142   chains have been flattened, to reduce the stack footprint.
 143
 144 * Use of add_extra_ref() API is now gone, to make it possible to
 145   cleanly restructure the overall refs API.
 146
 147 * The command line parser of "git pack-objects" now uses parse-options
 148   API.
 149
 150 * The test suite supports the new "test_pause" helper function.
 151
 152 * Parallel to the test suite, there is a beginning of performance
 153   benchmarking framework.
 154
 155 * t/Makefile is adjusted to prevent newer versions of GNU make from
 156   running tests in seemingly random order.
 157
 158 * The code to check if a path points at a file beyond a symbolic link
 159   has been restructured to be thread-safe.
 160
 161 * When pruning directories that has become empty during "git prune"
 162   and "git prune-packed", call closedir() that iterates over a
 163   directory before rmdir() it.
 164
 165Also contains minor documentation updates and code clean-ups.
 166
 167
 168Fixes since v1.7.9
 169------------------
 170
 171Unless otherwise noted, all the fixes since v1.7.9 in the maintenance
 172releases are contained in this release (see release notes to them for
 173details).
 174
 175 * "git bundle" did not record boundary commits correctly when there
 176   are many of them.
 177   (merge efe4be1 tr/maint-bundle-boundary later to maint).
 178
 179 * "git diff-index" and its friends at the plumbing level showed the
 180   "diff --git" header and nothing else for a path whose cached stat
 181   info is dirty without actual difference when asked to produce a
 182   patch. This was a longstanding bug that we could have fixed long
 183   time ago.
 184   (merge b3f01ff jc/maint-diff-patch-header later to maint).
 185
 186 * The code to synthesize the fake ancestor tree used by 3-way merge
 187   fallback in "git am" was not prepared to read a patch created with
 188   a non-standard -p<num> value.
 189   (merge a61ba26 jc/am-3-nonstandard-popt later to maint).
 190
 191 * "gitweb" used to drop warnings in the log file when "heads" view is
 192   accessed in a repository whose HEAD does not point at a valid
 193   branch.
 194
 195 * "gitweb" did use quotemeta() to prepare search string when asked to
 196   do a fixed-string project search, but did not use it by mistake and
 197   used the user-supplied string instead.
 198   (merge e65ceb6 jn/maint-do-not-match-with-unsanitized-searchtext later to maint).
 199
 200---
 201exec >/var/tmp/1
 202O=v1.7.10-rc0-15-g9a4c97e
 203echo O=$(git describe)
 204git log --first-parent --oneline ^maint $O..
 205echo
 206git shortlog --no-merges ^maint $O..