gerrit/Documentation/error-prohibited-by-gerrit.txt
Edwin Kempin 6ae9b21932 Fix message if pushing tag is rejected because tagger is somebody else
Pushing a tag that has somebody else as tagger requires the 'Forge
Committer' access right. If this access right is missing Gerrit
currently rejects the push with "can not create new references". This
error message is misleading because the user may think that the 'Create
Reference' access right is missing which is actually assigned.

The same reject message is also returned on push of an annotated tag
if the 'Push Annotated Tag' access right is missing. Also in this case
the error message is not ideal.

Go back to the old more generic message which says 'prohibited by
Gerrit'. This error message is at least explained in the Gerrit
documentation so that the user can find out the reason. The new error
message is not documented.

Describe the missing case in the 'prohibited by Gerrit' error
documentation if pushing a tag fails because the tagger is somebody
else and the 'Forge Committer' access right is not assigned.

Change-Id: Ib2e20bbc5f1c7d47e93fc0b2c5fecfa86908419e
Signed-off-by: Edwin Kempin <edwin.kempin@sap.com>
2012-09-17 08:59:10 +02:00

38 lines
1.6 KiB
Plaintext

prohibited by Gerrit
====================
This is a general error message that is returned by Gerrit if a push
is not allowed, e.g. because the pushing user has no sufficient
privileges.
In particular this error occurs:
1. if you push a commit for code review to a branch for which you
don't have upload permissions (access right
link:access-control.html#category_push_review['Push'] on
`refs/for/refs/heads/*`)
2. if you bypass code review without
link:access-control.html#category_push_direct['Push'] access right
on `refs/heads/*`
3. if you push an annotated tag without
link:access-control.html#category_push_annotated['Push Annotated Tag']
access right on 'refs/tags/*'
4. if you push a lightweight tag without the access right link:access-control.html#category_create['Create
Reference'] for the reference name 'refs/tags/*'
5. if you push a tag with somebody else as tagger and you don't have the
link:access-control.html#category_forge_committer['Forge Committer']
access right for the reference name 'refs/tags/*'
For new users it often happens that they accidentally try to bypass
code review. The push then fails with the error message 'prohibited
by Gerrit' because the project didn't allow to bypass code review.
Bypassing the code review is done by pushing directly to refs/heads/*
(e.g. refs/heads/master) instead of pushing to refs/for/* (e.g.
refs/for/master). Details about how to push commits for code review
are explained link:user-upload.html#push_create[here].
GERRIT
------
Part of link:error-messages.html[Gerrit Error Messages]