/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: Patch Queue Manager
  • Date: 2012-01-02 10:24:02 UTC
  • mfrom: (6404.1.2 branch-fetch-tags)
  • Revision ID: pqm@pqm.ubuntu.com-20120102102402-f8tlazxhdypu44ej
(vila) Migrate the 'branch.fetch_tags' option to config stacks. (Vincent
 Ladeuil)

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