/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/split-join-files.txt

  • Committer: Martin Pool
  • Date: 2005-06-28 03:02:31 UTC
  • Revision ID: mbp@sourcefrog.net-20050628030231-d311e4ebcd467ef4
Merge John's import-speedup branch:

                                                                                         
  777 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 22:20:32 -0500
      revision-id: john@arbash-meinel.com-20050627032031-e82a50db3863b18e
      bzr selftest was not using the correct bzr

  776 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 22:20:22 -0500
      revision-id: john@arbash-meinel.com-20050627032021-c9f21fde989ddaee
      Add was using an old mutter

  775 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 22:02:33 -0500
      revision-id: john@arbash-meinel.com-20050627030233-9165cfe98fc63298
      Cleaned up to be less different

  774 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 21:54:53 -0500
      revision-id: john@arbash-meinel.com-20050627025452-4260d0e744edef43
      Allow BZR_PLUGIN_PATH='' to negate plugin loading.

  773 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 21:49:34 -0500
      revision-id: john@arbash-meinel.com-20050627024933-b7158f67b7b9eae5
      Finished the previous cleanup (allowing load_plugins to be called twice)

  772 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 21:45:08 -0500
      revision-id: john@arbash-meinel.com-20050627024508-723b1df510d196fc
      Work on making the tests pass. versioning.py is calling run_cmd directly, but plugins have been loaded.

  771 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 21:32:29 -0500
      revision-id: john@arbash-meinel.com-20050627023228-79972744d7c53e15
      Got it down a little bit more by removing import of tree and inventory.

  770 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 21:26:05 -0500
      revision-id: john@arbash-meinel.com-20050627022604-350b9773ef622f95
      Reducing the number of import from bzrlib/__init__.py and bzrlib/branch.py

  769 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 20:32:25 -0500
      revision-id: john@arbash-meinel.com-20050627013225-32dd044f10d23948
      Updated revision.py and xml.py to include SubElement.

  768 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 20:03:56 -0500
      revision-id: john@arbash-meinel.com-20050627010356-ee66919e1c377faf
      Minor typo

  767 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 20:03:13 -0500
      revision-id: john@arbash-meinel.com-20050627010312-40d024007eb85051
      Caching the import

  766 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 19:51:47 -0500
      revision-id: john@arbash-meinel.com-20050627005147-5281c99e48ed1834
      Created wrapper functions for lazy import of ElementTree

  765 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 19:46:37 -0500
      revision-id: john@arbash-meinel.com-20050627004636-bf432902004a94c5
      Removed all of the test imports of cElementTree

  764 John Arbash Meinel <john@arbash-meinel.com>       Sun 2005-06-26 19:43:59 -0500
      revision-id: john@arbash-meinel.com-20050627004358-d137fbe9570dd71b
      Trying to make bzr startup faster.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/split-join-files.txt
1
 
Split and join files
2
 
====================
3
 
 
4
 
Version control systems tend to have trouble when files are split or
5
 
joined.  Here is one possibility for handling that.
6
 
 
7
 
 
8
 
Splitting files
9
 
---------------
10
 
 
11
 
This can work like 'svn cp': copy with history::
12
 
 
13
 
  % bzr cp a b
14
 
 
15
 
This creates a new file b, whose file-history is the same as a, but
16
 
with a different file-id, and present at a different name.
17
 
 
18
 
This creates the slightly strange situation that b claims to have text
19
 
versions for revisions where b was not actually present.
20
 
 
21
 
 
22
 
Joining files
23
 
-------------
24
 
 
25
 
We might want to also join files in various cases:
26
 
 
27
 
 * Multiple imports of the same file
28
 
 
29
 
 * Two source files are being refactored into a single one
30
 
 
31
 
 * Two people apply an external patch that creates the same file
32
 
 
33
 
I'm not aware of any other system that handles this.
34
 
 
35
 
  % bzr join a b
36
 
 
37
 
a and b must be versioned files.  b is removed from the working tree
38
 
and inventory.  b's file id is added as a secondary id as a, so that
39
 
later merges between them will detect them as being the same.  
40
 
 
41
 
b's weave is (???) incorporated into a.  
42
 
 
43
 
This means that we have a file which has multiple history paths.  For
44
 
example, asking to compare that file to its state in a previous
45
 
version has to arbitrarily pick one to use.  That's not necessarily
46
 
fatal if we assign one as primary, but it might be a bit confusing.
47
 
Trying to merge from another tree might can't really choose a good
48
 
basis.
49
 
 
50
 
 
51
 
 
52
 
File aliases
53
 
------------
54
 
 
55
 
Rather than trying to join files we might just add notes that files
56
 
are also known by a different file-id in other trees.
57
 
 
58
 
 
59