summaryrefslogtreecommitdiffstats
path: root/docs/manifest-format.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/manifest-format.txt')
-rw-r--r--docs/manifest-format.txt48
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
124revision attribute will use this revision. 128revision attribute will use this revision.
125 129
130Attribute `dest-branch`: Name of a Git branch (e.g. `master`).
131Project elements not setting their own `dest-branch` will inherit
132this value. If this value is not set, projects will use `revision`
133by default instead.
134
126Attribute `sync_j`: Number of parallel jobs to use when synching. 135Attribute `sync_j`: Number of parallel jobs to use when synching.
127 136
128Attribute `sync_c`: Set to true to only sync the given Git 137Attribute `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
201been extensively tested. If not supplied the revision given by 210been extensively tested. If not supplied the revision given by
202the default element is used. 211the default element is used.
203 212
213Attribute `dest-branch`: Name of a Git branch (e.g. `master`).
214When using `repo upload`, changes will be submitted for code
215review on this branch. If unspecified both here and in the
216default element, `revision` is used instead.
217
204Attribute `groups`: List of groups to which this project belongs, 218Attribute `groups`: List of groups to which this project belongs,
205whitespace or comma separated. All projects belong to the group 219whitespace 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
222can be found. Used when syncing a revision locked manifest in 236can 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
239Attribute `clone-depth`: Set the depth to use when fetching this
240project. If specified, this value will override any value given
241to repo init with the --depth option on the command line.
242
243Attribute `force-path`: Set to true to force this project to create the
244local mirror repository according to its `path` attribute (if supplied)
245rather than the `name` attribute. This attribute only applies to the
246local mirrors syncing, it will be ignored when syncing the projects in a
247client working directory.
248
225Element annotation 249Element annotation
226------------------ 250------------------
227 251