~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/release-notes/bzr-2.5.txt

  • Committer: Patch Queue Manager
  • Date: 2011-09-08 11:01:15 UTC
  • mfrom: (6123.1.16 gpg-typo)
  • Revision ID: pqm@cupuasso-20110908110115-gbb9benwkdksvzk5
(jelmer) Fix a typo (invalid format identifier) in an error message in
 bzrlib.gpg. (Jelmer Vernooij)

Show diffs side-by-side

added added

removed removed

Lines of Context:
5
5
.. toctree::
6
6
   :maxdepth: 1
7
7
 
8
 
bzr 2.5b3
 
8
bzr 2.5b1
9
9
#########
10
10
 
11
 
:2.x.y: NOT RELEASED YET
 
11
:2.5b1: NOT RELEASED YET
12
12
 
13
13
External Compatibility Breaks
14
14
*****************************
20
20
 
21
21
.. New commands, options, etc that users may wish to try out.
22
22
 
23
 
Improvements
24
 
************
25
 
 
26
 
.. Improvements to existing commands, especially improved performance 
27
 
   or memory usage, or better results.
28
 
 
29
 
Bug Fixes
30
 
*********
31
 
 
32
 
.. Fixes for situations where bzr would previously crash or give incorrect
33
 
   or undesirable results.
34
 
 
35
 
Documentation
36
 
*************
37
 
 
38
 
.. Improved or updated documentation.
39
 
 
40
 
API Changes
41
 
***********
42
 
 
43
 
.. Changes that may require updates in plugins or other code that uses
44
 
   bzrlib.
45
 
 
46
 
Internals
47
 
*********
48
 
 
49
 
.. Major internal changes, unlikely to be visible to users or plugin 
50
 
   developers, but interesting for bzr developers.
51
 
 
52
 
Testing
53
 
*******
54
 
 
55
 
.. Fixes and changes that are only relevant to bzr's test framework and 
56
 
   suite.  This can include new facilities for writing tests, fixes to 
57
 
   spurious test failures and changes to the way things should be tested.
58
 
 
59
 
 
60
 
bzr 2.5b2
61
 
#########
62
 
 
63
 
This is the second beta of the 2.5 series, leading to a 2.5.0 release in
64
 
February 2012. Beta releases are suitable for everyday use but may cause some
65
 
incompatibilities with plugins.
66
 
 
67
 
This release includes more filtering options for ``bzr log``, idle
68
 
connections handling for ``bzr serve``, a ``development-colo`` experimental
69
 
format to flesh out the colocated branches UI, better support for foreign
70
 
formats, enhancements to the config framework and more.
71
 
 
72
 
This release includes all bug fixed in previous series known at the time of
73
 
this release.
74
 
 
75
 
:2.5b2: 2011-10-06
76
 
 
77
 
External Compatibility Breaks
78
 
*****************************
79
 
 
80
 
None
81
 
 
82
 
New Features
83
 
************
84
 
 
85
 
* A new ``-O`` standard option (common to all commands) have been added. It
86
 
  provides a value for a config option in the ``-Oname=value`` form that
87
 
  takes precedence over all definitions found in config files.  It can be
88
 
  used multiple times to override different options.
89
 
  (Vincent Ladeuil, #491196)
90
 
 
91
 
* ``bzr log`` now has an option called ``--omit-merges`` to omit
92
 
  those commits that merged branches, i.e. those having more than one
93
 
  parent.
94
 
  In order to avoid confusion, the previous command line option
95
 
  ``--include-merges`` has been renamed to ``--include-merged``.
96
 
  The old name of the command line option will still be accepted.
97
 
  The name change also affects ``bzr missing``.
98
 
  (Martin von Gagern)
99
 
 
100
 
* ``bzr serve`` will now disconnect clients if they have not issued an RPC
101
 
  request after 5minutes. On POSIX platforms, this will also happen for
102
 
  ``bzr serve --inet``. This can be overridden with the configuration
103
 
  variable ``serve.client_timeout`` or in the command line parameter
104
 
  ``bzr serve --client-timeout=X``. Further, it is possible to request
105
 
  ``bzr serve [--inet]`` to shutdown gracefully by sending SIGHUP. It will
106
 
  finish the current request, and then close the connection.
107
 
  (John Arbash Meinel, #824797, #795025)
108
 
 
109
 
* The new experimental format ``development-colo`` supports colocated
110
 
  branches. This format will eventually be merged back into the ``2a``
111
 
  format when it has stabilized and there is adequate UI support for
112
 
  colocated branches.
113
 
  (Jelmer Vernooij, #831481)
114
 
 
115
 
Improvements
116
 
************
117
 
 
118
 
* Fixed a bug where ``bzr tags -r x..y`` loaded the branch history once for
119
 
  every revision in the range; it's now much faster. (Vincent Ladeuil, #857335)
120
 
 
121
 
* ``bzr info -v`` can now be run against branches that don't support
122
 
  ``last_revision_info``, in which case the branch information will simply
123
 
  not be displayed. (Jelmer Vernooij)
124
 
 
125
 
Bug Fixes
126
 
*********
127
 
 
128
 
* ``bzr shelve`` can now be used in emacs shells as the input handling is
129
 
  turned into a line-based one when ``INSIDE_EMACS`` is set (which is the
130
 
  case for all recent emacs versions). (Vincent Ladeuil, #856261)
131
 
 
132
 
* ``bzr tags`` can now be used against remote repositories that do
133
 
  not provide access to the revision graph. (Jelmer Vernooij, #858942)
134
 
 
135
 
* ``bzr update PATH`` will stop if you seem to be asking it to update
136
 
  anything less than a whole tree, because that's not supported by ``bzr``'s
137
 
  concept that the whole tree has a single basis revision.  Previously, it
138
 
  would go ahead and update the whole tree, which was surprising.
139
 
  (Martin Pool, #557886)
140
 
 
141
 
* Don't crash if ``bzrlib.initialize()`` has not been called while accessing
142
 
  configs.  (Vincent Ladeuil, #863401)
143
 
 
144
 
* Redirects between http and https no longer discard path information
145
 
  in some cases. (Jelmer Vernooij, #853765)
146
 
 
147
 
* The ``--overwrite`` argument to ``bzr push`` and ``bzr pull`` no longer
148
 
  reports all tags as changed. (Jelmer Vernooij, #845396)
149
 
 
150
 
* ``WorkingTree.get_file_mtime`` now raises NoSuchId if a file id is
151
 
  specified that is unknown. (Jelmer Vernooij, #847435)
152
 
 
153
 
 
154
 
API Changes
155
 
***********
156
 
 
157
 
* ``Branch.get_revision_delta`` has been deprecated. Use
158
 
  ``Repository.get_revision_delta`` instead. (Jelmer Vernooij, #859712)
159
 
 
160
 
* Plugins that implement custom protocols for ``bzr serve`` should now
161
 
  also take an argument ``timeout``. This is used by the the bzr protocol
162
 
  to close a connection if a client has been idle for more than X seconds.
163
 
  (Default 5minutes). (John Arbash Meinel)
164
 
 
165
 
* ``Repository.fileids_altered_by_revision_ids`` has been moved to
166
 
  ``VersionedFileRepository`` and is no longer part of the standard
167
 
  ``Repository`` interface. (Jelmer Vernooij)
168
 
 
169
 
* The argument ``include_merges`` to ``missing.find_unmerged`` has
170
 
  been renamed to ``include_merged``. The old name is still supported
171
 
  for now but will cause a deprecation warning. (Martin von Gagern)
172
 
 
173
 
* The new method ``ControlDirFormat.is_initializable()`` returns a boolean
174
 
  indicating whether or not it is possible to use any of the
175
 
  initialization methods of that format to create a new control dir.
176
 
  (Jelmer Vernooij)
177
 
 
178
 
Internals
179
 
*********
180
 
 
181
 
* ``Branch`` objects can now use a config stack with the newly introduced
182
 
  ``get_config_stack()``. Both ``get_config`` and ``get_config_stack`` can
183
 
  be used for the same branch but it's recommended to stick to one for a
184
 
  given option.
185
 
 
186
 
Testing
187
 
*******
188
 
 
189
 
* Test scripts can now use ``bzr shelve`` and provide their input as
190
 
  complete lines. (Vincent Ladeuil, #856261)
191
 
 
192
 
* Really corrupt the pack file without depending on a special length or value.
193
 
  (Vincent Ladeuil, #807032)
194
 
 
195
 
 
196
 
bzr 2.5b1
197
 
#########
198
 
 
199
 
:2.5b1: 2011-09-15
200
 
 
201
 
This is the first beta of the 2.5 series, leading up to a 2.5.0
202
 
release in February 2012.
203
 
 
204
 
This release includes better support for gpg signing, better support for
205
 
i18n (mostly command help and error messages), more options to filter ``bzr
206
 
log`` output, more support for colocated branches ("location,branch=XXX"
207
 
syntax), better feedback on updated tags for various commands, faster
208
 
branching into an empty repository, enhancements to the config framework and
209
 
more.
210
 
 
211
 
Beta releases are suitable for everyday use but may cause some
212
 
incompatibilities with plugins.  Some plugins may need small updates to work
213
 
with 2.5b1.
214
 
 
215
 
External Compatibility Breaks
216
 
*****************************
217
 
 
218
 
None
219
 
 
220
 
New Features
221
 
************
 
23
* A ``from_unicode`` parameter can be specified when registering a config
 
24
  option. This implements boolean and integer config options when the
 
25
  provided ``bool_from_store`` and ``int_from_store`` are used.
 
26
  (Vincent Ladeuil)
222
27
 
223
28
* A ``from_unicode`` parameter can be specified when registering a config
224
29
  option. This implements boolean, integer and list config options when the
251
56
 
252
57
* Add a config option gpg_signing_key for setting which GPG key should
253
58
  be used to sign commits. Also default to using the gpg user identity
254
 
  which matches user_email() as set by whoami.
255
 
  (Jonathan Riddell, #68501)
 
59
  which matches user_email() as set by whoami. (Jonathan Riddell,
 
60
  #68501)
256
61
 
257
62
* An ``invalid`` parameter can be specified when registering a config option
258
63
  to decide what should be done when invalid values are
259
 
  encountered. 'warning' and 'error' will respectively emit a warning and
 
64
  encountered. 'warning' and 'eeror' will respectively emit a warning and
260
65
  ignore the value or errors out. (Vincent Ladeuil)
261
66
 
262
 
* bzr add now skips large files in recursive mode. The default "large"
263
 
  size is 20MB, and is configurable via the add.maximum_file_size
264
 
  option. A value of 0 disables skipping. Named items passed to add are
265
 
  never skipped. (Shannon Weyrick, #54624)
266
 
 
267
67
* ``bzr help configuration/<option>`` display the help for ``option`` for
268
68
  all registered configuration options. (Vincent Ladeuil, #747050)
269
69
 
270
 
* ``bzr log -m`` now matches message, author, committer and bugs instead
271
 
  of just matching the message.  ``--message`` keeps its original meaning,
272
 
  while ``--match-message, --match-author, --match-committer`` and
273
 
  ``--match-bugs`` match each of those fields. (Jacek Sieka)
 
70
* bzr log -m now matches message, author, committer and bugs instead
 
71
  of just matching the message.  --message keeps its original meaning,
 
72
  while --match-message, --match-author, --match-committer and
 
73
  --match-bugs match each of those fields.
274
74
 
275
75
* ``config.Option`` can now declare ``default_from_env``, a list of
276
76
  environment variables to get a default value from. (Vincent Ladeuil)
285
85
* Relative local paths can now be specified in URL syntax by using the
286
86
  "file:" prefix.  (Jelmer Vernooij)
287
87
 
288
 
* Report commits signed with expired keys in ``verify-signatures``.
 
88
* Report commits signed with expired keys in "verify-signatures".
289
89
  (Jonathan Riddell, #804254)
290
90
 
291
 
* Translations are now enabled for command help, errors and globally
292
 
  for any message using ``gettext`` given on output.  (Jonathan Riddell,
293
 
  INADA Naoki, #83941)
 
91
* bzr add now skips large files in recursive mode. The default "large"
 
92
  size is 20MB, and is configurable via the add.maximum_file_size
 
93
  option. A value of 0 disables skipping. Named items passed to add are
 
94
  never skipped. (Shannon Weyrick, #54624)
 
95
 
 
96
* bzr now ships with translations for command help.  (Jonathan
 
97
  Riddell, INADA Naoki, #83941)
 
98
 
 
99
* bzr now ships with translations for command errors. (Jonathan
 
100
  Riddell, INADA Naoki)
294
101
 
295
102
Improvements
296
103
************
297
104
 
298
 
* ``bzr add`` will now warn about nested subtrees that are skipped.
299
 
  (Jelmer Vernooij, #187342)
 
105
.. Improvements to existing commands, especially improved performance 
 
106
   or memory usage, or better results.
300
107
 
301
108
* ``bzr commit -m ''`` can now be used to force an empty commit message.
302
109
  Entering an empty commit message in the message editor still triggers
313
120
  The ``--keep-tags`` option can be used to prevent this behaviour.
314
121
  (Jelmer Vernooij, #605814)
315
122
 
 
123
* Locations printed by ``bzr upgrade`` are now formatted before display.
 
124
  (Jelmer Vernooij)
 
125
 
 
126
* Install translation .mo files. (Jonathan Riddell)
 
127
 
316
128
* Do not run i18n initialisation twice. (Jonathan Riddell)
317
129
 
318
 
* Install translation .mo files. (Jonathan Riddell)
319
 
 
320
 
* Locations printed by ``bzr upgrade`` are now formatted before display.
321
 
  (Jelmer Vernooij)
322
 
 
323
 
* ``Repository.get_parent_map`` now estimates the size of the returned
324
 
  content more accurately. This means that we get closer to the desired
325
 
  64kB/request. For repositories converted from svn, this can be an
326
 
  improvement of approx 5:1 in round trips to discover the whole history.
327
 
  (John Arbash Meinel)
328
 
 
329
130
* Support a ``bugtracker`` option which is used by ``bzr commit --fixes``
330
131
  if no bug tracker was specified on the command line.
331
132
  (Jelmer Vernooij, #334860)
332
133
 
333
 
* Use ``gettext.NullTranslations`` in i18n to allow use of i18n even when
334
 
  translations are not turned on. (Jonathan Riddell)
335
 
 
336
134
Bug Fixes
337
135
*********
338
136
 
339
 
* ``bzr commit`` now correctly reports missing files as "removed", not
340
 
  "modified". (Jelmer Vernooij, #553955)
 
137
.. Fixes for situations where bzr would previously crash or give incorrect
 
138
   or undesirable results.
341
139
 
342
 
* ``bzr reconfigure`` will now allow multiple non-conflicting requests
343
 
  in a single invocation, e.g. ``--branch`` and ``--use-shared``.
344
 
  (Martin von Gagern, #842993)
 
140
* The pull command will now always use separate connections for the
 
141
  case where the destination is a heavyweight checkout of some remote
 
142
  branch on the same host as the source branch.
 
143
  (Martin von Gagern, #483661)
345
144
 
346
145
* A call to CHKInventory's filter-method will not result in a
347
146
  DuplicateFileId error, if you move a subfolder and change a file in
361
160
  raised whenever a transport at the drive root was opened on windows.
362
161
  (Martin [gz], #841322)
363
162
 
364
 
* Fixed loading of external merge tools from config to properly decode
365
 
  command-lines which contain embedded quotes. (Gordon Tyler, #828803)
366
 
 
367
163
* Rather than an error being raised, a warning is now printed when the
368
164
  current user does not have permission to read a configuration file.
369
165
  (Jelmer Vernooij, #837324)
370
166
 
371
 
* The pull command will now always use separate connections for the
372
 
  case where the destination is a heavyweight checkout of some remote
373
 
  branch on the same host as the source branch.
374
 
  (Martin von Gagern, #483661)
375
 
 
376
167
* TreeTransformBase.fixup_new_roots no longer forces trees to have a root, so
377
168
  operations that use it, like merge, can now create trees without a root.
378
169
  (Aaron Bentley)
380
171
Documentation
381
172
*************
382
173
 
 
174
.. Improved or updated documentation.
 
175
 
383
176
* Release instructions refreshed. (Vincent Ladeuil)
384
177
 
385
178
API Changes
386
179
***********
387
180
 
388
 
* ``BranchFormat.initialize`` now takes a ``append_revisions_only``
389
 
  argument. (Jelmer Vernooij)
390
 
 
391
 
* ``Branch._get_checkout_format`` now takes a ``lightweight`` argument
392
 
  which indicates if the format should be for a lightweight or a
393
 
  heavyweight checkout. (Jelmer Vernooij)
394
 
 
395
 
* ``ControlDir.create_branch`` now takes a ``append_revisions_only`` argument.
396
 
  (Jelmer Vernooij)
 
181
.. Changes that may require updates in plugins or other code that uses
 
182
   bzrlib.
397
183
 
398
184
* New class ``URL`` in ``bzrlib.utils`` for managing parsed URLs.
399
185
  (Jelmer Vernooij)
400
186
 
401
 
* New method ``Config.get_user_option_as_int_from_SI`` added for expanding a
402
 
  value in SI format (i.e. "20MB", "1GB") into its integer equivalent. 
403
 
  (Shannon Weyrick)
404
 
 
405
 
* New method ``InterTree.file_content_matches`` which checks that
406
 
  two files in different trees have the same contents.
407
 
  (Jelmer Vernooij)
 
187
* New methods ``get_transport_from_path`` and ``get_transport_from_url``
 
188
  have been added that only support opening from a path or a URL,
 
189
  unlike ``get_transport``. (Jelmer Vernooij)
408
190
 
409
191
* New method ``Tree.get_file_verifier`` which allows tree implementations
410
192
  to return non-sha1 checksums to verify files.
411
193
  (Jelmer Vernooij, #720831)
412
194
 
413
 
* New methods ``get_transport_from_path`` and ``get_transport_from_url``
414
 
  have been added that only support opening from a path or a URL,
415
 
  unlike ``get_transport``. (Jelmer Vernooij)
 
195
* New method ``InterTree.file_content_matches`` which checks that
 
196
  two files in different trees have the same contents.
 
197
  (Jelmer Vernooij)
416
198
 
417
199
* New registry ``OptionRegistry`` specialized for configuration options.
418
200
  (Vincent Ladeuil)
441
223
  ``UIFactory.warn_experimental_format_fetch`` in favor of
442
224
  ``UIFactory.show_user_warning``. (Jelmer Vernooij)
443
225
 
444
 
* ``Tags`` containers can now declare whether they support versioned
445
 
  tags and whether tags can refer to ghost tags.
446
 
  (Jelmer Vernooij)
447
 
 
448
 
* ``Tags.merge_to`` now returns a dictionary with the updated tags
449
 
  and a set of conflicts, rather than just conflicts. (Jelmer Vernooij)
450
 
 
451
226
* There is a new class `ContentFilterTree` that provides a facade for 
452
227
  content filtering.  The `filtered` parameter to `export` is deprecated 
453
228
  in favor of passing a filtered tree, and the specific exporter plugins
454
229
  no longer support it.
455
230
  (Martin Pool)
456
231
 
 
232
* New method ``Config.get_user_option_as_int_from_SI`` added for expanding a
 
233
  value in SI format (i.e. "20MB", "1GB") into its integer equivalent. 
 
234
  (Shannon Weyrick)
 
235
 
 
236
* ``Tags`` containers can now declare whether they support versioned
 
237
  tags and whether tags can refer to ghost tags.
 
238
  (Jelmer Vernooij)
 
239
 
 
240
* ``Tags.merge_to`` now returns a dictionary with the updated tags
 
241
  and a set of conflicts, rather than just conflicts. (Jelmer Vernooij)
 
242
 
457
243
* ``Transport`` now has a ``_parsed_url`` attribute instead of
458
244
  separate ``_user``, ``_password``, ``_port``, ``_scheme``, ``_host``
459
245
  and ``_path`` attributes. Proxies are provided for the moment but
460
246
  may be removed in the future. (Jelmer Vernooij)
461
247
 
 
248
 
462
249
Internals
463
250
*********
464
251
 
465
 
* A new debug flag ``hpss_client_no_vfs`` will now cause the HPSS client
 
252
.. Major internal changes, unlikely to be visible to users or plugin 
 
253
   developers, but interesting for bzr developers.
 
254
 
 
255
* A new debug flags ``hpss_client_no_vfs`` will now cause the HPSS client
466
256
  to raise a ``HpssVfsRequestNotAllowed`` exception when a VFS request
467
257
  is attempted. (Jelmer Vernooij)
468
258
 
473
263
Testing
474
264
*******
475
265
 
476
 
* Blackbox tests (including test scripts) can be debugged interactively (see
477
 
  bzrlib.debug.BzrPdb for details). (Vincent Ladeuil)
 
266
.. Fixes and changes that are only relevant to bzr's test framework and 
 
267
   suite.  This can include new facilities for writing tests, fixes to 
 
268
   spurious test failures and changes to the way things should be tested.
 
269
 
 
270
* Blackbox tests can be debugged interactively (see bzrlib.debug.BzrPdb for
 
271
  details). (Vincent Ladeuil)
478
272
 
479
273
* `BranchBuilder.build_snapshot` now supports a "flush" action.  This
480
274
  cleanly and reliably allows tests using `BranchBuilder` to construct