From cf52063b5d26dabc1a1b3eaffffd0cc3a0769ef9 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Sun, 11 Aug 2013 18:56:26 +0200 Subject: docs for 3 import duplicate file handling options --- doc/git-annex.mdwn | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) (limited to 'doc') diff --git a/doc/git-annex.mdwn b/doc/git-annex.mdwn index 60736d579..2437de488 100644 --- a/doc/git-annex.mdwn +++ b/doc/git-annex.mdwn @@ -190,6 +190,27 @@ subdirectories). git annex import /media/camera/DCIM/ + By default, importing two files with the same contents from two different + locations will result in both files being added to the repository. + (With most backends, only one copy of the data will be stored.) + + To not delete files from the import location, use the + --duplicate option. This could allow importing the same files repeatedly + to different locations in a repository. More likely, it could be used to + import the same files to a number of different branches or separate git + repositories. + + The --deduplicate option can be used to alter this behavior, making + files whose content has already been seen by git-annex not be added + to the repository, but just be deleted. + + The --clean-duplicates option does not import any new files, but any files + found in the import location that are duplicates of content in the annex + are deleted. + + (Note that using --deduplicate or --clean-duplicates with the WORM + backend does not look at file content, but filename and mtime.) + * importfeed [url ...] Imports the contents of podcast feeds. Only downloads files whose -- cgit v1.2.3