.\" Man page generated from reStructuredText.
.
.TH LEGIT: GIT FOR HUMANS  "" "" ""
.SH NAME
Legit: Git for Humans \- 
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" -*-restructuredtext-*-
.
.sp
Inspired by GitHub for Mac.
.SH THE CONCEPT
.sp
\fI\%GitHub for Mac\fP is not just a Git client.
.sp
This \fI\%comment\fP on Hacker News
says it best:
.INDENT 0.0
.INDENT 3.5
They haven\(aqt re\-created the git CLI tool in a GUI, they\(aqve created something different. They\(aqve created a tool that makes Git more accessible. Little things like auto\-stashing when you switch branches will confuse git veterans, but it will make Git much easier to grok for newcomers because of the assumptions it makes about your Git workflow.
.UNINDENT
.UNINDENT
.sp
Why not bring this innovation back to the command line?
.SH THE INTERFACE
.INDENT 0.0
.TP
.B \fBbranches\fP
Get a nice pretty list of available branches.
.TP
.B \fBsync [<branch>]\fP
Syncronizes the given branch. Defaults to current branch.
Stash, Fetch, Auto\-Merge/Rebase, Push, and Unstash.
You can only sync published branches.
.TP
.B \fBswitch <branch>\fP
Switches to specified branch.
Defaults to current branch.
Automatically stashes and unstashes any changes.
.TP
.B \fBsprout [<branch>] <new\-branch>\fP
Creates a new branch off of the specified branch.
Swiches to it immediately.
.TP
.B \fBharvest [<branch>] <new\-branch>\fP
Creates a new branch off of the specified branch.
Swiches to it immediately.
.TP
.B \fBgraft <branch> <into\-branch>\fP
Auto\-Merge/Rebase of specified branch into the second branch.
.TP
.B \fBpublish <branch>\fP
Publishes specified branch to the remote.
.TP
.B \fBunpublish <branch>\fP
Removes specified branch from the remote.
.TP
.B \fBinstall\fP
Installs legit git aliases.
.UNINDENT
.SH THE INSTALLATION
.sp
Installing Legit is easy with pip:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ pip install legit
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
You\(aqll then have the wonderful \fBlegit\fP command available. Run it within
a repository.
.sp
To install the git aliases, run the following command:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ legit install
.ft P
.fi
.UNINDENT
.UNINDENT
.SH CAVEATS
.INDENT 0.0
.IP \(bu 2
All remote operations are carried out by the first remote found.
.IP \(bu 2
If a \fBstash pop\fP merge fails, Legit stops. I\(aqd like to add checking for a merge failure, and undo the command with friendly error reporting.
.IP \(bu 2
Pip install is cumbersome to people unfamiliar with Python. Package. (Py2App + PyInstaller)
.UNINDENT
.\" Generated by docutils manpage writer.
.