~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Martin Packman
  • Date: 2011-12-23 19:38:22 UTC
  • mto: This revision was merged to the branch mainline in revision 6405.
  • Revision ID: martin.packman@canonical.com-20111223193822-hesheea4o8aqwexv
Accept and document passing the medium rather than transport for smart connections

Show diffs side-by-side

added added

removed removed

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