~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-10-06 10:15:06 UTC
  • mfrom: (6195.1.1 trunk)
  • Revision ID: pqm@pqm.ubuntu.com-20111006101506-mychax14dy7yjee2
(vila) Tag bzr-2.5b2 missed during freeze (Vincent Ladeuil)

Show diffs side-by-side

added added

removed removed

Lines of Context:
5
5
.. toctree::
6
6
   :maxdepth: 1
7
7
 
8
 
bzr 2.5b1
 
8
bzr 2.5b3
9
9
#########
10
10
 
11
 
:2.5b1: NOT RELEASED YET
 
11
:2.x.y: 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
 
* 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)
 
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
************
27
222
 
28
223
* A ``from_unicode`` parameter can be specified when registering a config
29
224
  option. This implements boolean, integer and list config options when the
56
251
 
57
252
* Add a config option gpg_signing_key for setting which GPG key should
58
253
  be used to sign commits. Also default to using the gpg user identity
59
 
  which matches user_email() as set by whoami. (Jonathan Riddell,
60
 
  #68501)
 
254
  which matches user_email() as set by whoami.
 
255
  (Jonathan Riddell, #68501)
61
256
 
62
257
* An ``invalid`` parameter can be specified when registering a config option
63
258
  to decide what should be done when invalid values are
64
 
  encountered. 'warning' and 'eeror' will respectively emit a warning and
 
259
  encountered. 'warning' and 'error' will respectively emit a warning and
65
260
  ignore the value or errors out. (Vincent Ladeuil)
66
261
 
 
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
 
67
267
* ``bzr help configuration/<option>`` display the help for ``option`` for
68
268
  all registered configuration options. (Vincent Ladeuil, #747050)
69
269
 
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.
 
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)
74
274
 
75
275
* ``config.Option`` can now declare ``default_from_env``, a list of
76
276
  environment variables to get a default value from. (Vincent Ladeuil)
85
285
* Relative local paths can now be specified in URL syntax by using the
86
286
  "file:" prefix.  (Jelmer Vernooij)
87
287
 
88
 
* Report commits signed with expired keys in "verify-signatures".
 
288
* Report commits signed with expired keys in ``verify-signatures``.
89
289
  (Jonathan Riddell, #804254)
90
290
 
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)
 
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)
101
294
 
102
295
Improvements
103
296
************
104
297
 
105
 
.. Improvements to existing commands, especially improved performance 
106
 
   or memory usage, or better results.
 
298
* ``bzr add`` will now warn about nested subtrees that are skipped.
 
299
  (Jelmer Vernooij, #187342)
107
300
 
108
301
* ``bzr commit -m ''`` can now be used to force an empty commit message.
109
302
  Entering an empty commit message in the message editor still triggers
120
313
  The ``--keep-tags`` option can be used to prevent this behaviour.
121
314
  (Jelmer Vernooij, #605814)
122
315
 
 
316
* Do not run i18n initialisation twice. (Jonathan Riddell)
 
317
 
 
318
* Install translation .mo files. (Jonathan Riddell)
 
319
 
123
320
* Locations printed by ``bzr upgrade`` are now formatted before display.
124
321
  (Jelmer Vernooij)
125
322
 
126
 
* Install translation .mo files. (Jonathan Riddell)
127
 
 
128
 
* Do not run i18n initialisation twice. (Jonathan Riddell)
 
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)
129
328
 
130
329
* Support a ``bugtracker`` option which is used by ``bzr commit --fixes``
131
330
  if no bug tracker was specified on the command line.
132
331
  (Jelmer Vernooij, #334860)
133
332
 
 
333
* Use ``gettext.NullTranslations`` in i18n to allow use of i18n even when
 
334
  translations are not turned on. (Jonathan Riddell)
 
335
 
134
336
Bug Fixes
135
337
*********
136
338
 
137
 
.. Fixes for situations where bzr would previously crash or give incorrect
138
 
   or undesirable results.
 
339
* ``bzr commit`` now correctly reports missing files as "removed", not
 
340
  "modified". (Jelmer Vernooij, #553955)
139
341
 
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)
 
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)
144
345
 
145
346
* A call to CHKInventory's filter-method will not result in a
146
347
  DuplicateFileId error, if you move a subfolder and change a file in
160
361
  raised whenever a transport at the drive root was opened on windows.
161
362
  (Martin [gz], #841322)
162
363
 
 
364
* Fixed loading of external merge tools from config to properly decode
 
365
  command-lines which contain embedded quotes. (Gordon Tyler, #828803)
 
366
 
163
367
* Rather than an error being raised, a warning is now printed when the
164
368
  current user does not have permission to read a configuration file.
165
369
  (Jelmer Vernooij, #837324)
166
370
 
 
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
 
167
376
* TreeTransformBase.fixup_new_roots no longer forces trees to have a root, so
168
377
  operations that use it, like merge, can now create trees without a root.
169
378
  (Aaron Bentley)
171
380
Documentation
172
381
*************
173
382
 
174
 
.. Improved or updated documentation.
175
 
 
176
383
* Release instructions refreshed. (Vincent Ladeuil)
177
384
 
178
385
API Changes
179
386
***********
180
387
 
181
 
.. Changes that may require updates in plugins or other code that uses
182
 
   bzrlib.
 
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)
183
397
 
184
398
* New class ``URL`` in ``bzrlib.utils`` for managing parsed URLs.
185
399
  (Jelmer Vernooij)
186
400
 
 
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)
 
408
 
 
409
* New method ``Tree.get_file_verifier`` which allows tree implementations
 
410
  to return non-sha1 checksums to verify files.
 
411
  (Jelmer Vernooij, #720831)
 
412
 
187
413
* New methods ``get_transport_from_path`` and ``get_transport_from_url``
188
414
  have been added that only support opening from a path or a URL,
189
415
  unlike ``get_transport``. (Jelmer Vernooij)
190
416
 
191
 
* New method ``Tree.get_file_verifier`` which allows tree implementations
192
 
  to return non-sha1 checksums to verify files.
193
 
  (Jelmer Vernooij, #720831)
194
 
 
195
 
* New method ``InterTree.file_content_matches`` which checks that
196
 
  two files in different trees have the same contents.
197
 
  (Jelmer Vernooij)
198
 
 
199
417
* New registry ``OptionRegistry`` specialized for configuration options.
200
418
  (Vincent Ladeuil)
201
419
 
223
441
  ``UIFactory.warn_experimental_format_fetch`` in favor of
224
442
  ``UIFactory.show_user_warning``. (Jelmer Vernooij)
225
443
 
 
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
 
226
451
* There is a new class `ContentFilterTree` that provides a facade for 
227
452
  content filtering.  The `filtered` parameter to `export` is deprecated 
228
453
  in favor of passing a filtered tree, and the specific exporter plugins
229
454
  no longer support it.
230
455
  (Martin Pool)
231
456
 
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
 
 
243
457
* ``Transport`` now has a ``_parsed_url`` attribute instead of
244
458
  separate ``_user``, ``_password``, ``_port``, ``_scheme``, ``_host``
245
459
  and ``_path`` attributes. Proxies are provided for the moment but
246
460
  may be removed in the future. (Jelmer Vernooij)
247
461
 
248
 
 
249
462
Internals
250
463
*********
251
464
 
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
 
465
* A new debug flag ``hpss_client_no_vfs`` will now cause the HPSS client
256
466
  to raise a ``HpssVfsRequestNotAllowed`` exception when a VFS request
257
467
  is attempted. (Jelmer Vernooij)
258
468
 
263
473
Testing
264
474
*******
265
475
 
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)
 
476
* Blackbox tests (including test scripts) can be debugged interactively (see
 
477
  bzrlib.debug.BzrPdb for details). (Vincent Ladeuil)
272
478
 
273
479
* `BranchBuilder.build_snapshot` now supports a "flush" action.  This
274
480
  cleanly and reliably allows tests using `BranchBuilder` to construct