From d16c3d683ed3265b1ecbdf291f463f6934bf9692 Mon Sep 17 00:00:00 2001 From: Chris Darroch Date: Wed, 2 Mar 2022 11:45:41 -0800 Subject: [PATCH] docs/man: note push --all only pushes local refs As the "git lfs push --all" command does not (when used without other arguments) push any objects not reachable from local refs, i.e., specifically only those under refs/heads and refs/tags, we note that this behaviour differs from that of "git lfs fetch --all" and that users wanting to migrate repositories with these commands may need to make additional pushes of non-local refs. --- docs/man/git-lfs-push.1.ronn | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/man/git-lfs-push.1.ronn b/docs/man/git-lfs-push.1.ronn index 09e75b1304..21c52f957a 100644 --- a/docs/man/git-lfs-push.1.ronn +++ b/docs/man/git-lfs-push.1.ronn @@ -21,7 +21,12 @@ of the remote. * `--all`: This pushes all objects to the remote that are referenced by any commit reachable from the refs provided as arguments. If no refs are provided, then - all refs are pushed. + all local refs are pushed. Note that this behavior differs from that of + git-lfs-fetch(1) when its `--all` option is used; in that case, all refs + are fetched, including refs other than those under `refs/heads` and + `refs/tags`. If you are migrating a repository with these commands, make + sure to run `git lfs push` for any additional remote refs that contain + Git LFS objects not reachable from your local refs. * `--object-id`: This pushes only the object OIDs listed at the end of the command, separated @@ -29,6 +34,6 @@ of the remote. ## SEE ALSO -git-lfs-pre-push(1). +git-lfs-fetch(1), git-lfs-pre-push(1). Part of the git-lfs(1) suite.