21ec5872f4
i found that most man pages only had references to the main git-annex manpage, which i stillfind pretty huge and hard to navigate through. i tried to sift through all the man pages and add cross-references between relevant pages. my general rule of thumb is that links should be both ways unless one of the pages is a more general page that would become ridiculously huge if all backlinks would be added (git-annex-preferred-content comes to mind). i have also make the links one per line as this is how it was done in the metadata pages so far. i did everything but the plumbing, utility and test commands, although some of those are linked from the other commands so cross-links were added there as well.
50 lines
1.2 KiB
Markdown
50 lines
1.2 KiB
Markdown
# NAME
|
|
|
|
git-annex migrate - switch data to different backend
|
|
|
|
# SYNOPSIS
|
|
|
|
git annex migrate `[path ...]`
|
|
|
|
# DESCRIPTION
|
|
|
|
Changes the specified annexed files to use the default key-value backend
|
|
(or the one specified with `--backend`). Only files whose content
|
|
is currently available are migrated.
|
|
|
|
Note that the content is also still available using the old key after
|
|
migration. Use `git annex unused` to find and remove the old key.
|
|
|
|
Normally, nothing will be done to files already using the new backend.
|
|
However, if a backend changes the information it uses to construct a key,
|
|
this can also be used to migrate files to use the new key format.
|
|
|
|
When you have multiple repositories that each contain a copy of a file,
|
|
it's best to run migrate in all of them.
|
|
|
|
# OPTIONS
|
|
|
|
* `--backend`
|
|
|
|
Specify the new key-value backend to use for migrated data.
|
|
|
|
* `--force`
|
|
|
|
Force migration of keys that are already using the new backend.
|
|
|
|
* file matching options
|
|
|
|
The [[git-annex-matching-options]](1)
|
|
can be used to specify files to migrate.
|
|
|
|
# SEE ALSO
|
|
|
|
[[git-annex]](1)
|
|
|
|
[[git-annex-upgrade]](1)
|
|
|
|
# AUTHOR
|
|
|
|
Joey Hess <id@joeyh.name>
|
|
|
|
Warning: Automatically converted into a man page by mdwn2man. Edit with care.
|