t0001-init.sh: change confusing directory name
[git/dscho.git] / Documentation / RelNotes-1.6.0.txt
blobe1f013bd3b7bbfb30907d981b7e1d798ce94459e
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.
26 GIT_CONFIG, which was only documented as affecting "git config", but
27 actually affected all git commands, now only affects "git config".
28 GIT_LOCAL_CONFIG, also only documented as affecting "git config" and
29 not different from GIT_CONFIG in a useful way, is removed.
31 An ancient merge strategy "stupid" has been removed.
34 Updates since v1.5.6
35 --------------------
37 (subsystems)
39 * git-p4 in contrib learned "allowSubmit" configuration to control on
40   which branch to allow "submit" subcommand.
42 * git-gui learned to stage changes per-line.
44 (portability)
46 * Changes for MinGW port have been merged, thanks to Johannes Sixt and
47   gangs.
49 * Sample hook scripts shipped in templates/ are now suffixed with
50   *.sample.  We used to prevent them from triggering by default by
51   relying on the fact that we install them as unexecutable, but on
52   some filesystems this approach does not work.  Instead of running
53   "chmod +x" on them, the users who want to activate these samples
54   as-is can now rename them dropping *.sample suffix.
56 * perl's in-place edit (-i) does not work well without backup files on Windows;
57   some tests are rewritten to cope with this.
59 (documentation)
61 * Updated howto/update-hook-example
63 * Got rid of usage of "git-foo" from the tutorial and made typography
64   more consistent.
66 * Disambiguating "--" between revs and paths is finally documented.
68 (performance, robustness, sanity etc.)
70 * even more documentation pages are now accessible via "man" and "git help".
72 * reduced excessive inlining to shrink size of the "git" binary.
74 * verify-pack checks the object CRC when using version 2 idx files.
76 * When an object is corrupt in a pack, the object became unusable even
77   when the same object is available in a loose form,  We now try harder to
78   fall back to these redundant objects when able.  In particular, "git
79   repack -a -f" can be used to fix such a corruption as long as necessary
80   objects are available.
82 * git-clone does not create refs in loose form anymore (it behaves as
83   if you immediately ran git-pack-refs after cloning).  This will help
84   repositories with insanely large number of refs.
86 * core.fsyncobjectfiles configuration can be used to ensure that the loose
87   objects created will be fsync'ed (this is only useful on filesystems
88   that does not order data writes properly).
90 * "git commit-tree" plumbing can make Octopus with more than 16 parents.
91   "git commit" has been capable of this for quite some time.
93 (usability, bells and whistles)
95 * A new environment variable GIT_CEILING_DIRECTORIES can be used to stop
96   the discovery process of the toplevel of working tree; this may be useful
97   when you are working in a slow network disk and are outside any working tree,
98   as bash-completion and "git help" may still need to run in these places.
100 * git-apply can handle a patch that touches the same path more than once
101   much better than before.
103 * git-apply can be told not to trust the line counts recorded in the input
104   patch but recount, with the new --recount option.
106 * git-archive can be told to omit certain paths from its output using
107   export-ignore attributes.
109 * git-clone can clone from a remote whose URL would be rewritten by
110   configuration stored in $HOME/.gitconfig now.
112 * git-diff --check now checks leftover merge conflict markers.
114 * When remote side used to have branch 'foo' and git-fetch finds that now
115   it has branch 'foo/bar', it refuses to lose the existing remote tracking
116   branch and its reflog.  The error message has been improved to suggest
117   pruning the remote if the user wants to proceed and get the latest set
118   of branches from the remote, including such 'foo/bar'.
120 * fast-export learned to export and import marks file; this can be used to
121   interface with fast-import incrementally.
123 * "git rerere" can be told to update the index with auto-reused resolution
124   with rerere.autoupdate configuration variable.
126 * git-send-mail can talk not just over SSL but over TLS now.
128 * You can tell "git status -u" to even more aggressively omit checking
129   untracked files with --untracked-files=no.
131 * Original SHA-1 value for "update-ref -d" is optional now.
133 * Error codes from gitweb are made more descriptive where possible, rather
134   than "403 forbidden" as we used to issue everywhere.
136 (internal)
139 Fixes since v1.5.6
140 ------------------
142 All of the fixes in v1.5.6 maintenance series are included in
143 this release, unless otherwise noted.
145  * "git fetch" into an empty repository used to remind the fetch will
146    be huge by saying "no common commits", but it is already known by
147    the user anyway (need to backport 8cb560f to 'maint').
150 exec >/var/tmp/1
151 O=v1.5.6.2-246-g86d7244
152 echo O=$(git describe refs/heads/master)
153 git shortlog --no-merges $O..refs/heads/master ^refs/heads/maint