summaryrefslogtreecommitdiffstats
path: root/docs/manifest-format.md
diff options
context:
space:
mode:
authorMike Frysinger <vapier@google.com>2025-01-30 19:11:36 -0500
committerLUCI <gerrit-scoped@luci-project-accounts.iam.gserviceaccount.com>2025-01-30 19:17:24 -0800
commitdfdf577e98f6e9b13a3236767316863b3a995c01 (patch)
tree80174e5979fec68b97180e80827bd965f2710b29 /docs/manifest-format.md
parent747ec83f58aceb855e92aa2befaba17f04da1bee (diff)
downloadgit-repo-dfdf577e98f6e9b13a3236767316863b3a995c01.tar.gz
docs: smart-sync: split out & expand details
The existing documentation on smart-sync behavior is a bit light on details, and out of date wrt what the code actually does. Start a dedicated document and fill it out more. Change-Id: I1a8a3ac6edf9291d72182ad55db865035d9b683e Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/450002 Commit-Queue: Mike Frysinger <vapier@google.com> Tested-by: Mike Frysinger <vapier@google.com> Reviewed-by: Josip Sokcevic <sokcevic@chromium.org>
Diffstat (limited to 'docs/manifest-format.md')
-rw-r--r--docs/manifest-format.md21
1 files changed, 1 insertions, 20 deletions
diff --git a/docs/manifest-format.md b/docs/manifest-format.md
index cfb80164..71fa04c5 100644
--- a/docs/manifest-format.md
+++ b/docs/manifest-format.md
@@ -231,26 +231,7 @@ At most one manifest-server may be specified. The url attribute
231is used to specify the URL of a manifest server, which is an 231is used to specify the URL of a manifest server, which is an
232XML RPC service. 232XML RPC service.
233 233
234The manifest server should implement the following RPC methods: 234See the [smart sync documentation](./smart-sync.md) for more details.
235
236 GetApprovedManifest(branch, target)
237
238Return a manifest in which each project is pegged to a known good revision
239for the current branch and target. This is used by repo sync when the
240--smart-sync option is given.
241
242The target to use is defined by environment variables TARGET_PRODUCT
243and TARGET_BUILD_VARIANT. These variables are used to create a string
244of the form $TARGET_PRODUCT-$TARGET_BUILD_VARIANT, e.g. passion-userdebug.
245If one of those variables or both are not present, the program will call
246GetApprovedManifest without the target parameter and the manifest server
247should choose a reasonable default target.
248
249 GetManifest(tag)
250
251Return a manifest in which each project is pegged to the revision at
252the specified tag. This is used by repo sync when the --smart-tag option
253is given.
254 235
255 236
256### Element submanifest 237### Element submanifest