bzr branch
http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
|
0.200.330
by Jelmer Vernooij
Add description of git-v1 mapping. |
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 |