Merge branch 'cr/tag-options'
[git/dscho.git] / Documentation / RelNotes-1.5.4.txt
blob192766f868f4669b7cedc5baa4c119a39fc602b5
1 GIT v1.5.4 Release Notes
2 ========================
4 Deprecation notices
5 -------------------
7  * Next feature release of git (this change is scheduled for v1.5.5 but
8    it could slip) will by default install dashed form of commands
9    (e.g. "git-commit") outside of users' normal $PATH, and will install
10    only selected commands ("git" itself, and "gitk") in $PATH.  This
11    implies:
13    - Using dashed form of git commands (e.g. "git-commit") from the
14      command line has been informally deprecated since early 2006, but
15      now it officially is, and will be removed in the future.  Use
16      dashless form (e.g. "git commit") instead.
18    - Using dashed from from your scripts, without first prepending the
19      return value from "git --exec-path" to the scripts' PATH, has been
20      informally deprecated since early 2006, but now it officially is.
22    - Use of dashed form with "PATH=$(git --exec-path):$PATH; export
23      PATH" early in your script is not deprecated with this change.
25   Users are strongly encouraged to adjust their habits and scripts now
26   to prepare for this.
28  * The post-receive hook was introduced in March 2007 to supersede
29    post-update hook, primarily to overcome the command line length
30    limitation of the latter.  Use of post-update hook will be deprecated
31    in future versions of git, perhaps in v1.5.5.
34 Updates since v1.5.3
35 --------------------
37  * Comes with much improved gitk.
39  * Comes with git-gui 0.9.0 with i18n.
41  * git-lost-found was deprecated in favor of git-fsck's --lost-found
42    option.
44  * git-peek-remote is deprecated, as git-ls-remote was written in C and
45    works for all transports.
47  * git-cherry-pick made a misguided attempt to repeat the original
48    command line in the generated log message, when told to cherry-pick a
49    commit by naming a tag that points at it.  It does not anymore.
51  * "progress display" from many commands are a lot nicer to the
52    eye.  Transfer commands show throughput data.
54  * many commands that pay attention to per-directory .gitignore now do
55    so lazily, which makes the usual case go much faster.
57  * git-reset is now built-in and its output can be squelched with -q.
59  * git-send-email can optionally talk over ssmtp and use SMTP-AUTH.
61  * git-rebase learned --whitespace option.
63  * In git-rebase, when you decide not to replay a particular change
64    after the command stopped with a conflict, you can say "git-rebase
65    --skip" without first running "git reset --hard", as the command now
66    runs it for you.
68  * git-remote knows --mirror mode.
70  * git-merge can call the "post-merge" hook.
72  * git-pack-objects can optionally run deltification with multiple threads.
74  * git-archive can optionally substitute keywords in files marked with
75    export-subst attribute.
77  * git-for-each-ref learned %(xxxdate:<dateformat>) syntax to
78    show the various date fields in different formats.
80  * git-gc --auto is a low-impact way to automatically run a
81    variant of git-repack that does not lose unreferenced objects
82    (read: safer than the usual one) after the user accumulates
83    too many loose objects.
85  * You need to explicitly set clean.requireForce to "false" to allow
86    git-clean without -f to do any damage (lack of the configuration
87    variable used to mean "do not require", but we now use the safer
88    default).
90  * git-clean has been rewritten in C.
92  * git-push has been rewritten in C.
94  * git-push learned --dry-run option to show what would happen
95    if a push is run.
97  * git-push does not update a tracking ref on the pushing side when the
98    remote refused to update the corresponding ref.
100  * git-push learned --mirror option.  This is to push the local refs
101    one-to-one to the remote, and deletes refs from the remote that do
102    not exist anymore in the repository on the pushing side.
104  * git-remote learned "rm" subcommand.
106  * git-rebase --interactive mode can now work on detached HEAD.
108  * git-cvsserver can be run via git-shell.
110  * git-am and git-rebase are far less verbose.
112  * git-pull learned to pass --[no-]ff option to underlying git-merge.
114  * Various Perforce importer updates.
116  * "git log" learned --early-output option to help interactive
117    GUI implementations.
119  * git-svnimport was removed in favor of git-svn.
121  * git-bisect learned "skip" action to mark untestable commits.
123  * git-format-patch learned "format.numbered" configuration variable
124    to automatically turn --numbered option on when more than one
125    commits are formatted.
127  * git-ls-files learned "--exclude-standard" to use the canned
128    set of exclude files.
130  * git-rebase now detaches head during its operation, so after a
131    successful "git rebase" operation, the reflog entry branch@{1}
132    for the current branch points at the commit before the rebase
133    was started.
135  * "git-tag -a -f existing" begins the editor session using the
136    existing annotation message.
138  * "git cvsexportcommit" learned -w option to specify and switch
139    to the CVS working directory.
141  * "git checkout" from a subdirectory learned to use "../path"
142    to allow checking out a path outside the current directory
143    without cd'ing up.
145  * "git send-email --dry-run" shows full headers for easier
146    diagnosis.
148  * "git merge-ours" is built-in.
150  * "git svn" learned "info" and "show-externals" subcommands.
152  * calling "git svn" from a subdirectory failed read settings from the
153    .git/config.
155  * "git svn" learned --use-log-author option, which picks up more
156    descriptive name from From: and Signed-off-by: lines in the commit
157    message.
159  * "git status" from a subdirectory now shows relative paths
160    which makes copy-and-pasting for git-checkout/git-add/git-rm
161    easier.
163  * "git checkout" from and to detached HEAD leaves a bit more
164    information in the reflog.
166  * Output processing for '--pretty=format:<user format>' has
167    been optimized.
169  * Rename detection of diff family, while detecting exact matches, has
170    been greatly optimized.
172  * Rename detection of diff family tries to make more naturally looking
173    pairing.  Earlier if more than one identical rename sources were
174    found in the preimage, they were picked pretty much at random.
176  * Example update and post-receive hooks have been improved.
178  * A corrupt ref at the remote site can be removed via "git push".
180  * In addition there are quite a few internal clean-ups. Notably
182    - many fork/exec have been replaced with run-command API,
183      brought from the msysgit effort.
185    - introduction and more use of the option parser API.
187    - enhancement and more use of the strbuf API.
190 Fixes since v1.5.3
191 ------------------
193 All of the fixes in v1.5.3 maintenance series are included in
194 this release, unless otherwise noted.
196  * git-svn talking with the SVN over http will correctly quote branch
197    and project names.
199  * "git rev-list --objects A..B" choked when the lower boundary
200    of the range involved a subproject.  This fix is also queued
201    for 'maint' (but not in there yet).
204 exec >/var/tmp/1
205 O=v1.5.3.7-948-gb52e985
206 echo O=`git describe refs/heads/master`
207 git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint