← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/missing.txt

  • Committer: Martin Pool
  • Date: 2005-08-17 02:06:19 UTC
  • Revision ID: mbp@sourcefrog.net-20050817020618-c7ae430253df8532
- rearrangement of modules, contributed by Gustavo Niemeyer


1) Moved plugins directory to bzrlib/, so that there's a standard
  plugin directory which is not only installed with bzr itself
  but is also available when using bzr from the development tree.
  BZR_PLUGIN_PATH and DEFAULT_PLUGIN_PATH are then added to the
  standard plugins directory.

2) Moved the needed third-party tools to an internal directory under
  bzrlib/util.  This makes sure that needed tools are available in
  the bzr installation, including the correct/expected version, and
  eases the process of packaging and redistribution of bzr
  ('setup.py bdist*' creates a working distribution).

3) Fixed setup.py including the needed package entries.

I hope you find them useful.

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.