summaryrefslogtreecommitdiff
path: root/doc/git-annex-import.mdwn
blob: 4d2c05547ece6a334d0121bf21f8f8e5c016dee8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
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.