~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Aaron Bentley
  • Date: 2005-07-26 14:06:11 UTC
  • mto: (1092.1.41) (1185.3.4) (974.1.47)
  • mto: This revision was merged to the branch mainline in revision 982.
  • Revision ID: abentley@panoramicfeedback.com-20050726140611-403e366f3c79c1f1
Fixed python invocation

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