Index: generic/include/proc/thread.h
===================================================================
--- generic/include/proc/thread.h	(revision e507afa088d8dc5b39f7813ae1e13adf07fa7645)
+++ generic/include/proc/thread.h	(revision b87f41860c88213bb9dc599f59adedde6615550b)
@@ -65,5 +65,10 @@
 	link_t threads_link;			/**< Link to the list of all threads. */
 	
-	/* items below are protected by lock */
+	/** Lock protecting thread structure.
+	 *
+	 * Protects the whole thread structure except list links above.
+	 * Must be acquired before T.lock for each T of type task_t.
+	 * 
+	 */
 	spinlock_t lock;
 
@@ -110,5 +115,12 @@
 };
 
-extern spinlock_t threads_lock;			/**< Lock protecting threads_head list. */
+/** Thread list lock.
+ *
+ * This lock protects all link_t structures chained in threads_head.
+ * Must be acquired before T.lock for each T of type thread_t.
+ *
+ */
+extern spinlock_t threads_lock;
+
 extern link_t threads_head;			/**< List of all threads in the system. */