How to git fetch efficiently from a shallow clone

--depth is a git fetch option. I see the doc doesn’t really highlight that git clone does a fetch.

When you fetch, the two repos swap info on who has what by starting from the remote’s heads and searching backward for the most recent shared commit in the fetched refs’ histories, then filling in all the missing objects to complete just the new commits between the most recent shared commits and the newly fetched ones.

A --depth=1 fetch just gets the branch tips and no prior history. Further fetches of those histories will fetch everything new by the above procedure, but if the previously-fetched commits aren’t in the newly fetched history, fetch will retrieve all of it — unless you limit the fetch with --depth.

Your client did a depth=1 fetch from one repo and switched urls to a different repo. At least one long ancestry path in this new repo’s refs apparently shares no commits with anything currently in your repo. That might be worth investigating, but either way unless there’s some particular reason, your clients can just do every fetch --depth=1.

Leave a Comment