diff --git a/doc/dbus-daemon.1.xml.in b/doc/dbus-daemon.1.xml.in
index 5f8dddd6..be4e1aa8 100644
--- a/doc/dbus-daemon.1.xml.in
+++ b/doc/dbus-daemon.1.xml.in
@@ -938,6 +938,17 @@ the character "*" can be substituted, meaning "any." Complex globs
like "foo.bar.*" aren't allowed for now because they'd be work to
implement and maybe encourage sloppy security anyway.
+
+ Rules with the own or own_prefix
+ attribute are checked when a connection attempts to own a well-known bus
+ names. As a special case, own="*" matches any well-known
+ bus name. The well-known session bus normally allows any connection to
+ own any name, while the well-known system bus normally does not allow any
+ connection to own any name, except where allowed by further configuration.
+ System services that will own a name must install configuration that allows
+ them to do so, usually via rules of the form
+ <policy user="some-system-user"><allow own="…"/></policy>.
+
<allow own_prefix="a.b"/> allows you to own the name "a.b" or any
name whose first dot-separated elements are "a.b": in particular,