~ubuntu-branches/ubuntu/utopic/bzr-fastimport/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/notes.txt

  • Committer: Bazaar Package Importer
  • Author(s): Jelmer Vernooij
  • Date: 2009-01-25 03:13:48 UTC
  • Revision ID: james.westby@ubuntu.com-20090125031348-pykgsz5j6xpgfw8a
Tags: upstream-0.0.1~bzr112
ImportĀ upstreamĀ versionĀ 0.0.1~bzr112

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
=======================
 
2
Notes on bzr-fastimport
 
3
=======================
 
4
 
 
5
..contents::
 
6
 
 
7
Features
 
8
========
 
9
 
 
10
fast-import
 
11
-----------
 
12
 
 
13
Things that ought to work:
 
14
 
 
15
* add & deletes of files and symlinks
 
16
 
 
17
* automatic creation of directories (but not deletion)
 
18
 
 
19
* executable permission
 
20
 
 
21
* branches created based on where the import is run:
 
22
 
 
23
  * import into a shared repository outside a branch - branches
 
24
    are created as subdirectories of the current directory
 
25
  
 
26
  * import into a branch inside a shared repository - current
 
27
    branch becomes the trunk and other branches are created
 
28
    as sister directories
 
29
 
 
30
  * import into a standalone tree - warnings are given
 
31
    for branches (heads) found but not imported
 
32
  
 
33
* merge tracking
 
34
 
 
35
Things that probably work (more testing needed):
 
36
 
 
37
* separate author to committer
 
38
 
 
39
* lightweight tags
 
40
 
 
41
 
 
42
Known Limitations
 
43
=================
 
44
 
 
45
Parsing
 
46
-------
 
47
 
 
48
Things not supported yet:
 
49
 
 
50
* renaming a path that contains a space in the old name
 
51
 
 
52
* copying a path that contains a space in the source name
 
53
 
 
54
* delimited data sections (all data must be length prefixed currently)
 
55
 
 
56
* rfc2822 dates.
 
57
 
 
58
fast-import
 
59
-----------
 
60
 
 
61
Things not supported yet:
 
62
 
 
63
* deterministic revision-ids as an option
 
64
 
 
65
* 'reset' handling
 
66
 
 
67
* 'filedeleteall' handling
 
68
 
 
69
Things not recorded in Bazaar:
 
70
 
 
71
* tagger and message for (non-lightweight) tags
 
72
 
 
73
* copy semantics
 
74
 
 
75
 
 
76
Custom Enhancements
 
77
===================
 
78
 
 
79
General
 
80
-------
 
81
 
 
82
The date format is auto-detected.
 
83
 
 
84
Parsing
 
85
-------
 
86
 
 
87
These enhancements over the specification are provided in order
 
88
to read data produced by some verisons of git-fast-export:
 
89
 
 
90
* A person's name may be empty
 
91
 
 
92
* Long file modes with an extra leading 0, i.e. 0000644,
 
93
  0000755 and 0120000 are legal.