clean up 1.5.4 release notes
Mostly typo and small grammatical fixes with one or two rewordings for clarity. But note the important fix for status.relativepaths. Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Jeff King committed
Dec 20, 2007 at 07:11 UTC
6a7f14c4651f9773eb5e7e8111721a979ce2a64c
1 file changed
+17
-16
Documentation/RelNotes-1.5.4.txt
+17
-16
@@ -14,28 +14,28 @@ Removal
14
Deprecation notices
15
-------------------
16
17
- * Next feature release of git (this change is scheduled for v1.6.0)
17
+ * The next feature release of git (this change is scheduled for v1.6.0)
18
will by default install dashed form of commands (e.g. "git-commit")
19
outside of users' normal $PATH, and will install only selected
20
commands ("git" itself, and "gitk") in $PATH. This implies:
21
22
- - Using dashed form of git commands (e.g. "git-commit") from the
22
+ - Using dashed forms of git commands (e.g. "git-commit") from the
23
command line has been informally deprecated since early 2006, but
24
now it officially is, and will be removed in the future. Use
25
- dashless form (e.g. "git commit") instead.
25
+ dashless forms (e.g. "git commit") instead.
26
27
- - Using dashed from from your scripts, without first prepending the
27
+ - Using dashed forms from your scripts, without first prepending the
28
return value from "git --exec-path" to the scripts' PATH, has been
29
informally deprecated since early 2006, but now it officially is.
30
31
- - Use of dashed form with "PATH=$(git --exec-path):$PATH; export
31
+ - Use of dashed forms with "PATH=$(git --exec-path):$PATH; export
32
PATH" early in your script is not deprecated with this change.
33
34
Users are strongly encouraged to adjust their habits and scripts now
35
to prepare for this.
36
37
* The post-receive hook was introduced in March 2007 to supersede
38
- post-update hook, primarily to overcome the command line length
38
+ the post-update hook, primarily to overcome the command line length
39
limitation of the latter. Use of post-update hook will be deprecated
40
in future versions of git, starting from v1.6.0.
41
@@ -43,10 +43,11 @@ Deprecation notices
43
option, and will be removed in the future.
44
45
* "git peek-remote" is deprecated, as "git ls-remote" was written in C
46
- and works for all transports, and will be removed in the future.
46
+ and works for all transports; "git peek-remote" will be removed in
47
+ the future.
48
49
* From v1.6.0, the repack.usedeltabaseoffset config option will default
49
- to true, which will give denser packfile (i.e. more efficient storage).
50
+ to true, which will give denser packfiles (i.e. more efficient storage).
51
The downside is that git older than version 1.4.4 will not be able
52
to directly use a repository packed using this setting.
53
@@ -67,7 +68,7 @@ Updates since v1.5.3
68
* gitk is now merged as a subdirectory of git.git project, in
69
preparation for its i18n.
70
70
- * progress display from many commands are a lot nicer to the eye.
71
+ * progress displays from many commands are a lot nicer to the eye.
72
Transfer commands show throughput data.
73
74
* many commands that pay attention to per-directory .gitignore now do
@@ -76,12 +77,12 @@ Updates since v1.5.3
77
* Output processing for '--pretty=format:<user format>' has been
78
optimized.
79
79
- * Rename detection of diff family, while detecting exact matches, has
80
+ * Rename detection of diff family while detecting exact matches has
81
been greatly optimized.
82
82
- * Rename detection of diff family tries to make more naturally looking
83
- pairing. Earlier if more than one identical rename sources were
84
- found in the preimage, they were picked pretty much at random.
83
+ * Rename detection of diff family tries to make more natural looking
84
+ pairing. Earlier, if multiple identical rename sources were
85
+ found in the preimage, the source used was picked pretty much at random.
86
87
* Value "true" for color.diff and color.status configuration used to
88
mean "always" (even when the output is not going to a terminal).
@@ -114,7 +115,7 @@ Updates since v1.5.3
115
116
* "git rebase --interactive" mode can now work on detached HEAD.
117
117
- * Other minor to serious bugs in "git rebase -i" has been fixed.
118
+ * Other minor to serious bugs in "git rebase -i" have been fixed.
119
120
* "git rebase" now detaches head during its operation, so after a
121
successful "git rebase" operation, the reflog entry branch@{1} for
@@ -247,7 +248,7 @@ Updates since v1.5.3
248
* The format "git show" outputs an annotated tag has been updated to
249
include "Tagger: " and "Date: " lines from the tag itself. Strictly
250
speaking this is a backward incompatible change, but this is a
250
- reasonable usability fix and people's script shouldn't have been
251
+ reasonable usability fix and people's scripts shouldn't have been
252
relying on the exact output from "git show" Porcelain anyway.
253
254
* "git cvsexportcommit" learned -w option to specify and switch to the
@@ -283,7 +284,7 @@ Updates since v1.5.3
284
makes copy-and-pasting for git-checkout/git-add/git-rm easier. The
285
traditional behaviour to show the full path relative to the top of
286
the work tree can be had by setting status.relativepaths
286
- configuration variable to true.
287
+ configuration variable to false.
288
289
* "git blame" kept text for each annotated revision in core needlessly;
290
this has been corrected.