~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Martin Pool
  • Date: 2010-02-11 04:20:19 UTC
  • mto: This revision was merged to the branch mainline in revision 5029.
  • Revision ID: mbp@sourcefrog.net-20100211042019-o7e4sgd2z5b82mw3
Add vim modeline

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
What's New in Bazaar 2.1?
2
 
=========================
3
 
 
4
 
This document outlines the major improvements in Bazaar 2.1
5
 
vs Bazaar 2.0. As well as summarizing improvements made to
6
 
the core product, it highlights enhancements within the broader
7
 
Bazaar world of potential interest to those upgrading.
8
 
 
9
 
Bazaar 2.1.0 marks the start of our second long-term-stable series.
10
 
This series will be supported with bug fixes for the next 12 months.
11
 
All users are encouraged to upgrade from the 2.0.x stable series.
12
 
 
13
 
 
14
 
Better efficiency
15
 
-----------------
16
 
 
17
 
Many operations now consume less memory. Several operations are
18
 
also faster including branching, logging merged revisions and
19
 
upgrading from pre-2a to 2a format.
20
 
 
21
 
 
22
 
New command options
23
 
-------------------
24
 
 
25
 
Several commands have new options. These include:
26
 
 
27
 
===========     ==============  ======================================
28
 
Command         Option            Description
29
 
===========     ==============  ======================================
30
 
branch          bind            Bind to the source location
31
 
commit          commit-time     Give an explicit commit timestamp
32
 
switch          revision        Switch to a particular revision
33
 
unshelve        keep            Apply changes but don't delete them
34
 
unshelve        preview         Show the diff that would result from
35
 
                                unshelving
36
 
update          revision        Update to a particular revision
37
 
===========     ==============  ======================================
38
 
 
39
 
Other command improvements include:
40
 
 
41
 
* A :doc:`../user-reference/shelve-help` editor can be defined to provide shelf functionality at
42
 
  a granularity finer than per-patch hunk.
43
 
 
44
 
* :doc:`../user-reference/send-help` send now supports the OS X Mail application.
45
 
 
46
 
See the help for the commands above for further details.
47
 
 
48
 
 
49
 
Per-file merge hooks
50
 
--------------------
51
 
 
52
 
Hooks can now be defined for smart merging of selected file types.
53
 
This enables easier merging of ChangeLogs, Release Notes and other
54
 
file that frequently conflict.
55
 
 
56
 
 
57
 
DWIM revision identifiers
58
 
-------------------------
59
 
 
60
 
Revision identifiers can now be given in a *Do-What-I-Mean* style.
61
 
For example, you can now just give a tag (instead of saying ``tag:xxx``)
62
 
or just say ``today`` (instead of saying ``date:today``). Prefixes
63
 
are now only required if the revision spec could be ambiguous.
64
 
 
65
 
Launchpad compatibility
66
 
-----------------------
67
 
 
68
 
Launchpad has `announced
69
 
<http://blog.launchpad.net/general/edge-is-deprecated>`_ that the
70
 
``edge.launchpad.net`` instance is deprecated and may be shut down in the
71
 
future . Bazaar has therefore been updated in this release to talk to the main
72
 
(``launchpad.net``) servers, rather than the ``edge`` ones (the same code is
73
 
running on both servers during the interim).
74
 
 
75
 
 
76
 
New ignore patterns
77
 
-------------------
78
 
 
79
 
Patterns prefixed with ``!`` are exceptions to ignore patterns and
80
 
take precedence over regular ignores. Such exceptions are used to
81
 
specify files that should be versioned which would otherwise be
82
 
ignored. Patterns prefixed with ``!!`` act as regular ignore patterns,
83
 
but have highest precedence, even over the ``!`` exception patterns. 
84
 
 
85
 
 
86
 
Smart server home directory support
87
 
-----------------------------------
88
 
 
89
 
``bzr+ssh`` and ``bzr`` paths can now be relative to home directories
90
 
specified in the URL.  Paths starting with a path segment of ``~`` are
91
 
relative to the home directory of the user running the server, and paths
92
 
starting with ``~user`` are relative to the home directory of the named
93
 
user.  For example, for a user "bob" with a home directory of
94
 
``/home/bob``, these URLs are all equivalent:
95
 
 
96
 
* ``bzr+ssh://bob@host/~/repo``
97
 
* ``bzr+ssh://bob@host/~bob/repo``
98
 
* ``bzr+ssh://bob@host/home/bob/repo``
99
 
 
100
 
If ``bzr serve`` was invoked with a ``--directory`` argument, then no
101
 
home directories outside that directory will be accessible via this
102
 
method.
103
 
 
104
 
This is a feature of ``bzr serve``, so pre-2.1 clients will
105
 
automatically benefit from this feature when ``bzr`` on the server is
106
 
upgraded.
107
 
 
108
 
 
109
 
Generalized glob support on Windows
110
 
-----------------------------------
111
 
 
112
 
On Windows, glob expansion is now handled in a universal way across
113
 
all commands. In previous versions, it was explicitly handed by just
114
 
a few commands, e.g. ``add``. A side effect of this change is that
115
 
patterns now need to be quoted when passed to the ``ignore`` command,
116
 
e.g. ``bzr ignore *.foo`` now needs to be given as ``bzr ignore "*.foo"``.
117
 
 
118
 
 
119
 
Improved Git and Mercurial interoperability
120
 
-------------------------------------------
121
 
 
122
 
Many improvements have been made to the git_ and hg_ plugins.
123
 
With these plugins installed, most Git and Mercurial repositories
124
 
can now be read by standard Bazaar clients. Changes can also
125
 
be written back via the dpush command.
126
 
 
127
 
.. _git: http://doc.bazaar.canonical.com/plugins/en/git-plugin.html
128
 
.. _hg: http://doc.bazaar.canonical.com/plugins/en/hg-plugin.html
129
 
 
130
 
 
131
 
Metaprojects
132
 
------------
133
 
 
134
 
New plugins are available for constructing larger projects
135
 
from smaller ones. These include:
136
 
 
137
 
* builder_ - construction of a branch using recipes
138
 
* externals_ - Subversion-style external branches
139
 
 
140
 
.. note::
141
 
 
142
 
   The builder plugin has been designed to complement the builddeb_
143
 
   plugin to streamline Debian source package management. It may also
144
 
   be useful for building test images for a QA team or disk images
145
 
   for installers, say.
146
 
 
147
 
.. _builder: http://doc.bazaar.canonical.com/plugins/en/builder-plugin.html
148
 
.. _externals: http://doc.bazaar.canonical.com/plugins/en/externals-plugin.html
149
 
.. _builddeb: http://doc.bazaar.canonical.com/plugins/en/builddeb-plugin.html
150
 
 
151
 
 
152
 
Colocated branch workspaces
153
 
---------------------------
154
 
 
155
 
A colocated workspace is one where a single working tree is used
156
 
across one or more branches managed at that same location. This
157
 
is now supported by the new colo_ plugin and by Bazaar Explorer.
158
 
 
159
 
.. _colo: http://doc.bazaar.canonical.com/plugins/en/colo-plugin.html
160
 
 
161
 
 
162
 
Better documentation
163
 
--------------------
164
 
 
165
 
A :doc:`../admin-guide/index` covering topics such as setting up servers,
166
 
security, backups and email integration has been added.
167
 
 
168
 
A large number of documentation bugs have been fixed, clarifying
169
 
numerous issues and filling in some missing holes.
170
 
 
171
 
The :doc:`../user-reference/index`
172
 
has been organized into topics making it easier to
173
 
navigate through and print selected sections of.
174
 
 
175
 
To assist users migrating from other tools, a
176
 
`Survival Guide <http://doc.bazaar.canonical.com/migration/en/survival/index.html>`_
177
 
has been published explaining Bazaar to users of other tools in terms they
178
 
already know. Sections are provided for existing users of 
179
 
CVS, Subversion, ClearCase, Perforce, Visual SourceSafe, Git, Mercurial,
180
 
Darcs and Monotone.
181
 
 
182
 
Selected documents have also been translated to Japanese.
183
 
 
184
 
 
185
 
Enhanced GUI clients
186
 
--------------------
187
 
 
188
 
Numerous enhancements have been made to most of our GUIs including
189
 
Bazaar Explorer, TortoiseBZR and the QBzr-Eclipse add-on. These
190
 
applications all build on top of improvements made to QBzr. Bzr-gtk
191
 
has also been improved.
192
 
 
193
 
Bazaar Explorer has over a dozen new features including smart toolbars,
194
 
support for all bzr commands (including those in plugins),
195
 
a better working tree browser and a submit delta report showing the
196
 
cumulative effect of a series of commits.
197
 
See `What's New in Bazaar Explorer 1.0?
198
 
<http://doc.bazaar.canonical.com/explorer/en/whats-new/whats-new-in-1.0.html>`_
199
 
for more information.
200
 
 
201
 
 
202
 
Further information
203
 
-------------------
204
 
 
205
 
For more detailed information on the changes made, be sure to check
206
 
the :doc:`../release-notes/index` for:
207
 
 
208
 
* the interim bzr `milestones <https://launchpad.net/bzr/2.1>`_
209
 
* the plugins you use.
210
 
 
211
 
Enjoy,
212
 
The Bazaar Development Team