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