← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/whats-new/whats-new-in-2.3.txt

  • Committer: Robert Collins
  • Date: 2006-06-09 07:45:35 UTC
  • mto: (1755.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 1756.
  • Revision ID: robertc@robertcollins.net-20060609074535-3002a0209179b35c
Fixup '== None' usage in inventory.py.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/whats-new/whats-new-in-2.3.txt
1
 
*************************
2
 
What's New in Bazaar 2.3?
3
 
*************************
4
 
 
5
 
Bazaar 2.3 has been released on the 3rd of February 2011 and marks the start
6
 
of another long-term-stable series. From here, we will only make bugfix
7
 
releases on the 2.3 series (2.3.1, etc), while 2.4 will become our new
8
 
development series. The 2.1 and 2.2 series will also continue to get
9
 
bugfixes. (Currently 2.0 is planned to be EOLed circa September 2011.)
10
 
 
11
 
This document accumulates a high level summary of what's changed.
12
 
See the
13
 
:doc:`../release-notes/index` for a full list.
14
 
 
15
 
Users are encouraged to upgrade from the other stable series.  This document
16
 
outlines the improvements in Bazaar 2.3 vs Bazaar 2.2. As well as summarizing
17
 
improvements made to the core product, it highlights enhancements within the
18
 
broader Bazaar world of potential interest to those upgrading.
19
 
 
20
 
Bazaar 2.3.1 includes all the fixes in the un-released 2.0.7, 2.1.4 and 2.2.5
21
 
versions that weren't included in 2.3.0 and fixes some bugs on its own.
22
 
 
23
 
See the :doc:`../release-notes/index` for details.
24
 
 
25
 
Bazaar 2.3 is fully compatible both locally and on the network with 2.0, 2.1,
26
 
and 2.2. It can read and write repositories generated by all previous
27
 
versions.
28
 
 
29
 
Changed Behaviour
30
 
*****************
31
 
 
32
 
* Committing a new revision in a stacked branch is now supported, as long as
33
 
  you are using the current repository format (2a). It will preserve the
34
 
  stacking invariants, etc, so that fetching after commit is guaranteed to
35
 
  work. (John Arbash Meinel, #375013)
36
 
 
37
 
* Support for some old development formats have been removed:
38
 
  ``development-rich-root``, ``development6-rich-root``, and
39
 
  ``development7-rich-root``.  These formats were always labelled experimental
40
 
  and not used unless the user specifically asked for them.  If you have
41
 
  repositories using these old formats you should upgrade them to ``2a`` using
42
 
  Bazaar 2.2.  (Andrew Bennetts)
43
 
 
44
 
* The default ``ignore`` file created by Bazaar will contain ``__pycache__``,
45
 
  which is the name of the directory that will be used by Python to store
46
 
  bytecode files.
47
 
  (Andrea Corbellini, #626687)
48
 
 
49
 
* The default sort order for the ``bzr tags`` command now uses a natural sort
50
 
  where numeric substrings are sorted numerically.  The previous default was
51
 
  "asciibetical" where tags were sorted by the characters they contained.  To
52
 
  get the old behavior, one can use ``bzr tags --sort=alpha``.
53
 
  (Neil Martinsen-Burrell, #640760)
54
 
 
55
 
* On platforms other than Windows and Mac OS X, Bazaar will use configuration
56
 
  files that live in $XDG_CONFIG_HOME/bazaar if that directory exists.  This
57
 
  allows interested individuals to conform to the XDG Base Directory
58
 
  specification.  The plugin location has not changed and is still
59
 
  ~/.bazaar/plugins.  To use a different directory for plugins, use the
60
 
  environment variable BZR_PLUGIN_PATH.  (Neil Martinsen-Burrell, #195397)
61
 
 
62
 
* ``bzr upgrade`` now operates recursively when run on a shared
63
 
  repository, automatically upgrading the branches within it, and has
64
 
  grown additional options for showing what it will do and cleaning up
65
 
  after itself.  (Ian Clatworthy, Matthew Fuller, #89830, #374734, #422450)
66
 
 
67
 
Launchpad integration
68
 
*********************
69
 
 
70
 
* The ``lp:`` prefix will now use your known username (from
71
 
  ``bzr launchpad-login``) to expand ``~`` to your username.  For example:
72
 
  ``bzr launchpad-login user && bzr push lp:~/project/branch`` will now
73
 
  push to ``lp:~user/project/branch``.  (John Arbash Meinel)
74
 
 
75
 
* Launchpad has announced that the ``edge.launchpad.net`` instance is
76
 
  deprecated and may be shut down in the future
77
 
  <http://blog.launchpad.net/general/edge-is-deprecated>.  Bazaar has therefore
78
 
  been updated in this release to talk to the main (``launchpad.net``) servers,
79
 
  rather than the ``edge`` ones.
80
 
 
81
 
Performance improvements
82
 
************************
83
 
 
84
 
* ``bzr revert`` and ``bzr status`` are up to 15% faster on large trees
85
 
  with many changes by not repeatedly building a list of all file-ids.
86
 
  (Andrew Bennetts)
87
 
 
88
 
* ``bzr send`` uses less memory.
89
 
  (John Arbash Meinel, #614576)
90
 
 
91
 
* Fetches involving stacked branches and branches with tags now do slightly less
92
 
  I/O, and so does branching from an existing branch.  This also improves the
93
 
  network performance of these operations.  (Andrew Bennetts)
94
 
 
95
 
* Inventory entries now consume less memory (on 32-bit Ubuntu file entries
96
 
  have dropped from 68 bytes to 40, and directory entries from 120 bytes
97
 
  to 48).  This affects most operations, and depending on the size of the
98
 
  tree may substantially improve the speed of operations like ``bzr
99
 
  commit``.  (Andrew Bennetts)
100
 
 
101
 
* Lower memory consumption when reading many chk index pages. Helpful for
102
 
  things like ``bzr co`` or ``bzr ls -R`` on large trees.
103
 
  (John Arbash Meinel)
104
 
 
105
 
* When building new working trees, default to reading from the repository
106
 
  rather than the source tree unless explicitly requested. (via
107
 
  ``--files-from`` and ``--hardlink`` for ``bzr branch`` and
108
 
  ``bzr checkout``. Generally, 2a format repositories extract
109
 
  content faster than seeking and reading content from another tree,
110
 
  especially in cold-cache situations. (John Arbash Meinel, #607298)
111
 
 
112
 
New revision specifiers
113
 
***********************
114
 
 
115
 
* The ``mainline`` revision specifier has been added.  It takes another revision
116
 
  spec as its input, and selects the revision which merged that revision into
117
 
  the mainline.
118
 
  
119
 
  For example, ``bzr log -vp -r mainline:1.2.3`` will show the log of the
120
 
  revision that merged revision 1.2.3 into mainline, along with its status
121
 
  output and diff.  (Aaron Bentley)
122
 
 
123
 
* The ``annotate`` revision specifier has been added.  It takes a path and a
124
 
  line as its input (in the form ``path:line``), and selects the revision which
125
 
  introduced that line of that file.
126
 
 
127
 
  For example: ``bzr log -vp -r annotate:bzrlib/transform.py:500`` will select
128
 
  the revision that introduced line 500 of transform.py, and display its log,
129
 
  status output and diff.
130
 
 
131
 
  It can be combined with ``mainline`` to select the revision that landed this
132
 
  line into trunk, like so: 
133
 
  ``bzr log -vp -r mainline:annotate:bzrlib/transform.py:500``
134
 
  (Aaron Bentley)
135
 
 
136
 
Testing/Bug reporting
137
 
*********************
138
 
 
139
 
* Shell-like scripts can now be run directly from the command line without
140
 
  writing a python test. This should help users adding reproducing recipes
141
 
  to bug reports. (Vincent Ladeuil)
142
 
 
143
 
 
144
 
Improved conflict handling
145
 
**************************
146
 
 
147
 
* ``pull``, ``merge`` or ``switch`` can lead to conflicts when deleting a
148
 
  versioned directory contains unversioned files. The cause of the conflict
149
 
  is that deleting the directory will orphan the unversioned files so the
150
 
  user needs to instruct ``bzr`` what do to do about these orpahns. This is
151
 
  controlled by setting the ``bzr.transform.orphan_policy`` configuration
152
 
  variable with a value of ``move``. In this case the unversioned files are
153
 
  moved to a ``bzr-orphans`` directory at the root of the working tree. The
154
 
  default behaviour is specified (if needed) by setting the variable to
155
 
  ``conflict``.  (Vincent Ladeuil, #323111)
156
 
 
157
 
* ``bzr resolve --take-this`` and ``bzr resolve --take-other`` can now be
158
 
  used for text conflicts. This will ignore the differences that were merged
159
 
  cleanly and replace the file with its content in the current branch
160
 
  (``--take-this``) or with its content in the merged branch
161
 
  (``--take-other``). (Vincent Ladeuil, #638451)
162
 
 
163
 
* ``bzr resolve`` now provides more feedback about the conflicts just
164
 
  resolved and the remaining ones. (Vincent Ladeuil)
165
 
 
166
 
Documentation
167
 
*************
168
 
 
169
 
* A beta version of the documentation is now available in GNU TexInfo
170
 
  format, used by emacs and the standalone ``info`` reader.
171
 
  (Vincent Ladeuil, #219334)
172
 
 
173
 
Configuration
174
 
*************
175
 
 
176
 
``bzr`` can be configured via environment variables, command-line options
177
 
and configurations files. We've started working on unifying this and give
178
 
access to more options. The first step is a new ``bzr config`` command that
179
 
can be used to display the active configuration options in the current
180
 
working tree or branch as well as the ability to set or remove an
181
 
option. Scripts can also use it to get only the value for a given option.
182
 
 
183
 
Further information
184
 
*******************
185
 
 
186
 
For more detailed information on the changes made, see the
187
 
the :doc:`../release-notes/index` for:
188
 
 
189
 
* the interim bzr `milestones <https://launchpad.net/bzr/2.3>`_
190
 
* the plugins you use.
191
 
 
192
 
For a summary of changes made in earlier releases, see:
193
 
 
194
 
* :doc:`whats-new-in-2.1`
195
 
* :doc:`whats-new-in-2.2`
196
 
 
197
 
 
198
 
.. vim: ft=rst