diff --git a/swift/common/middleware/keystoneauth.py b/swift/common/middleware/keystoneauth.py
index 446734ac10..cb1b4c7c39 100644
--- a/swift/common/middleware/keystoneauth.py
+++ b/swift/common/middleware/keystoneauth.py
@@ -86,7 +86,7 @@ class KeystoneAuth(object):
 
     It is possible to have several accounts associated with the same project.
     This is done by listing several prefixes as shown in the following
-    example:
+    example::
 
         reseller_prefix = AUTH, SERVICE
 
@@ -95,7 +95,7 @@ class KeystoneAuth(object):
     using roles that a user has with that project. The core use of this feature
     is that it is possible to provide different rules for each account
     prefix. The following parameters may be prefixed with the appropriate
-    prefix:
+    prefix::
 
         operator_roles
         service_roles
diff --git a/swift/common/middleware/tempurl.py b/swift/common/middleware/tempurl.py
index abff073551..f93950104d 100644
--- a/swift/common/middleware/tempurl.py
+++ b/swift/common/middleware/tempurl.py
@@ -85,7 +85,7 @@ Let's say ``sig`` ends up equaling
 You may also use ISO 8601 UTC timestamps with the format
 ``"%Y-%m-%dT%H:%M:%SZ"`` instead of UNIX timestamps in the URL
 (but NOT in the code above for generating the signature!).
-So, the latter URL could also be formulated as:
+So, the latter URL could also be formulated as::
 
     https://swift-cluster.example.com/v1/AUTH_account/container/object?
     temp_url_sig=da39a3ee5e6b4b0d3255bfef95601890afd80709&
diff --git a/swift/common/middleware/xprofile.py b/swift/common/middleware/xprofile.py
index deca857f2b..fd8797a0ee 100644
--- a/swift/common/middleware/xprofile.py
+++ b/swift/common/middleware/xprofile.py
@@ -63,13 +63,13 @@ as proxy, account, container and object servers. Please refer to the sample
 configuration files in etc directory.
 
 The profiling data is provided with four formats such as binary(by default),
-json, csv and odf spreadsheet which requires installing odfpy library.
+json, csv and odf spreadsheet which requires installing odfpy library::
 
     sudo pip install odfpy
 
 There's also a simple visualization capability which is enabled by using
 matplotlib toolkit. it is also required to be installed if you want to use
-it to visualize statistic data.
+it to visualize statistic data::
 
     sudo apt-get install python-matplotlib
 """