diff --git a/oslo_messaging/transport.py b/oslo_messaging/transport.py
index abac3dfec..2a3c9aaf7 100644
--- a/oslo_messaging/transport.py
+++ b/oslo_messaging/transport.py
@@ -230,7 +230,7 @@ class TransportURL(object):
 
     Transport URLs take the form::
 
-      transport://user:pass@host1:port[,hostN:portN]/virtual_host
+      transport://user:pass@host:port[,userN:passN@hostN:portN]/virtual_host
 
     i.e. the scheme selects the transport driver, you may include multiple
     hosts in netloc and the path part is a "virtual host" partition path.
@@ -354,7 +354,7 @@ class TransportURL(object):
 
         Assuming a URL takes the form of::
 
-          transport://user:pass@host1:port[,hostN:portN]/virtual_host
+          transport://user:pass@host:port[,userN:passN@hostN:portN]/virtual_host
 
         then parse the URL and return a TransportURL object.