opendev/git-review
Code Issues Proposed changes
git-review/doc/source/usage.rst
James E. Blair c16582058b Stop setting a default topic on new changes 
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
2024-06-13 11:44:31 -07:00

1.4 KiB
Raw Blame History

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