diff options
Diffstat (limited to 'docs/manifest-format.txt')
-rw-r--r-- | docs/manifest-format.txt | 48 |
1 files changed, 36 insertions, 12 deletions
diff --git a/docs/manifest-format.txt b/docs/manifest-format.txt index 0bf09f6f..dcc90d07 100644 --- a/docs/manifest-format.txt +++ b/docs/manifest-format.txt | |||
@@ -37,25 +37,29 @@ following DTD: | |||
37 | <!ATTLIST remote review CDATA #IMPLIED> | 37 | <!ATTLIST remote review CDATA #IMPLIED> |
38 | 38 | ||
39 | <!ELEMENT default (EMPTY)> | 39 | <!ELEMENT default (EMPTY)> |
40 | <!ATTLIST default remote IDREF #IMPLIED> | 40 | <!ATTLIST default remote IDREF #IMPLIED> |
41 | <!ATTLIST default revision CDATA #IMPLIED> | 41 | <!ATTLIST default revision CDATA #IMPLIED> |
42 | <!ATTLIST default sync-j CDATA #IMPLIED> | 42 | <!ATTLIST default dest-branch CDATA #IMPLIED> |
43 | <!ATTLIST default sync-c CDATA #IMPLIED> | 43 | <!ATTLIST default sync-j CDATA #IMPLIED> |
44 | <!ATTLIST default sync-s CDATA #IMPLIED> | 44 | <!ATTLIST default sync-c CDATA #IMPLIED> |
45 | <!ATTLIST default sync-s CDATA #IMPLIED> | ||
45 | 46 | ||
46 | <!ELEMENT manifest-server (EMPTY)> | 47 | <!ELEMENT manifest-server (EMPTY)> |
47 | <!ATTLIST url CDATA #REQUIRED> | 48 | <!ATTLIST url CDATA #REQUIRED> |
48 | 49 | ||
49 | <!ELEMENT project (annotation?, | 50 | <!ELEMENT project (annotation?, |
50 | project*)> | 51 | project*)> |
51 | <!ATTLIST project name CDATA #REQUIRED> | 52 | <!ATTLIST project name CDATA #REQUIRED> |
52 | <!ATTLIST project path CDATA #IMPLIED> | 53 | <!ATTLIST project path CDATA #IMPLIED> |
53 | <!ATTLIST project remote IDREF #IMPLIED> | 54 | <!ATTLIST project remote IDREF #IMPLIED> |
54 | <!ATTLIST project revision CDATA #IMPLIED> | 55 | <!ATTLIST project revision CDATA #IMPLIED> |
55 | <!ATTLIST project groups CDATA #IMPLIED> | 56 | <!ATTLIST project dest-branch CDATA #IMPLIED> |
56 | <!ATTLIST project sync-c CDATA #IMPLIED> | 57 | <!ATTLIST project groups CDATA #IMPLIED> |
57 | <!ATTLIST project sync-s CDATA #IMPLIED> | 58 | <!ATTLIST project sync-c CDATA #IMPLIED> |
59 | <!ATTLIST project sync-s CDATA #IMPLIED> | ||
58 | <!ATTLIST project upstream CDATA #IMPLIED> | 60 | <!ATTLIST project upstream CDATA #IMPLIED> |
61 | <!ATTLIST project clone-depth CDATA #IMPLIED> | ||
62 | <!ATTLIST project force-path CDATA #IMPLIED> | ||
59 | 63 | ||
60 | <!ELEMENT annotation (EMPTY)> | 64 | <!ELEMENT annotation (EMPTY)> |
61 | <!ATTLIST annotation name CDATA #REQUIRED> | 65 | <!ATTLIST annotation name CDATA #REQUIRED> |
@@ -123,6 +127,11 @@ Attribute `revision`: Name of a Git branch (e.g. `master` or | |||
123 | `refs/heads/master`). Project elements lacking their own | 127 | `refs/heads/master`). Project elements lacking their own |
124 | revision attribute will use this revision. | 128 | revision attribute will use this revision. |
125 | 129 | ||
130 | Attribute `dest-branch`: Name of a Git branch (e.g. `master`). | ||
131 | Project elements not setting their own `dest-branch` will inherit | ||
132 | this value. If this value is not set, projects will use `revision` | ||
133 | by default instead. | ||
134 | |||
126 | Attribute `sync_j`: Number of parallel jobs to use when synching. | 135 | Attribute `sync_j`: Number of parallel jobs to use when synching. |
127 | 136 | ||
128 | Attribute `sync_c`: Set to true to only sync the given Git | 137 | Attribute `sync_c`: Set to true to only sync the given Git |
@@ -201,6 +210,11 @@ Tags and/or explicit SHA-1s should work in theory, but have not | |||
201 | been extensively tested. If not supplied the revision given by | 210 | been extensively tested. If not supplied the revision given by |
202 | the default element is used. | 211 | the default element is used. |
203 | 212 | ||
213 | Attribute `dest-branch`: Name of a Git branch (e.g. `master`). | ||
214 | When using `repo upload`, changes will be submitted for code | ||
215 | review on this branch. If unspecified both here and in the | ||
216 | default element, `revision` is used instead. | ||
217 | |||
204 | Attribute `groups`: List of groups to which this project belongs, | 218 | Attribute `groups`: List of groups to which this project belongs, |
205 | whitespace or comma separated. All projects belong to the group | 219 | whitespace or comma separated. All projects belong to the group |
206 | "all", and each project automatically belongs to a group of | 220 | "all", and each project automatically belongs to a group of |
@@ -222,6 +236,16 @@ Attribute `upstream`: Name of the Git branch in which a sha1 | |||
222 | can be found. Used when syncing a revision locked manifest in | 236 | can be found. Used when syncing a revision locked manifest in |
223 | -c mode to avoid having to sync the entire ref space. | 237 | -c mode to avoid having to sync the entire ref space. |
224 | 238 | ||
239 | Attribute `clone-depth`: Set the depth to use when fetching this | ||
240 | project. If specified, this value will override any value given | ||
241 | to repo init with the --depth option on the command line. | ||
242 | |||
243 | Attribute `force-path`: Set to true to force this project to create the | ||
244 | local mirror repository according to its `path` attribute (if supplied) | ||
245 | rather than the `name` attribute. This attribute only applies to the | ||
246 | local mirrors syncing, it will be ignored when syncing the projects in a | ||
247 | client working directory. | ||
248 | |||
225 | Element annotation | 249 | Element annotation |
226 | ------------------ | 250 | ------------------ |
227 | 251 | ||