.TH git-annex-fromkey 1
.SH NAME
git-annex-fromkey \- adds a file using a specific key
.PP
.SH SYNOPSIS
git annex fromkey \fB[key file ...]\fP
.PP
.SH DESCRIPTION
This plumbing\-level command can be used to manually set up a file
in the git repository to link to a specified key.
.PP
Multiple pairs of file and key can be given in a single command line.
.PP
If no key and file pair are specified on the command line, batch input
is used, the same as if the \-\-batch option were specified.
.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. Note that this does not
register the url as a location of the key; use git-annex\-registerurl(1)
to do that.
.PP
.SH OPTIONS
.IP "\fB\-\-force\fP"
.IP
Allow making a file link to a key whose content is not in the local
repository. The key may not be known to git-annex at all.
.IP
.IP "\fB\-\-batch\fP"
In batch input mode, lines are read from stdin, and each line
should contain a key and filename, separated by a single space.
.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
.SH SEE ALSO
git-annex(1)
.PP
.SH AUTHOR
Joey Hess <id@joeyh.name>
.PP
.PP