c16582058b
Recent releases of Gerrit have evolved their use of the "topic" functionality. Originally it was there merely for the convenince of users. It could be used to make a group of related or similar changes easy to query. In current releases of Gerrit, it serves a much more deliberate purpose: if submitWholeTopic is enabled, then merging one change in a topic will merge all of them simultaneously. Since this has very significant impacts to developer workflow, git-review should no longer set a topic unless it is explicitly requested by a user. This change alters the behavior of git-review so that it will no longer set a topic unless explicitly set by a user. It also deprecates the 'notopic' and '-T' options. They are retained for backwards compatability with existing scripts, but no longer have any effect. Change-Id: Ib83981a4952e1d6d68ebb8add11aabefbf3b2a4b
65 lines
1.4 KiB
ReStructuredText
65 lines
1.4 KiB
ReStructuredText
=======
|
|
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 awesome-feature
|
|
|
|
If you want to subscribe some reviewers::
|
|
|
|
git review --reviewers a@example.com b@example.com
|
|
|
|
If you want to submit a branch for review and then remove the local branch::
|
|
|
|
git review -f
|
|
|
|
If you want to be able to push a change which has a merge conflict with the
|
|
remote branch::
|
|
|
|
git review -R
|
|
|
|
If you want to download change 781 from gerrit to review it::
|
|
|
|
git review -d 781
|
|
|
|
If you want to download patchset 4 for change 781 from gerrit to review it::
|
|
|
|
git review -d 781,4
|
|
|
|
If you want to compare patchset 4 with patchset 10 of change 781 from gerrit::
|
|
|
|
git review -m 781,4-10
|
|
|
|
If you want to see a list of open reviews::
|
|
|
|
git review -l
|
|
|
|
If you just want to do the commit message and remote setup steps::
|
|
|
|
git review -s
|
|
|
|
|
|
.. note::
|
|
|
|
If using multiple SSH keys (identities) or SSH keys with passphrases, you
|
|
may wish to use a tool like `ssh-agent`__, `Gnome Seahorse`__ or `KDE
|
|
KWallet`__ to avoid manual SSH configuration or frequent passphrase
|
|
requests.
|
|
|
|
__ https://www.ssh.com/ssh/agent
|
|
__ https://wiki.gnome.org/Apps/Seahorse
|
|
__ https://userbase.kde.org/KDE_Wallet_Manager
|