diff --git a/doc/repmgrd-configuration.xml b/doc/repmgrd-configuration.xml
index 920ab6c0..20a32a1d 100644
--- a/doc/repmgrd-configuration.xml
+++ b/doc/repmgrd-configuration.xml
@@ -345,14 +345,18 @@
- Indicates a preferred priority (default: 100) for promoting nodes;
- a value of zero prevents the node being promoted to primary.
+ Indicates a preferred priority (default: 100) for promoting nodes.
Note that the priority setting is only applied if two or more nodes are
determined as promotion candidates; in that case the node with the
higher priority is selected.
+
+ A value of zero will always prevent the node being promoted to primary, even if there
+ is no other promotion candidate.
+
+