Documentation / RelNotes-1.5.3.txton commit Do not check if getcwd() result begins with a slash. (f66a4d6)
   1GIT v1.5.3 Release Notes
   2========================
   3
   4Updates 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 stash" allows you to quickly save away your work in
  25    progress and replay it later on an updated state.
  26
  27  - "git rebase" learned an "interactive" mode that let you
  28    pick and reorder which commits to rebuild.
  29
  30  - "git fsck" can save its findings in $GIT_DIR/lost-found,
  31    without a separate invocation of "git lost-found" command.
  32
  33  - $GIT_WORK_TREE environment variable can be used together with
  34    $GIT_DIR to work in a subdirectory of a working tree that is
  35    not located at "$GIT_DIR/..".
  36
  37  - "git log" learned a new option "--follow", to follow
  38    renaming history of a single file.
  39
  40  - "git-filter-branch" lets you rewrite the revision history of
  41    the current branch, creating a new branch. You can specify a
  42    number of filters to modify the commits, files and trees.
  43
  44  - "git-cvsserver" learned new options (--base-path, --export-all,
  45    --strict-paths) inspired by git-daemon.
  46
  47  - "git-submodule" command helps you manage the projects from
  48    the superproject that contain them.
  49
  50  - In addition to core.compression configuration option,
  51    core.loosecompression and pack.compression options can
  52    independently tweak zlib compression levels used for loose
  53    and packed objects.
  54
  55  - "git-ls-tree -l" shows size of blobs pointed at by the
  56    tree entries, similar to "/bin/ls -l".
  57
  58  - "git-rev-list" learned --regexp-ignore-case and
  59    --extended-regexp options to tweak its matching logic used
  60    for --grep fitering.
  61
  62  - "git-describe --contains" is a handier way to call more
  63    obscure command "git-name-rev --tags".
  64
  65  - "git gc --aggressive" tells the command to spend more cycles
  66    to optimize the repository harder.
  67
  68  - "git repack" can be told to split resulting packs to avoid
  69    exceeding limit specified with "--max-pack-size".
  70
  71  - "git fsck" gained --verbose option.  This is really really
  72    verbose but it might help you identify exact commit that is
  73    corrupt in your repository.
  74
  75  - "git format-patch" learned --numbered-files option.  This
  76    may be useful for MH users.
  77
  78  - "git format-patch" learned format.subjectprefix configuration
  79    variable, which serves the same purpose as "--subject-prefix"
  80    option.
  81
  82  - "git tag -n -l" shows tag annotations while listing tags.
  83
  84  - "git cvsimport" can optionally use the separate-remote layout.
  85
  86  - "git blame" can be told to see through commits that change
  87    whitespaces and indentation levels with "-w" option.
  88
  89  - "git send-email" can be told not to thread the messages when
  90    sending out more than one patches.
  91
  92  - "git config" learned NUL terminated output format via -z to
  93    help scripts.
  94
  95  - "git init -q" makes the command quieter.
  96
  97* Updated behavior of existing commands.
  98
  99  - "git svn dcommit" retains local merge information.
 100
 101  - "git config" to set values also honors type flags like --bool
 102    and --int.
 103
 104  - core.quotepath configuration can be used to make textual git
 105    output to emit most of the characters in the path literally.
 106
 107  - "git mergetool" chooses its backend more wisely, taking
 108    notice of its environment such as use of X, Gnome/KDE, etc.
 109
 110  - "gitweb" shows merge commits a lot nicer than before.  The
 111    default view uses more compact --cc format, while the UI
 112    allows to choose normal diff with any parent.
 113
 114  - snapshot files "gitweb" creates from a repository at
 115    $path/$project/.git are more useful.  We use $project part
 116    in the filename, which we used to discard.
 117
 118  - "git cvsimport" creates lightweight tags; there is no
 119    interesting information we can record in an annotated tag,
 120    and the handcrafted ones the old code created was not
 121    properly formed anyway.
 122
 123  - "git-push" pretends that you immediately fetched back from
 124    the remote by updating corresponding remote tracking
 125    branches if you have any.
 126
 127  - The diffstat given after a merge (or a pull) honors the
 128    color.diff configuration.
 129
 130  - "git-apply --whitespace=strip" removes blank lines added at
 131    the end of the file.
 132
 133  - "git-fetch" over git native protocols with "-v" option shows
 134    connection status, and the IP address of the other end, to
 135    help diagnosing problems.
 136
 137  - We used to have core.legacyheaders configuration, when
 138    set to false, allowed git to write loose objects in a format
 139    that mimicks the format used by objects stored in packs.  It
 140    turns out that this was not so useful.  Although we will
 141    continue to read objects written in that format, we do not
 142    honor that configuration anymore and create loose objects in
 143    the legacy/traditional format.
 144
 145  - "--find-copies-harder" option to diff family can now be
 146    spelled as "-C -C" for brevity.
 147
 148  - "git-mailsplit" (hence "git-am") can read from Maildir
 149    formatted mailboxes.
 150
 151  - "git-cvsserver" does not barf upon seeing "cvs login"
 152    request.
 153
 154  - "pack-objects" honors "delta" attribute set in
 155    .gitattributes.  It does not attempt to deltify blobs that
 156    come from paths with delta attribute set to false.
 157
 158  - "new-workdir" script (in contrib) can now be used with a
 159    bare repository.
 160
 161  - "git-mergetool" learned to use gvimdiff.
 162
 163  - "gitview" (in contrib) has a better blame interface.
 164
 165  - "git log" and friends did not handle a commit log message
 166    that is larger than 16kB; they do now.
 167
 168  - "--pretty=oneline" output format for "git log" and friends
 169    deals with "malformed" commit log messages that have more
 170    than one lines in the first paragraph better.  We used to
 171    show the first line, cutting the title at mid-sentence; we
 172    concatenate them into a single line and treat the result as
 173    "oneline".
 174
 175* Builds
 176
 177  - old-style function definitions (most notably, a function
 178    without parameter defined with "func()", not "func(void)")
 179    have been eradicated.
 180
 181* Performance Tweaks
 182
 183  - git-pack-objects avoids re-deltification cost by caching
 184    small enough delta results it creates while looking for the
 185    best delta candidates.
 186
 187  - diff-delta code that is used for packing has been improved
 188    to work better on big files.
 189
 190  - when there are more than one pack files in the repository,
 191    the runtime used to try finding an object always from the
 192    newest packfile; it now tries the same packfile as we found
 193    the object requested the last time, which exploits the
 194    locality of references.
 195
 196  - verifying pack contents done by "git fsck --full" got boost
 197    by carefully choosing the order to verify objects in them.
 198
 199
 200Fixes since v1.5.2
 201------------------
 202
 203All of the fixes in v1.5.2 maintenance series are included in
 204this release, unless otherwise noted.
 205
 206* Bugfixes
 207
 208  - "gitweb" had trouble handling non UTF-8 text with older
 209    Encode.pm Perl module.
 210
 211--
 212exec >/var/tmp/1
 213O=v1.5.3-rc0
 214echo O=`git describe refs/heads/master`
 215git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint