Outline extended git annex sync semantics in the documentation

This commit is contained in:
Joachim Breitner 2011-12-27 19:23:41 +01:00
parent ab1435310c
commit 559bbdb424

View file

@ -122,13 +122,18 @@ subdirectories).
* sync * sync
Use this command when you want to synchronize the local repository Use this command when you want to synchronize the local repository with
with its default remote (typically "origin"). The sync process involves one or more other repositories. The sync process involves first committing
first committing all local changes, then pulling and merging any changes all local changes, then fetching and merging the `synced/master` and the
from the remote, and finally pushing the repository's state to the remote. `git-annex` branch from the remote repositories and finally pushing the
changes back to these remote branches.
You can use standard git commands to do each of those steps by hand, You can use standard git commands to do each of those steps by hand,
or if you don't want to worry about the details, you can use sync. or if you don't want to worry about the details, you can use sync.
By default, `git annex sync` will sync all remote repositories that have a
`synced/master` branch. If you want to include/exclude a repository from
this list, just create or delete this branch.
Note that sync does not transfer any file contents from or to the remote. Note that sync does not transfer any file contents from or to the remote.
* addurl [url ...] * addurl [url ...]