/brz/remove-bazaar

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

« back to all changes in this revision

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

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