Git and Gerrit FAQ
Here is a FAQ concerning how to use Git and Gerrit .
Git
editPulling
editShould I use git pull origin master
or git pull gerrit master
?
edit
Unless you're a git expert, they should be the same. The remote repository "gerrit" is the "origin" for the code of Wikimedia projects. Change directory to a repository and enter git remote -v to see what remotes uses.
As Gerrit/Tutorial#Configuring git-review says, you can put the following in ~/.config/git-review/git-review.conf
to ensure this:
[gerrit]
defaultremote = origin
It says "Please, commit your changes or stash them before you can merge." What do I do?
editTo discard your changes (and anything you had in the stash):
git stash git stash clear
Now you can proceed with your pull.
Committing
editWhat's the difference between git commit --amend
and git commit --amend -a
?
edit
The -a
option automatically stages all tracked, modified files before the commit, letting you skip the git add
step unless you need to start tracking new files.
A tracked file is a file that was in your last commit.
Submitting for review
editWhen should I use git review -R
rather than just git review
?
edit
You use git review -R
when you don't want your changes to be rebased, because you already used git pull --rebase origin master
.
To be more specific, when amending an existing change (adding changes to an existing patch set), you don't want to rebase against the master branch, as it causes the diffs to be cluttered.
Gerrit
editComments
editHow do I save inline code comments? I can only save them as drafts.
editYou have to click the "Up" button to go back to the change overview page. The inline comments will be attached to your "global" comment when you "reply" (save your comment).
Miscellaneous
editHow do I watch changes?
editHow do I link to Gerrit URLs from Wikimedia wikis using internal link syntax?
editTo link to revision 1234 use [[gerrit:1234|revision 1234]]: revision 1234.