mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

add example, including use of branch:subdir to export only a subdir

Browse source
This commit is contained in:
Joey Hess 2017-09-16 16:36:18 -04:00
parent 7960870e48
commit fa73387345
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
1 changed files with 25 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
doc/git-annex-export.mdwn
View file

@ -19,8 +19,12 @@ so is not allowed. You have to configure a special remote with
`exporttree=yes` when initially setting it up with
[[git-annex-initremote]](1).
The treeish to export can be the name of a git branch, or a tag, or any
other treeish accepted by git, including eg master:subdir to only export a
subdirectory from a branch.
Repeated exports are done efficiently, by diffing the old and new tree,
and transferring only the changed files.
and transferring only the changed files, and renaming files as necessary.
Exports can be interrupted and resumed. However, partially uploaded files
will be re-started from the beginning.
@ -32,6 +36,26 @@ verification of content downloaded from an export. Some types of keys,
that are not based on checksums, cannot be downloaded from an export.
And, git-annex will never trust an export to retain the content of a key.
# EXAMPLE
git annex initremote myexport type=directory directory=/mnt/myexport \
exportree=yes encryption=none
git annex export master --to myexport
After that, /mnt/myexport will contain the same tree of files as the master
branch does.
git mv myfile subdir/myfile
git commit -m renamed
git annex export master --to myexport
That updates /mnt/myexport to reflect the renamed file.
git annex export master:subdir --to myexport
That updates /mnt/myexport, to contain only the files in the "subdir"
directory of the master branch.
# EXPORT CONFLICTS
If two different git-annex repositories are both exporting different trees