workqueue: Fix manage_workers() RETURNS description

[~andy/linux] / kernel / workqueue.c

diff --git a/kernel/workqueue.c b/kernel/workqueue.c
index eebd9a66c04462b9e5ccffe741ee7755d6365d79..10f655ec8de6ebd5d222043a5414c1bc95518d32 100644 (file)
--- a/kernel/workqueue.c
+++ b/kernel/workqueue.c
@@ -2034,8 +2034,11 @@ static bool maybe_destroy_workers(struct worker_pool *pool)
  * multiple times.  Does GFP_KERNEL allocations.
  *
  * RETURNS:
- * spin_lock_irq(pool->lock) which may be released and regrabbed
- * multiple times.  Does GFP_KERNEL allocations.
+ * %false if the pool don't need management and the caller can safely start
+ * processing works, %true indicates that the function released pool->lock
+ * and reacquired it to perform some management function and that the
+ * conditions that the caller verified while holding the lock before
+ * calling the function might no longer be true.
  */
 static bool manage_workers(struct worker *worker)
 {