.TH git-annex-addcomputed 1
.SH NAME
git-annex-addcomputed \- adds computed files to the repository
.PP
.SH SYNOPSIS
git annex addcomputed \fB\-\-to=remote \-\- ...\fP
.PP
.SH DESCRIPTION
Adds files to the annex that are computed from input files in the
repository, using a compute special remote.
.PP
Once a file has been added to a compute remote, commands
like \fBgit-annex get\fP will use it to compute the content of the file.
.PP
The syntax of this command after the \fB\-\-\fP is up to the program that
the compute special remote is set up to run to perform the comuptation.
.PP
To see the program's usage, you can run:
.PP
git-annex addcomputed \-\-to=foo
.PP
Generally you will provide an input file (or files), and often also an
output filename, and additional parameters to control the computation.
.PP
There can be more than one input file that are combined to compute an
output file. And multiple output files can be computed at the same time.
.PP
Some examples of how this might look:
.PP
git-annex addcomputed \-\-to=x \-\- convert file.raw file.jpeg passes=10
git-annex addcomputed \-\-to=y \-\- compress foo \-\-level=9
git-annex addcomputed \-\-to=z \-\- clip foo 2:01\-3:00 combine with bar to baz
.PP
Note that parameters that were passed to \fBgit-annex initremote\fP 
when setting up the compute special remote will be appended to the end of
the parameters provided to \fBgit-annex addcomputed\fP.
.PP
.SH OPTIONS
.IP "\fB\-\-to=remote\fP"
.IP
Specify which remote will compute the files. 
.IP
This must be a compute remote. For example, one can be
initialized with:
.IP
git-annex initremote photoconv type=compute \\
program=git-annex\-compute\-photoconv
.IP
For details about compute remotes, and a list of some
of the programs that are available, see
<https://git-annex.branchable.com/special_remotes/compute/>
.IP
.IP "\fB\-\-fast\fP"
Adds computed files to the repository, without doing any work yet to
compute their content.
.IP
This implies \fB\-\-unreproducible\fP, because even if the compute remote
produces reproducible output, it's not available.
.IP
.IP "\fB\-\-unreproducible\fP, \fB\-u\fP"
Indicate that the computation is not expected to be fully reproducible.
It can vary, in ways that produce files that equivilant enough to
be interchangeable, but are not necessarily identical.
.IP
This is the default unless the compute remote indicates that it produces
reproducible output.
.IP
.IP "\fB\-\-reproducible\fP, \fB\-r\fP"
Indicate that the computation is expected to be fully reproducible.
.IP
This is the default when the compute remote indicates that it produces
reproducible output (except when using \fB\-\-fast\fP).
.IP
If a computation turns out not to be fully reproducible, then getting
a computed file from the compute remote will later fail with a
checksum verification error. One thing that can be done then is to use 
\fBgit-annex recompute \-\-original \-\-unreproducible\fP.
.IP
.IP "\fB\-\-backend\fP"
Specifies which key\-value backend to use.
.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 "Also the git-annex\-common\-options(1) can be used."
.SH SEE ALSO
git-annex(1)
.PP
git-annex\-recompute(1)
.PP
git-annex\-findcomputed(1)
.PP
git-annex\-initremote(1)
.PP
.SH AUTHOR
Joey Hess <id@joeyh.name>
.PP
.PP