gitweb: new cgi parameter: opt
[git/platforms.git] / Documentation / RelNotes-1.5.3.txt
blobe2e809e3c8e700dc23ed7c95a2f2c2fa8ff2f708
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 stash" allows you to quickly save away your work in
25     progress and replay it later on an updated state.
27   - "git rebase" learned an "interactive" mode that let you
28     pick and reorder which commits to rebuild.
30   - "git fsck" can save its findings in $GIT_DIR/lost-found,
31     without a separate invocation of "git lost-found" command.
33   - $GIT_WORK_TREE environment variable can be used together with
34     $GIT_DIR to work in a subdirectory of a working tree that is
35     not located at "$GIT_DIR/..".
37   - "git log" learned a new option "--follow", to follow
38     renaming history of a single file.
40   - "git-filter-branch" lets you rewrite the revision history of
41     the current branch, creating a new branch. You can specify a
42     number of filters to modify the commits, files and trees.
44   - "git-cvsserver" learned new options (--base-path, --export-all,
45     --strict-paths) inspired by git-daemon.
47   - "git-submodule" command helps you manage the projects from
48     the superproject that contain them.
50   - In addition to core.compression configuration option,
51     core.loosecompression and pack.compression options can
52     independently tweak zlib compression levels used for loose
53     and packed objects.
55   - "git-ls-tree -l" shows size of blobs pointed at by the
56     tree entries, similar to "/bin/ls -l".
58   - "git-rev-list" learned --regexp-ignore-case and
59     --extended-regexp options to tweak its matching logic used
60     for --grep fitering.
62   - "git-describe --contains" is a handier way to call more
63     obscure command "git-name-rev --tags".
65   - "git gc --aggressive" tells the command to spend more cycles
66     to optimize the repository harder.
68   - "git repack" can be told to split resulting packs to avoid
69     exceeding limit specified with "--max-pack-size".
71   - "git fsck" gained --verbose option.  This is really really
72     verbose but it might help you identify exact commit that is
73     corrupt in your repository.
75   - "git format-patch" learned --numbered-files option.  This
76     may be useful for MH users.
78   - "git format-patch" learned format.subjectprefix configuration
79     variable, which serves the same purpose as "--subject-prefix"
80     option.
82   - "git tag -n -l" shows tag annotations while listing tags.
84   - "git cvsimport" can optionally use the separate-remote layout.
86   - "git blame" can be told to see through commits that change
87     whitespaces and indentation levels with "-w" option.
89   - "git send-email" can be told not to thread the messages when
90     sending out more than one patches.
92   - "git config" learned NUL terminated output format via -z to
93     help scripts.
95   - "git init -q" makes the command quieter.
97 * Updated behavior of existing commands.
99   - "git svn dcommit" retains local merge information.
101   - "git config" to set values also honors type flags like --bool
102     and --int.
104   - core.quotepath configuration can be used to make textual git
105     output to emit most of the characters in the path literally.
107   - "git mergetool" chooses its backend more wisely, taking
108     notice of its environment such as use of X, Gnome/KDE, etc.
110   - "gitweb" shows merge commits a lot nicer than before.  The
111     default view uses more compact --cc format, while the UI
112     allows to choose normal diff with any parent.
114   - snapshot files "gitweb" creates from a repository at
115     $path/$project/.git are more useful.  We use $project part
116     in the filename, which we used to discard.
118   - "git cvsimport" creates lightweight tags; there is no
119     interesting information we can record in an annotated tag,
120     and the handcrafted ones the old code created was not
121     properly formed anyway.
123   - "git-push" pretends that you immediately fetched back from
124     the remote by updating corresponding remote tracking
125     branches if you have any.
127   - The diffstat given after a merge (or a pull) honors the
128     color.diff configuration.
130   - "git-apply --whitespace=strip" removes blank lines added at
131     the end of the file.
133   - "git-fetch" over git native protocols with "-v" option shows
134     connection status, and the IP address of the other end, to
135     help diagnosing problems.
137   - We used to have core.legacyheaders configuration, when
138     set to false, allowed git to write loose objects in a format
139     that mimicks the format used by objects stored in packs.  It
140     turns out that this was not so useful.  Although we will
141     continue to read objects written in that format, we do not
142     honor that configuration anymore and create loose objects in
143     the legacy/traditional format.
145   - "--find-copies-harder" option to diff family can now be
146     spelled as "-C -C" for brevity.
148   - "git-mailsplit" (hence "git-am") can read from Maildir
149     formatted mailboxes.
151   - "git-cvsserver" does not barf upon seeing "cvs login"
152     request.
154   - "pack-objects" honors "delta" attribute set in
155     .gitattributes.  It does not attempt to deltify blobs that
156     come from paths with delta attribute set to false.
158   - "new-workdir" script (in contrib) can now be used with a
159     bare repository.
161   - "git-mergetool" learned to use gvimdiff.
163   - "gitview" (in contrib) has a better blame interface.
165   - "git log" and friends did not handle a commit log message
166     that is larger than 16kB; they do now.
168   - "--pretty=oneline" output format for "git log" and friends
169     deals with "malformed" commit log messages that have more
170     than one lines in the first paragraph better.  We used to
171     show the first line, cutting the title at mid-sentence; we
172     concatenate them into a single line and treat the result as
173     "oneline".
175 * Builds
177   - old-style function definitions (most notably, a function
178     without parameter defined with "func()", not "func(void)")
179     have been eradicated.
181 * Performance Tweaks
183   - git-pack-objects avoids re-deltification cost by caching
184     small enough delta results it creates while looking for the
185     best delta candidates.
187   - diff-delta code that is used for packing has been improved
188     to work better on big files.
190   - when there are more than one pack files in the repository,
191     the runtime used to try finding an object always from the
192     newest packfile; it now tries the same packfile as we found
193     the object requested the last time, which exploits the
194     locality of references.
196   - verifying pack contents done by "git fsck --full" got boost
197     by carefully choosing the order to verify objects in them.
200 Fixes since v1.5.2
201 ------------------
203 All of the fixes in v1.5.2 maintenance series are included in
204 this release, unless otherwise noted.
206 * Bugfixes
208   - "gitweb" had trouble handling non UTF-8 text with older
209     Encode.pm Perl module.
212 exec >/var/tmp/1
213 O=v1.5.3-rc0
214 echo O=`git describe refs/heads/master`
215 git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint