git-annex/doc/walkthrough
Joey Hess 5df89d58c7
git-annex pull and push
Split out two new commands, git-annex pull and git-annex push. Those plus a
git commit are equivilant to git-annex sync.

In a sense, git-annex sync conflates 3 things, and it would have been
better to have push and pull from the beginning and not sync. Although
note that git-annex sync --content is faster than a pull followed by a
push, because it only has to walk the tree once, look at preferred
content once, etc. So there is some value in git-annex sync in speed, as
well as user convenience.

And it would be hard to split out pull and push from sync, as far as the
implementaton goes. The implementation inside sync was easy, just adjust
SyncOptions so it does the right thing.

Note that the new commands default to syncing content, unless
annex.synccontent is explicitly set to false. I'd like sync to also do
that, but that's a hard transition to make. As a start to that
transition, I added a note to git-annex-sync.mdwn that it may start to
do so in a future version of git-annex. But a real transition would
necessarily involve displaying warnings when sync is used without
--content, and time.

Sponsored-by: Kevin Mueller on Patreon
2023-05-16 16:51:07 -04:00
..
adding_a_remote
backups
modifying_annexed_files
moving_file_content_between_repositories
removing_files
renaming_files
unused_data
using_ssh_remotes
adding_a_remote.mdwn
adding_files.mdwn
automatically_managing_content.mdwn
backups.mdwn
creating_a_repository.mdwn
fsck__58___verifying_your_data.mdwn
fsck__58___when_things_go_wrong.mdwn
getting_file_content.mdwn
modifying_annexed_files.mdwn
more.mdwn
moving_file_content_between_repositories.mdwn
quiet_please__58___When_git-annex_seems_to_skip_files.mdwn
removing_files.mdwn
removing_files__58___When_things_go_wrong.mdwn
renaming_files.mdwn
syncing.mdwn
transferring_files__58___When_things_go_wrong.mdwn
unused_data.mdwn
using_bup.mdwn
using_ddar.mdwn
using_special_remotes.mdwn
using_ssh_remotes.mdwn
using_tags_and_branches.mdwn