diff --git a/libraries/fabric-shim/lib/stub.js b/libraries/fabric-shim/lib/stub.js
index bcc514b3..38eb7ae5 100644
--- a/libraries/fabric-shim/lib/stub.js
+++ b/libraries/fabric-shim/lib/stub.js
@@ -763,6 +763,7 @@ class ChaincodeStub {
      * Only a single chaincode event can be included in a transaction.
      * If setEvent() is called multiple times only the last event will be included in the transaction.
      * The event must originate from the outer-most invoked chaincode in chaincode-to-chaincode scenarios.
+     * If Chaincode A invokes Chaincode B, and Chaincode B calls setEvent, that event will be ignored by the peer.
      * The marshaled ChaincodeEvent will be available in the transaction's ChaincodeAction.events field.
      * @param {string} name Name of the event
      * @param {byte[]} payload A payload can be used to include data about the event