blob: 51ff53b370d909be01af8d264919b22195f4b8c1 [file] [log] [blame]
Junio C Hamano401939f2007-07-01 06:34:301GIT v1.5.3 Release Notes
Junio C Hamano38b693c2007-06-03 08:40:142========================
3
4Updates since v1.5.2
5--------------------
6
Junio C Hamanobb0f4042007-07-04 06:41:407* The commit walkers other than http are officially deprecated,
8 but still supported for now.
Junio C Hamano38b693c2007-06-03 08:40:149
Junio C Hamanobb0f4042007-07-04 06:41:4010* The submodule support has Porcelain layer.
11
Junio C Hamanof7b9ebd2007-08-15 08:14:2312 Note that the current submodule support is minimal and this is
13 deliberately so. A design decision we made is that operations
14 at the supermodule level do not recurse into submodules by
15 default. The expectation is that later we would add a
16 mechanism to tell git which submodules the user is interested
17 in, and this information might be used to determine the
18 recursive behaviour of certain commands (e.g. "git checkout"
19 and "git diff"), but currently we haven't agreed on what that
20 mechanism should look like. Therefore, if you use submodules,
21 you would probably need "git submodule update" on the
22 submodules you care about after running a "git checkout" at
23 the supermodule level.
24
Junio C Hamanobb0f4042007-07-04 06:41:4025* There are a handful pack-objects changes to help you cope better
26 with repositories with pathologically large blobs in them.
Junio C Hamano38b693c2007-06-03 08:40:1427
Junio C Hamano401939f2007-07-01 06:34:3028* For people who need to import from Perforce, a front-end for
Junio C Hamanobb0f4042007-07-04 06:41:4029 fast-import is in contrib/fast-import/.
Junio C Hamano401939f2007-07-01 06:34:3030
Junio C Hamanoe03e9892007-08-27 00:56:3331* Comes with git-gui 0.8.2.
Junio C Hamano401939f2007-07-01 06:34:3032
33* Comes with updated gitk.
34
Junio C Hamano38b693c2007-06-03 08:40:1435* New commands and options.
36
Junio C Hamanod81c5d32007-07-16 00:06:1237 - "git log --date=<format>" can use more formats: iso8601, rfc2822.
38
Junio C Hamano235d53f2007-07-13 00:25:1539 - The hunk header output from "git diff" family can be customized
40 with the attributes mechanism. See gitattributes(5) for details.
41
Junio C Hamanobb0f4042007-07-04 06:41:4042 - "git stash" allows you to quickly save away your work in
43 progress and replay it later on an updated state.
44
45 - "git rebase" learned an "interactive" mode that let you
46 pick and reorder which commits to rebuild.
47
Junio C Hamanoa3770f92007-07-25 08:53:3348 - "git fsck" can save its findings in $GIT_DIR/lost-found, without a
49 separate invocation of "git lost-found" command. The blobs stored by
50 lost-found are stored in plain format to allow you to grep in them.
Junio C Hamanobb0f4042007-07-04 06:41:4051
52 - $GIT_WORK_TREE environment variable can be used together with
53 $GIT_DIR to work in a subdirectory of a working tree that is
54 not located at "$GIT_DIR/..".
55
Junio C Hamano092f5f02007-08-02 07:23:3856 - Giving "--file=<file>" option to "git config" is the same as
57 running the command with GIT_CONFIG=<file> environment.
58
Junio C Hamanobb0f4042007-07-04 06:41:4059 - "git log" learned a new option "--follow", to follow
Junio C Hamano401939f2007-07-01 06:34:3060 renaming history of a single file.
61
Junio C Hamanof7b9ebd2007-08-15 08:14:2362 - "git filter-branch" lets you rewrite the revision history of
Junio C Hamanoc71a8732007-08-04 00:27:2663 specified branches. You can specify a number of filters to
64 modify the commits, files and trees.
Junio C Hamano401939f2007-07-01 06:34:3065
Junio C Hamanof7b9ebd2007-08-15 08:14:2366 - "git cvsserver" learned new options (--base-path, --export-all,
67 --strict-paths) inspired by "git daemon".
Junio C Hamano401939f2007-07-01 06:34:3068
Junio C Hamano092f5f02007-08-02 07:23:3869 - "git daemon --base-path-relaxed" can help migrating a repository URL
70 that did not use to use --base-path to use --base-path.
71
Junio C Hamanof7b9ebd2007-08-15 08:14:2372 - "git commit" can use "-t templatefile" option and commit.template
Junio C Hamanoa3770f92007-07-25 08:53:3373 configuration variable to prime the commit message given to you in the
74 editor.
75
Junio C Hamanof7b9ebd2007-08-15 08:14:2376 - "git submodule" command helps you manage the projects from
Junio C Hamano38b693c2007-06-03 08:40:1477 the superproject that contain them.
78
79 - In addition to core.compression configuration option,
80 core.loosecompression and pack.compression options can
81 independently tweak zlib compression levels used for loose
82 and packed objects.
83
Junio C Hamanof7b9ebd2007-08-15 08:14:2384 - "git ls-tree -l" shows size of blobs pointed at by the
Junio C Hamano38b693c2007-06-03 08:40:1485 tree entries, similar to "/bin/ls -l".
86
Junio C Hamanof7b9ebd2007-08-15 08:14:2387 - "git rev-list" learned --regexp-ignore-case and
Junio C Hamano38b693c2007-06-03 08:40:1488 --extended-regexp options to tweak its matching logic used
89 for --grep fitering.
90
Junio C Hamanof7b9ebd2007-08-15 08:14:2391 - "git describe --contains" is a handier way to call more
92 obscure command "git name-rev --tags".
Junio C Hamano38b693c2007-06-03 08:40:1493
94 - "git gc --aggressive" tells the command to spend more cycles
95 to optimize the repository harder.
96
Junio C Hamanod81c5d32007-07-16 00:06:1297 - "git repack" learned a "window-memory" limit which
98 dynamically reduces the window size to stay within the
99 specified memory usage.
100
Junio C Hamano38b693c2007-06-03 08:40:14101 - "git repack" can be told to split resulting packs to avoid
102 exceeding limit specified with "--max-pack-size".
103
Junio C Hamano401939f2007-07-01 06:34:30104 - "git fsck" gained --verbose option. This is really really
105 verbose but it might help you identify exact commit that is
106 corrupt in your repository.
107
108 - "git format-patch" learned --numbered-files option. This
109 may be useful for MH users.
110
Junio C Hamanobb0f4042007-07-04 06:41:40111 - "git format-patch" learned format.subjectprefix configuration
112 variable, which serves the same purpose as "--subject-prefix"
113 option.
114
Junio C Hamano401939f2007-07-01 06:34:30115 - "git tag -n -l" shows tag annotations while listing tags.
116
117 - "git cvsimport" can optionally use the separate-remote layout.
118
Junio C Hamanobb0f4042007-07-04 06:41:40119 - "git blame" can be told to see through commits that change
Junio C Hamano401939f2007-07-01 06:34:30120 whitespaces and indentation levels with "-w" option.
121
122 - "git send-email" can be told not to thread the messages when
123 sending out more than one patches.
124
125 - "git config" learned NUL terminated output format via -z to
126 help scripts.
127
Junio C Hamanof7b9ebd2007-08-15 08:14:23128 - "git add" learned "--refresh <paths>..." option to selectively refresh
129 the cached stat information.
130
Junio C Hamanobb0f4042007-07-04 06:41:40131 - "git init -q" makes the command quieter.
132
Junio C Hamano41031ae2007-08-21 06:02:54133 - "git -p command" now has a cousin of opposite sex, "git --no-pager
134 command".
135
Junio C Hamano38b693c2007-06-03 08:40:14136* Updated behavior of existing commands.
137
Junio C Hamanoa3770f92007-07-25 08:53:33138 - "gitweb" can offer multiple snapshot formats.
139
140 ***NOTE*** Unfortunately, this changes the format of the
141 $feature{snapshot}{default} entry in the per-site
142 configuration file 'gitweb_config.perl'. It used to be a
143 three-element tuple that describe a single format; with the
144 new configuration item format, you only have to say the name
145 of the format ('tgz', 'tbz2' or 'zip'). Please update the
146 your configuration file accordingly.
147
Junio C Hamanof7b9ebd2007-08-15 08:14:23148 - "git clone" uses -l (hardlink files under .git) by default when
149 cloning locally.
150
151 - "git bundle create" can now create a bundle without negative refs,
152 i.e. "everything since the beginning up to certain points".
153
Junio C Hamano092f5f02007-08-02 07:23:38154 - "git diff" (but not the plumbing level "git diff-tree") now
155 recursively descends into trees by default.
156
Junio C Hamanof7b9ebd2007-08-15 08:14:23157 - "git diff" does not show differences that come only from
158 stat-dirtiness in the form of "diff --git" header anymore. When
159 generating a textual diff, it shows a warning message at the end.
160
Junio C Hamanoa3770f92007-07-25 08:53:33161 - The editor to use with many interactive commands can be
162 overridden with GIT_EDITOR environment variable, or if it
163 does not exist, with core.editor configuration variable. As
164 before, if you have neither, environment variables VISUAL
165 and EDITOR are consulted in this order, and then finally we
166 fall back on "vi".
167
Junio C Hamanod81c5d32007-07-16 00:06:12168 - "git rm --cached" does not complain when removing a newly
169 added file from the index anymore.
170
Junio C Hamanoa3770f92007-07-25 08:53:33171 - Options to "git log" to affect how --grep/--author options look for
172 given strings now have shorter abbreviations. -i is for ignore case,
173 and -E is for extended regexp.
174
Junio C Hamanof7b9ebd2007-08-15 08:14:23175 - "git log" learned --log-size to show the number of bytes in
176 the log message part of the output to help qgit.
177
Junio C Hamano7d9e9bd2007-08-29 07:31:47178 - "git log --name-status" does not require you to give "-r" anymore.
179 As a general rule, Porcelain commands should recurse when showing
180 diff.
181
182 - "git format-patch --root A" can be used to format everything
183 since the beginning up to A. This was supported with
184 "git format-patch --root A A" for a long time, but was not
185 properly documented.
186
Junio C Hamanobb0f4042007-07-04 06:41:40187 - "git svn dcommit" retains local merge information.
188
Junio C Hamanof7b9ebd2007-08-15 08:14:23189 - "git svnimport" allows an empty string to be specified as the
190 trunk/ directory. This is necessary to suck data from a SVN
191 repository that doe not have trunk/ branches/ and tags/ organization
192 at all.
193
Junio C Hamanobb0f4042007-07-04 06:41:40194 - "git config" to set values also honors type flags like --bool
195 and --int.
196
197 - core.quotepath configuration can be used to make textual git
198 output to emit most of the characters in the path literally.
199
Junio C Hamano401939f2007-07-01 06:34:30200 - "git mergetool" chooses its backend more wisely, taking
201 notice of its environment such as use of X, Gnome/KDE, etc.
202
203 - "gitweb" shows merge commits a lot nicer than before. The
204 default view uses more compact --cc format, while the UI
205 allows to choose normal diff with any parent.
206
207 - snapshot files "gitweb" creates from a repository at
208 $path/$project/.git are more useful. We use $project part
209 in the filename, which we used to discard.
210
Junio C Hamanobb0f4042007-07-04 06:41:40211 - "git cvsimport" creates lightweight tags; there is no
Junio C Hamano401939f2007-07-01 06:34:30212 interesting information we can record in an annotated tag,
213 and the handcrafted ones the old code created was not
214 properly formed anyway.
215
Junio C Hamanof7b9ebd2007-08-15 08:14:23216 - "git push" pretends that you immediately fetched back from
Junio C Hamano38b693c2007-06-03 08:40:14217 the remote by updating corresponding remote tracking
218 branches if you have any.
219
220 - The diffstat given after a merge (or a pull) honors the
221 color.diff configuration.
222
Junio C Hamano092f5f02007-08-02 07:23:38223 - "git commit --amend" is now compatible with various message source
224 options such as -m/-C/-c/-F.
225
Junio C Hamanof7b9ebd2007-08-15 08:14:23226 - "git apply --whitespace=strip" removes blank lines added at
Junio C Hamano38b693c2007-06-03 08:40:14227 the end of the file.
228
Junio C Hamanof7b9ebd2007-08-15 08:14:23229 - "git fetch" over git native protocols with "-v" option shows
Junio C Hamanobb0f4042007-07-04 06:41:40230 connection status, and the IP address of the other end, to
231 help diagnosing problems.
Junio C Hamano38b693c2007-06-03 08:40:14232
Junio C Hamano401939f2007-07-01 06:34:30233 - We used to have core.legacyheaders configuration, when
234 set to false, allowed git to write loose objects in a format
235 that mimicks the format used by objects stored in packs. It
236 turns out that this was not so useful. Although we will
237 continue to read objects written in that format, we do not
238 honor that configuration anymore and create loose objects in
239 the legacy/traditional format.
240
241 - "--find-copies-harder" option to diff family can now be
242 spelled as "-C -C" for brevity.
Junio C Hamano38b693c2007-06-03 08:40:14243
Junio C Hamanof7b9ebd2007-08-15 08:14:23244 - "git mailsplit" (hence "git am") can read from Maildir
Junio C Hamano38b693c2007-06-03 08:40:14245 formatted mailboxes.
246
Junio C Hamanof7b9ebd2007-08-15 08:14:23247 - "git cvsserver" does not barf upon seeing "cvs login"
Junio C Hamano38b693c2007-06-03 08:40:14248 request.
249
250 - "pack-objects" honors "delta" attribute set in
251 .gitattributes. It does not attempt to deltify blobs that
252 come from paths with delta attribute set to false.
253
Junio C Hamanobb0f4042007-07-04 06:41:40254 - "new-workdir" script (in contrib) can now be used with a
255 bare repository.
Junio C Hamano38b693c2007-06-03 08:40:14256
Junio C Hamanof7b9ebd2007-08-15 08:14:23257 - "git mergetool" learned to use gvimdiff.
Junio C Hamano401939f2007-07-01 06:34:30258
259 - "gitview" (in contrib) has a better blame interface.
260
261 - "git log" and friends did not handle a commit log message
262 that is larger than 16kB; they do now.
263
264 - "--pretty=oneline" output format for "git log" and friends
265 deals with "malformed" commit log messages that have more
266 than one lines in the first paragraph better. We used to
267 show the first line, cutting the title at mid-sentence; we
268 concatenate them into a single line and treat the result as
269 "oneline".
Junio C Hamano38b693c2007-06-03 08:40:14270
Junio C Hamanod81c5d32007-07-16 00:06:12271 - "git p4import" has been demoted to contrib status. For
Junio C Hamanof7b9ebd2007-08-15 08:14:23272 a superior option, checkout the "git p4" front end to
273 "git fast-import" (also in contrib). The man page and p4
Junio C Hamanod81c5d32007-07-16 00:06:12274 rpm have been removed as well.
275
Junio C Hamanoa3770f92007-07-25 08:53:33276 - "git mailinfo" (hence "am") now tries to see if the message
277 is in utf-8 first, instead of assuming iso-8859-1, if
278 incoming e-mail does not say what encoding it is in.
279
Junio C Hamano38b693c2007-06-03 08:40:14280* Builds
281
Junio C Hamano401939f2007-07-01 06:34:30282 - old-style function definitions (most notably, a function
283 without parameter defined with "func()", not "func(void)")
284 have been eradicated.
Junio C Hamano38b693c2007-06-03 08:40:14285
Junio C Hamanof7b9ebd2007-08-15 08:14:23286 - "git tag" and "git verify-tag" have been rewritten in C.
287
Junio C Hamano38b693c2007-06-03 08:40:14288* Performance Tweaks
289
Junio C Hamanof7b9ebd2007-08-15 08:14:23290 - "git pack-objects" avoids re-deltification cost by caching
Junio C Hamano38b693c2007-06-03 08:40:14291 small enough delta results it creates while looking for the
292 best delta candidates.
293
Junio C Hamanof7b9ebd2007-08-15 08:14:23294 - "git pack-objects" learned a new heuristcs to prefer delta
Junio C Hamano235d53f2007-07-13 00:25:15295 that is shallower in depth over the smallest delta
296 possible. This improves both overall packfile access
297 performance and packfile density.
298
Junio C Hamano38b693c2007-06-03 08:40:14299 - diff-delta code that is used for packing has been improved
300 to work better on big files.
301
302 - when there are more than one pack files in the repository,
303 the runtime used to try finding an object always from the
304 newest packfile; it now tries the same packfile as we found
305 the object requested the last time, which exploits the
306 locality of references.
307
Junio C Hamano401939f2007-07-01 06:34:30308 - verifying pack contents done by "git fsck --full" got boost
309 by carefully choosing the order to verify objects in them.
310
Junio C Hamanof7b9ebd2007-08-15 08:14:23311 - "git read-tree -m" to read into an already populated index
312 has been optimized vastly. The effect of this can be seen
313 when switching branches that have differences in only a
314 handful paths.
315
Junio C Hamano7d9e9bd2007-08-29 07:31:47316 - "git add paths..." and "git commit paths..." has also been
317 heavily optimized.
Junio C Hamano401939f2007-07-01 06:34:30318
Junio C Hamano38b693c2007-06-03 08:40:14319Fixes since v1.5.2
320------------------
321
322All of the fixes in v1.5.2 maintenance series are included in
323this release, unless otherwise noted.
324
325* Bugfixes
326
Junio C Hamano401939f2007-07-01 06:34:30327 - "gitweb" had trouble handling non UTF-8 text with older
328 Encode.pm Perl module.
Junio C Hamano38b693c2007-06-03 08:40:14329
Junio C Hamanoe03e9892007-08-27 00:56:33330 - "git-write-tree" had a bad interaction with racy-git avoidance and
331 gitattributes mechanisms.
332
Junio C Hamano7d9e9bd2007-08-29 07:31:47333 - "git --bare command" overrode existing GIT_DIR setting and always
334 made it treat the current working directory as GIT_DIR.
335
Junio C Hamano21e7f9c2007-08-31 07:56:26336 - "git ls-files --error-unmatch" does not complain if you give the
337 same path pattern twice by mistake.
338
339 - "git init" autodetected core.filemode but not core.symlinks, which
340 made a new directory created automatically by "git clone" cumbersome
341 to use on filesystems that require these configurations to be set.
342
343 - "git log" family of commands behaved differently when run as "git
344 log" (no pathspec) and as "git log --" (again, no pathspec). This
345 inconsistency was introduced somewhere in v1.3.0 series but now has
346 been corrected.
347
Junio C Hamano38b693c2007-06-03 08:40:14348--
349exec >/var/tmp/1
Junio C Hamano21e7f9c2007-08-31 07:56:26350O=v1.5.3-rc7-15-ga65f200
Junio C Hamano38b693c2007-06-03 08:40:14351echo O=`git describe refs/heads/master`
352git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint