Tool for rebasing change series
Go to file
Monty Taylor 1b20aa2df3 Replace sphinx manpage with manual one.
If we upload source tarballs to PyPI instead of eggs, then the man
pages actually work. However, this means that the installer has to
run setup.py. Using sphinx, while slighly nicer from a dev
perspective, means we have to then require that people installing
git-review also install sphinx, which is a bit overkill given the
size of the man page.

This change, and a change to the release process of not uploading
eggs to PyPI should finall get git review --help to work.

Change-Id: I29b07667127a9ec5c241b7e1fc5a3960dd2a6b63
2011-10-29 22:24:53 -04:00
.gitignore Fix manpage installation for setup.py install. 2011-10-05 15:50:36 -04:00
.gitreview Check .gitreview file in repo for location of gerrit. 2011-10-14 13:24:53 -04:00
AUTHORS Bug fixes relating to first-time runs. 2011-09-28 10:17:43 -07:00
LICENSE Ported rfc.sh to a standalone program. 2011-09-25 09:16:31 -07:00
MANIFEST.in Fix manpage installation for setup.py install. 2011-10-05 15:50:36 -04:00
README.md Clean up documentation; add --version. 2011-10-27 16:28:46 -04:00
git-review Bump version after release. 2011-10-27 16:45:16 -04:00
git-review.1 Replace sphinx manpage with manual one. 2011-10-29 22:24:53 -04:00
setup.py Replace sphinx manpage with manual one. 2011-10-29 22:24:53 -04:00

README.md

git-review

A git command for submitting branches to Gerrit

git-review is a tool that helps submitting git branches to gerrit for review.

Setup

git-review, by default, looks for a git remote called gerrit, and submits the current branch to HEAD:refs/for/master at that remote.

If the "gerrit" remote does not exist, git-review looks for a file called .gitreview at the root of the repository with information about the gerrit remote. Assuming that file is present, git-review should be able to automatically configure your repository the first time it is run.

Usage

Hack on some code, then:

git review

If you want to submit that code to a branch other than "master", then:

git review branchname

If you want to submit to a different remote:

git review -r my-remote

If you want to supply a review topic:

git review -t topic/awesome-feature

If you want to skip the automatic "git rebase -i" step:

git review -R

If you want to download change 781 from gerrit to review it:

git review -d 781

Contributing

To get the latest code or for information about contributing, visit the project homepage at:

https://launchpad.net/git-review