summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorJames W. Mills <jameswmills@gmail.com>2012-04-12 15:04:13 -0500
committerShawn O. Pearce <sop@google.com>2012-04-23 12:35:08 -0700
commit24c130884018364f91baa8de0ff3541f4c32d1bb (patch)
tree213b269d05e2a5f2b70d895325301a9a9f30e4a2 /docs
parentb962a1f5e0daad323bdd66fad93f00a3738cc255 (diff)
downloadgit-repo-24c130884018364f91baa8de0ff3541f4c32d1bb.tar.gz
Add project annotation handling to repo
Allow the optional addition of "annotation" nodes nested under projects. Each annotation node must have "name" and "value" attributes. These name/value pairs will be exported into the environment during any forall command, prefixed with "REPO__" In addition, an optional "keep" attribute with case insensitive "true" or "false" values can be included to determine whether the annotation will be exported with 'repo manifest' Change-Id: Icd7540afaae02c958f769ce3d25661aa721a9de8 Signed-off-by: James W. Mills <jameswmills@gmail.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/manifest-format.txt18
1 files changed, 17 insertions, 1 deletions
diff --git a/docs/manifest-format.txt b/docs/manifest-format.txt
index a7bb1561..e5f5ee18 100644
--- a/docs/manifest-format.txt
+++ b/docs/manifest-format.txt
@@ -43,12 +43,17 @@ following DTD:
43 <!ELEMENT manifest-server (EMPTY)> 43 <!ELEMENT manifest-server (EMPTY)>
44 <!ATTLIST url CDATA #REQUIRED> 44 <!ATTLIST url CDATA #REQUIRED>
45 45
46 <!ELEMENT project (EMPTY)> 46 <!ELEMENT project (annotation?)>
47 <!ATTLIST project name CDATA #REQUIRED> 47 <!ATTLIST project name CDATA #REQUIRED>
48 <!ATTLIST project path CDATA #IMPLIED> 48 <!ATTLIST project path CDATA #IMPLIED>
49 <!ATTLIST project remote IDREF #IMPLIED> 49 <!ATTLIST project remote IDREF #IMPLIED>
50 <!ATTLIST project revision CDATA #IMPLIED> 50 <!ATTLIST project revision CDATA #IMPLIED>
51 <!ATTLIST project groups CDATA #IMPLIED> 51 <!ATTLIST project groups CDATA #IMPLIED>
52
53 <!ELEMENT annotation (EMPTY)>
54 <!ATTLIST annotation name CDATA #REQUIRED>
55 <!ATTLIST annotation value CDATA #REQUIRED>
56 <!ATTLIST annotation keep CDATA "true">
52 57
53 <!ELEMENT remove-project (EMPTY)> 58 <!ELEMENT remove-project (EMPTY)>
54 <!ATTLIST remove-project name CDATA #REQUIRED> 59 <!ATTLIST remove-project name CDATA #REQUIRED>
@@ -163,6 +168,17 @@ Attribute `groups`: List of groups to which this project belongs,
163whitespace or comma separated. All projects are part of the group 168whitespace or comma separated. All projects are part of the group
164"default" unless "-default" is specified in the list of groups. 169"default" unless "-default" is specified in the list of groups.
165 170
171Element annotation
172------------------
173
174Zero or more annotation elements may be specified as children of a
175project element. Each element describes a name-value pair that will be
176exported into each project's environment during a 'forall' command,
177prefixed with REPO__. In addition, there is an optional attribute
178"keep" which accepts the case insensitive values "true" (default) or
179"false". This attribute determines whether or not the annotation will
180be kept when exported with the manifest subcommand.
181
166Element remove-project 182Element remove-project
167---------------------- 183----------------------
168 184