Use Google-style docstrings

60 files changed, 138 insertions, 42 deletions

diff --git a/docs/reference/index.rst b/docs/reference/index.rst
index 85b07bc7..6c3285ca 100644
--- a/docs/reference/index.rst
+++ b/docs/reference/index.rst
@@ -45,6 +45,7 @@
     kombu.transport.memory
     kombu.transport.redis
     kombu.transport.mongodb
+    kombu.transport.consul
     kombu.transport.zookeeper
     kombu.transport.filesystem
     kombu.transport.SQS
diff --git a/docs/reference/kombu.abstract.rst b/docs/reference/kombu.abstract.rst
index 0669a5a8..436bc535 100644
--- a/docs/reference/kombu.abstract.rst
+++ b/docs/reference/kombu.abstract.rst
@@ -1,3 +1,7 @@
+=======================================
+ Abstract Classes - ``kombu.abstract``
+=======================================
+
 .. currentmodule:: kombu.abstract
 
 .. automodule:: kombu.abstract
diff --git a/docs/reference/kombu.async.aws.connection.rst b/docs/reference/kombu.async.aws.connection.rst
index 5ce41972..70cf588a 100644
--- a/docs/reference/kombu.async.aws.connection.rst
+++ b/docs/reference/kombu.async.aws.connection.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Amazon AWS Connection - kombu.async.aws.connection
+ Amazon AWS Connection - ``kombu.async.aws.connection``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.aws.rst b/docs/reference/kombu.async.aws.rst
index db5836c2..62c7438c 100644
--- a/docs/reference/kombu.async.aws.rst
+++ b/docs/reference/kombu.async.aws.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Async Amazon AWS Client - kombu.async.aws
+ Async Amazon AWS Client - ``kombu.async.aws``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.aws.sqs.connection.rst b/docs/reference/kombu.async.aws.sqs.connection.rst
index ae8e9dcb..90eeae4f 100644
--- a/docs/reference/kombu.async.aws.sqs.connection.rst
+++ b/docs/reference/kombu.async.aws.sqs.connection.rst
@@ -1,5 +1,5 @@
 ==========================================================
- SQS Connection - kombu.async.aws.sqs.connection
+ SQS Connection - ``kombu.async.aws.sqs.connection``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.aws.sqs.message.rst b/docs/reference/kombu.async.aws.sqs.message.rst
index 6c4f84ef..980cecfe 100644
--- a/docs/reference/kombu.async.aws.sqs.message.rst
+++ b/docs/reference/kombu.async.aws.sqs.message.rst
@@ -1,5 +1,5 @@
 ==========================================================
- SQS Messages - kombu.async.aws.sqs.message
+ SQS Messages - ``kombu.async.aws.sqs.message``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.aws.sqs.queue.rst b/docs/reference/kombu.async.aws.sqs.queue.rst
index 64a42c6d..bd338c19 100644
--- a/docs/reference/kombu.async.aws.sqs.queue.rst
+++ b/docs/reference/kombu.async.aws.sqs.queue.rst
@@ -1,5 +1,5 @@
 ==========================================================
- SQS Queues - kombu.async.aws.sqs.queue
+ SQS Queues - ``kombu.async.aws.sqs.queue``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.aws.sqs.rst b/docs/reference/kombu.async.aws.sqs.rst
index 2d70c517..1ab25d41 100644
--- a/docs/reference/kombu.async.aws.sqs.rst
+++ b/docs/reference/kombu.async.aws.sqs.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Async Amazon SQS Client - kombu.async.aws.sqs
+ Async Amazon SQS Client - ``kombu.async.aws.sqs``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.debug.rst b/docs/reference/kombu.async.debug.rst
index 508333ac..ab67c594 100644
--- a/docs/reference/kombu.async.debug.rst
+++ b/docs/reference/kombu.async.debug.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Debugging Utils - kombu.async.debug
+ Event Loop Debugging Utils - ``kombu.async.debug``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.http.base.rst b/docs/reference/kombu.async.http.base.rst
index c891329d..37dddb0d 100644
--- a/docs/reference/kombu.async.http.base.rst
+++ b/docs/reference/kombu.async.http.base.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Async HTTP Client Interface - kombu.async.http.base
+ Async HTTP Client Interface - ``kombu.async.http.base``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.http.curl.rst b/docs/reference/kombu.async.http.curl.rst
index fcb11529..dc4ebec2 100644
--- a/docs/reference/kombu.async.http.curl.rst
+++ b/docs/reference/kombu.async.http.curl.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Async pyCurl HTTP Client - kombu.async.http.curl
+ Async pyCurl HTTP Client - ``kombu.async.http.curl``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.http.rst b/docs/reference/kombu.async.http.rst
index 505e68c9..40235631 100644
--- a/docs/reference/kombu.async.http.rst
+++ b/docs/reference/kombu.async.http.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Async HTTP Client - kombu.async.http
+ Async HTTP Client - ``kombu.async.http``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.hub.rst b/docs/reference/kombu.async.hub.rst
index a1ee144d..1007c79a 100644
--- a/docs/reference/kombu.async.hub.rst
+++ b/docs/reference/kombu.async.hub.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Event Loop Implementation - kombu.async.hub
+ Event Loop Implementation - ``kombu.async.hub``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.rst b/docs/reference/kombu.async.rst
index 3f575f0d..651f67d8 100644
--- a/docs/reference/kombu.async.rst
+++ b/docs/reference/kombu.async.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Event Loop - kombu.async
+ Event Loop - ``kombu.async``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.semaphore.rst b/docs/reference/kombu.async.semaphore.rst
index 6143623a..b3ac5e0d 100644
--- a/docs/reference/kombu.async.semaphore.rst
+++ b/docs/reference/kombu.async.semaphore.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Semaphores - kombu.async.semaphore
+ Semaphores - ``kombu.async.semaphore``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.async.timer.rst b/docs/reference/kombu.async.timer.rst
index 5edeca59..3cc47b5d 100644
--- a/docs/reference/kombu.async.timer.rst
+++ b/docs/reference/kombu.async.timer.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Timer - kombu.async.timer
+ Timer - ``kombu.async.timer``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.clocks.rst b/docs/reference/kombu.clocks.rst
index 9f49cff3..08e524c2 100644
--- a/docs/reference/kombu.clocks.rst
+++ b/docs/reference/kombu.clocks.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Clocks and Synchronization - kombu.clocks
+ Logical Clocks and Synchronization - ``kombu.clocks``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.common.rst b/docs/reference/kombu.common.rst
index 01eee9b2..bd560a9d 100644
--- a/docs/reference/kombu.common.rst
+++ b/docs/reference/kombu.common.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Common Utilities - kombu.common
+ Common Utilities - ``kombu.common``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.compat.rst b/docs/reference/kombu.compat.rst
index 3201a844..b8caaec8 100644
--- a/docs/reference/kombu.compat.rst
+++ b/docs/reference/kombu.compat.rst
@@ -1,3 +1,7 @@
+==========================================
+  Carrot Compatibility - ``kombu.compat``
+==========================================
+
 .. currentmodule:: kombu.compat
 
 .. automodule:: kombu.compat
diff --git a/docs/reference/kombu.compression.rst b/docs/reference/kombu.compression.rst
index c7748577..cff4dfe4 100644
--- a/docs/reference/kombu.compression.rst
+++ b/docs/reference/kombu.compression.rst
@@ -1,3 +1,7 @@
+=============================================
+ Message Compression - ``kombu.compression``
+=============================================
+
 .. currentmodule:: kombu.compression
 
 .. automodule:: kombu.compression
diff --git a/docs/reference/kombu.connection.rst b/docs/reference/kombu.connection.rst
index 63870dd4..d1399a7e 100644
--- a/docs/reference/kombu.connection.rst
+++ b/docs/reference/kombu.connection.rst
@@ -1,4 +1,6 @@
-
+=======================================
+  Connection - ``kombu.connection``
+=======================================
 
 .. currentmodule:: kombu.connection
 
diff --git a/docs/reference/kombu.exceptions.rst b/docs/reference/kombu.exceptions.rst
index 5a11bf92..4b042518 100644
--- a/docs/reference/kombu.exceptions.rst
+++ b/docs/reference/kombu.exceptions.rst
@@ -1,3 +1,7 @@
+=====================================
+ Exceptions - ``kombu.exceptions``
+=====================================
+
 .. currentmodule:: kombu.exceptions
 
 .. automodule:: kombu.exceptions
diff --git a/docs/reference/kombu.five.rst b/docs/reference/kombu.five.rst
index 51898e63..36993c10 100644
--- a/docs/reference/kombu.five.rst
+++ b/docs/reference/kombu.five.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Python 2 to Python 3 utilities - kombu.five
+ Python 2 to Python 3 utilities - ``kombu.five``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.log.rst b/docs/reference/kombu.log.rst
index 39863762..598365b3 100644
--- a/docs/reference/kombu.log.rst
+++ b/docs/reference/kombu.log.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Logging - kombu.log
+ Logging - ``kombu.log``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.message.rst b/docs/reference/kombu.message.rst
index b644ec01..0955368e 100644
--- a/docs/reference/kombu.message.rst
+++ b/docs/reference/kombu.message.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Message Objects - kombu.message
+ Message Objects - ``kombu.message``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.mixins.rst b/docs/reference/kombu.mixins.rst
index 7a87ac27..1d00f34a 100644
--- a/docs/reference/kombu.mixins.rst
+++ b/docs/reference/kombu.mixins.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Mixin Classes - kombu.mixins
+ Mixin Classes - ``kombu.mixins``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.pidbox.rst b/docs/reference/kombu.pidbox.rst
index a0a24a2d..e6467613 100644
--- a/docs/reference/kombu.pidbox.rst
+++ b/docs/reference/kombu.pidbox.rst
@@ -1,3 +1,8 @@
+=========================================
+ Pidbox - ``kombu.pidbox``
+=========================================
+
+
 .. currentmodule:: kombu.pidbox
 
 .. automodule:: kombu.pidbox
diff --git a/docs/reference/kombu.pools.rst b/docs/reference/kombu.pools.rst
index b1c210fd..4ffcd03b 100644
--- a/docs/reference/kombu.pools.rst
+++ b/docs/reference/kombu.pools.rst
@@ -1,5 +1,5 @@
 ==========================================================
- General Pools - kombu.pools
+ Connection/Producer Pools - ``kombu.pools``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.resource.rst b/docs/reference/kombu.resource.rst
index 40d22a76..2135ce66 100644
--- a/docs/reference/kombu.resource.rst
+++ b/docs/reference/kombu.resource.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Resource Management - kombu.resource
+ Resource Management - ``kombu.resource``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.rst b/docs/reference/kombu.rst
index 6205f84b..6afa213c 100644
--- a/docs/reference/kombu.rst
+++ b/docs/reference/kombu.rst
@@ -1,3 +1,7 @@
+===================================
+ Kombu - ``kombu``
+===================================
+
 .. currentmodule:: kombu
 
 .. contents::
diff --git a/docs/reference/kombu.serialization.rst b/docs/reference/kombu.serialization.rst
index 7ed56ff9..66ca178d 100644
--- a/docs/reference/kombu.serialization.rst
+++ b/docs/reference/kombu.serialization.rst
@@ -1,3 +1,7 @@
+========================================
+ Message Serialization - ``kombu``
+========================================
+
 .. currentmodule:: kombu.serialization
 
 .. automodule:: kombu.serialization
diff --git a/docs/reference/kombu.simple.rst b/docs/reference/kombu.simple.rst
index abba2374..ddd198c2 100644
--- a/docs/reference/kombu.simple.rst
+++ b/docs/reference/kombu.simple.rst
@@ -1,3 +1,7 @@
+===============================================
+ Simple Messaging API - ``kombu.simple``
+===============================================
+
 .. currentmodule:: kombu.simple
 
 .. automodule:: kombu.simple
diff --git a/docs/reference/kombu.syn.rst b/docs/reference/kombu.syn.rst
index f5c650be..f5043b68 100644
--- a/docs/reference/kombu.syn.rst
+++ b/docs/reference/kombu.syn.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Async Utilities - kombu.syn
+ Eventlet/Gevent Detection - ``kombu.syn``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.transport.SLMQ.rst b/docs/reference/kombu.transport.SLMQ.rst
index b8c7a83f..95c57d7f 100644
--- a/docs/reference/kombu.transport.SLMQ.rst
+++ b/docs/reference/kombu.transport.SLMQ.rst
@@ -1,6 +1,6 @@
-======================================
-kombu.transport.SLMQ
-======================================
+=============================================
+ SLMQ Transport - ``kombu.transport.SLMQ``
+=============================================
 
 .. currentmodule:: kombu.transport.SLMQ
 
diff --git a/docs/reference/kombu.transport.SQS.rst b/docs/reference/kombu.transport.SQS.rst
index 97a5df6b..f9abcfae 100644
--- a/docs/reference/kombu.transport.SQS.rst
+++ b/docs/reference/kombu.transport.SQS.rst
@@ -1,3 +1,7 @@
+================================================
+ Amazon SQS Transport - ``kombu.transport.SQS``
+================================================
+
 .. currentmodule:: kombu.transport.SQS
 
 .. automodule:: kombu.transport.SQS
diff --git a/docs/reference/kombu.transport.base.rst b/docs/reference/kombu.transport.base.rst
index c9d77df8..1ff3d9c6 100644
--- a/docs/reference/kombu.transport.base.rst
+++ b/docs/reference/kombu.transport.base.rst
@@ -1,3 +1,7 @@
+==================================================
+ Transport Base Class - ``kombu.transport.base``
+==================================================
+
 .. currentmodule:: kombu.transport.base
 
 .. automodule:: kombu.transport.base
diff --git a/docs/reference/kombu.transport.consul.rst b/docs/reference/kombu.transport.consul.rst
index 5e429617..cbfe4cad 100644
--- a/docs/reference/kombu.transport.consul.rst
+++ b/docs/reference/kombu.transport.consul.rst
@@ -1,3 +1,7 @@
+================================================
+ Consul Transport - ``kombu.transport.consul``
+================================================
+
 .. currentmodule:: kombu.transport.consul
 
 .. automodule:: kombu.transport.consul
diff --git a/docs/reference/kombu.transport.filesystem.rst b/docs/reference/kombu.transport.filesystem.rst
index d059edb0..114f2a92 100644
--- a/docs/reference/kombu.transport.filesystem.rst
+++ b/docs/reference/kombu.transport.filesystem.rst
@@ -1,3 +1,7 @@
+========================================================
+ File-system Transport - ``kombu.transport.filesystem``
+========================================================
+
 .. currentmodule:: kombu.transport.filesystem
 
 .. automodule:: kombu.transport.filesystem
diff --git a/docs/reference/kombu.transport.librabbitmq.rst b/docs/reference/kombu.transport.librabbitmq.rst
index cc694d7b..9d64d8a9 100644
--- a/docs/reference/kombu.transport.librabbitmq.rst
+++ b/docs/reference/kombu.transport.librabbitmq.rst
@@ -1,3 +1,7 @@
+===============================================================
+ librabbitmq AMQP transport - ``kombu.transport.librabbitmq``
+===============================================================
+
 .. currentmodule:: kombu.transport.librabbitmq
 
 .. automodule:: kombu.transport.librabbitmq
diff --git a/docs/reference/kombu.transport.memory.rst b/docs/reference/kombu.transport.memory.rst
index c712b135..e478ee5c 100644
--- a/docs/reference/kombu.transport.memory.rst
+++ b/docs/reference/kombu.transport.memory.rst
@@ -1,3 +1,7 @@
+==================================================
+ In-memory Transport - ``kombu.transport.memory``
+==================================================
+
 .. currentmodule:: kombu.transport.memory
 
 .. automodule:: kombu.transport.memory
diff --git a/docs/reference/kombu.transport.mongodb.rst b/docs/reference/kombu.transport.mongodb.rst
index f4d25537..dcfef8eb 100644
--- a/docs/reference/kombu.transport.mongodb.rst
+++ b/docs/reference/kombu.transport.mongodb.rst
@@ -1,3 +1,7 @@
+=================================================
+ MongoDB Transport - ``kombu.transport.mongodb``
+=================================================
+
 .. currentmodule:: kombu.transport.mongodb
 
 .. automodule:: kombu.transport.mongodb
diff --git a/docs/reference/kombu.transport.pyamqp.rst b/docs/reference/kombu.transport.pyamqp.rst
index 33ebf0b4..f798c289 100644
--- a/docs/reference/kombu.transport.pyamqp.rst
+++ b/docs/reference/kombu.transport.pyamqp.rst
@@ -1,3 +1,7 @@
+=========================================================
+ Pure-python AMQP Transport - ``kombu.transport.pyamqp``
+=========================================================
+
 .. currentmodule:: kombu.transport.pyamqp
 
 .. automodule:: kombu.transport.pyamqp
diff --git a/docs/reference/kombu.transport.pyro.rst b/docs/reference/kombu.transport.pyro.rst
index 5bbf3377..7dc03212 100644
--- a/docs/reference/kombu.transport.pyro.rst
+++ b/docs/reference/kombu.transport.pyro.rst
@@ -1,3 +1,7 @@
+================================================
+ Pyro Transport - ``kombu.transport.pyro``
+================================================
+
 .. currentmodule:: kombu.transport.pyro
 
 .. automodule:: kombu.transport.pyro
diff --git a/docs/reference/kombu.transport.qpid.rst b/docs/reference/kombu.transport.qpid.rst
index 4e152c8d..d43970cf 100644
--- a/docs/reference/kombu.transport.qpid.rst
+++ b/docs/reference/kombu.transport.qpid.rst
@@ -1,3 +1,7 @@
+===================================================
+ Apache QPid Transport - ``kombu.transport.qpid``
+===================================================
+
 .. currentmodule:: kombu.transport.qpid
 
 .. automodule:: kombu.transport.qpid
diff --git a/docs/reference/kombu.transport.redis.rst b/docs/reference/kombu.transport.redis.rst
index 6a3f4fe5..1307ab34 100644
--- a/docs/reference/kombu.transport.redis.rst
+++ b/docs/reference/kombu.transport.redis.rst
@@ -1,3 +1,7 @@
+=================================================
+ Redis Transport - ``kombu.transport.redis``
+=================================================
+
 .. currentmodule:: kombu.transport.redis
 
 .. automodule:: kombu.transport.redis
diff --git a/docs/reference/kombu.transport.rst b/docs/reference/kombu.transport.rst
index 806d9d94..d0cf14c4 100644
--- a/docs/reference/kombu.transport.rst
+++ b/docs/reference/kombu.transport.rst
@@ -1,3 +1,7 @@
+===========================================
+  Built-in Transports - ``kombu.transport``
+===========================================
+
 .. currentmodule:: kombu.transport
 
 .. automodule:: kombu.transport
diff --git a/docs/reference/kombu.transport.virtual.exchange.rst b/docs/reference/kombu.transport.virtual.exchange.rst
index 220b0176..004268cb 100644
--- a/docs/reference/kombu.transport.virtual.exchange.rst
+++ b/docs/reference/kombu.transport.virtual.exchange.rst
@@ -1,3 +1,7 @@
+=============================================================================
+ Virtual AMQ Exchange Implementation - ``kombu.transport.virtual.exchange``
+=============================================================================
+
 .. currentmodule:: kombu.transport.virtual.exchange
 
 .. automodule:: kombu.transport.virtual.exchange
diff --git a/docs/reference/kombu.transport.virtual.rst b/docs/reference/kombu.transport.virtual.rst
index 4bac1dd7..12d2b983 100644
--- a/docs/reference/kombu.transport.virtual.rst
+++ b/docs/reference/kombu.transport.virtual.rst
@@ -1,3 +1,7 @@
+============================================================
+ Virtual Transport Base Class - ``kombu.transport.virtual``
+============================================================
+
 .. currentmodule:: kombu.transport.virtual
 
 .. automodule:: kombu.transport.virtual
diff --git a/docs/reference/kombu.transport.zookeeper.rst b/docs/reference/kombu.transport.zookeeper.rst
index af900a35..a75d6e61 100644
--- a/docs/reference/kombu.transport.zookeeper.rst
+++ b/docs/reference/kombu.transport.zookeeper.rst
@@ -1,6 +1,6 @@
-===========================
- kombu.transport.zookeeper
-===========================
+======================================================
+ Zookeeper Transport - ``kombu.transport.zookeeper``
+======================================================
 
 .. currentmodule:: kombu.transport.zookeeper
 
diff --git a/docs/reference/kombu.utils.amq_manager.rst b/docs/reference/kombu.utils.amq_manager.rst
index 13e191eb..23c50873 100644
--- a/docs/reference/kombu.utils.amq_manager.rst
+++ b/docs/reference/kombu.utils.amq_manager.rst
@@ -1,6 +1,6 @@
-====================================================
- Generic RabbitMQ manager - kombu.utils.amq_manager
-====================================================
+========================================================
+ Generic RabbitMQ manager - ``kombu.utils.amq_manager``
+========================================================
 
 .. contents::
     :local:
diff --git a/docs/reference/kombu.utils.debug.rst b/docs/reference/kombu.utils.debug.rst
index 35cbc4c5..7649a733 100644
--- a/docs/reference/kombu.utils.debug.rst
+++ b/docs/reference/kombu.utils.debug.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Debugging - kombu.utils.debug
+ Debugging Utilities - ``kombu.utils.debug``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.utils.encoding.rst b/docs/reference/kombu.utils.encoding.rst
index 2ac4c513..1ec5c3e3 100644
--- a/docs/reference/kombu.utils.encoding.rst
+++ b/docs/reference/kombu.utils.encoding.rst
@@ -1,5 +1,5 @@
 ==========================================================
- String Encoding - kombu.utils.encoding
+ String Encoding Utilities - ``kombu.utils.encoding``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.utils.eventio.rst b/docs/reference/kombu.utils.eventio.rst
index 16c40f33..1058c1bd 100644
--- a/docs/reference/kombu.utils.eventio.rst
+++ b/docs/reference/kombu.utils.eventio.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Evented I/O - kombu.utils.eventio
+ Async I/O Selectors - ``kombu.utils.eventio``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.utils.functional.rst b/docs/reference/kombu.utils.functional.rst
index ffe1fbbe..48c35141 100644
--- a/docs/reference/kombu.utils.functional.rst
+++ b/docs/reference/kombu.utils.functional.rst
@@ -1,5 +1,5 @@
 ==========================================================
- kombu.utils.functional
+ Functional-style Utilities - ``kombu.utils.functional``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.utils.json.rst b/docs/reference/kombu.utils.json.rst
index 8d835875..abf2060a 100644
--- a/docs/reference/kombu.utils.json.rst
+++ b/docs/reference/kombu.utils.json.rst
@@ -1,5 +1,5 @@
 ==========================================================
- JSON Utilities - kombu.utils.json
+ JSON Utilities - ``kombu.utils.json``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.utils.limits.rst b/docs/reference/kombu.utils.limits.rst
index 59df5508..d46431da 100644
--- a/docs/reference/kombu.utils.limits.rst
+++ b/docs/reference/kombu.utils.limits.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Rate limiting - kombu.utils.limits
+ Rate limiting - ``kombu.utils.limits``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.utils.rst b/docs/reference/kombu.utils.rst
index 8df34c5d..a267d380 100644
--- a/docs/reference/kombu.utils.rst
+++ b/docs/reference/kombu.utils.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Utilities - kombu.utils
+ Utilities - ``kombu.utils``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.utils.scheduling.rst b/docs/reference/kombu.utils.scheduling.rst
index 7efb54e9..ced727c7 100644
--- a/docs/reference/kombu.utils.scheduling.rst
+++ b/docs/reference/kombu.utils.scheduling.rst
@@ -1,3 +1,7 @@
+=============================================
+ Consumer Scheduling - ``kombu.scheduling``
+=============================================
+
 .. contents::
     :local:
 .. currentmodule:: kombu.utils.scheduling
diff --git a/docs/reference/kombu.utils.text.rst b/docs/reference/kombu.utils.text.rst
index ca6354fe..78dce43d 100644
--- a/docs/reference/kombu.utils.text.rst
+++ b/docs/reference/kombu.utils.text.rst
@@ -1,5 +1,5 @@
 ==========================================================
- Text utilitites - kombu.utils.text
+ Text utilitites - ``kombu.utils.text``
 ==========================================================
 
 .. contents::
diff --git a/docs/reference/kombu.utils.url.rst b/docs/reference/kombu.utils.url.rst
index f223fba3..e0ddccc5 100644
--- a/docs/reference/kombu.utils.url.rst
+++ b/docs/reference/kombu.utils.url.rst
@@ -1,5 +1,5 @@
 ==============================================
- kombu.utils.url
+ URL Utilities - ``kombu.utils.url``
 ==============================================
 
 .. contents::