.\" Man page generated from reStructuredText.
.
.
.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
..
.TH "LEGIT: GIT FOR HUMANS"  "" "" ""
.SH NAME
Legit: Git for Humans \- 
.\" -*-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 \fBswitch <branch>\fP
Switches to specified branch.
Defaults to current branch.
Automatically stashes and unstashes any changes. (alias: \fBsw\fP)
.TP
.B \fBsync [<branch>]\fP
Synchronizes the given branch. Defaults to current branch.
Stash, Fetch, Auto\-Merge/Rebase, Push, and Unstash.
You can only sync published branches. (alias: \fBsy\fP)
.TP
.B \fBpublish [<branch>]\fP
Publishes specified branch to the remote. (alias: \fBpub\fP)
.TP
.B \fBunpublish <branch>\fP
Removes specified branch from the remote. (alias: \fBunp\fP)
.TP
.B \fBundo\fP
Un\-does the last commit in git history.  (alias: \fBun\fP)
.TP
.B \fBbranches [<wildcard pattern>]\fP
Display a list of available branches.
Allows wildcard pattern matching of branch name.
.UNINDENT
.SH THE INSTALLATION
\fI\%[image: https://img.shields.io/pypi/v/legit.svg]
\fP\fI\%[image: https://img.shields.io/travis/frostming/legit/master.svg]
\fP\fI\%[image: https://img.shields.io/coveralls/github/frostming/legit.svg]
\fP\fI\%[image: https://repl.it/badge/github/frostming/legit]
\fP
.sp
From \fI\%PyPI\fP with the Python package manager:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
pip install legit
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Or download a standalone Windows executable from \fI\%GitHub Releases\fP\&.
.sp
To install the cutting edge version from the git repository:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
git clone https://github.com/frostming/legit.git
cd legit
python setup.py install
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Note: if you encountered \fIPermission denied\fP,
prepend \fIsudo\fP before the \fIpip\fP or \fIpython setup.py\fP command.
.sp
You\(aqll then have the wonderful \fBlegit\fP command available. Run it within
a repository.
.sp
To view usage and examples, run \fBlegit\fP with no commands or options:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
legit
.ft P
.fi
.UNINDENT
.UNINDENT
.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
.sp
To uninstall the git aliases, run the following command:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
legit \-\-uninstall
.ft P
.fi
.UNINDENT
.UNINDENT
.SH COMMAND OPTIONS
.sp
All legit commands support \fB\-\-verbose\fP and \fB\-\-fake\fP options.
.sp
In order to view the git commands invoked by legit, use the \fB\-\-verbose\fP option:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
legit sync \-\-verbose
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
If you want to see the git commands used by legit but don\(aqt want them invoked, use the \fB\-\-fake\fP option:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
legit publish \-\-fake
.ft P
.fi
.UNINDENT
.UNINDENT
.SH CAVEATS
.INDENT 0.0
.IP \(bu 2
All remote operations are carried out by the remote identified in \fB$ git config legit.remote remotename\fP
.IP \(bu 2
If a \fBstash pop\fP merge fails, Legit stops. I\(aqd like to add checking for a failed merge, and undo the command with friendly error reporting.
.UNINDENT
.\" Generated by docutils manpage writer.
.