/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 notes/mapping.txt

Support reading .git files.

Merged from https://code.launchpad.net/~jelmer/brz-git/read-gitfile/+merge/342256

Show diffs side-by-side

added added

removed removed

Lines of Context:
notes/mapping.txt
 
1
Mapping between Git and Bazaar is generally straightforward.
 
2
 
 
3
Mapping version 1
 
4
=================
 
5
 
 
6
All revision ids created in this mapping format are prefixed with "git-v1:". 
 
7
This mapping format does not support roundtripped revisions from Bazaar; 
 
8
pushing or pulling from Bazaar into Git is not possible. dpush is possible 
 
9
and more or less does the opposite of the mapping described in this section.
 
10
 
 
11
Commits
 
12
-------
 
13
 
 
14
Git commits are mapped to Bazaar revisions. 
 
15
 
 
16
Bazaar revision ids are created by prefixing the (hex format) of git commit 
 
17
sha with "git-v1:". 
 
18
 
 
19
Commit properties are as follows:
 
20
 
 
21
 * git committer string: mapped to the Bazaar committer string
 
22
 * git committer timestamp: mapped to the Bazaar commit timestamp
 
23
 * git author string: mapped to the Bazaar 'author' revision property, if it 
 
24
   is different from the committer string
 
25
 * git author timestamp: ignored
 
26
 * git commit message: mapped to Bazaar commit message
 
27
 
 
28
The git committer string, author string and commit message are assumed to 
 
29
be encoded in UTF-8. Any utf-8-invalid characters are ignored.
 
30
 
 
31
Trees and blobs
 
32
---------------
 
33
Git trees are generally converted to Bazaar directories, Git blobs are 
 
34
generally converted to Bazaar files and symlinks.
 
35
 
 
36
Since all git trees are mapped *including* the root tree, it is only possible 
 
37
to create mapped rich-root revisions.
 
38
 
 
39
File ids for all objects are simply created by taking their path and 
 
40
escaping invalid characters in them:
 
41
 
 
42
 * _ is mapped to __
 
43
 * spaces are mapped to _s
 
44
 * \x0c is mapped to _c