From 4aa661f418d3a469d1df0e47075e8eeb34d22441 Mon Sep 17 00:00:00 2001
From: Jeff Hill <johill@lanl.gov>
Date: Sat, 18 Nov 2006 00:16:33 +0000
Subject: [PATCH] added warning

---
 src/libCom/timer/epicsTimer.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/libCom/timer/epicsTimer.h b/src/libCom/timer/epicsTimer.h
index 7a4dbbe80..ff79e0b16 100644
--- a/src/libCom/timer/epicsTimer.h
+++ b/src/libCom/timer/epicsTimer.h
@@ -49,9 +49,13 @@ public:
 
 class epicsTimer {              /* X aCC 655 */
 public:
+    // calls cancel (see warning below) and then destroys the timer
     virtual void destroy () = 0;
     virtual void start ( epicsTimerNotify &, const epicsTime & ) = 0;
     virtual void start ( epicsTimerNotify &, double delaySeconds ) = 0;
+    // WARNING: A deadlock will occur if you hold a lock while
+    // calling this function that you also take within the timer 
+    // expiration callback.
     virtual void cancel () = 0;
     struct expireInfo {
         expireInfo ( bool active, const epicsTime & expireTime );