diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index 91a2e15b05..3f643a5384 100644
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -2140,9 +2140,16 @@ REVOKE ALL ON accounts FROM PUBLIC;
aclitem
The privileges that have been granted for a particular object are
- displayed as a list of aclitem entries, where each
- aclitem describes the permissions of one grantee that
- have been granted by a particular grantor. For example,
+ displayed as a list of aclitem entries, each having the
+ format:
+
+grantee=privilege-abbreviation*.../grantor
+
+ Each aclitem lists all the permissions of one grantee that
+ have been granted by a particular grantor. Specific privileges are
+ represented by one-letter abbreviations from
+ , with *
+ appended if the privilege was granted with grant option. For example,
calvin=r*w/hobbes specifies that the role
calvin has the privilege
SELECT (r) with grant option