summaryrefslogtreecommitdiffstats
path: root/man/repo-manifest.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/repo-manifest.1')
-rw-r--r--man/repo-manifest.130
1 files changed, 23 insertions, 7 deletions
diff --git a/man/repo-manifest.1 b/man/repo-manifest.1
index e49836ca..10ec2e75 100644
--- a/man/repo-manifest.1
+++ b/man/repo-manifest.1
@@ -1,5 +1,5 @@
1.\" DO NOT MODIFY THIS FILE! It was generated by help2man. 1.\" DO NOT MODIFY THIS FILE! It was generated by help2man.
2.TH REPO "1" "October 2022" "repo manifest" "Repo Manual" 2.TH REPO "1" "April 2024" "repo manifest" "Repo Manual"
3.SH NAME 3.SH NAME
4repo \- repo manifest - manual page for repo manifest 4repo \- repo manifest - manual page for repo manifest
5.SH SYNOPSIS 5.SH SYNOPSIS
@@ -194,8 +194,9 @@ CDATA #IMPLIED>
194<!ATTLIST extend\-project upstream CDATA #IMPLIED> 194<!ATTLIST extend\-project upstream CDATA #IMPLIED>
195.IP 195.IP
196<!ELEMENT remove\-project EMPTY> 196<!ELEMENT remove\-project EMPTY>
197<!ATTLIST remove\-project name CDATA #REQUIRED> 197<!ATTLIST remove\-project name CDATA #IMPLIED>
198<!ATTLIST remove\-project optional CDATA #IMPLIED> 198<!ATTLIST remove\-project path CDATA #IMPLIED>
199<!ATTLIST remove\-project optional CDATA #IMPLIED>
199.IP 200.IP
200<!ELEMENT repo\-hooks EMPTY> 201<!ELEMENT repo\-hooks EMPTY>
201<!ATTLIST repo\-hooks in\-project CDATA #REQUIRED> 202<!ATTLIST repo\-hooks in\-project CDATA #REQUIRED>
@@ -210,8 +211,9 @@ CDATA #IMPLIED>
210<!ATTLIST contactinfo bugurl CDATA #REQUIRED> 211<!ATTLIST contactinfo bugurl CDATA #REQUIRED>
211.IP 212.IP
212<!ELEMENT include EMPTY> 213<!ELEMENT include EMPTY>
213<!ATTLIST include name CDATA #REQUIRED> 214<!ATTLIST include name CDATA #REQUIRED>
214<!ATTLIST include groups CDATA #IMPLIED> 215<!ATTLIST include groups CDATA #IMPLIED>
216<!ATTLIST include revision CDATA #IMPLIED>
215.PP 217.PP
216]> 218]>
217``` 219```
@@ -533,13 +535,24 @@ the repo client.
533.PP 535.PP
534Element remove\-project 536Element remove\-project
535.PP 537.PP
536Deletes the named project from the internal manifest table, possibly allowing a 538Deletes a project from the internal manifest table, possibly allowing a
537subsequent project element in the same manifest file to replace the project with 539subsequent project element in the same manifest file to replace the project with
538a different source. 540a different source.
539.PP 541.PP
540This element is mostly useful in a local manifest file, where the user can 542This element is mostly useful in a local manifest file, where the user can
541remove a project, and possibly replace it with their own definition. 543remove a project, and possibly replace it with their own definition.
542.PP 544.PP
545The project `name` or project `path` can be used to specify the remove target
546meaning one of them is required. If only name is specified, all projects with
547that name are removed.
548.PP
549If both name and path are specified, only projects with the same name and path
550are removed, meaning projects with the same name but in other locations are
551kept.
552.PP
553If only path is specified, a matching project is removed regardless of its name.
554Logic otherwise behaves like both are specified.
555.PP
543Attribute `optional`: Set to true to ignore remove\-project elements with no 556Attribute `optional`: Set to true to ignore remove\-project elements with no
544matching `project` element. 557matching `project` element.
545.PP 558.PP
@@ -608,7 +621,10 @@ included manifest belong. This appends and recurses, meaning all projects in
608included manifests carry all parent include groups. Same syntax as the 621included manifests carry all parent include groups. Same syntax as the
609corresponding element of `project`. 622corresponding element of `project`.
610.PP 623.PP
611Local Manifests 624Attribute `revision`: Name of a Git branch (e.g. `main` or `refs/heads/main`)
625default to which all projects in the included manifest belong.
626.PP
627Local Manifests
612.PP 628.PP
613Additional remotes and projects may be added through local manifest files stored 629Additional remotes and projects may be added through local manifest files stored
614in `$TOP_DIR/.repo/local_manifests/*.xml`. 630in `$TOP_DIR/.repo/local_manifests/*.xml`.