summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Orlitzky <mjo@gentoo.org>2024-04-24 07:57:55 -0400
committerMichael Orlitzky <mjo@gentoo.org>2024-04-24 07:59:43 -0400
commit3c8b6585a9ba887e45fc53823cf520d5f986027f (patch)
treeabb838e6e31db56de57693715cc012453a781d13 /net-mail
parentsys-apps/fwupd-efi: add 1.6 (diff)
downloadgentoo-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.xml162
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 &lt;http://postfixadmin.sourceforge.net/&gt;,
- 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):
- &amp;#x20; user1
- &amp;#x20; user3
- &amp;#x20; user5
- example.invalid (1):
- &amp;#x20; user7
- example.net (2):
- &amp;#x20; user2
- &amp;#x20; user4
- example.org (1):
- &amp;#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>