summaryrefslogtreecommitdiff
path: root/skins.h
diff options
context:
space:
mode:
Diffstat (limited to 'skins.h')
-rw-r--r--skins.h10
1 files changed, 6 insertions, 4 deletions
diff --git a/skins.h b/skins.h
index f994d47d..d2eae368 100644
--- a/skins.h
+++ b/skins.h
@@ -4,7 +4,7 @@
* See the main source file 'vdr.c' for copyright information and
* how to reach the author.
*
- * $Id: skins.h 4.2 2017/06/21 09:40:39 kls Exp $
+ * $Id: skins.h 4.3 2017/06/23 09:08:40 kls Exp $
*/
#ifndef __SKINS_H
@@ -23,9 +23,11 @@
// Several member functions of the following classes are called with a pointer to
// an object from a global list (cTimer, cChannel, cRecording or cEvent). In these
-// cases the core VDR code holds a lock on the respective list. The called function
-// may itself set a read lock (not a write lock!) on this list, because read locks
-// can be nested. It may also set read locks (not write locks!) on higher order lists.
+// cases the core VDR code holds a lock on the respective list. While in general a
+// plugin should only work with the objects and data that is explicitly given to it
+// in the function call, the called function may itself set a read lock (not a write
+// lock!) on this list, because read locks can be nested. It may also set read locks
+// (not write locks!) on higher order lists.
// For instance, a function that is called with a cChannel may lock cRecordings and/or
// cSchedules (which contains cEvent objects), but not cTimers. If a plugin needs to
// set locks of its own (on mutexes defined inside the plugin code), it shall do so