list-remote-forwards.cabal: delete the redundant description

I'm tired of maintaining this.

diff --git a/list-remote-forwards.cabal b/list-remote-forwards.cabal
index 53dfcd9ef348c5837f73f56fe2c35cbcc1ace98a..e9a239f6ea973e55559712440791cb0d376ffaec 100644 (file)
--- a/list-remote-forwards.cabal
+++ b/list-remote-forwards.cabal
@@ -17,124 +17,9 @@ extra-source-files:
 synopsis:
   List all remote forwards for mail accounts stored in a SQL database.
 description:
-  /Usage/:
-
-  @
-  list-remote-forwards [OPTIONS]
-  @
-
-  List all remote forwards for mail accounts stored in a SQL database.
-
-  A list of local domains is supplied to the program (more or less)
-  through the @--domain-query@ option. Any addresses which
-  forward to another address not contained in this list of local domains
-  is considered a remote forward. Remote forwards can cause problems for
-  a number of reasons, the most common of which are,
-
-    * If the sender has an SPF record authorizing his mail server to send
-      mail on his behalf, then when his message is forwarded by the
-      recipient's mail server, it will fail any subsequent SPF checks. This
-      will likely cause the message to be rejected, and the original
-      recipient's server will generate backscatter.
-
-    * If any spam makes it through the filter on the recipient's mail
-      server, that spam will then be forwarded to a remote destination. The
-      remote destination will blame the forwarding server for the spam, and
-      that can impact its reputation and potentially lead to a blacklisting
-      even though the spam did not originate on the recipient's server.
-
-  Whether or not these are an issue depends on the circumstances, but in
-  any case it is useful to know who is forwarding mail off-site.
-
-  /Input:/
-
-  None.
-
-  /Output:/
-
-  A list of addresses that are forwarded to remote domains.
-
-  /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).
-
-  * \--domain-query
-
-      SQL query used to produce a list of local domains. This should
-      return the set of all domains (i.e one column) that are local to the
-      server. See the default value for an example.
-
-      Default: \"SELECT domain FROM domain WHERE domain <> 'ALL' ORDER BY
-      domain;\"
-
-  * \--exclude-mx, -e
-
-      The name of a mail exchanger, the forwards of whose domains we
-      should ignore. For example, if one mail exchanger,
-      mx1.example.com, has strict spam filtering, it may be acceptable
-      to have remote forwarding for domains that have mx1.example.com
-      as their sole mail exchanger (MX record). In that case, you
-      might want to exclude those domains from the report by naming
-      mx1.example.com here.
-
-      A forward will be excluded from the report only if /all/ of its MX
-      records are contained in the given exclude list.
-
-      This option can be repeated to add mail exchangers to the exclude list.
-
-      Default: [] (empty)
-
-  * \--forward-query, -f
-
-      SQL query used to produce a list of all forwards on the mail
-      system. This query should return the set of all (address, goto)
-      pairs, where \"goto\" is the destination address; i.e. to
-      where the \"address\" forwards. The \"goto\" field may contain
-      more than one email address, separated by commas.
-
-      Default: \"SELECT address,goto FROM alias ORDER BY address;\"
-
-  * \--host, -h
-
-      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)
-
-  * \--username, -u
-
-      Username used to connect to the database (Postgres-only).
-
-      Default: The current user
-
-  /Examples/:
-
-  @
-  $ list-remote-forwards --database=test\/fixtures\/postfixadmin.sqlite3
-  user1@example.com -> user1@example.net
-  user2@example.com -> user1@example.org
-  user2@example.com -> user2@example.org
-  user2@example.com -> user3@example.org
-  user7@example.com -> user8@example.net
-  @
+  List all remote forwards for mail accounts stored in a SQL
+  database. A description, options, and examples can be found in the
+  man page.
 
 executable list-remote-forwards
   build-depends: