← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/missing.txt

  • Committer: Vincent Ladeuil
  • Date: 2009-12-14 15:51:36 UTC
  • mto: (4894.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 4895.
  • Revision ID: v.ladeuil+lp@free.fr-20091214155136-rf4nkqvxda9oiw4u
Cleanup tests and tweak the text displayed.

* bzrlib/tests/blackbox/test_update.py:
Fix imports and replace the assertContainsRe with assertEqualDiff
to make the test clearer, more robust and easier to debug.

* bzrlib/tests/commands/test_update.py: 
Fix imports.

* bzrlib/tests/blackbox/test_filtered_view_ops.py: 
Fix imports and strange accesses to base class methods.
(TestViewTreeOperations.test_view_on_update): Avoid os.chdir()
call, simplify string matching assertions.

* bzrlib/builtins.py:
(cmd_update.run): Fix spurious space, get rid of the final '/' for
the base path, don't add a final period (it's a legal char in a
path and would be annoying for people that like to copy/paste).

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/missing.txt
 
1
Missing
 
2
=======
 
3
 
 
4
Missing is used to find out the differences between the current branch and
 
5
another branch.
 
6
 
 
7
The performance analysis itself brings no further points than the
 
8
incremental-push-pull one.
 
9
 
 
10
More importantly, the UI have been considered not optimal: missing finds and
 
11
displays the differences between two branches, presenting the revisions that
 
12
are not common to both branches as two sets:
 
13
 
 
14
* the revisions that are present only in the current branch,
 
15
* the revisions that are present only in the other branch.
 
16
 
 
17
A quick and dirty survey indicates that most of the users are interested in
 
18
only one set of revisions at a time.
 
19
 
 
20
From a performance point of view, it may be more appropriate to calculate only
 
21
the set the user is asking for.
 
22
 
 
23
It has been proposed that the missing command be deprecated in favor of a
 
24
--dry-run option for the push, pull, merge commands.
 
25
 
 
26
In the mean time, the missing command stays interesting as it provides an easy
 
27
way to test, measure and optimize graph differences processing.