.TH git-annex-registerurl 1
.SH NAME
git-annex-registerurl \- registers an url for a key
.PP
.SH SYNOPSIS
git annex registerurl \fB[key url]\fP
.PP
.SH DESCRIPTION
This plumbing\-level command can be used to register urls where a
key can be downloaded from.
.PP
No verification is performed of the url's contents.
.PP
Normally the key is a git-annex formatted key. However, to make it easier
to use this to add urls, if the key cannot be parsed as a key, and is a
valid url, an URL key is constructed from the url.
.PP
Registering an url also makes git-annex treat the key as present in the
special remote that claims it. (Usually the web special remote.)
.PP
.SH OPTIONS
.IP "\fB\-\-remote=name|uuid\fP"
.IP
Indicate that the url is expected to be claimed by the specified remote.
If some other remote claims the url instead, registering it will fail.
.IP
Note that \fB\-\-remote=web\fP will prevent any other remote from claiming
the url.
.IP
.IP "\fB\-\-batch\fP"
In batch input mode, lines are read from stdin, and each line
should contain a key and url, separated by a single space.
.IP
For backwards compatability with old git-annex before this option
was added, when no key and url pair are specified on the command line,
batch input is used, the same as if the \-\-batch option were
specified. It is however recommended to use \-\-batch.
.IP
.IP "\fB\-z\fP"
When in batch mode, the input is delimited by nulls instead of the usual
newlines.
.IP
(Note that for this to be used, you have to explicitly enable batch mode
with \fB\-\-batch\fP)
.IP
.IP "\fB\-\-json\fP"
Enable JSON output. This is intended to be parsed by programs that use
git-annex. Each line of output is a JSON object.
.IP
.IP "\fB\-\-json\-error\-messages\fP"
Messages that would normally be output to standard error are included in
the JSON instead.
.IP
.IP "Also the git-annex\-common\-options(1) can be used."
.SH SEE ALSO
git-annex(1)
.PP
git-annex\-addurl(1)
.PP
git-annex\-unregisterurl(1)
.PP
.SH AUTHOR
Joey Hess <id@joeyh.name>
.PP
.PP