| blob | 7da62d08d6a18332eb7b3a492f8c9435f9f77396 |
1 GIT v1.6.0 Release Notes
2 ========================
4 User visible changes
5 --------------------
7 With the default Makefile settings, most of the programs are now
8 installed outside your $PATH, except for "git", "gitk", "git-gui" and
9 some server side programs that need to be accessible for technical
10 reasons. Invoking a git subcommand as "git-xyzzy" from the command
11 line has been deprecated since early 2006 (and officially announced in
12 1.5.4 release notes); use of them from your scripts after adding
13 output from "git --exec-path" to the $PATH is still supported in this
14 release, but users are again strongly encouraged to adjust their
15 scripts to use "git xyzzy" form, as we will stop installing
16 "git-xyzzy" hardlinks for built-in commands in later releases.
18 Source changes needed for porting to MinGW environment are now all in the
19 main git.git codebase.
21 By default, packfiles created with this version uses delta-base-offset
22 encoding introduced in v1.4.4. Pack idx files are using version 2 that
23 allows larger packs and added robustness thanks to its CRC checking,
24 introduced in v1.5.2 and v1.4.4.5. If you want to keep your repositories
25 backwards compatible past these versions, set repack.useDeltaBaseOffset
26 to false or pack.indexVersion to 1, respectively.
28 GIT_CONFIG, which was only documented as affecting "git config", but
29 actually affected all git commands, now only affects "git config".
30 GIT_LOCAL_CONFIG, also only documented as affecting "git config" and
31 not different from GIT_CONFIG in a useful way, is removed.
33 The ".dotest" temporary area "git am" and "git rebase" use is now moved
34 inside the $GIT_DIR, to avoid mistakes of adding it to the project by
35 accident.
37 An ancient merge strategy "stupid" has been removed.
40 Updates since v1.5.6
41 --------------------
43 (subsystems)
45 * git-p4 in contrib learned "allowSubmit" configuration to control on
46 which branch to allow "submit" subcommand.
48 * git-gui learned to stage changes per-line.
50 (portability)
52 * Changes for MinGW port have been merged, thanks to Johannes Sixt and
53 gangs.
55 * Sample hook scripts shipped in templates/ are now suffixed with
56 *.sample. We used to prevent them from triggering by default by
57 relying on the fact that we install them as unexecutable, but on
58 some filesystems this approach does not work. Instead of running
59 "chmod +x" on them, the users who want to activate these samples
60 as-is can now rename them dropping *.sample suffix.
62 * perl's in-place edit (-i) does not work well without backup files on Windows;
63 some tests are rewritten to cope with this.
65 (documentation)
67 * Updated howto/update-hook-example
69 * Got rid of usage of "git-foo" from the tutorial and made typography
70 more consistent.
72 * Disambiguating "--" between revs and paths is finally documented.
74 (performance, robustness, sanity etc.)
76 * index-pack used too much memory when dealing with a deep delta chain.
77 This has been optimized.
79 * reduced excessive inlining to shrink size of the "git" binary.
81 * verify-pack checks the object CRC when using version 2 idx files.
83 * When an object is corrupt in a pack, the object became unusable even
84 when the same object is available in a loose form, We now try harder to
85 fall back to these redundant objects when able. In particular, "git
86 repack -a -f" can be used to fix such a corruption as long as necessary
87 objects are available.
89 * Performance of "git-blame -C -C" operation is vastly improved.
91 * git-clone does not create refs in loose form anymore (it behaves as
92 if you immediately ran git-pack-refs after cloning). This will help
93 repositories with insanely large number of refs.
95 * core.fsyncobjectfiles configuration can be used to ensure that the loose
96 objects created will be fsync'ed (this is only useful on filesystems
97 that does not order data writes properly).
99 * "git commit-tree" plumbing can make Octopus with more than 16 parents.
100 "git commit" has been capable of this for quite some time.
102 (usability, bells and whistles)
104 * even more documentation pages are now accessible via "man" and "git help".
106 * A new environment variable GIT_CEILING_DIRECTORIES can be used to stop
107 the discovery process of the toplevel of working tree; this may be useful
108 when you are working in a slow network disk and are outside any working tree,
109 as bash-completion and "git help" may still need to run in these places.
111 * By default, stash entries never expire. Set reflogexpire in [gc
112 "refs/stash"] to a reasonable value to get traditional auto-expiration
113 behaviour back
115 * Longstanding latency issue with bash completion script has been
116 addressed. This will need to be backmerged to 'maint' later.
118 * pager.<cmd> configuration variable can be used to enable/disable the
119 default paging behaviour per command.
121 * "git-add -i" has a new action 'e/dit' to allow you edit the patch hunk
122 manually.
124 * git-am records the original tip of the branch in ORIG_HEAD before it
125 starts applying patches.
127 * git-apply can handle a patch that touches the same path more than once
128 much better than before.
130 * git-apply can be told not to trust the line counts recorded in the input
131 patch but recount, with the new --recount option.
133 * git-apply can be told to apply a patch to a path deeper than what the
134 patch records with --directory option.
136 * git-archive can be told to omit certain paths from its output using
137 export-ignore attributes.
139 * git-archive uses the zlib default compression level when creating
140 zip archive.
142 * With -v option, git-branch describes the remote tracking statistics
143 similar to the way git-checkout reports by how many commits your branch
144 is ahead/behind.
146 * git-branch's --contains option used to always require a commit parameter
147 to limit the branches with; it now defaults to list branches that
148 contains HEAD if this parameter is omitted.
150 * git-branch's --merged and --no-merged option used to always limit the
151 branches relative to the HEAD, but they can now take an optional commit
152 argument that is used in place of HEAD.
154 * git-bundle can read the revision arguments from the standard input.
156 * git-cherry-pick can replay a root commit now.
158 * git-clone can clone from a remote whose URL would be rewritten by
159 configuration stored in $HOME/.gitconfig now.
161 * git-cvsserver learned to respond to "cvs co -c".
163 * git-diff --check now checks leftover merge conflict markers.
165 * When remote side used to have branch 'foo' and git-fetch finds that now
166 it has branch 'foo/bar', it refuses to lose the existing remote tracking
167 branch and its reflog. The error message has been improved to suggest
168 pruning the remote if the user wants to proceed and get the latest set
169 of branches from the remote, including such 'foo/bar'.
171 * fast-export learned to export and import marks file; this can be used to
172 interface with fast-import incrementally.
174 * fast-import and fast-export learned to export and import gitlinks.
176 * git-rebase records the original tip of branch in ORIG_HEAD before it is
177 rewound.
179 * "git rerere" can be told to update the index with auto-reused resolution
180 with rerere.autoupdate configuration variable.
182 * git-rev-list learned --children option to show child commits it
183 encountered during the traversal, instead of shoing parent commits.
185 * git-send-mail can talk not just over SSL but over TLS now.
187 * git-shortlog honors custom output format specified with "--pretty=format:".
189 * "git-stash save" learned --keep-index option. This lets you stash away the
190 local changes and bring the changes staged in the index to your working
191 tree for examination and testing.
193 * git-stash also learned branch subcommand to create a new branch out of
194 stashed changes.
196 * git-status gives the remote tracking statistics similar to the way
197 git-checkout reports by how many commits your branch is ahead/behind.
199 * You can tell "git status -u" to even more aggressively omit checking
200 untracked files with --untracked-files=no.
202 * Original SHA-1 value for "update-ref -d" is optional now.
204 * Error codes from gitweb are made more descriptive where possible, rather
205 than "403 forbidden" as we used to issue everywhere.
207 (internal)
209 * git-merge has been reimplemented in C.
212 Fixes since v1.5.6
213 ------------------
215 All of the fixes in v1.5.6 maintenance series are included in
216 this release, unless otherwise noted.
218 ---
219 exec >/var/tmp/1
220 O=v1.5.6.4-432-g6796399
221 echo O=$(git describe refs/heads/master)
222 git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint