Made two separate module references; One public API, and one internal, making the reference more accessible.

contrib/doc4allmods

@@ -2,7 +2,7 @@
 
 PACKAGE="$1"
 SKIP_PACKAGES="$PACKAGE tests management urls"
-SKIP_FILES="celery.bin.rst celery.serialization.rst"
+SKIP_FILES="celery.bin.rst celery.contrib.rst celery.serialization.rst"
 
 modules=$(find "$PACKAGE" -name "*.py")
 
@@ -19,11 +19,13 @@ for module in $modules; do
     for skip_file in $SKIP_FILES; do
         [ "$skip_file" == "$rst" ] && skip=1
     done
-    
+
     if [ $skip -eq 0 ]; then
         if [ ! -f "docs/reference/$rst" ]; then
-            echo $rst :: FAIL
-            failed=1
+            if [ ! -f "docs/internals/reference/$rst" ]; then
+                echo $rst :: FAIL
+                failed=1
+            fi
         fi
     fi
 done

docs/internals/index.rst

@@ -9,3 +9,4 @@
     :maxdepth: 2
 
     worker
+    reference/index

docs/internals/reference/index.rst

@@ -0,0 +1,33 @@
+===========================
+ Internal Module Reference
+===========================
+
+:Release: |version|
+:Date: |today|
+
+.. toctree::
+    :maxdepth: 2
+
+    celery.worker
+    celery.worker.job
+    celery.worker.controllers
+    celery.worker.buckets
+    celery.worker.scheduler
+    celery.worker.pool
+    celery.beat
+    celery.backends
+    celery.backends.base
+    celery.backends.amqp
+    celery.backends.database
+    celery.backends.cache
+    celery.backends.mongodb
+    celery.backends.redis
+    celery.backends.tyrant
+    celery.datastructures
+    celery.log
+    celery.utils
+    celery.discovery
+    celery.utils.functional
+    celery.platform
+    celery.managers
+    celery.models

docs/reference/index.rst

@@ -1,6 +1,6 @@
-===========================
- Module API Reference
-===========================
+===============
+ API Reference
+===============
 
 :Release: |version|
 :Date: |today|
@@ -24,32 +24,10 @@
     celery.loaders.default
     celery.loaders.djangoapp
     celery.registry
-    celery.discovery
     celery.monitoring
     celery.messaging
     celery.contrib.test_runner
-    celery.worker
-    celery.worker.job
-    celery.worker.controllers
-    celery.worker.buckets
-    celery.worker.scheduler
-    celery.worker.pool
-    celery.beat
-    celery.backends
-    celery.backends.base
-    celery.backends.amqp
-    celery.backends.database
-    celery.backends.cache
-    celery.backends.mongodb
-    celery.backends.redis
-    celery.backends.tyrant
-    celery.datastructures
-    celery.log
-    celery.utils
     celery.views
-    celery.managers
-    celery.models
-    celery.platform
     celery.bin.celeryd
     celery.bin.celerybeat
     celery.bin.celeryinit