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.txt25
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/manifest-format.txt b/docs/manifest-format.txt
index da0e69ff..211344ee 100644
--- a/docs/manifest-format.txt
+++ b/docs/manifest-format.txt
@@ -22,6 +22,7 @@ following DTD:
22 <!DOCTYPE manifest [ 22 <!DOCTYPE manifest [
23 <!ELEMENT manifest (remote*, 23 <!ELEMENT manifest (remote*,
24 default?, 24 default?,
25 manifest-server?,
25 remove-project*, 26 remove-project*,
26 project*)> 27 project*)>
27 28
@@ -33,6 +34,9 @@ following DTD:
33 <!ELEMENT default (EMPTY)> 34 <!ELEMENT default (EMPTY)>
34 <!ATTLIST default remote IDREF #IMPLIED> 35 <!ATTLIST default remote IDREF #IMPLIED>
35 <!ATTLIST default revision CDATA #IMPLIED> 36 <!ATTLIST default revision CDATA #IMPLIED>
37
38 <!ELEMENT manifest-server (EMPTY)>
39 <!ATTLIST url CDATA #REQUIRED>
36 40
37 <!ELEMENT project (EMPTY)> 41 <!ELEMENT project (EMPTY)>
38 <!ATTLIST project name CDATA #REQUIRED> 42 <!ATTLIST project name CDATA #REQUIRED>
@@ -89,6 +93,27 @@ Attribute `revision`: Name of a Git branch (e.g. `master` or
89revision attribute will use this revision. 93revision attribute will use this revision.
90 94
91 95
96Element manifest-server
97-----------------------
98
99At most one manifest-server may be specified. The url attribute
100is used to specify the URL of a manifest server, which is an
101XML RPC service that will return a manifest in which each project
102is pegged to a known good revision for the current branch and
103target.
104
105The manifest server should implement:
106
107 GetApprovedManifest(branch, target)
108
109The target to use is defined by environment variables TARGET_PRODUCT
110and TARGET_BUILD_VARIANT. These variables are used to create a string
111of the form $TARGET_PRODUCT-$TARGET_BUILD_VARIANT, e.g. passion-userdebug.
112If one of those variables or both are not present, the program will call
113GetApprovedManifest without the target paramater and the manifest server
114should choose a reasonable default target.
115
116
92Element project 117Element project
93--------------- 118---------------
94 119