Doc improvements

docs/configuration.rst

@@ -66,11 +66,16 @@ CELERY_TIMEZONE
 ---------------
 
 Configure Celery to use a custom time zone.
-The timezone value can be any time zone supported by the :mod:`pytz`
+The timezone value can be any time zone supported by the `pytz`_
 library.
 
-If not set then the UTC timezone is used if :setting:`CELERY_ENABLE_UTC` is
-enabled, otherwise it falls back to the local timezone.
+If not set the UTC timezone is used.  For backwards compatibility
+there is also a :setting:`CELERY_ENABLE_UTC` setting, and this is set
+to false the system local timezone is used instead.
+
+.. _`pytz`: http://pypi.python.org/pypi/pytz/
+
+
 
 .. _conf-tasks:
 

docs/userguide/application.rst

@@ -178,6 +178,14 @@ The ``celeryconfig`` module may then look like this:
 Example 2: Using a configuration module
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. tip::
+
+    Using the name of a module is recomended
+    as this means that the module doesn't need to be serialized
+    when the multiprocessing pool is used.  If you're
+    experiencing configuration pickle errors then please try using
+    the name of a module instead.
+
 .. code-block:: python
 
     from celery import Celery

docs/userguide/periodic-tasks.rst

@@ -61,8 +61,6 @@ schedule manually.
         >>> from djcelery.models import PeriodicTask
         >>> PeriodicTask.objects.update(last_run_at=None)
 
-.. _`pytz`: http://pypi.python.org/pypi/pytz/
-
 .. _beat-entries:
 
 Entries