[master] 764f988 sync comment with reality

[Nils Goroll]

commit 764f9887da9e607f1e969840090af2bd0c31119c
Author: Nils Goroll <nils.goroll at uplex.de>
Date:   Wed Oct 26 16:36:23 2016 +0200

    sync comment with reality

diff --git a/bin/varnishd/cache/cache_wrk.c b/bin/varnishd/cache/cache_wrk.c
index 7176f09..2421b44 100644
--- a/bin/varnishd/cache/cache_wrk.c
+++ b/bin/varnishd/cache/cache_wrk.c
@@ -416,13 +416,13 @@ pool_breed(struct pool *qp)
 /*--------------------------------------------------------------------
  * Herd a single pool
  *
- * This thread wakes up whenever a pool queues.
+ * This thread wakes every 5 seconds and whenever a pool queues.
  *
- * The trick here is to not be too aggressive about creating threads.
- * We do this by only examining one pool at a time, and by sleeping
- * a short while whenever we create a thread and a little while longer
- * whenever we fail to, hopefully missing a lot of cond_signals in
- * the meantime.
+ * The trick here is to not be too aggressive about creating threads.  In
+ * pool_breed(), we sleep whenever we create a thread and a little while longer
+ * whenever we fail to, hopefully missing a lot of cond_signals in the meantime.
+ *
+ * Idle threads are destroyed at a rate termined by wthread_destroy_delay
  *
  * XXX: probably need a lot more work.
  *