diff options
| author |  Joey Hess <joeyh@joeyh.name> | 2017-05-31 16:57:27 -0400 |
|---|---|---|
| committer | Joey Hess <joeyh@joeyh.name> | 2017-05-31 17:00:18 -0400 |
| commit | 8ba5e7165763682c9154a7cfc3e8b070d0685a6b (patch) | |
| tree | c6a0f3a606e9894408722746ce093a3081201d69 /doc/git-annex-move.mdwn | |
| parent | 75ae06595a6971eb21630928bcdd3f33c06b3ea0 (diff) | |
move --to=here
* move --to=here moves from all reachable remotes to the local repository.
The output of move --from remote is changed slightly, when the remote and
local both have the content. It used to say:
move foo ok
Now:
move foo (from theremote...) ok
That was done so that, when move --to=here is used and the content is
locally present and also in several remotes, it's clear which remotes the
content gets dropped from.
Note that move --to=here will report an error if a non-reachable remote
contains the file, even if the local repository also contains the file. I
think that's reasonable; the user may be intending to move all other copies
of the file from remotes.
OTOH, if a copy of the file is believed to be present in some repository
that is not a configured remote, move --to=here does not report an error.
So a little bit inconsistent, but erroring in this case feels wrong.
copy --to=here came along for free, but it's basically the same behavior as
git-annex get, and probably with not as good messages in edge cases
(especially on failure), so I've not documented it.
This commit was sponsored by Anthony DeRobertis on Patreon.
Diffstat (limited to 'doc/git-annex-move.mdwn')
| -rw-r--r-- | doc/git-annex-move.mdwn | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/doc/git-annex-move.mdwn b/doc/git-annex-move.mdwn index d2595cfe8..6bf24309b 100644 --- a/doc/git-annex-move.mdwn +++ b/doc/git-annex-move.mdwn @@ -4,7 +4,7 @@ git-annex move - move content of files to/from another repository # SYNOPSIS -git annex move `[path ...] [--from=remote|--to=remote]` +git annex move `[path ...] [--from=remote|--to=remote|--to=here]` # DESCRIPTION @@ -14,13 +14,16 @@ Moves the content of files from or to another remote. * `--from=remote` - Use this option to move the content of files from the specified - remote to the local repository. + Move the content of files from the specified remote to the local repository. * `--to=remote` - Use this option to move the content of files from the local repository - to the specified remote. + Move the content of files from the local repository to the specified remote. + +* `--to=here` + + Move the content of files from all reachable remotes to the local + repository. * `--jobs=N` `-JN` |