Added explanation for "branch not found" error

Added a documentation page that explains the
"branch ... not found" error in details and what
can be done to solve the problem.

Signed-off-by: Edwin Kempin <edwin.kempin@gmail.com>
Change-Id: I74a0c4e00b6153e1f2ab60aec2737333d83f4440
This commit is contained in:
Edwin Kempin 2011-01-10 13:12:53 +01:00
parent 26b9e72bbd
commit 0fde32f3d8
2 changed files with 32 additions and 0 deletions

View File

@ -0,0 +1,31 @@
branch ... not found
====================
With this error message Gerrit rejects to push a commit for code
review if the specified target branch does not exist.
To push a change for code review the commit has to be pushed to the
project's magical `refs/for/'branch'` ref (for details have a look at
link:user-upload.html#push_create[Create Changes]).
If you specify a non existing branch in the `refs/for/'branch'` ref
the push is failing with the error message 'branch ... not found'.
To fix this problem verify
* that the branch name in the push specification is typed correctly
(case sensitive) and
* that the branch really exists for this project (in the Gerrit WebUI
go to 'Admin' -> 'Projects' and browse your project, then click on
'Branches' to see all existing branches).
If it was your intention to create a new branch you can either
* bypass code review on push as explained link:user-upload.html#bypass_review[here] or
* create the new branch in the Gerrit WebUI before pushing (go to
'Admin' -> 'Projects' and browse your project, in the 'Branches'
tab you can then create a new branch).
Please note that you need the access right '+2 Create Branch' in the
link:access-control.html#category_pHD['Push Branch'] category to create new branches.
GERRIT
------
Part of link:error-messages.html[Gerrit Error Messages]

View File

@ -9,6 +9,7 @@ occurring and what can be done to solve it.
Error Messages
--------------
* link:error-branch-not-found.html[branch ... not found]
* link:error-change-closed.html[change ... closed]
* link:error-invalid-changeid.html[invalid Change-Id line format in commit message]
* link:error-missing-changeid.html[missing Change-Id in commit message]