diff --git a/doc/man/man5/slapo-memberof.5 b/doc/man/man5/slapo-memberof.5
index 504cee063f..42e3d18319 100644
--- a/doc/man/man5/slapo-memberof.5
+++ b/doc/man/man5/slapo-memberof.5
@@ -15,6 +15,11 @@ allows automatic reverse group membership maintenance.
 Any time a group entry is modified, its members are modified as appropriate
 in order to keep a DN-valued "is member of" attribute updated with the DN
 of the group.
+.LP
+Note that this overlay is deprecated and support will be dropped in future
+OpenLDAP releases. Installations should use the \fBdynlist\fP
+overlay instead. Using this overlay in a replicated environment is especially
+discouraged.
 
 .SH CONFIGURATION
 The config directives that are specific to the
@@ -126,6 +131,7 @@ a future release:
 .B olcMemberOf
 is replaced with olcMemberOfConfig
 .SH SEE ALSO
+.BR slapo-dynlist (5),
 .BR slapd.conf (5),
 .BR slapd\-config (5),
 .BR slapd (8).