summaryrefslogtreecommitdiff
path: root/doc/git-annex-import.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'doc/git-annex-import.mdwn')
-rw-r--r--doc/git-annex-import.mdwn69
1 files changed, 69 insertions, 0 deletions
diff --git a/doc/git-annex-import.mdwn b/doc/git-annex-import.mdwn
new file mode 100644
index 000000000..4d2c05547
--- /dev/null
+++ b/doc/git-annex-import.mdwn
@@ -0,0 +1,69 @@
+# NAME
+
+git-annex import - move and add files from outside git working copy
+
+# SYNOPSIS
+
+git annex import `[path ...]`
+
+# DESCRIPTION
+
+Moves files from somewhere outside the git working copy, and adds them to
+the annex. Individual files to import can be specified.
+If a directory is specified, the entire directory is imported.
+
+ 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 all checksumming backends, including the default SHA256E,
+only one copy of the data will be stored.)
+
+# OPTIONS
+
+* `--duplicate`
+
+ Do not delete files from the import location.
+
+ 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.
+
+* `--deduplicate`
+
+ Only import files whose content has not been seen before by git-annex.
+
+ Duplicate files will be deleted from the import location.
+
+* `--skip-duplicates`
+
+ Only import files whose content has not been seen before by git-annex,
+ but avoid deleting duplicate files.
+
+* `--clean-duplicates`
+
+ Does not import any files, but any files found in the import location
+ that are duplicates of content in the annex are deleted.
+
+* file matching options
+
+ Many of the [[git-annex-matching-options]](1)
+ can be used to specify files to import.
+
+ git annex import /dir --include='*.png'
+
+# CAVEATS
+
+Note that using `--deduplicate` or `--clean-duplicates` with the WORM
+backend does not look at file content, but filename and mtime.
+
+# SEE ALSO
+
+[[git-annex]](1)
+
+# AUTHOR
+
+Joey Hess <id@joeyh.name>
+
+Warning: Automatically converted into a man page by mdwn2man. Edit with care.