/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: Martin Packman
  • Date: 2012-01-05 10:44:12 UTC
  • mfrom: (6424 +trunk)
  • mto: This revision was merged to the branch mainline in revision 6427.
  • Revision ID: martin.packman@canonical.com-20120105104412-z03fi9m43h946fvs
Merge bzr.dev to resolve conflicts

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