From 11cb96030ed5a0c322b5262c10a6af1a70486981 Mon Sep 17 00:00:00 2001 From: Gavin Mak Date: Wed, 16 Aug 2023 22:06:25 +0000 Subject: [PATCH] docs: Document .repo_localsyncstate.json Update docs to reflect the new internal filesystem layout. Bug: b/286126621, b/271507654 Change-Id: I8a2f8f36dff75544f32356ac5e31668f32ddffb3 Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/383074 Reviewed-by: Mike Frysinger Commit-Queue: Gavin Mak Tested-by: Gavin Mak --- docs/internal-fs-layout.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/internal-fs-layout.md b/docs/internal-fs-layout.md index 401ebda1..f63978f3 100644 --- a/docs/internal-fs-layout.md +++ b/docs/internal-fs-layout.md @@ -42,8 +42,12 @@ For example, if you want to change the manifest branch, you can simply run change the git URL/branch that this tracks, re-run `repo init` with the new settings. -* `.repo_fetchtimes.json`: Used by `repo sync` to record stats when syncing - the various projects. +* `.repo_fetchtimes.json`: Used by `repo sync` to record fetch times when + syncing the various projects. + +* `.repo_localsyncstate.json`: Used by `repo sync` to detect and warn on + on partial tree syncs. Partial syncs are allowed by `repo` itself, but are + unsupported by many projects where `repo` is used. ### Manifests