]> asedeno.scripts.mit.edu Git - git.git/blob - Documentation/RelNotes-1.5.3.txt
INSTALL: add warning on docbook-xsl 1.72 and 1.73
[git.git] / Documentation / RelNotes-1.5.3.txt
1 GIT v1.5.3 Release Notes
2 ========================
3
4 Updates 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
264 Fixes since v1.5.2
265 ------------------
266
267 All of the fixes in v1.5.2 maintenance series are included in
268 this 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 --
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