~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

(jelmer) Use the absolute_import feature everywhere in bzrlib,
 and add a source test to make sure it's used everywhere. (Jelmer Vernooij)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
####################
 
2
Bazaar Release Notes
 
3
####################
 
4
 
 
5
.. toctree::
 
6
   :maxdepth: 1
 
7
 
 
8
bzr 2.5b5
 
9
#########
 
10
 
 
11
:2.5b5: NOT RELEASED YET
 
12
 
 
13
External Compatibility Breaks
 
14
*****************************
 
15
 
 
16
.. These may require users to change the way they use Bazaar.
 
17
 
 
18
* The '.bzr/branch/email' file is no longer read to determine the users'
 
19
  identity. Instead, the 'email' setting in '.bzr/branch/branch.conf'
 
20
  should be used. (Jelmer Vernooij, #903894)
 
21
 
 
22
New Features
 
23
************
 
24
 
 
25
.. New commands, options, etc that users may wish to try out.
 
26
 
 
27
* "bzr mkdir" now includes -p (--parents) option for recursively adding
 
28
  parent directories.
 
29
  (Jared Hance, Jelmer Vernooij, #253529)
 
30
 
 
31
Improvements
 
32
************
 
33
 
 
34
.. Improvements to existing commands, especially improved performance 
 
35
   or memory usage, or better results.
 
36
 
 
37
* New HPSS call for ``Repository.reconcile``. (Jelmer Vernooij, #894455)
 
38
 
 
39
* Override the value returned by ``sys.getfilesystemencoding()`` for the bzr
 
40
  script to utf-8 when it would otherwise be ascii on a posix system. This
 
41
  will mean bzr works with non-ascii files when no locale or an incorrect
 
42
  locale is set. (Martin Packman, #794353)
 
43
 
 
44
* ``bzr send`` now only opens a single connection, rather than two,
 
45
  to the target branch.  (Jelmer Vernooij)
 
46
 
 
47
Bug Fixes
 
48
*********
 
49
 
 
50
.. Fixes for situations where bzr would previously crash or give incorrect
 
51
   or undesirable results.
 
52
 
 
53
* Allow configuration option default value to be a python callable at
 
54
  registration. (Vincent Ladeuil, #832064)
 
55
 
 
56
* Create obsolete_packs directory when repacking if it does not
 
57
  exist. (Jonathan Riddell, Jelmer Vernooij, #314314)
 
58
 
 
59
* Fallback to the slower ``bzr log`` implementation when displaying a range
 
60
  of revisions whose ancestry is not obviously on the same developement
 
61
  line. (Vincent Ladeuil, #904744)
 
62
 
 
63
* Not setting ``gpg_signing_key`` or setting it to ``default`` will use the
 
64
  user email (obtained from the ``email`` configuration option or its
 
65
  default value). (Vincent Ladeuil, Jelmer Vernooij, #904550)
 
66
 
 
67
* Properly ignore '\n' in an option reference since this cannot be part of a
 
68
  config option identifier. (Vincent Ladeuil, #902125)
 
69
 
 
70
* Make sure that the bzr probers are always registered when
 
71
  bzrlib.workingtree is imported. (Jelmer Vernooij, #905218)
 
72
 
 
73
* Report mistake trying to move a removed file with a non-ascii name without
 
74
  UnicodeEncodeError being raised. (Martin Packman, #898541)
 
75
 
 
76
Documentation
 
77
*************
 
78
 
 
79
.. Improved or updated documentation.
 
80
 
 
81
API Changes
 
82
***********
 
83
 
 
84
.. Changes that may require updates in plugins or other code that uses
 
85
   bzrlib.
 
86
 
 
87
* ``Config.signature_needed``, ``Config.signing_policy``,
 
88
  ``Config.gpg_signing_key``, ``Config.gpg_signing_command``,
 
89
  ``Config.checking_policy`` and ``Config.post_commit`` are now deprecated.
 
90
  (Jelmer Vernooij)
 
91
 
 
92
* ``Repository.get_commit_builder`` now takes a ``config_stack``
 
93
  rather than a ``config`` argument. (Jelmer Vernooij)
 
94
 
 
95
* Send formats now accept a new optional argument ``submit_branch``,
 
96
  which can be None or a Branch object for the submit branch location.
 
97
  (Jelmer Vernooij)
 
98
 
 
99
Internals
 
100
*********
 
101
 
 
102
.. Major internal changes, unlikely to be visible to users or plugin 
 
103
   developers, but interesting for bzr developers.
 
104
 
 
105
* ``bzrlib.urlutils`` now includes ``quote`` and ``unquote`` functions,
 
106
  rather than importing them from ``urllib``. This prevents loading
 
107
  of the ``socket``, ``ssl`` and ``urllib`` modules for
 
108
  local bzr operations. (Jelmer Vernooij)
 
109
 
 
110
* ControlDir now has a get_branches method that returns a dictionary
 
111
  whose keys are the names of the branches and whose values are the
 
112
  branches themselves. The active branch uses the key None.
 
113
  (Neil Martinsen-Burrell)
 
114
 
 
115
* Helper ``osutils.path_from_environ`` added for extracting a unicode path
 
116
  from an environment variable. (Martin Packman, #832028)
 
117
 
 
118
* Helper ``win32utils.get_environ_unicode`` added for avoiding encoding
 
119
  problems with ``os.environ.get`` use. (Martin Packman, #262874) 
 
120
 
 
121
* Lazy imports can now only be absolute. (Jelmer Vernooij)
 
122
 
 
123
* New HPSS call ``BzrDir.checkout_metadir``. (Jelmer Vernooij, #894459)
 
124
 
 
125
* New HPSS call ``VersionedFileRepository.get_inventories``,
 
126
  speeding up various commands including ``bzr export``,
 
127
  ``bzr checkout`` and ``bzr cat``. (Jelmer Vernooij, #608640)
 
128
 
 
129
Testing
 
130
*******
 
131
 
 
132
.. Fixes and changes that are only relevant to bzr's test framework and 
 
133
   suite.  This can include new facilities for writing tests, fixes to 
 
134
   spurious test failures and changes to the way things should be tested.
 
135
 
 
136
* New matcher ``ContainsNoVfsCalls`` which filters a list of HPSS
 
137
  calls for VFS requests. (Jelmer Vernooij)
 
138
 
 
139
 
 
140
bzr 2.5b4
 
141
#########
 
142
 
 
143
:2.5b4: 2011-12-08
 
144
 
 
145
This is the fourth beta of the 2.5 series, leading to a 2.5.0 release in
 
146
February 2012. Beta releases are suitable for everyday use but may cause
 
147
some incompatibilities with plugins.
 
148
 
 
149
This release includes many improvements in the smart server, UI polish for
 
150
the colocated branches, optimizations for revision specifiers to avoid
 
151
history sized operations, enhancements to the config framework, bug fixes
 
152
related to unicode paths and more.
 
153
 
 
154
All bug fixed in previous series known at the time of this release are
 
155
included.
 
156
 
 
157
External Compatibility Breaks
 
158
*****************************
 
159
 
 
160
None.
 
161
 
 
162
New Features
 
163
************
 
164
 
 
165
* Provides a ``po_merge`` plugin to automatically merge ``.po`` files with
 
166
  ``msgmerge``. See ``bzr help po_merge`` for details.
 
167
  (Vincent Ladeuil, #884270)
 
168
 
 
169
Improvements
 
170
************
 
171
 
 
172
* ``bzr branch --stacked`` now only makes a single connection to the remote
 
173
  server rather than three. (Jelmer Vernooij, #444293)
 
174
 
 
175
* ``bzr export --uncommitted`` will export the uncommitted tree.
 
176
  (Jelmer Vernooij, #555613)
 
177
 
 
178
* ``bzr rmbranch`` can now remove colocated branches.
 
179
  (Jelmer Vernooij, #831464)
 
180
 
 
181
* ``bzr status`` no longer shows shelves if files are specified.
 
182
  (Francis Devereux)
 
183
 
 
184
* ``bzr switch`` now accepts colocated branch names to switch to.
 
185
  (Jelmer Vernooij, #826814)
 
186
 
 
187
* Plugins can now register additional "location aliases".
 
188
  (Jelmer Vernooij)
 
189
 
 
190
* ``bzr status`` no longer shows shelves if files are specified.
 
191
  (Francis Devereux)
 
192
 
 
193
* Revision specifiers will now only browse as much history as they
 
194
  need to, rather than grabbing the whole history unnecessarily in some
 
195
  cases. (Jelmer Vernooij)
 
196
 
 
197
* When using ``bzr switch`` to switch to a sibling of the current
 
198
  branch, the relative branch name should no longer be url-encoded.
 
199
  (Jelmer Vernooij)
 
200
 
 
201
Bug Fixes
 
202
*********
 
203
 
 
204
* A new section local option ``basename`` is available to help support some
 
205
  ``bzr-pipeline`` workflows and more generally help mapping local paths to
 
206
  remote ones. See ``bzr help configuration`` for more details.
 
207
  (Vincent Ladeuil, #843211)
 
208
 
 
209
* Add HPSS call for looking up revision numbers from revision ids on
 
210
  remote repositories. (Jelmer Vernooij, #640253)
 
211
 
 
212
* Add HPSS call for retrieving file contents from remote repositories.
 
213
  Should improve performance for lightweight checkouts and exports of
 
214
  from remote repositories.  (Jelmer Vernooij, #368717, #762330,
 
215
  #608640)
 
216
 
 
217
* Allow lazy compiled patterns from ``bzrlib.lazy_regex`` to be
 
218
  pickled. (Jelmer Vernooij, #893149)
 
219
 
 
220
* ``bzr info`` no longer shows empty output if only a control
 
221
  directory is present. (Jelmer Vernooij, #159098)
 
222
 
 
223
* Cope with missing revision ids being specified to
 
224
  ``Repository.gather_stats`` HPSS call. (Jelmer Vernooij, #411290)
 
225
 
 
226
* Fix test failures on windows related to locations.conf handling.
 
227
  (Vincent Ladeuil, #892992)
 
228
 
 
229
* Fixed parsing of the timestamp given to ``commit --commit-time``. Now
 
230
  prohibits several invalid strings, reads the correct number of seconds,
 
231
  and gives a better error message if the time zone offset is not given.
 
232
  (Matt Giuca, #892657)
 
233
 
 
234
* Give meaningful file/line references when reporting deprecation warnings
 
235
  for _CompatabilityThunkFeature based test features.
 
236
  (Vincent Ladeuil, #897718)
 
237
 
 
238
* Make reporting of mistakes involving unversioned files with non-ascii
 
239
  filenames work again without 'Unprintable exception' being shown.
 
240
  (Martin Packman, #898408)
 
241
 
 
242
* Provide names for lazily registered hooks. 
 
243
  (Neil Martinsen-Burrell, #894609)
 
244
 
 
245
* Raise BadIndexKey exception in btree_index when a key is too large, fixing 
 
246
  an infinite recursion issue. (Shannon Weyrick, #720853)
 
247
 
 
248
* Resolve regression from colocated branch path handling, by ensuring that
 
249
  unreserved characters are unquoted in URLs. (Martin Packman, #842223)
 
250
 
 
251
* Split segments from URLs for colocated branches without assuming the
 
252
  combined form is valid. (Martin Packman, #842233)
 
253
 
 
254
* Support looking up revision numbers by revision id in empty branches.
 
255
  (Jelmer Vernooij, #535031)
 
256
 
 
257
* Support verifying signatures on remote repositories.
 
258
  (Jelmer Vernooij, #889694)
 
259
 
 
260
* Teach the bzr client how to reconnect if we get ``ConnectionReset``
 
261
  while making an RPC request. This doesn't handle all possible network
 
262
  disconnects, but it should at least handle when the server is asked to
 
263
  shutdown gracefully. (John Arbash Meinel, #819604)
 
264
 
 
265
* When a remote format is unknown, bzr will now print a single-line error
 
266
  message rather than a backtrace. (Jelmer Vernooij, #687226)
 
267
 
 
268
API Changes
 
269
***********
 
270
 
 
271
* ``BzrDir.open_branch`` and ``BranchFormat.open`` now take an optional
 
272
  ``possible_transports`` argument. (Jelmer Vernooij)
 
273
 
 
274
* New method ``Transport.set_segment_parameter``.  (Jelmer Vernooij)
 
275
 
 
276
* ``Repository.verify_revision`` has been renamed to
 
277
  ``Repository.verify_revision_signature``. (Jelmer Vernooij)
 
278
 
 
279
* ``RevisionSpec.wants_revision_history`` now defaults to ``False`` and
 
280
  is deprecated. The ``revs`` argument of
 
281
  ``RevisionInfo.from_revision_id`` is now deprecated. (Jelmer Vernooij)
 
282
 
 
283
* ``Tree.get_file_by_path`` is now deprecated. Use ``Tree.get_file`` instead.
 
284
  (Jelmer Vernooij, #666897)
 
285
 
 
286
* Some global options for use with commands have been removed, construct
 
287
  an ``Option`` with the name instead. (Martin Packman)
 
288
 
 
289
* The unused exception ``HistoryMissing`` has been removed.
 
290
  (Jelmer Vernooij)
 
291
 
 
292
Internals
 
293
*********
 
294
 
 
295
* Add HPSS call for ``Repository.pack``. (Jelmer Vernooij, #894461)
 
296
 
 
297
* ``bzr config`` uses the new configuration implementation.
 
298
  (Vincent Ladeuil)
 
299
 
 
300
* Custom HPSS error handlers can now be installed in the smart server client
 
301
  using the ``error_translators`` and ``no_context_error_translators``
 
302
  registries. (Jelmer Vernooij)
 
303
 
 
304
* New HPSS calls ``Repository.has_signature_for_revision_id``,
 
305
  ``Repository.make_working_trees``, ``BzrDir.destroy_repository``,
 
306
  ``BzrDir.has_workingtree``, ``Repository.get_physical_lock_status``,
 
307
  ``Branch.get_physical_lock_status``,
 
308
  ``Branch.put_config_file``, ``Branch.break_lock``,
 
309
  ``BzrDir.destroy_branch``, ``Repository.break_lock``,
 
310
  ``VersionedFileRepository.get_serializer_format``,
 
311
  ``Repository.all_revision_ids``, ``Repository.start_write_group``,
 
312
  ``Repository.commit_write_group``, ``Repository.abort_write_group``
 
313
  ``Repository.check_write_group``, ``Repository.iter_revisions``,
 
314
  ``Repository.add_signature_revision_text`` and
 
315
  ``Repository.get_revision_signature_text``.
 
316
  (Jelmer Vernooij)
 
317
 
 
318
* Add HPSS call for ``Branch.get_checkout_format``. (Jelmer Vernooij, #894459)
 
319
 
 
320
* Add HPSS call for ``Repository.pack``. (Jelmer Vernooij, #894461)
 
321
 
 
322
* Add HPSS calls for ``Repository.iter_files_bytes``, speeding up
 
323
  several commands including ``bzr export`` and ``bzr co --lightweight``.
 
324
  (Jelmer Vernooij, #608640)
 
325
 
 
326
* Custom HPSS error handlers can now be installed in the smart server client
 
327
  using the ``error_translators`` and ``no_context_error_translators``
 
328
  registries. (Jelmer Vernooij)
 
329
 
 
330
* ``RemoteBranch.get_config_stack`` and ``RemoteBzrDir.get_config_stack``
 
331
  will now use HPSS calls where possible. (Jelmer Vernooij)
 
332
 
 
333
* Custom HPSS error handlers can now be installed in the smart server client
 
334
  using the ``error_translators`` and ``no_context_error_translators``
 
335
  registries. (Jelmer Vernooij)
 
336
 
 
337
* The registry of merge types has been moved to ``merge`` from ``option`` but
 
338
  ``merge.get_merge_type_registry`` remains as an accessor. (Martin Packman)
 
339
 
 
340
Testing
 
341
*******
 
342
 
 
343
* Avoid failures in test_transform when OS error messages are localised.
 
344
  (Martin Packman, #891582)
 
345
 
 
346
* Tests are now subject to a time limit: by default 300s, and 120s when
 
347
  run from 'make check', controlled by the `selftest.timeout`
 
348
  configuration option.  This is currently not supported on Windows.
 
349
  (Martin Pool)
 
350
 
 
351
bzr 2.5b3
 
352
#########
 
353
 
 
354
:2.5b3: 2011-11-10
 
355
 
 
356
This is the third beta of the 2.5 series, leading to a 2.5.0 release in
 
357
February 2012. Beta releases are suitable for everyday use but may cause
 
358
some incompatibilities with plugins.
 
359
 
 
360
This release includes log options for ``push`` and ``pull``, more UI polish
 
361
for colocated branches, a better and more coherent implementation for UI
 
362
dialogs, enhancements to the config framework and more.
 
363
 
 
364
This release includes all bug fixed in previous series known at the time of
 
365
this release.
 
366
 
 
367
External Compatibility Breaks
 
368
*****************************
 
369
 
 
370
None
 
371
 
 
372
New Features
 
373
************
 
374
 
 
375
* The ``log_format`` configuration can be used with ``-Olog_format=line`` to
 
376
  change the format ``push`` and ``pull`` use to display the
 
377
  revisions. I.e.: ``bzr pull -v -Olog_format=short`` will use the ``short``
 
378
  format instead of the default ``long`` one. (Vincent Ladeuil, #861472)
 
379
 
 
380
* The new config scheme allows an alternative syntax for the 'appenpath'
 
381
  policy relying on option expansion and defining a new 'relpath' option
 
382
  local to a section. Instead of using '<option>:policy=appendpath', the
 
383
  option value can de defined as 'option=xxxx/{relpath}'.
 
384
  (Vincent Ladeuil, #832013)
 
385
 
 
386
Improvements
 
387
************
 
388
 
 
389
* ``bzr info -v`` now shows the number of colocated branches
 
390
  for control directories that support them.
 
391
  (Jelmer Vernooij, #863285)
 
392
 
 
393
* ``bzr version-info`` now takes a ``--revision`` argument.
 
394
  (Jelmer Vernooij, #238705)
 
395
 
 
396
* ``bzr revno`` now takes a ``--revision`` argument.
 
397
  (Jelmer Vernooij, #870649)
 
398
 
 
399
* ``bzr serve`` now can serve from URLs rather than just from the
 
400
  file system. I.e.: ``bzr serve -d lp:bzr`` or
 
401
  ``bzr serve -d file:///data/bzr`` (Jelmer Vernooij)
 
402
 
 
403
* all input prompts are now char-based when possible, and can be forced to
 
404
  line-based mode by setting the ``BZR_TEXTUI_INPUT`` environment variable
 
405
  to 'line-based'. This replace the previous shelf UI only patch using
 
406
  ``INSIDE_EMACS``. (Benoît Pierre)
 
407
 
 
408
Bug Fixes
 
409
*********
 
410
 
 
411
* ``bzr info`` now shows the master branch location too for
 
412
  treeless local branches. (Jelmer Vernooij, #258355)
 
413
 
 
414
* ``bzr mkdir --quiet`` now does not print a line for every created
 
415
  directory. (Martin von Gagern, #869915)
 
416
 
 
417
* ``bzr mv`` does not crash when attempting to move the root of a
 
418
  branch. (Jonathan Riddell, #809728)
 
419
 
 
420
* ``bzr shelve`` now use ``UIFactory.choose`` for input handling, making
 
421
  it usable when creating a custom ``UIFactory`` implementation. (Benoît
 
422
  Pierre)
 
423
 
 
424
* ``bzr clean-tree`` now use ``UIFactory.get_boolean`` for confirmation
 
425
  prompt, making it usable when using a custom ``UIFactory``
 
426
  implementation. (Benoît Pierre)
 
427
 
 
428
* If sending a crash through Apport fails report the Apport failure to
 
429
  bzr.log rather than stderr. (Jonathan Riddell, #766735)
 
430
 
 
431
* ``bzr upgrade`` no longer treats 'already up-to-date' exceptions as
 
432
  errors. (Benoît Pierre, #716560).
 
433
 
 
434
* ``bzr version-info`` no longer populates the clean state for custom
 
435
  templates unless {clean} is explicitly asked for.
 
436
  (Lawrence Mitchell, #882541)
 
437
 
 
438
* Fix finding the CPU count when using Python >= 2.6 on BSD-based systems.
 
439
  (Jelmer Vernooij, #887151)
 
440
 
 
441
* ``WorkingTree.clone()`` now supports its ``revision_id`` being set
 
442
  to the null revision. (Jelmer Vernooij, #876423)
 
443
 
 
444
* ``WorkingTree.pull`` can now pull ``NULL_REVISION``.
 
445
  (Jelmer Vernooij, #887556)
 
446
 
 
447
API Changes
 
448
***********
 
449
 
 
450
* ``Branch.revision_history`` is now deprecated. (Jelmer Vernooij, #799519)
 
451
 
 
452
* Methods ``add`` and ``items`` of ``LRUCache`` and ``LRUSizeCache`` are
 
453
  deprecated. Use normal dict-style access instead. (Martin Packman)
 
454
 
 
455
* New flag ``RepositoryFormat.supports_unreferenced_revisions`` which
 
456
  indicates whether revisions can be present in a repository without
 
457
  being referenced from e.g. a branch history at the same time.
 
458
  (Jelmer Vernooij)
 
459
 
 
460
* ``UIFactory.choose`` has been added: prompt the user for a list of
 
461
  choices. (Benoît Pierre)
 
462
 
 
463
Internals
 
464
*********
 
465
 
 
466
* ``ControlDirFormat`` now has a new method ``supports_transport``
 
467
  which format implementations can use whether or not they can access
 
468
  a control dir over a particular transport. (Jelmer Vernooij)
 
469
 
 
470
* ``BranchBuilder.build_commit`` now take ``parent_ids`` and
 
471
  ``allow_leftmost_as_ghost`` arguments.  (Jelmer Vernooij)
 
472
 
 
473
Testing
 
474
*******
 
475
 
 
476
* Ensure TestCase instances are deallocated immediately after running where
 
477
  possible. This greatly reduces the peak resource needs of a full test suite
 
478
  run. The new ``-Euncollected_cases`` selftest flag will add failures if any
 
479
  case which persists pasts its expected lifetime. (Martin Packman, #613247)
 
480
 
 
481
* Report exceptions from child processes during fork instead of swallowing the
 
482
  error and reporting that everything went okay. (Martin Packman, #804130)
 
483
 
 
484
 
 
485
bzr 2.5b2
 
486
#########
 
487
 
 
488
This is the second beta of the 2.5 series, leading to a 2.5.0 release in
 
489
February 2012. Beta releases are suitable for everyday use but may cause some
 
490
incompatibilities with plugins.
 
491
 
 
492
This release includes more filtering options for ``bzr log``, idle
 
493
connections handling for ``bzr serve``, a ``development-colo`` experimental
 
494
format to flesh out the colocated branches UI, better support for foreign
 
495
formats, enhancements to the config framework and more.
 
496
 
 
497
This release includes all bug fixed in previous series known at the time of
 
498
this release.
 
499
 
 
500
:2.5b2: 2011-10-06
 
501
 
 
502
External Compatibility Breaks
 
503
*****************************
 
504
 
 
505
None
 
506
 
 
507
New Features
 
508
************
 
509
 
 
510
* A new ``-O`` standard option (common to all commands) have been added. It
 
511
  provides a value for a config option in the ``-Oname=value`` form that
 
512
  takes precedence over all definitions found in config files.  It can be
 
513
  used multiple times to override different options.
 
514
  (Vincent Ladeuil, #491196)
 
515
 
 
516
* ``bzr log`` now has an option called ``--omit-merges`` to omit
 
517
  those commits that merged branches, i.e. those having more than one
 
518
  parent.
 
519
  In order to avoid confusion, the previous command line option
 
520
  ``--include-merges`` has been renamed to ``--include-merged``.
 
521
  The old name of the command line option will still be accepted.
 
522
  The name change also affects ``bzr missing``.
 
523
  (Martin von Gagern)
 
524
 
 
525
* ``bzr serve`` will now disconnect clients if they have not issued an RPC
 
526
  request after 5minutes. On POSIX platforms, this will also happen for
 
527
  ``bzr serve --inet``. This can be overridden with the configuration
 
528
  variable ``serve.client_timeout`` or in the command line parameter
 
529
  ``bzr serve --client-timeout=X``. Further, it is possible to request
 
530
  ``bzr serve [--inet]`` to shutdown gracefully by sending SIGHUP. It will
 
531
  finish the current request, and then close the connection.
 
532
  (John Arbash Meinel, #824797, #795025)
 
533
 
 
534
* The new experimental format ``development-colo`` supports colocated
 
535
  branches. This format will eventually be merged back into the ``2a``
 
536
  format when it has stabilized and there is adequate UI support for
 
537
  colocated branches.
 
538
  (Jelmer Vernooij, #831481)
 
539
 
 
540
Improvements
 
541
************
 
542
 
 
543
* Fixed a bug where ``bzr tags -r x..y`` loaded the branch history once for
 
544
  every revision in the range; it's now much faster. (Vincent Ladeuil, #857335)
 
545
 
 
546
* ``bzr info -v`` can now be run against branches that don't support
 
547
  ``last_revision_info``, in which case the branch information will simply
 
548
  not be displayed. (Jelmer Vernooij)
 
549
 
 
550
Bug Fixes
 
551
*********
 
552
 
 
553
* ``bzr shelve`` can now be used in emacs shells as the input handling is
 
554
  turned into a line-based one when ``INSIDE_EMACS`` is set (which is the
 
555
  case for all recent emacs versions). (Vincent Ladeuil, #856261)
 
556
 
 
557
* ``bzr tags`` can now be used against remote repositories that do
 
558
  not provide access to the revision graph. (Jelmer Vernooij, #858942)
 
559
 
 
560
* ``bzr update PATH`` will stop if you seem to be asking it to update
 
561
  anything less than a whole tree, because that's not supported by ``bzr``'s
 
562
  concept that the whole tree has a single basis revision.  Previously, it
 
563
  would go ahead and update the whole tree, which was surprising.
 
564
  (Martin Pool, #557886)
 
565
 
 
566
* Don't crash if ``bzrlib.initialize()`` has not been called while accessing
 
567
  configs.  (Vincent Ladeuil, #863401)
 
568
 
 
569
* Redirects between http and https no longer discard path information
 
570
  in some cases. (Jelmer Vernooij, #853765)
 
571
 
 
572
* The ``--overwrite`` argument to ``bzr push`` and ``bzr pull`` no longer
 
573
  reports all tags as changed. (Jelmer Vernooij, #845396)
 
574
 
 
575
* ``WorkingTree.get_file_mtime`` now raises NoSuchId if a file id is
 
576
  specified that is unknown. (Jelmer Vernooij, #847435)
 
577
 
 
578
 
 
579
API Changes
 
580
***********
 
581
 
 
582
* ``Branch.get_revision_delta`` has been deprecated. Use
 
583
  ``Repository.get_revision_delta`` instead. (Jelmer Vernooij, #859712)
 
584
 
 
585
* Plugins that implement custom protocols for ``bzr serve`` should now
 
586
  also take an argument ``timeout``. This is used by the the bzr protocol
 
587
  to close a connection if a client has been idle for more than X seconds.
 
588
  (Default 5minutes). (John Arbash Meinel)
 
589
 
 
590
* ``Repository.fileids_altered_by_revision_ids`` has been moved to
 
591
  ``VersionedFileRepository`` and is no longer part of the standard
 
592
  ``Repository`` interface. (Jelmer Vernooij)
 
593
 
 
594
* The argument ``include_merges`` to ``missing.find_unmerged`` has
 
595
  been renamed to ``include_merged``. The old name is still supported
 
596
  for now but will cause a deprecation warning. (Martin von Gagern)
 
597
 
 
598
* The new method ``ControlDirFormat.is_initializable()`` returns a boolean
 
599
  indicating whether or not it is possible to use any of the
 
600
  initialization methods of that format to create a new control dir.
 
601
  (Jelmer Vernooij)
 
602
 
 
603
Internals
 
604
*********
 
605
 
 
606
* ``Branch`` objects can now use a config stack with the newly introduced
 
607
  ``get_config_stack()``. Both ``get_config`` and ``get_config_stack`` can
 
608
  be used for the same branch but it's recommended to stick to one for a
 
609
  given option.
 
610
 
 
611
Testing
 
612
*******
 
613
 
 
614
* Test scripts can now use ``bzr shelve`` and provide their input as
 
615
  complete lines. (Vincent Ladeuil, #856261)
 
616
 
 
617
* Really corrupt the pack file without depending on a special length or value.
 
618
  (Vincent Ladeuil, #807032)
 
619
 
 
620
 
 
621
bzr 2.5b1
 
622
#########
 
623
 
 
624
:2.5b1: 2011-09-15
 
625
 
 
626
This is the first beta of the 2.5 series, leading up to a 2.5.0
 
627
release in February 2012.
 
628
 
 
629
This release includes better support for gpg signing, better support for
 
630
i18n (mostly command help and error messages), more options to filter ``bzr
 
631
log`` output, more support for colocated branches ("location,branch=XXX"
 
632
syntax), better feedback on updated tags for various commands, faster
 
633
branching into an empty repository, enhancements to the config framework and
 
634
more.
 
635
 
 
636
Beta releases are suitable for everyday use but may cause some
 
637
incompatibilities with plugins.  Some plugins may need small updates to work
 
638
with 2.5b1.
 
639
 
 
640
External Compatibility Breaks
 
641
*****************************
 
642
 
 
643
None
 
644
 
 
645
New Features
 
646
************
 
647
 
 
648
* A ``from_unicode`` parameter can be specified when registering a config
 
649
  option. This implements boolean, integer and list config options when the
 
650
  provided ``bool_from_store``, ``int_from_store`` and ``list_from_store``
 
651
  are used for this parameter.  (Vincent Ladeuil)
 
652
 
 
653
* Accessing a packaging branch on Launchpad (eg, ``lp:ubuntu/bzr``) now
 
654
  checks to see if the most recent published source package version for
 
655
  that project is present in the branch tags. This should help developers
 
656
  trust whether the packaging branch is up-to-date and can be used for new
 
657
  changes. The level of verbosity is controlled by the config item
 
658
  ``launchpad.packaging_verbosity``. It can be set to one of
 
659
 
 
660
  off
 
661
    disable all checks
 
662
 
 
663
 
 
664
  minimal
 
665
    only display if the branch is out-of-date
 
666
 
 
667
  short
 
668
    also display single-line up-to-date and missing,
 
669
 
 
670
 
 
671
  all
 
672
    (default) display multi-line content for all states
 
673
 
 
674
 
 
675
  (John Arbash Meinel, #609187, #812928)
 
676
 
 
677
* Add a config option gpg_signing_key for setting which GPG key should
 
678
  be used to sign commits. Also default to using the gpg user identity
 
679
  which matches user_email() as set by whoami.
 
680
  (Jonathan Riddell, #68501)
 
681
 
 
682
* An ``invalid`` parameter can be specified when registering a config option
 
683
  to decide what should be done when invalid values are
 
684
  encountered. 'warning' and 'error' will respectively emit a warning and
 
685
  ignore the value or errors out. (Vincent Ladeuil)
 
686
 
 
687
* bzr add now skips large files in recursive mode. The default "large"
 
688
  size is 20MB, and is configurable via the add.maximum_file_size
 
689
  option. A value of 0 disables skipping. Named items passed to add are
 
690
  never skipped. (Shannon Weyrick, #54624)
 
691
 
 
692
* ``bzr help configuration/<option>`` display the help for ``option`` for
 
693
  all registered configuration options. (Vincent Ladeuil, #747050)
 
694
 
 
695
* ``bzr log -m`` now matches message, author, committer and bugs instead
 
696
  of just matching the message.  ``--message`` keeps its original meaning,
 
697
  while ``--match-message, --match-author, --match-committer`` and
 
698
  ``--match-bugs`` match each of those fields. (Jacek Sieka)
 
699
 
 
700
* ``config.Option`` can now declare ``default_from_env``, a list of
 
701
  environment variables to get a default value from. (Vincent Ladeuil)
 
702
 
 
703
* ``config.NameMatcher`` can be used to implement config stores and stacks
 
704
  that need to provide specific option values for arbitrary unique IDs (svn
 
705
  repository UUIDs, etc).  (Vincent Ladeuil, #843638)
 
706
 
 
707
* New builtin ``bzr branches`` command, which lists all colocated branches
 
708
  in a directory. (Jelmer Vernooij, #826820)
 
709
 
 
710
* Relative local paths can now be specified in URL syntax by using the
 
711
  "file:" prefix.  (Jelmer Vernooij)
 
712
 
 
713
* Report commits signed with expired keys in ``verify-signatures``.
 
714
  (Jonathan Riddell, #804254)
 
715
 
 
716
* Translations are now enabled for command help, errors and globally
 
717
  for any message using ``gettext`` given on output.  (Jonathan Riddell,
 
718
  INADA Naoki, #83941)
 
719
 
 
720
Improvements
 
721
************
 
722
 
 
723
* ``bzr add`` will now warn about nested subtrees that are skipped.
 
724
  (Jelmer Vernooij, #187342)
 
725
 
 
726
* ``bzr commit -m ''`` can now be used to force an empty commit message.
 
727
  Entering an empty commit message in the message editor still triggers
 
728
  an error. (Jelmer Vernooij)
 
729
 
 
730
* ``bzr pull`` will now mention how many tags it has updated.
 
731
  (Jelmer Vernooij, #164450)
 
732
 
 
733
* ``bzr tag`` no longer errors if a tag already exists but refers to the
 
734
  same revision, and will mention when a tag has been updated
 
735
  rather than created. (Jelmer Vernooij, #381203)
 
736
 
 
737
* ``bzr uncommit`` will now remove tags that refer to removed revisions.
 
738
  The ``--keep-tags`` option can be used to prevent this behaviour.
 
739
  (Jelmer Vernooij, #605814)
 
740
 
 
741
* Do not run i18n initialisation twice. (Jonathan Riddell)
 
742
 
 
743
* Install translation .mo files. (Jonathan Riddell)
 
744
 
 
745
* Locations printed by ``bzr upgrade`` are now formatted before display.
 
746
  (Jelmer Vernooij)
 
747
 
 
748
* ``Repository.get_parent_map`` now estimates the size of the returned
 
749
  content more accurately. This means that we get closer to the desired
 
750
  64kB/request. For repositories converted from svn, this can be an
 
751
  improvement of approx 5:1 in round trips to discover the whole history.
 
752
  (John Arbash Meinel)
 
753
 
 
754
* Support a ``bugtracker`` option which is used by ``bzr commit --fixes``
 
755
  if no bug tracker was specified on the command line.
 
756
  (Jelmer Vernooij, #334860)
 
757
 
 
758
* Use ``gettext.NullTranslations`` in i18n to allow use of i18n even when
 
759
  translations are not turned on. (Jonathan Riddell)
 
760
 
 
761
Bug Fixes
 
762
*********
 
763
 
 
764
* ``bzr commit`` now correctly reports missing files as "removed", not
 
765
  "modified". (Jelmer Vernooij, #553955)
 
766
 
 
767
* ``bzr reconfigure`` will now allow multiple non-conflicting requests
 
768
  in a single invocation, e.g. ``--branch`` and ``--use-shared``.
 
769
  (Martin von Gagern, #842993)
 
770
 
 
771
* A call to CHKInventory's filter-method will not result in a
 
772
  DuplicateFileId error, if you move a subfolder and change a file in
 
773
  that subfolder.
 
774
  (Bastian Bowe, #809901)
 
775
 
 
776
* Branching from a stacked branch no longer does a ``get_parent_map``
 
777
  request for each revisions that is in the stacked-on repository while
 
778
  determining what revisions need to be fetched. This mostly impacts
 
779
  branching initialy into an empty shared repository when the source is
 
780
  not the development focus.  (John Arbash Meinel, #388269)
 
781
 
 
782
* Decode ``BZR_HOME`` with fs encoding on posix platforms to avoid unicode
 
783
  errors.  (Vincent Ladeuil, #822571)
 
784
 
 
785
* Fix fallout from URL handling changes in 2.5 that caused an IndexError to be
 
786
  raised whenever a transport at the drive root was opened on windows.
 
787
  (Martin [gz], #841322)
 
788
 
 
789
* Fixed loading of external merge tools from config to properly decode
 
790
  command-lines which contain embedded quotes. (Gordon Tyler, #828803)
 
791
 
 
792
* Rather than an error being raised, a warning is now printed when the
 
793
  current user does not have permission to read a configuration file.
 
794
  (Jelmer Vernooij, #837324)
 
795
 
 
796
* The pull command will now always use separate connections for the
 
797
  case where the destination is a heavyweight checkout of some remote
 
798
  branch on the same host as the source branch.
 
799
  (Martin von Gagern, #483661)
 
800
 
 
801
* TreeTransformBase.fixup_new_roots no longer forces trees to have a root, so
 
802
  operations that use it, like merge, can now create trees without a root.
 
803
  (Aaron Bentley)
 
804
 
 
805
Documentation
 
806
*************
 
807
 
 
808
* Release instructions refreshed. (Vincent Ladeuil)
 
809
 
 
810
API Changes
 
811
***********
 
812
 
 
813
* ``BranchFormat.initialize`` now takes a ``append_revisions_only``
 
814
  argument. (Jelmer Vernooij)
 
815
 
 
816
* ``Branch._get_checkout_format`` now takes a ``lightweight`` argument
 
817
  which indicates if the format should be for a lightweight or a
 
818
  heavyweight checkout. (Jelmer Vernooij)
 
819
 
 
820
* ``ControlDir.create_branch`` now takes a ``append_revisions_only`` argument.
 
821
  (Jelmer Vernooij)
 
822
 
 
823
* New class ``URL`` in ``bzrlib.utils`` for managing parsed URLs.
 
824
  (Jelmer Vernooij)
 
825
 
 
826
* New method ``Config.get_user_option_as_int_from_SI`` added for expanding a
 
827
  value in SI format (i.e. "20MB", "1GB") into its integer equivalent. 
 
828
  (Shannon Weyrick)
 
829
 
 
830
* New method ``InterTree.file_content_matches`` which checks that
 
831
  two files in different trees have the same contents.
 
832
  (Jelmer Vernooij)
 
833
 
 
834
* New method ``Tree.get_file_verifier`` which allows tree implementations
 
835
  to return non-sha1 checksums to verify files.
 
836
  (Jelmer Vernooij, #720831)
 
837
 
 
838
* New methods ``get_transport_from_path`` and ``get_transport_from_url``
 
839
  have been added that only support opening from a path or a URL,
 
840
  unlike ``get_transport``. (Jelmer Vernooij)
 
841
 
 
842
* New registry ``OptionRegistry`` specialized for configuration options.
 
843
  (Vincent Ladeuil)
 
844
 
 
845
* Remove ``AtomicFile.closed`` which has been deprecated in bzr 0.10.
 
846
  (Vincent Ladeuil)
 
847
 
 
848
* Remove ``commands._builtin_commands``, ``commands.shlex_split_unicode``,
 
849
  ``Command._maybe_expand_globs`` and ``Command.run_direct`` deprecated in
 
850
  2.10 and 2.2.0. (Vincent Ladeuil)
 
851
 
 
852
* Remove ``diff.get_trees_and_branches_to_diff`` deprecated in 2.2.0.
 
853
 
 
854
* Remove ``log.calculate_view_revisions``, ``log._filter_revision_range``,
 
855
  ``log.get_view_revisions`` which have been deprecated in bzr 2.1.0. Also
 
856
  remove ``log.show_one_log`` which was never properly deprecated but wasn't
 
857
  used and is easy to inline if needed. (Vincent Ladeuil)
 
858
 
 
859
* Remove ``trace.info``, ``trace.error`` and ``trace.show_log_error``
 
860
  deprecated in 2.1.0. (Vincent Ladeuil)
 
861
 
 
862
* Remove ``TransportListRegistry.set_default_transport``, as the concept of
 
863
  a default transport is currently unused. (Jelmer Vernooij)
 
864
 
 
865
* Remove ``UIFactory.warn_cross_format_fetch`` and
 
866
  ``UIFactory.warn_experimental_format_fetch`` in favor of
 
867
  ``UIFactory.show_user_warning``. (Jelmer Vernooij)
 
868
 
 
869
* ``Tags`` containers can now declare whether they support versioned
 
870
  tags and whether tags can refer to ghost tags.
 
871
  (Jelmer Vernooij)
 
872
 
 
873
* ``Tags.merge_to`` now returns a dictionary with the updated tags
 
874
  and a set of conflicts, rather than just conflicts. (Jelmer Vernooij)
 
875
 
 
876
* There is a new class `ContentFilterTree` that provides a facade for 
 
877
  content filtering.  The `filtered` parameter to `export` is deprecated 
 
878
  in favor of passing a filtered tree, and the specific exporter plugins
 
879
  no longer support it.
 
880
  (Martin Pool)
 
881
 
 
882
* ``Transport`` now has a ``_parsed_url`` attribute instead of
 
883
  separate ``_user``, ``_password``, ``_port``, ``_scheme``, ``_host``
 
884
  and ``_path`` attributes. Proxies are provided for the moment but
 
885
  may be removed in the future. (Jelmer Vernooij)
 
886
 
 
887
Internals
 
888
*********
 
889
 
 
890
* A new debug flag ``hpss_client_no_vfs`` will now cause the HPSS client
 
891
  to raise a ``HpssVfsRequestNotAllowed`` exception when a VFS request
 
892
  is attempted. (Jelmer Vernooij)
 
893
 
 
894
* New method ``ControlDir._get_selected_branch`` which returns the
 
895
  colocated branch selected using path segment parameters.
 
896
  (Jelmer Vernooij, #380871)
 
897
 
 
898
Testing
 
899
*******
 
900
 
 
901
* Blackbox tests (including test scripts) can be debugged interactively (see
 
902
  bzrlib.debug.BzrPdb for details). (Vincent Ladeuil)
 
903
 
 
904
* `BranchBuilder.build_snapshot` now supports a "flush" action.  This
 
905
  cleanly and reliably allows tests using `BranchBuilder` to construct
 
906
  branches that e.g. rename files out of a directory and unversion that
 
907
  directory in the same revision.  Previously some changes were impossible
 
908
  due to the order that `build_snapshot` performs its actions.
 
909
  (Andrew Bennetts)
 
910
 
 
911
* Don't require ``os.fdatasync`` to be defined on all supported OSes
 
912
  (BSD-based OSes don't define it).  (Vincent Ladeuil, #822649)
 
913
 
 
914
* Fix compatibility with testtools 0.9.12. (Jelmer Vernooij, #815423)
 
915
 
 
916
* ``LockDir`` can now be run when the local hostname is ``localhost``.
 
917
  (Jelmer Vernooij, #825994)
 
918
 
 
919
* ``ModuleAvailableFeature`` won't try to import already imported modules,
 
920
  allowing it to be used for modules with side-effects.
 
921
  (Vincent Ladeuil, #712474)
 
922
 
 
923
* Output time stamps while running ``make check`` to get better timings from
 
924
  pqm.  (Vincent Ladeuil, #837926)
 
925
 
 
926
* `TestCaseWithMemoryTransport` is faster now: `_check_safety_net` now
 
927
  just compares the bytes in the dirstate file to its pristine state,
 
928
  rather than opening the WorkingTree and calling ``last_revision()``.
 
929
  This reduces the overall test suite time by about 10% on my laptop.
 
930
  (Andrew Bennetts)
 
931
 
 
932
* Update `TestCase.knownFailure` to the testtools way of handling expected
 
933
  failures to resolve Python 2.7 incompatibility. (Martin [gz], #607400)
 
934
 
 
935
..
 
936
   vim: tw=74 ft=rst ff=unix