| blob | 21bb1fc6f2d1dfdb0231ba7381f0ade1ecb66c49 |
1 GIT v1.5.3 Release Notes
2 ========================
4 Updates since v1.5.2
5 --------------------
7 * The commit walkers other than http are officially deprecated,
8 but still supported for now.
10 * The submodule support has Porcelain layer.
12 * There are a handful pack-objects changes to help you cope better
13 with repositories with pathologically large blobs in them.
15 * For people who need to import from Perforce, a front-end for
16 fast-import is in contrib/fast-import/.
18 * Comes with git-gui 0.8.0.
20 * Comes with updated gitk.
22 * New commands and options.
24 - "git log --date=<format>" can use more formats: iso8601, rfc2822.
26 - The hunk header output from "git diff" family can be customized
27 with the attributes mechanism. See gitattributes(5) for details.
29 - "git stash" allows you to quickly save away your work in
30 progress and replay it later on an updated state.
32 - "git rebase" learned an "interactive" mode that let you
33 pick and reorder which commits to rebuild.
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.
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/..".
43 - Giving "--file=<file>" option to "git config" is the same as
44 running the command with GIT_CONFIG=<file> environment.
46 - "git log" learned a new option "--follow", to follow
47 renaming history of a single file.
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.
53 - "git-cvsserver" learned new options (--base-path, --export-all,
54 --strict-paths) inspired by git-daemon.
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.
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.
63 - "git-submodule" command helps you manage the projects from
64 the superproject that contain them.
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.
71 - "git-ls-tree -l" shows size of blobs pointed at by the
72 tree entries, similar to "/bin/ls -l".
74 - "git-rev-list" learned --regexp-ignore-case and
75 --extended-regexp options to tweak its matching logic used
76 for --grep fitering.
78 - "git-describe --contains" is a handier way to call more
79 obscure command "git-name-rev --tags".
81 - "git gc --aggressive" tells the command to spend more cycles
82 to optimize the repository harder.
84 - "git repack" learned a "window-memory" limit which
85 dynamically reduces the window size to stay within the
86 specified memory usage.
88 - "git repack" can be told to split resulting packs to avoid
89 exceeding limit specified with "--max-pack-size".
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.
95 - "git format-patch" learned --numbered-files option. This
96 may be useful for MH users.
98 - "git format-patch" learned format.subjectprefix configuration
99 variable, which serves the same purpose as "--subject-prefix"
100 option.
102 - "git tag -n -l" shows tag annotations while listing tags.
104 - "git cvsimport" can optionally use the separate-remote layout.
106 - "git blame" can be told to see through commits that change
107 whitespaces and indentation levels with "-w" option.
109 - "git send-email" can be told not to thread the messages when
110 sending out more than one patches.
112 - "git config" learned NUL terminated output format via -z to
113 help scripts.
115 - "git init -q" makes the command quieter.
117 * Updated behavior of existing commands.
119 - "gitweb" can offer multiple snapshot formats.
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.
129 - "git diff" (but not the plumbing level "git diff-tree") now
130 recursively descends into trees by default.
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".
139 - "git rm --cached" does not complain when removing a newly
140 added file from the index anymore.
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.
146 - "git svn dcommit" retains local merge information.
148 - "git config" to set values also honors type flags like --bool
149 and --int.
151 - core.quotepath configuration can be used to make textual git
152 output to emit most of the characters in the path literally.
154 - "git mergetool" chooses its backend more wisely, taking
155 notice of its environment such as use of X, Gnome/KDE, etc.
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.
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.
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.
170 - "git-push" pretends that you immediately fetched back from
171 the remote by updating corresponding remote tracking
172 branches if you have any.
174 - The diffstat given after a merge (or a pull) honors the
175 color.diff configuration.
177 - "git commit --amend" is now compatible with various message source
178 options such as -m/-C/-c/-F.
180 - "git-apply --whitespace=strip" removes blank lines added at
181 the end of the file.
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.
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.
195 - "--find-copies-harder" option to diff family can now be
196 spelled as "-C -C" for brevity.
198 - "git-mailsplit" (hence "git-am") can read from Maildir
199 formatted mailboxes.
201 - "git-cvsserver" does not barf upon seeing "cvs login"
202 request.
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.
208 - "new-workdir" script (in contrib) can now be used with a
209 bare repository.
211 - "git-mergetool" learned to use gvimdiff.
213 - "gitview" (in contrib) has a better blame interface.
215 - "git log" and friends did not handle a commit log message
216 that is larger than 16kB; they do now.
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".
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.
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.
234 * Builds
236 - old-style function definitions (most notably, a function
237 without parameter defined with "func()", not "func(void)")
238 have been eradicated.
240 * Performance Tweaks
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.
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.
251 - diff-delta code that is used for packing has been improved
252 to work better on big files.
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.
260 - verifying pack contents done by "git fsck --full" got boost
261 by carefully choosing the order to verify objects in them.
264 Fixes since v1.5.2
265 ------------------
267 All of the fixes in v1.5.2 maintenance series are included in
268 this release, unless otherwise noted.
270 * Bugfixes
272 - "gitweb" had trouble handling non UTF-8 text with older
273 Encode.pm Perl module.
275 --
276 exec >/var/tmp/1
277 O=v1.5.3-rc4
278 echo O=`git describe refs/heads/master`
279 git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint