[improve][client] Mention partitioning in failover priorityLevel java…

…Doc (apache#21980)

Co-authored-by: Matteo Merli <mmerli@apache.org>

pulsar-client-api/src/main/java/org/apache/pulsar/client/api/ConsumerBuilder.java

@@ -511,9 +511,9 @@ public interface ConsumerBuilder<T> extends Cloneable {
      * Order in which broker dispatches messages to consumers: C1, C2, C3, C1, C4, C5, C4
      * </pre>
      *
-     * <p><b>Failover subscription</b>
-     * The broker selects the active consumer for a failover subscription based on consumer's priority-level and
-     * lexicographical sorting of consumer name.
+     * <p><b>Failover subscription for partitioned topic</b>
+     * The broker selects the active consumer for a failover subscription for a partitioned topic
+     * based on consumer's priority-level and lexicographical sorting of consumer name.
      * eg:
      * <pre>
      * 1. Active consumer = C1 : Same priority-level and lexicographical sorting
@@ -530,6 +530,8 @@ public interface ConsumerBuilder<T> extends Cloneable {
      * Broker evenly assigns partitioned topics to highest priority consumers.
      * </pre>
      *
+     * <p>Priority level has no effect on failover subscriptions for non-partitioned topics.
+     *
      * @param priorityLevel the priority of this consumer
      * @return the consumer builder instance
      */