.TH git-annex-log 1
.SH NAME
git-annex-log \- shows location log information
.PP
.SH SYNOPSIS
git annex log \fB[path ...]\fP
.PP
.SH DESCRIPTION
This command displays information from the history of the git-annex branch. 
.PP
Several things can prevent that information being available to display.
When git-annex\-forget is used, old historical
data gets cleared from the branch. When annex.private or
remote.name.annex\-private is configured, git-annex does not write
information to the branch at all. And when annex.alwayscommit is set to
false, information may not have been committed to the branch yet.
.PP
.SH OPTIONS
.IP "\fB[path ...]\fP"
.IP
Displays the location log for the specified file or files, showing each
repository they were added to ("+") and removed from ("\-"). Note that
it displays information about the file content currently at these paths,
not for any different content that was there in earlier commits.
.IP
.IP "matching options"
The git-annex\-matching\-options(1)
can be used to control what to act on when displaying the location log
for specified files.
.IP
.IP "\fB\-\-all\fP \fB\-A\fP"
Shows location log changes to all content, with the most recent changes first.
In this mode, the names of files are not available and keys are displayed
instead.
.IP
.IP "\fB\-\-sizesof=repository\fP"
Displays a history of the total size of the annexed files in a repository
over time from the creation of the repository to the present.
.IP
The repository can be "here" for the current repository, or the name of a
remote, or a repository description or uuid.
.IP
Note that keys that do not have a known size are not included in the
total.
.IP
.IP "\fB\-\-sizes\fP"
This is like \-\-sizesof, but rather than display the size of a single
repository, it displays the sizes of all known repositories.
.IP
The output is a CSV formatted table.
.IP
.IP "\fB\-\-totalsizes\fP"
This is like \fB\-\-sizesof\fP, but it displays the total size of all
known repositories.
.IP
.IP "\fB\-\-interval=time\fP"
When using \fB\-\-sizesof\fP, \fB\-\-sizes\fP, and \fB\-\-totalsizes\fP, this 
controls the minimum interval between displays of the size.
The default is to display each new recorded size.
.IP
The time is of the form "30d" or "1y".
.IP
.IP "\fB\-\-received\fP"
Combine this option with \fB\-\-sizesof\fP or \fB\-\-sizes\fP to display
the amount of data received into repositories since the last
line was output.
.IP
.IP "\fB\-\-gnuplot\fP"
Combine this option with \fB\-\-sizesof\fP or \fB\-\-sizes\fP or \fB\-\-totalsizes\fP
to use gnuplot(1) to graph the data. The gnuplot file will be left on
disk for you to reuse.
.IP
For example, to graph the sizes of all repositories:
.IP
git-annex log \-\-sizes \-\-interval=1d \-\-gnuplot
.IP
To graph the amount of new data received into each repository every 30
days:
.IP
git-annex log \-\-sizes \-\-interval=30d \-\-gnuplot \-\-recieved
.IP
.IP "\fB\-\-bytes\fP"
Show sizes in bytes, disabling the default nicer units.
.IP
.IP "\fB\-\-raw\-date\fP"
Rather than the normal display of a date in the local time zone,
displays seconds since the unix epoch.
.IP
.IP "\fB\-\-since=date\fP, \fB\-\-after=date\fP, \fB\-\-until=date\fP, \fB\-\-before=date\fP, \fB\-\-max\-count=N\fP"
These options are passed through to \fBgit log\fP, and can be used to limit
how far back to search for location log changes.
.IP
For example: \fB\-\-since "1 month ago"\fP
.IP
These options do not have an affect when using \fB\-\-sizesof\fP, \fB\-\-sizes\fP, 
and \fB\-\-totalsizes\fP.
.IP
.IP "\fB\-\-gource\fP"
Generates output suitable for the \fBgource\fP visualization program.
.IP
This option does not have an affect when using \fB\-\-sizesof\fP, \fB\-\-sizes\fP, 
and \fB\-\-totalsizes\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
This option does not have an affect when using \fB\-\-sizesof\fP, \fB\-\-sizes\fP, 
and \fB\-\-totalsizes\fP.
.IP
.IP "\fB\-\-json\-error\-messages\fP"
Messages that would normally be output to standard error are included in
the JSON instead.
.IP
This option does not have an affect when using \fB\-\-sizesof\fP, \fB\-\-sizes\fP, 
and \fB\-\-totalsizes\fP.
.IP
.IP "Also the git-annex\-common\-options(1) can be used."
.SH SEE ALSO
git-annex(1)
.PP
git-annex\-forget(1)
.PP
.SH AUTHOR
Joey Hess <id@joeyh.name>
.PP
.PP