diff options
author | Michael Orlitzky <mjo@gentoo.org> | 2024-04-24 07:57:55 -0400 |
---|---|---|
committer | Michael Orlitzky <mjo@gentoo.org> | 2024-04-24 07:59:43 -0400 |
commit | 3c8b6585a9ba887e45fc53823cf520d5f986027f (patch) | |
tree | abb838e6e31db56de57693715cc012453a781d13 /net-mail | |
parent | sys-apps/fwupd-efi: add 1.6 (diff) | |
download | gentoo-3c8b6585a9ba887e45fc53823cf520d5f986027f.tar.gz gentoo-3c8b6585a9ba887e45fc53823cf520d5f986027f.tar.bz2 gentoo-3c8b6585a9ba887e45fc53823cf520d5f986027f.zip |
net-mail/mailbox-count: trim down longdescription
Signed-off-by: Michael Orlitzky <mjo@gentoo.org>
Diffstat (limited to 'net-mail')
-rw-r--r-- | net-mail/mailbox-count/metadata.xml | 162 |
1 files changed, 22 insertions, 140 deletions
diff --git a/net-mail/mailbox-count/metadata.xml b/net-mail/mailbox-count/metadata.xml index 4831484d5891..134a467564f6 100644 --- a/net-mail/mailbox-count/metadata.xml +++ b/net-mail/mailbox-count/metadata.xml @@ -1,144 +1,26 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE pkgmetadata SYSTEM "https://www.gentoo.org/dtd/metadata.dtd"> <pkgmetadata> - <maintainer type="person"> - <email>mjo@gentoo.org</email> - <name>Michael Orlitzky</name> - </maintainer> - <maintainer type="project"> - <email>haskell@gentoo.org</email> - <name>Gentoo Haskell</name> - </maintainer> - <longdescription> - /Usage/: - - @ - mailbox-count [OPTIONS] - @ - - Mailbox-count produces a simple count of mailboxes that exist - per-domain in some SQL database. The default queries are compatible - with the schema used by PostfixAdmin <http://postfixadmin.sourceforge.net/>, - but it is possible to supply your own queries via the @--summary-query@ - and @--detail-query@ options. - - The summary report lists each domain, along with the number of - mailboxes owned by that domain. The order is determined by the summary - query, which lists the domains alphabetically by default. - - The default detail report shows the same, but also contains a list of - each individual mailbox (again in alphabetical order) belonging to the - domains. - - /Input/: - - None. - - /Output/: - - Either a summary, or detailed report (with @--detail@) of the - number of mailboxes per-domain contained in the database. - - /Options/: - - @ - \--database - @ - - The name of the database (or file, if SQLite) to which we should - connect. - - Default: The name of the current user (Postgres only). - - @ - \--detail - @ - - Produce a detailed report listing all mailboxes by domain. - - @ - \--detail-query - @ - - 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: \"SELECT domain,username FROM mailbox ORDER BY domain;\" - - @ - \--host - @ - - Hostname where the database is located (Postgres-only). - - Default: None, a UNIX domain socket connection is attempted (Postgres only) - - @ - \--password - @ - - Password used to connect to the database (Postgres-only). - - Default: None (assumes passwordless authentication) - - @ - \--port - @ - Port number used to connect to the database (Postgres-only). - - Default: None, a UNIX domain socket connection is attempted (Postgres only) - - @ - \--summary-query - @ - - SQL query used to produce the summary report. This should return - (domain, user count) pairs. See the default value for an - example. - - Default: \"SELECT domain,COUNT(username) FROM mailbox GROUP BY domain - ORDER BY domain;\" - - @ - \--username - @ - - Username used to connect to the database (Postgres-only). - - Default: The current user - - /Examples/: - - The default summary report: - - @ - $ mailbox-count --database=postfixadmin.sqlite3 - Summary (number of mailboxes per domain) - \---------------------------------------- - example.com: 3 - example.invalid: 1 - example.net: 2 - example.org: 1 - @ - - The more detailed report: - - @ - $ mailbox-count --detail --database=postfixadmin.sqlite3 - Detail (list of all mailboxes by domain) - \---------------------------------------- - example.com (3): - &#x20; user1 - &#x20; user3 - &#x20; user5 - example.invalid (1): - &#x20; user7 - example.net (2): - &#x20; user2 - &#x20; user4 - example.org (1): - &#x20; user6 - @ - </longdescription> + <maintainer type="person"> + <email>mjo@gentoo.org</email> + <name>Michael Orlitzky</name> + </maintainer> + <maintainer type="project"> + <email>haskell@gentoo.org</email> + <name>Gentoo Haskell</name> + </maintainer> + <longdescription> + Mailbox-count produces a simple count of mailboxes that exist + per-domain in some SQL database. The default queries are compatible + with the schema used by PostfixAdmin but it is possible to supply + your own queries via the --summary-query and --detail-query options. + + The summary report lists each domain, along with the number of + mailboxes owned by that domain. The order is determined by the + summary query, which lists the domains alphabetically by default. + + The default detail report shows the same, but also contains a list + of each individual mailbox (again in alphabetical order) belonging + to the domains. + </longdescription> </pkgmetadata> |