event void granted();
/**
- * Release a shared resource you previously acquired.
+ * Release a shared resource you previously acquired.
*
* @return SUCCESS The resource has been released <br>
* FAIL You tried to release but you are not the
* owner of the resource
+ *
+ * @note This command should never be called between putting in a request
+ * and waiting for a granted event. Doing so will result in a
+ * potential race condition. There are ways to guarantee that no
+ * race will occur, but they are clumsy and overly complicated.
+ * Since it doesn't logically make since to be calling
+ * <code>release</code> before receiving a <code>granted</code> event,
+ * we have opted to keep thing simple and warn you about the potential
+ * race.
*/
async command error_t release();