commit: 3c8b6585a9ba887e45fc53823cf520d5f986027f Author: Michael Orlitzky <mjo <AT> gentoo <DOT> org> AuthorDate: Wed Apr 24 11:57:55 2024 +0000 Commit: Michael Orlitzky <mjo <AT> gentoo <DOT> org> CommitDate: Wed Apr 24 11:59:43 2024 +0000 URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=3c8b6585
net-mail/mailbox-count: trim down longdescription Signed-off-by: Michael Orlitzky <mjo <AT> gentoo.org> net-mail/mailbox-count/metadata.xml | 162 +++++------------------------------- 1 file 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>[email protected]</email> - <name>Michael Orlitzky</name> - </maintainer> - <maintainer type="project"> - <email>[email protected]</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>[email protected]</email> + <name>Michael Orlitzky</name> + </maintainer> + <maintainer type="project"> + <email>[email protected]</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>
