warning about interrupts in Error_raise
diff --git a/src/packages/xdc/runtime/Error.xdc b/src/packages/xdc/runtime/Error.xdc
index ef193a2..f6cd63c 100644
--- a/src/packages/xdc/runtime/Error.xdc
+++ b/src/packages/xdc/runtime/Error.xdc
@@ -702,6 +702,16 @@
* the `{@link #policyFxn}`. It processes the error and logs it before
* returning to the caller or aborting - depending on the error policy
* `{@link #policy}`.
+ *
+ * @a(Warning)
+ * If this function is used as `{@link #policyFxn}`, interrupts may get
+ * enabled when `{@link #raise Error_raise}` is called. For example, that
+ * could happen for the purpose of flushing a text buffer containing an
+ * error message to a console. To avoid re-enabling of interrupts within
+ * `Error_raise`, either `{@link #policyMin Error_policyMin}` or
+ * `{@link #policySpin Error_policySpin}` can be used as
+ * `{@link #policyFxn}` instead.
+
*/
/* REQ_TAG(SYSBIOS-853), REQ_TAG(SYSBIOS-865) */
Void policyDefault(Block *eb, Types.ModuleId mod, CString file, Int line,
