Browse Source

Improves reference for CELERY_QUEUES. Closes #2231

Ask Solem 10 years ago
parent
commit
6c74fbff0a
1 changed files with 11 additions and 4 deletions
  1. 11 4
      docs/configuration.rst

+ 11 - 4
docs/configuration.rst

@@ -785,14 +785,21 @@ Message Routing
 CELERY_QUEUES
 ~~~~~~~~~~~~~
 
-The mapping of queues the worker consumes from.  This is a dictionary
-of queue name/options.  See :ref:`guide-routing` for more information.
+Most users will not want to specify this setting and should rather use
+the :ref:`automatic routing facilities <routing-automatic>`.
+
+If you really want to configure advanced routing, this setting should
+be a list of :class:`kombu.Queue` objects the worker will consume from.
+
+Note that workers can be overriden this setting via the `-Q` option,
+or individual queues from this list (by name) can be excluded using
+the `-X` option.
+
+Also see :ref:`routing-basics` for more information.
 
 The default is a queue/exchange/binding key of ``celery``, with
 exchange type ``direct``.
 
-You don't have to care about this unless you want custom routing facilities.
-
 .. setting:: CELERY_ROUTES
 
 CELERY_ROUTES