diff options
| author | Shawn O. Pearce <sop@google.com> | 2008-11-06 11:07:14 -0800 |
|---|---|---|
| committer | Shawn O. Pearce <sop@google.com> | 2008-11-06 11:23:08 -0800 |
| commit | 70939e2f73bf118c89cf4af4988dba807c50a0ce (patch) | |
| tree | b1849b9a48572876b35cd621192cbb4c712e816e /docs | |
| parent | ae6e0949d187c35d79dbc0b21788fdbb2c65bf78 (diff) | |
| download | git-repo-70939e2f73bf118c89cf4af4988dba807c50a0ce.tar.gz git-repo-70939e2f73bf118c89cf4af4988dba807c50a0ce.zip | |
Add <add-remote to-project="..."> to inject additional remotes
This way users can add forks they know about to an existing project
that was already declared in the primary manifest. This is mostly
useful with the Linux kernel project, where multiple forks is quite
common for the main upstream tree (e.g. Linus' tree), a platform
architecture tree (e.g. ARM) and a device specific tree (e.g. the
msm7k tree used by Android).
Signed-off-by: Shawn O. Pearce <sop@google.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/manifest-format.txt | 24 |
1 files changed, 23 insertions, 1 deletions
diff --git a/docs/manifest-format.txt b/docs/manifest-format.txt index 2b49d4660..5c014d6d4 100644 --- a/docs/manifest-format.txt +++ b/docs/manifest-format.txt @@ -20,7 +20,10 @@ A manifest XML file (e.g. 'default.xml') roughly conforms to the following DTD: <!DOCTYPE manifest [ - <!ELEMENT manifest (remote*, default?, project*)> + <!ELEMENT manifest (remote*, + default?, + project*, + add-remote*)> <!ELEMENT remote (EMPTY)> <!ATTLIST remote name ID #REQUIRED> @@ -37,6 +40,13 @@ following DTD: <!ATTLIST project path CDATA #IMPLIED> <!ATTLIST project remote IDREF #IMPLIED> <!ATTLIST project revision CDATA #IMPLIED> + + <!ELEMENT add-remote (EMPTY)> + <!ATTLIST add-remote to-project ID #REQUIRED> + <!ATTLIST add-remote name ID #REQUIRED> + <!ATTLIST add-remote fetch CDATA #REQUIRED> + <!ATTLIST add-remote review CDATA #IMPLIED> + <!ATTLIST add-remote project-name CDATA #IMPLIED> ]> A description of the elements and their attributes follows. @@ -74,6 +84,18 @@ Only permitted when the remote element is nested inside of a project element (see below). If not given, defaults to the name supplied in the project's name attribute. +Element add-remote +------------------ + +Adds a remote to an existing project, whose name is given by the +to-project attribute. This is functionally equivalent to nesting +a remote element under the project, but has the advantage that it +can be specified in the uesr's `local_manifest.xml` to add a remote +to a project declared by the normal manifest. + +The element can be used to add a fork of an existing project that +the user needs to work with. + Element default --------------- |