summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2012-02-16 12:25:19 -0400
committerGravatar Joey Hess <joey@kitenet.net>2012-02-16 12:25:19 -0400
commit39c3f56b339fcaad3f91530f1f2dce0a0783d782 (patch)
tree6cb77b1b0fc97d21420dd6ba4b27602e45be43a9 /doc
parenta86d937b5b4dd8348bdf3d08ceea7cfe1aa43668 (diff)
addurl: Add --pathdepth option.
Diffstat (limited to 'doc')
-rw-r--r--doc/git-annex.mdwn13
1 files changed, 9 insertions, 4 deletions
diff --git a/doc/git-annex.mdwn b/doc/git-annex.mdwn
index d4e62568f..d5814a2c2 100644
--- a/doc/git-annex.mdwn
+++ b/doc/git-annex.mdwn
@@ -149,10 +149,15 @@ subdirectories).
To avoid immediately downloading the url, specify --fast.
- To specify what file the url is added to, specify --file. This changes
- the behavior; now all the specified urls are recorded as alternate
- locations from which the file can be downloaded. In this mode, addurl
- can be used both to add new files, or to add urls to existing files.
+ Normally the filename is based on the full url, so will look like
+ "www.example.com_subdir_bigfile". For a shorter filename, specify
+ --pathdepth=N. For example, --pathdepth=2 will use "subdir/bigfile",
+ while --parhdepth=1 will use "bigfile".
+
+ Or, to directly specify what file the url is added to, specify --file.
+ This changes the behavior; now all the specified urls are recorded as
+ alternate locations from which the file can be downloaded. In this mode,
+ addurl can be used both to add new files, or to add urls to existing files.
# REPOSITORY SETUP COMMANDS