diff --git a/doc/man/man5/slapd-sock.5 b/doc/man/man5/slapd-sock.5
index afa281a984..981a2a43be 100644
--- a/doc/man/man5/slapd-sock.5
+++ b/doc/man/man5/slapd-sock.5
@@ -162,6 +162,22 @@ where only RESULT is mandatory, and then close the socket.
 The \fBsearch\fP RESULT should be preceded by the entries in LDIF
 format, each entry followed by a blank line.
 Lines starting with `#' or `DEBUG:' are ignored.
+
+When used as an overlay, the result from an operation is also sent,
+so the external program can see if the operation succeeded or not.
+This message is similar to the RESULT message above, but
+will also include any configured extensions:
+.RS
+.nf
+RESULT
+msgid: <message id>
+code: <integer>
+matched: <matched DN>
+info: <text>
+.fi
+.RE
+Typically both the msgid and the connid will be needed to match
+a result message to a request.
 .SH ACCESS CONTROL
 The
 .B sock
diff --git a/doc/man/man5/slapd-sock.5.links b/doc/man/man5/slapd-sock.5.links
new file mode 100644
index 0000000000..b5f4e45c95
--- /dev/null
+++ b/doc/man/man5/slapd-sock.5.links
@@ -0,0 +1 @@
+slapo-sock.5