.\" Manpage for git-box.
.\" Contact jason.g.ozias@gmail.com to correct errors or typos.
.TH GIT-BOX 1 "02/15/2016" "0.1.2" "Git Manual"
.SH NAME
git-box \- manage binary off-repository external storage
.SH SYNOPSIS
\fBgit-box config \fR[\fB\-gv\fR] [\fB\-\-unset\fR]
.br
\fBgit-box config file \fR[\fB\-gv\fR] \fIfilepath
.br
\fBgit-box config file \fR[\fB\-gv\fR] \fB\-\-unset
.br
\fBgit-box config mysql \fR[\fB\-gv\fR] \fIuser pass db table \fR[\fItcpaddr tcpport\fR]
.br
\fBgit-box config mysql \fR[\fB\-gv\fR] \fB\-\-unset
.br
\fBgit-box config postgres \fR[\fB\-gvs\fR]\fB \fIuser \fR[\fIppass phost pport pdb ptable\fR]
.br
\fBgit-box config postgres \fR[\fB\-gv\fR] \fB\-\-unset
.br
\fBgit-box config sqlite \fR[\fB\-gv\fR] \fIpath table
.br
\fBgit-box config sqlite \fR[\fB\-gv\fR] \fB\-\-unset
.br
\fBgit-box config ssh \fR[\fB\-gv\fR] \fIuser host sshpath
.br
\fBgit-box config ssh \fR[\fB\-gv\fR] \fB\-\-unset
.br
\fBgit-box track \fR[\fB\-v\fR] \fIpattern
.br
\fBgit-box untrack \fR[\fB\-v\fR] \fIpattern
.br
\fBgit-box \fB\-V\fR [\fB\-v\fR]
.br
\fBgit box \fB-h\fR
.SH DESCRIPTION
Configures binary off-repository external storage.
Enabling this type of storage will allow you to store a reference in the git repository that identifies the binary file in the off-repository storage.
.PP
There are three basic operations to use when configuring git-box on a repository.
.IP 1.
Configure the clean/smudge filters for your repository (or globally) with \fBgit box config\fR.
.IP 2.
Configure the storage type for your repository (or globally) with \fBgit box config X [options]\fR where X is the storage type you are wanting to use.
.IP 3.
Setup the files you would like to track and store externally with \fBgit box track \fIpattern\fR, where the pattern adheres to the rules defined in \fBgitignore(5)\fR.
Note that this step will create a \fI.gitattributes\fR file in your repository that should be tracked.
.SH OPTIONS
.TP
\-g, \-\-global
When configuring git-box, specifying this flag will apply the changes to the global (as determined by libgit2) configuration file.
.TP
\-h, \-\-help
Show git-box help.
.TP
\-s, \-\-ssl
Enable SSL for git-box storage that supports it.
.TP
\-\-unset
Remove the specified configurations from the appropriate git configuration file.
.TP
\-v, \-\-verbose
Enable verbose output
.TP
\-V, \-\-version
Show git-box version information.
.SH SEE ALSO
git-config(1), gitignore(5), gitattributes(5)
.SH BUGS
No known bugs.
.SH AUTHOR
Jason Ozias (jason.g.ozias@gmail.com)