Pulp

pulp/docs/dev-guide/newtypesupport/plugin/distributors.rst mentions publish_repo and cancel_publish_repo. It doesn't explain what cancel_publish_repo is supposed to do.

Could that please be documented? In particular, the points:

• is cancel_publish_repo supposed to raise an exception, or cause publish_repo to raise an exception/return a failure, or just return?
• is cancel_publish_repo expected to undo what's been done up to its cancellation?

The reason why I've raised this issue is that base class implementation pulp.server.pulp.plugins.distributor.Distributor#cancel_publish_repo raises an exception, while the distributors I've looked at which override cancel_publish_repo don't raise, and it's hard to say if one of these is a bug.