Documentation/RelNotes-1.5.3.txt

   1 GIT v1.5.3 Release Notes
   2 ========================
   3
   4 Updates since v1.5.2
   5 --------------------
   6
   7 * The commit walkers other than http are officially deprecated,
   8   but still supported for now.
   9
  10 * The submodule support has Porcelain layer.
  11
  12 * There are a handful pack-objects changes to help you cope better
  13   with repositories with pathologically large blobs in them.
  14
  15 * For people who need to import from Perforce, a front-end for
  16   fast-import is in contrib/fast-import/.
  17
  18 * Comes with git-gui 0.8.0.
  19
  20 * Comes with updated gitk.
  21
  22 * New commands and options.
  23
  24   - "git log --date=<format>" can use more formats: iso8601, rfc2822.
  25
  26   - The hunk header output from "git diff" family can be customized
  27     with the attributes mechanism.  See gitattributes(5) for details.
  28
  29   - "git stash" allows you to quickly save away your work in
  30     progress and replay it later on an updated state.
  31
  32   - "git rebase" learned an "interactive" mode that let you
  33     pick and reorder which commits to rebuild.
  34
  35   - "git fsck" can save its findings in $GIT_DIR/lost-found, without a
  36     separate invocation of "git lost-found" command.  The blobs stored by
  37     lost-found are stored in plain format to allow you to grep in them.
  38
  39   - $GIT_WORK_TREE environment variable can be used together with
  40     $GIT_DIR to work in a subdirectory of a working tree that is
  41     not located at "$GIT_DIR/..".
  42
  43   - "git log" learned a new option "--follow", to follow
  44     renaming history of a single file.
  45
  46   - "git-filter-branch" lets you rewrite the revision history of
  47     the current branch, creating a new branch. You can specify a
  48     number of filters to modify the commits, files and trees.
  49
  50   - "git-cvsserver" learned new options (--base-path, --export-all,
  51     --strict-paths) inspired by git-daemon.
  52
  53   - "git-commit" can use "-t templatefile" option and commit.template
  54     configuration variable to prime the commit message given to you in the
  55     editor.
  56
  57   - "git-submodule" command helps you manage the projects from
  58     the superproject that contain them.
  59
  60   - In addition to core.compression configuration option,
  61     core.loosecompression and pack.compression options can
  62     independently tweak zlib compression levels used for loose
  63     and packed objects.
  64
  65   - "git-ls-tree -l" shows size of blobs pointed at by the
  66     tree entries, similar to "/bin/ls -l".
  67
  68   - "git-rev-list" learned --regexp-ignore-case and
  69     --extended-regexp options to tweak its matching logic used
  70     for --grep fitering.
  71
  72   - "git-describe --contains" is a handier way to call more
  73     obscure command "git-name-rev --tags".
  74
  75   - "git gc --aggressive" tells the command to spend more cycles
  76     to optimize the repository harder.
  77
  78   - "git repack" learned a "window-memory" limit which
  79     dynamically reduces the window size to stay within the
  80     specified memory usage.
  81
  82   - "git repack" can be told to split resulting packs to avoid
  83     exceeding limit specified with "--max-pack-size".
  84
  85   - "git fsck" gained --verbose option.  This is really really
  86     verbose but it might help you identify exact commit that is
  87     corrupt in your repository.
  88
  89   - "git format-patch" learned --numbered-files option.  This
  90     may be useful for MH users.
  91
  92   - "git format-patch" learned format.subjectprefix configuration
  93     variable, which serves the same purpose as "--subject-prefix"
  94     option.
  95
  96   - "git tag -n -l" shows tag annotations while listing tags.
  97
  98   - "git cvsimport" can optionally use the separate-remote layout.
  99
 100   - "git blame" can be told to see through commits that change
 101     whitespaces and indentation levels with "-w" option.
 102
 103   - "git send-email" can be told not to thread the messages when
 104     sending out more than one patches.
 105
 106   - "git config" learned NUL terminated output format via -z to
 107     help scripts.
 108
 109   - "git init -q" makes the command quieter.
 110
 111 * Updated behavior of existing commands.
 112
 113   - "gitweb" can offer multiple snapshot formats.
 114
 115     ***NOTE*** Unfortunately, this changes the format of the
 116     $feature{snapshot}{default} entry in the per-site
 117     configuration file 'gitweb_config.perl'.  It used to be a
 118     three-element tuple that describe a single format; with the
 119     new configuration item format, you only have to say the name
 120     of the format ('tgz', 'tbz2' or 'zip').  Please update the
 121     your configuration file accordingly.
 122
 123   - The editor to use with many interactive commands can be
 124     overridden with GIT_EDITOR environment variable, or if it
 125     does not exist, with core.editor configuration variable.  As
 126     before, if you have neither, environment variables VISUAL
 127     and EDITOR are consulted in this order, and then finally we
 128     fall back on "vi".
 129
 130   - "git rm --cached" does not complain when removing a newly
 131     added file from the index anymore.
 132
 133   - Options to "git log" to affect how --grep/--author options look for
 134     given strings now have shorter abbreviations.  -i is for ignore case,
 135     and -E is for extended regexp.
 136
 137   - "git svn dcommit" retains local merge information.
 138
 139   - "git config" to set values also honors type flags like --bool
 140     and --int.
 141
 142   - core.quotepath configuration can be used to make textual git
 143     output to emit most of the characters in the path literally.
 144
 145   - "git mergetool" chooses its backend more wisely, taking
 146     notice of its environment such as use of X, Gnome/KDE, etc.
 147
 148   - "gitweb" shows merge commits a lot nicer than before.  The
 149     default view uses more compact --cc format, while the UI
 150     allows to choose normal diff with any parent.
 151
 152   - snapshot files "gitweb" creates from a repository at
 153     $path/$project/.git are more useful.  We use $project part
 154     in the filename, which we used to discard.
 155
 156   - "git cvsimport" creates lightweight tags; there is no
 157     interesting information we can record in an annotated tag,
 158     and the handcrafted ones the old code created was not
 159     properly formed anyway.
 160
 161   - "git-push" pretends that you immediately fetched back from
 162     the remote by updating corresponding remote tracking
 163     branches if you have any.
 164
 165   - The diffstat given after a merge (or a pull) honors the
 166     color.diff configuration.
 167
 168   - "git-apply --whitespace=strip" removes blank lines added at
 169     the end of the file.
 170
 171   - "git-fetch" over git native protocols with "-v" option shows
 172     connection status, and the IP address of the other end, to
 173     help diagnosing problems.
 174
 175   - We used to have core.legacyheaders configuration, when
 176     set to false, allowed git to write loose objects in a format
 177     that mimicks the format used by objects stored in packs.  It
 178     turns out that this was not so useful.  Although we will
 179     continue to read objects written in that format, we do not
 180     honor that configuration anymore and create loose objects in
 181     the legacy/traditional format.
 182
 183   - "--find-copies-harder" option to diff family can now be
 184     spelled as "-C -C" for brevity.
 185
 186   - "git-mailsplit" (hence "git-am") can read from Maildir
 187     formatted mailboxes.
 188
 189   - "git-cvsserver" does not barf upon seeing "cvs login"
 190     request.
 191
 192   - "pack-objects" honors "delta" attribute set in
 193     .gitattributes.  It does not attempt to deltify blobs that
 194     come from paths with delta attribute set to false.
 195
 196   - "new-workdir" script (in contrib) can now be used with a
 197     bare repository.
 198
 199   - "git-mergetool" learned to use gvimdiff.
 200
 201   - "gitview" (in contrib) has a better blame interface.
 202
 203   - "git log" and friends did not handle a commit log message
 204     that is larger than 16kB; they do now.
 205
 206   - "--pretty=oneline" output format for "git log" and friends
 207     deals with "malformed" commit log messages that have more
 208     than one lines in the first paragraph better.  We used to
 209     show the first line, cutting the title at mid-sentence; we
 210     concatenate them into a single line and treat the result as
 211     "oneline".
 212
 213   - "git p4import" has been demoted to contrib status.  For
 214     a superior option, checkout the git-p4 front end to
 215     git-fast-import (also in contrib).  The man page and p4
 216     rpm have been removed as well.
 217
 218   - "git mailinfo" (hence "am") now tries to see if the message
 219     is in utf-8 first, instead of assuming iso-8859-1, if
 220     incoming e-mail does not say what encoding it is in.
 221
 222 * Builds
 223
 224   - old-style function definitions (most notably, a function
 225     without parameter defined with "func()", not "func(void)")
 226     have been eradicated.
 227
 228 * Performance Tweaks
 229
 230   - git-pack-objects avoids re-deltification cost by caching
 231     small enough delta results it creates while looking for the
 232     best delta candidates.
 233
 234   - git-pack-objects learned a new heuristcs to prefer delta
 235     that is shallower in depth over the smallest delta
 236     possible.  This improves both overall packfile access
 237     performance and packfile density.
 238
 239   - diff-delta code that is used for packing has been improved
 240     to work better on big files.
 241
 242   - when there are more than one pack files in the repository,
 243     the runtime used to try finding an object always from the
 244     newest packfile; it now tries the same packfile as we found
 245     the object requested the last time, which exploits the
 246     locality of references.
 247
 248   - verifying pack contents done by "git fsck --full" got boost
 249     by carefully choosing the order to verify objects in them.
 250
 251
 252 Fixes since v1.5.2
 253 ------------------
 254
 255 All of the fixes in v1.5.2 maintenance series are included in
 256 this release, unless otherwise noted.
 257
 258 * Bugfixes
 259
 260   - "gitweb" had trouble handling non UTF-8 text with older
 261     Encode.pm Perl module.
 262
 263 --
 264 exec >/var/tmp/1
 265 O=v1.5.3-rc3
 266 echo O=`git describe refs/heads/master`
 267 git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint