diff options
author | Joey Hess <joeyh@joeyh.name> | 2015-08-09 10:12:47 -0400 |
---|---|---|
committer | Joey Hess <joeyh@joeyh.name> | 2015-08-09 10:12:47 -0400 |
commit | f99bdba8f31bc2616b5badd7e98608bc101b8d0f (patch) | |
tree | 95379750e3e03562863f53f24d963b62b478112d | |
parent | 439da03636cbc34f0c0ab3bd99be7bf72c684a30 (diff) |
Revert "removed"
This reverts commit e5546ac16dba167fcad7e9a7408e9726868cd3c3.
This user will be banned if they make any further such apparently malicious
or stupid changes.
-rw-r--r-- | doc/git-annex-addurl.mdwn | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/doc/git-annex-addurl.mdwn b/doc/git-annex-addurl.mdwn new file mode 100644 index 000000000..888f6ac31 --- /dev/null +++ b/doc/git-annex-addurl.mdwn @@ -0,0 +1,81 @@ +# NAME + +git-annex addurl - add urls to annex + +# SYNOPSIS + +git annex addurl `[url ...]` + +# DESCRIPTION + +Downloads each url to its own file, which is added to the annex. + +When `quvi` is installed, urls are automatically tested to see if they +point to a video hosting site, and the video is downloaded instead. + +Urls to torrent files (including magnet links) will cause the content of +the torrent to be downloaded, using `aria2c`. + +Normally the filename is based on the full url, so will look like +"www.example.com_dir_subdir_bigfile". In some cases, addurl is able to +come up with a better filename based on other information. Options can also +be used to get better filenames. + +# OPTIONS + +* `--fast` + + Avoid immediately downloading the url. + +* `--relaxed` + + Avoid storing the size of the url's content, and accept whatever + content is there at a future point. (Implies `--fast`.) + +* `--raw` + + Prevent special handling of urls by quvi, bittorrent, and other + special remotes. This will for example, make addurl + download the .torrent file and not the contents it points to. + +* `--file=name` + + Use with a filename that does not yet exist to add a new file + with the specified name and the content downloaded from the url. + + If the file already exists, addurl will record that it can be downloaded + from the specified url(s). + +* `--pathdepth=N` + + 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) + +[[git-annex-rmurl]](1) + +[[git-annex-registerurl]](1) + +[[git-annex-importfeed]](1) + +# AUTHOR + +Joey Hess <id@joeyh.name> + +Warning: Automatically converted into a man page by mdwn2man. Edit with care. |