summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/git-annex-addurl.mdwn15
-rw-r--r--doc/todo/Add___39__dir__39___option_to_addurl.mdwn3
2 files changed, 15 insertions, 3 deletions
diff --git a/doc/git-annex-addurl.mdwn b/doc/git-annex-addurl.mdwn
index 99b1f8c65..888f6ac31 100644
--- a/doc/git-annex-addurl.mdwn
+++ b/doc/git-annex-addurl.mdwn
@@ -48,13 +48,22 @@ be used to get better filenames.
* `--pathdepth=N`
- This causes a shorter filename to be used. For example,
- `--pathdepth=1` will use "dir/subdir/bigfile",
- while `--pathdepth=3` will use "bigfile".
+ Rather than basing the filename on the whole url, this causes a path to
+ be constructed, starting at the specified depth within the path of the
+ url.
+
+ For example, adding the url http://www.example.com/dir/subdir/bigfile
+ with `--pathdepth=1` will use "dir/subdir/bigfile",
+ while `--pathdepth=3` will use "bigfile".
It can also be negative; `--pathdepth=-2` will use the last
two parts of the url.
+* `--prefix=foo` `--suffix=bar`
+
+ Use to adjust the filenames that are created by addurl. For example,
+ `--suffix=.mp3` can be used to add an extension to the file.
+
# SEE ALSO
[[git-annex]](1)
diff --git a/doc/todo/Add___39__dir__39___option_to_addurl.mdwn b/doc/todo/Add___39__dir__39___option_to_addurl.mdwn
index ccba47947..834b6309f 100644
--- a/doc/todo/Add___39__dir__39___option_to_addurl.mdwn
+++ b/doc/todo/Add___39__dir__39___option_to_addurl.mdwn
@@ -1 +1,4 @@
Is it possible to add a '--dir' option to addurl (or some other mechanic) to make git annex create the symlinks in the specified directory?
+
+> --prefix makes sense, and might as well also add --suffix. [[done]]
+> --[[Joey]]