-.IP \fB\-\-both\fR,\ \fB-b\fR
-Produce both summary and detailed reports at the same time.
-.IP \fB\-\-detail\fR,\ \fB-d\fR
-Produce a detailed report instead of the (default) summary.
+.IP \fB\-\-database\fR
+The name of the database (or file, if SQLite) to which we should
+connect.
+
+Default: The name of the current user (Postgres only).
+
+.IP \fB\-\-detail\fR
+Produce a detailed report listing all mailboxes by domain.
+
+.IP \fB\-\-detail-query\fR
+SQL query used to produce the detail report. This should return the
+set of all (domain, username) pairs. See the default value for an
+example.
+
+Default: \(dqSELECT domain,username FROM mailbox ORDER BY domain;\(dq
+
+.IP \fB\-\-host\fR
+Hostname where the database is located (Postgres-only).
+
+Default: None, a UNIX domain socket connection is attempted (Postgres only)
+
+.IP \fB\-\-password\fR
+Password used to connect to the database (Postgres-only).
+
+Default: None (assumes passwordless authentication)
+
+.IP \fB\-\-port\fR
+Port number used to connect to the database (Postgres-only).
+
+Default: None, a UNIX domain socket connection is attempted (Postgres only)
+
+.IP \fB\-\-summary-query\fR
+SQL query used to produce the summary report. This should return
+(domain, user count) pairs. See the default value for an
+example.
+
+Default: \(dqSELECT domain,COUNT(username) FROM mailbox GROUP BY domain ORDER BY domain;\(dq
+
+.IP \fB\-\-username\fR
+Username used to connect to the database (Postgres-only).
+
+Default: The current user
+
+.SH EXAMPLES
+
+.IP \[bu] 2
+The default summary report:
+
+.nf
+.I $ mailbox-count --database=postfixadmin.sqlite3
+Summary (number of mailboxes per domain)
+----------------------------------------
+example.com: 3
+example.invalid: 1
+example.net: 2
+example.org: 1
+.fi
+.IP \[bu]
+The more detailed report:
+
+.nf
+.I $ mailbox-count --detail --database=postfixadmin.sqlite3
+Detail (list of all mailboxes by domain)
+----------------------------------------
+example.com (3):
+ user1
+ user3
+ user5
+
+example.invalid (1):
+ user7
+
+example.net (2):
+ user2
+ user4