/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Vincent Ladeuil
  • Date: 2012-01-18 14:09:19 UTC
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120118140919-rlvdrhpc0nq1lbwi
Change set/remove to require a lock for the branch config files.

This means that tests (or any plugin for that matter) do not requires an
explicit lock on the branch anymore to change a single option. This also
means the optimisation becomes "opt-in" and as such won't be as
spectacular as it may be and/or harder to get right (nothing fails
anymore).

This reduces the diff by ~300 lines.

Code/tests that were updating more than one config option is still taking
a lock to at least avoid some IOs and demonstrate the benefits through
the decreased number of hpss calls.

The duplication between BranchStack and BranchOnlyStack will be removed
once the same sharing is in place for local config files, at which point
the Stack class itself may be able to host the changes.

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