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 - "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 252Fixes since v1.5.2 253------------------ 254 255All of the fixes in v1.5.2 maintenance series are included in 256this 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-- 264exec >/var/tmp/1 265O=v1.5.3-rc3 266echo O=`git describe refs/heads/master` 267git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint