1.5.0 release notes - reword introductory text.

Signed-off-by: Junio C Hamano <junkio@cox.net>

Junio C Hamano committed Dec 27, 2006 at 21:50 UTC d086af93c471297d638c0967f8e1d5cdd2186c04
1 file changed +35 -409
v1.5.0.txt
+35 -409
@@ -1,37 +1,46 @@
1 -Major changes that are not news
2 --------------------------------
1 +GIT v1.5.0 Release Notes
2 +========================
3
4 -There were a handful big changes that happened before this major
5 -release.
4 +Old news
5 +--------
6
7 This section is for people who are upgrading from ancient
8 -versions. Some of them are one-way street upgrades -- once you
9 -use the feature your repository cannot be used with ancient git.
8 +versions of git. Although all of the changes in this section
9 +happened before the current v1.4.4 release, they are summarized
10 +here in the v1.5.0 release notes for people who skip versions
11 +between upgrading.
12 +
13 +In general, you should not have to worry about incompatibility.
14 +There is no need to perform "repository conversion". However,
15 +some of the changes are one-way street upgrades -- once you use
16 +the feature your repository cannot be used with ancient git.
17
18 - There is a new configuration variable core.legacyheaders that
12 - changes the format of loose objects to more efficient to pack
13 - and send out of the repository over git native protocol.
14 - However, this format cannot be read by git older than v1.4.2;
15 - people fetching from your repository using older clients over
16 - dumb transports (e.g. http) will also be affected. This is
17 - not enabled by default.
19 + changes the format of loose objects so that they are more
20 + efficient to pack and to send out of the repository over git
21 + native protocol. However, this format cannot be read by git
22 + older than v1.4.2; people fetching from your repository using
23 + older clients over dumb transports (e.g. http) using older
24 + versions of git will also be affected. This is not enabled
25 + by default.
26
27 - Another configuration repack.usedeltabaseoffset further
28 allows packfile to be created in more space efficient format,
21 - which cannot be read by git older than v1.4.3. This is not
29 + which cannot be read by git older than v1.4.3. This is not
30 enabled by default.
31
32 - 'git pack-refs' appeared in v1.4.4; this command allows tags
33 to be accessed much more efficiently than the traditional
26 - 'one-file-per-tag' format. Older git-native client can fetch
27 - from a repository that packed its tags, but older dumb
28 - transports cannot. This is done by an explicit user action,
29 - either by use of "git pack-refs --prune" command or by use of
30 - "git gc" command.
34 + 'one-file-per-tag' format. Older git-native clients can
35 + fetch from a repository that packed its tags (the server side
36 + needs to run the up-to-date version of git), but older dumb
37 + transports cannot. Packing of refs is done by an explicit
38 + user action, either by use of "git pack-refs --prune" command
39 + or by use of "git gc" command.
40
41 - 'git -p' to paginate anything -- many commands do pagination
42 by default on a tty. Introduced between v1.4.1 and v1.4.2;
34 - this may surprise old timer users.
43 + this may surprise old timers.
44
45 - 'git archive' superseded 'git tar' in v1.4.3;
46
@@ -43,7 +52,10 @@ use the feature your repository cannot be used with ancient git.
52 - 'gitweb' became part of git.git during v1.4.0 timeperiod and
53 seriously modified since then.
54
46 - - reflog is an v1.4.0 invention.
55 + - reflog is an v1.4.0 invention. This alows you to name a
56 + revision that a branch used to be at (e.g. "git diff
57 + master@{yesterday} master" allows you to see changes since
58 + yesterday's tip of the branch).
59
60
61 Updates in v1.5.0 since v1.4.4 series
@@ -80,7 +92,9 @@ Updates in v1.5.0 since v1.4.4 series
92
93 - The data for origin repository is stored in the configuration
94 file $GIT_DIR/config, not in $GIT_DIR/remotes/, for newly
83 - created clones (the latter is still supported).
95 + created clones. The latter is still supported and there is
96 + no need to convert your existing repository if you are
97 + already comfortable with your workflow with the layout.
98
99 - git-clone always uses what is known as "separate remote"
100 layout for a newly created repository with a working tree;
@@ -200,391 +214,3 @@ Updates in v1.5.0 since v1.4.4 series
214
215 - Better error messages for often used Porcelainish commands.
216
203 -
204 -----------------------------------------------------------------
205 -Alex Riesen (1):
206 - Make perl/ build procedure ActiveState friendly.
207 -
208 -Alexandre Julliard (1):
209 - vc-git: Ignore errors caused by a non-existent directory in vc-git-registered.
210 -
211 -Andreas Ericsson (2):
212 - ls-files: Give hints when errors happen.
213 - git-diff: Introduce --index and deprecate --cached.
214 -
215 -Andy Parkins (8):
216 - Improve git-prune -n output
217 - Add support to git-branch to show local and remote branches
218 - Use .git/config for storing "origin" shortcut repository
219 - De-emphasise the symbolic link documentation.
220 - Explicitly add the default "git pull" behaviour to .git/config on clone
221 - Colourise git-branch output
222 - Allow subcommand.color and color.subcommand color configuration
223 - git-status always says what branch it's on
224 -
225 -Aneesh Kumar K.V (1):
226 - Add config example with respect to branch
227 -
228 -Brian Gernhardt (6):
229 - Add --add option to git-repo-config
230 - Make git-diff documentation use [--] when it should.
231 - Add documentation for show-branch --topics
232 - Remove COLLISION_CHECK from Makefile since it's not used.
233 - Keep "git --git-dir" from causing a bus error.
234 - Make git-show-branch options similar to git-branch.
235 -
236 -David Miller (1):
237 - Pass -M to diff in request-pull
238 -
239 -Eric Wong (29):
240 - git-svn: handle authentication without relying on cached tokens on disk
241 - git-svn: correctly access repos when only given partial read permissions
242 - git-svn: exit with status 1 for test failures
243 - git-svn: allow SVN:: lib users to track the root of the repository (again)
244 - git-svn: use ~/.subversion config files when using SVN:: libraries
245 - git-svn: enable delta transfers during fetches when using SVN:: libs
246 - git-svn: update tests for recent changes
247 - git-svn: error out when the SVN connection fails during a fetch
248 - git-svn: fix output reporting from the delta fetcher
249 - git-svn: color support for the log command
250 - git-svn: documentation updates
251 - git-svn: fix multi-init
252 - git-svn: avoid network timeouts for long-running fetches
253 - git-svn: extra error check to ensure we open a file correctly
254 - git-svn: use do_switch for --follow-parent if the SVN library supports it
255 - rerere: add clear, diff, and status commands
256 - rerere: record (or avoid misrecording) resolved, skipped or aborted rebase/am
257 - git-svn: enable logging of information not supported by git
258 - git-svn: allow dcommit to take an alternate head
259 - git-svn: correctly display fatal() error messages
260 - git-svn: correctly handle packed-refs in refs/remotes/
261 - git-svn: correctly handle "(no author)" when using an authors file
262 - git-svn: convert to using Git.pm
263 - git-svn: remove support for the svn command-line client
264 - git-svn: rename 'commit' command to 'set-tree'
265 - git-cvsserver: fix breakage when calling git merge-file
266 - Remove NO_ACCURATE_DIFF options from build systems
267 - git-svn: enable common fetch/commit options for dcommit
268 - Makefile: add quick-install-doc for installing pre-built manpages
269 -
270 -Han-Wen Nienhuys (2):
271 - git-tag: allow empty tag message if -m is given explicitly.
272 - ident.c: Trim hint printed when gecos is empty.
273 -
274 -Iñaki Arenaza (1):
275 - git-cvsimport: add support for CVS pserver method HTTP/1.x proxying
276 -
277 -J. Bruce Fields (5):
278 - Documentation: clarify tutorial pull/merge discussion
279 - cvs-migration: improved section titles, better push/commit explanation
280 - Documentation: reorganize cvs-migration.txt
281 - Documentation: update git-clone man page with new behavior
282 - Documentation: simpler shared repository creation
283 -
284 -Jakub Narebski (26):
285 - gitweb: Protect against possible warning in git_commitdiff
286 - gitweb: Buffer diff header to deal with split patches + git_patchset_body refactoring
287 - gitweb: Default to $hash_base or HEAD for $hash in "commit" and "commitdiff"
288 - gitweb: New improved formatting of chunk header in diff
289 - gitweb: Add an option to href() to return full URL
290 - gitweb: Refactor feed generation, make output prettier, add Atom feed
291 - gitweb: Finish restoring "blob" links in git_difftree_body
292 - gitweb: Replace SPC with &nbsp; also in tag comment
293 - gitweb: Do not use esc_html in esc_path
294 - gitweb: Use git-show-ref instead of git-peek-remote
295 - gitweb: Add author and committer email extraction to parse_commit
296 - gitweb: Add author and contributor email to Atom feed
297 - gitweb: Use author_epoch for pubdate in gitweb feeds
298 - gitweb: Make project description in projects list link to summary view
299 - gitweb: Fix Atom feed <logo>: it is $logo, not $logo_url
300 - git-clone: Rename --use-immingled-remote option to --no-separate-remote
301 - Document git-diff whitespace flags -b and -w
302 - gitweb: Allow PNG, GIF, JPEG images to be displayed in "blob" view
303 - gitweb: Don't use Content-Encoding: header in git_snapshot
304 - gitweb: Show target of symbolic link in "tree" view
305 - gitweb: Add generic git_object subroutine to display object of any type
306 - gitweb: Hyperlink target of symbolic link in "tree" view (if possible)
307 - gitweb: SHA-1 in commit log message links to "object" view
308 - gitweb: Do not show difftree for merges in "commit" view
309 - gitweb: Add title attribute to ref marker with full ref name
310 - gitweb: Add "next" link to commit view
311 -
312 -Jeff King (2):
313 - shortlog: fix segfault on empty authorname
314 - vim syntax: follow recent changes to commit template
315 -
316 -Jim Meyering (1):
317 - Set permissions of each new file before "cvs add"ing it.
318 -
319 -Johannes Schindelin (30):
320 - Build in shortlog
321 - shortlog: do not crash on parsing "[PATCH"
322 - shortlog: read mailmap from ./.mailmap again
323 - shortlog: handle email addresses case-insensitively
324 - shortlog: fix "-n"
325 - shortlog: use pager
326 - sha1_object_info(): be consistent with read_sha1_file()
327 - xdiff: add xdl_merge()
328 - xdl_merge(): fix an off-by-one bug
329 - xdl_merge(): fix thinko
330 - diff -b: ignore whitespace at end of line
331 - xdl_merge(): fix and simplify conflict handling
332 - cvs-migration document: make the need for "push" more obvious
333 - Add builtin merge-file, a minimal replacement for RCS merge
334 - merge-file: support -p and -q; fix compile warnings
335 - Get rid of the dependency on RCS' merge program
336 - merge-recursive: add/add really is modify/modify with an empty base
337 - INSTALL: no need to have GNU diff installed
338 - git-show: grok blobs, trees and tags, too
339 - Document git-merge-file
340 - add a function to rename sections in the config
341 - git-branch: rename config vars branch.<branch>.*, too
342 - Introduce GIT_TEMPLATE_DIR
343 - Use git-merge-file in git-merge-one-file, too
344 - git-tag: support -F <file> option
345 - git-reset --hard: tell the user what the HEAD was reset to
346 - move read_mmfile() into xdiff-interface
347 - Add a test for git-rerere
348 - Make git-rerere a builtin
349 - commit-tree: encourage UTF-8 commit messages.
350 -
351 -Josef Weidendorfer (2):
352 - Add branch.*.merge warning and documentation update
353 - Move "no merge candidate" warning into git-pull
354 -
355 -Junio C Hamano (126):
356 - upload-pack: stop the other side when they have more roots than we do.
357 - apply --numstat: mark binary diffstat with - -, not 0 0
358 - pack-objects: tweak "do not even attempt delta" heuristics
359 - Store peeled refs in packed-refs file.
360 - remove merge-recursive-old
361 - git-merge: make it usable as the first class UI
362 - merge: allow merging into a yet-to-be-born branch.
363 - Store peeled refs in packed-refs (take 2).
364 - git-fetch: reuse ls-remote result.
365 - git-fetch: fix dumb protocol transport to fetch from pack-pruned ref
366 - git-fetch: allow glob pattern in refspec
367 - refs outside refs/{heads,tags} match less strongly.
368 - Typefix builtin-prune.c::prune_object()
369 - Allow git push to delete remote ref.
370 - gitweb: (style) use chomp without parentheses consistently.
371 - git-clone: stop dumb protocol from copying refs outside heads/ and tags/.
372 - git-branch -D: make it work even when on a yet-to-be-born branch
373 - git-shortlog: fix common repository prefix abbreviation.
374 - git-shortlog: make common repository prefix configurable with .mailmap
375 - git-commit: show --summary after successful commit.
376 - git-fetch: exit with non-zero status when fast-forward check fails
377 - git-fetch: allow forcing glob pattern in refspec
378 - fetch-pack: do not barf when duplicate re patterns are given
379 - grep: do not skip unmerged entries when grepping in the working tree.
380 - git-merge: tighten error checking.
381 - git-merge: do not leak rev-parse output used for checking internally.
382 - cvsimport: style fixup.
383 - git-merge: fix confusion between tag and branch
384 - xmerge: make return value from xdl_merge() more usable.
385 - merge-recursive: use xdl_merge().
386 - read-tree: further loosen "working file will be lost" check.
387 - Loosen "working file will be lost" check in Porcelain-ish
388 - read-tree: document --exclude-per-directory
389 - git-merge: squelch needless error message.
390 - git-merge: fix "fix confusion between tag and branch" for real
391 - Fix perl/ build.
392 - git-rerere: add 'gc' command.
393 - Documentation/git-commit: rewrite to make it more end-user friendly.
394 - git-commit: allow --only to lose what was staged earlier.
395 - shortlog: remove "[PATCH]" prefix from shortlog output
396 - shortlog: fix segfault on empty authorname
397 - diff --numstat: show binary with '-' to match "apply --numstat"
398 - add test case for recursive merge
399 - git-push: document removal of remote ref with :<dst> pathspec
400 - Revert "git-diff: Introduce --index and deprecate --cached."
401 - git merge: reword failure message.
402 - spurious .sp in manpages
403 - git-push: accept tag <tag> as advertised.
404 - send-pack: tighten checks for remote names
405 - branch --color: change default color selection.
406 - git-blame: show lines attributed to boundary commits differently.
407 - config documentation: group color items together.
408 - git-svn: allow both diff.color and color.diff
409 - Update git-diff documentation
410 - git-fetch: make it work from within a subdirectory.
411 - git-reset: make it work from within a subdirectory.
412 - git-reset [--mixed] <tree> [--] <paths>...
413 - merge: give a bit prettier merge message to "merge branch~$n"
414 - git-clone: use wildcard specification for tracking branches
415 - git-pull: refuse default merge without branch.*.merge
416 - git-clone: lose the artificial "first" fetch refspec
417 - git-clone: lose the traditional 'no-separate-remote' layout
418 - update-index: make D/F conflict error a bit more verbose.
419 - git-add: remove conflicting entry when adding.
420 - Fix check_file_directory_conflict().
421 - Fix mis-mark-up in git-merge-file.txt documentation
422 - markup fix in svnimport documentation.
423 - rev-list --left-right
424 - Teach all of log family --left-right output.
425 - Make left-right automatic.
426 - Teach show-branch how to show ref-log data.
427 - git-fetch: Avoid reading packed refs over and over again
428 - avoid accessing _all_ loose refs in git-show-ref --verify
429 - show-ref: fix --quiet --verify
430 - show-ref: fix --verify --hash=length
431 - parse-remote::expand_refs_wildcard()
432 - show-ref: fix --exclude-existing
433 - racy-git: documentation updates.
434 - rerere: fix breakage of resolving.
435 - fix testsuite: make sure they use templates freshly built from the source
436 - Teach git-branch to delete tracking branches with -r -d
437 - blame: -b (blame.blankboundary) and --root (blame.showroot)
438 - git-add --interactive
439 - git-add --interactive: hunk splitting
440 - Revert "fix testsuite: make sure they use templates freshly built from the source"
441 - Do not create $GIT_DIR/remotes/ directory anymore.
442 - Use preprocessor constants for environment variable names.
443 - Revert "Make left-right automatic."
444 - fix populate-filespec
445 - config_rename_section: fix FILE* leak
446 - simplify inclusion of system header files.
447 - revision: --skip=<n>
448 - git-add: error out when given no arguments.
449 - compat/inet_ntop: do not use u_int
450 - diff documentation: mostly talk about <commit>
451 - add for_each_reflog_ent() iterator
452 - Protect commits recorded in reflog from pruning.
453 - Teach git-repack to preserve objects referred to by reflog entries.
454 - reflog: fix warning message.
455 - Move in_merge_bases() to commit.c
456 - git reflog expire
457 - Revert "git-pull: refuse default merge without branch.*.merge"
458 - parse-remote: mark all refs not for merge only when fetching more than one
459 - _XOPEN_SOURCE problem also exists on FreeBSD
460 - commit-tree: do not overflow MAXPARENT
461 - reflog expire: prune commits that are not incomplete
462 - merge and reset: adjust for "reset --hard" messages
463 - default pull: forget about "newbie protection" for now.
464 - Do not support "partial URL shorthand" anymore.
465 - Really fix headers for __FreeBSD__
466 - git-tag: lose exit after die
467 - reflog expire: do not punt on tags that point at non commits.
468 - Allow branch.*.merge to talk about remote tracking branches.
469 - git-add --interactive: add documentation
470 - match_pathspec() -- return how well the spec matched
471 - git-rm: update to saner semantics
472 - t3600: update the test for updated git rm
473 - git-rm: Documentation
474 - read_directory: show_both option.
475 - git-add: add ignored files when asked explicitly.
476 - git-add: warn when adding an ignored file with an explicit request.
477 - git-add -f: allow adding otherwise ignored files.
478 - GIT v1.5.0 preview
479 - Move encoding conversion routine out of mailinfo to utf8.c
480 - i18n.logToUTF8: convert commit log message to UTF-8
481 - Teach log family --encoding
482 -
483 -Lars Hjemli (4):
484 - Add -v and --abbrev options to git-branch
485 - git-branch: add options and tests for branch renaming
486 - rename_ref: use lstat(2) when testing for symlink
487 - git-branch: let caller specify logmsg
488 -
489 -Luben Tuikov (1):
490 - Export PERL_PATH
491 -
492 -Michael Loeffler (1):
493 - git-fetch: ignore dereferenced tags in expand_refs_wildcard
494 -
495 -Nicolas Pitre (12):
496 - builtin git-shortlog is broken
497 - pack-objects: remove redundent status information
498 - make 'git add' a first class user friendly interface to the index
499 - change the unpack limit treshold to a saner value
500 - repacked packs should be read-only
501 - make commit message a little more consistent and conforting
502 - make patch_delta() error cases a bit more verbose
503 - make git a bit less cryptic on fetch errors
504 - index-pack usage of mmap() is unacceptably slower on many OSes other than Linux
505 - clarify some error messages wrt unknown object types
506 - checkout: make the message about the need for a new branch a bit clearer
507 - add .mailmap for git-shortlog output with the git repository
508 -
509 -Paul Mackerras (1):
510 - gitk: Fix enabling/disabling of menu items on Mac OS X
511 -
512 -Peter Baumann (1):
513 - config option log.showroot to show the diff of root commits
514 -
515 -Petr Baudis (1):
516 - Make git-clone --use-separate-remote the default
517 -
518 -Quy Tonthat (4):
519 - git-clone documentation
520 - Documentation: new option -P for git-svnimport
521 - git-branch -d: do not stop at the first failure.
522 - Documentation/git-branch: new -r to delete remote-tracking branches.
523 -
524 -René Scharfe (1):
525 - shortlog: remove range check
526 -
527 -Robert Fitzsimons (17):
528 - gitweb: Show '...' links in "summary" view only if there are more items
529 - gitweb: Add missing show '...' links change.
530 - gitweb: optimize git_get_last_activity.
531 - gitweb: optimize git_shortlog_body.
532 - gitweb: optimize git_summary.
533 - gitweb: Use rev-list pattern search options.
534 - gitweb: Require a minimum of two character for the search text.
535 - gitweb: Allow search to be disabled from the config file.
536 - gitweb: Paginate commit/author/committer search output
537 - gitweb: Add parse_commits, used to bulk load commit objects.
538 - gitweb: We do longer need the --parents flag in rev-list.
539 - gitweb: Change summary, shortlog actions to use parse_commits.
540 - gitweb: Change log action to use parse_commits.
541 - gitweb: Change header search action to use parse_commits.
542 - gitweb: Change atom, rss actions to use parse_commits.
543 - gitweb: Change history action to use parse_commits.
544 - gitweb: Use rev-list --skip option.
545 -
546 -Robin Rosenberg (1):
547 - Make cvsexportcommit work with filenames with spaces and non-ascii characters.
548 -
549 -Sean Estabrooks (1):
550 - Update documentation to remove incorrect GIT_DIFF_OPTS example.
551 -
552 -Shawn O. Pearce (31):
553 - Teach git-completion.bash how to complete git-merge.
554 - Hide plumbing/transport commands from bash completion.
555 - Teach bash how to complete options for git-name-rev.
556 - Add current branch in PS1 support to git-completion.bash.
557 - Teach bash how to complete git-format-patch.
558 - Teach bash how to complete git-cherry-pick.
559 - Teach bash how to complete git-rebase.
560 - Teach bash about git log/show/whatchanged options.
561 - Support bash completion of refs/remote.
562 - Teach bash about git-repo-config.
563 - Support --strategy=x completion in addition to --strategy x.
564 - Cache the list of merge strategies and available commands during load.
565 - Teach bash about git-am/git-apply and their whitespace options.
566 - Teach bash how to complete long options for git-commit.
567 - Fix broken bash completion of local refs.
568 - Remove uncontested renamed files during merge.
569 - Avoid accessing a slow working copy during diffcore operations.
570 - Provide more meaningful output from 'git init-db'.
571 - Enable reflogs by default in any repository with a working directory.
572 - Teach bash the new features of 'git show'.
573 - Suggest use of "git add file1 file2" when there is nothing to commit.
574 - Align section headers of 'git status' to new 'git add'.
575 - Default GIT_COMMITTER_NAME to login name in recieve-pack.
576 - Suggest 'add' in am/revert/cherry-pick.
577 - Rename imap-send's internal info/warn functions.
578 - Introduce a global level warn() function.
579 - Don't crash during repack of a reflog with pruned commits.
580 - Use extended SHA1 syntax in merge-recursive conflicts.
581 - Display 'theirs' branch name when possible in merge.
582 - Rename gitfakemmap to git_mmap.
583 - Switch git_mmap to use pread.
584 -
585 -Terje Sten Bjerkseth (1):
586 - Fix system header problems on Mac OS X
587 -
588 -Uwe Zeisberger (1):
589 - Fix documentation copy&paste typo
590 -