...
/approval [<id>] (request|cancel) [<text>]
Description
Create Requests maintainer approval request for fixes.
Only the author of the pull request is allowed to issue this command.
If the user requested approval, the 'text' will be posted to the related bug. The user will be able to update the 'text' by requesting the approval again.
Once maintainer processed the request(either approved or rejected), the user will not be able to update or cancel the request.
If there is only one issue associated with this pull request, the user will not need to specify the issue id. If there are more than one issues associated with this pull request, the user should request approval for each issue individuallya change.
The approval process actually takes place in JBS, this command is mostly for convenience. In a pull request for a repository that requires maintainer approval, the author may use this command to add both the comment with the motivation and the correct label to any associated bugs. This can be especially useful if the author does not have a JBS account. Skara also tracks the approval labels in the associated bugs and will block integration until all bugs are approved.
The 'id' argument is needed if there are multiple bugs associated with the pull request as separate requests need to be submitted for each bug.
The 'text' argument should contain the motivation for the change as defined. The pull request author may issue the command multiple times to update the text. Note that if the request is made through this command, the comment on the bug will be made by a bot user, so the text can only be modified by running this command again.
Canceling a request removes the label and the request comment from the bug.
Examples
/approval request My reason
/approval request My reason line1,
My reason line2,
My reason line3.
/approval cancel
/approval JDK-123 request My reason
/approval 123 request
/approval 123 cancel
...
/approve [<id>] (yes|no)
Description
Handle user's approval request for fixes.
Only maintainers of the repository are allowed to issue this command. Maintainers can not approve or reject the approval request if the request doesn't exist.
if the maintainer doesn't specify issue id in this command, then all the approval requests associated with this pull request will be Approves a request for maintainer approval by adding the appropriate labels to the associated bugs.
The /approve command is only available to repository maintainers. It can only approve existing requests.
If an 'id' is specified, then only that bug is handled, if not, all associated bugs are handled.
Examples
/approve yes
/approve no
/approve JDK-123 yes
/approve 123 no
...