GH-1099: Fix Javadocs for Publisher Connection

Resolves #1099

**cherry-pick to 2.3.x, 2.2.x**

Author: garyrussell

spring-rabbit/src/main/java/org/springframework/amqp/rabbit/core/RabbitTemplate.java

@@ -823,10 +823,12 @@ public boolean isUsePublisherConnection() {
 	}
 
 	/**
-	 * To avoid deadlocked connections, it is generally recommended to use
-	 * a separate connection for publishers and consumers (except when a publisher
-	 * is participating in a consumer transaction). Default 'false'; will change
-	 * to 'true' in 2.1.
+	 * To avoid deadlocked connections, it is generally recommended to use a separate
+	 * connection for publishers and consumers (except when a publisher is participating
+	 * in a consumer transaction). Default 'false'. When setting this to true, be careful
+	 * in that a {@link RabbitAdmin} that uses this template will declare queues on the
+	 * publisher connection; this may not be what you expect, especially with exclusive
+	 * queues that might be consumed in this application.
 	 * @param usePublisherConnection true to use a publisher connection.
 	 * @since 2.0.2
 	 */