diff --git a/src/include/replication/slot.h b/src/include/replication/slot.h
index 0bf2611fe9c0f6e6af98281c7391f508ad20d502..0c442330b227ac6f583ea8bb3e6a81e19adf5b01 100644
--- a/src/include/replication/slot.h
+++ b/src/include/replication/slot.h
@@ -22,9 +22,13 @@
  *
  * Slots marked as PERSISTENT are crash-safe and will not be dropped when
  * released. Slots marked as EPHEMERAL will be dropped when released or after
- * restarts.
+ * restarts.  Slots marked TEMPORARY will be dropped at the end of a session
+ * or on error.
  *
- * EPHEMERAL slots can be made PERSISTENT by calling ReplicationSlotPersist().
+ * EPHEMERAL is used as a not-quite-ready state when creating persistent
+ * slots.  EPHEMERAL slots can be made PERSISTENT by calling
+ * ReplicationSlotPersist().  For a slot that goes away at the end of a
+ * session, TEMPORARY is the appropriate choice.
  */
 typedef enum ReplicationSlotPersistency
 {