doc/TODO: remove the --help item

doc/man1/mailshears.1: add --help to the usage info

lib/common/user_interface.rb: add --help to the usage info

bin/mailshears: print usage info and exit on -h or --help

mailshears.gemspec: use SPDX license identifier

doc/man1/mailshears.1: document the new config file location

lib/common/configuration.rb: move the config file to XDG_CONFIG_HOME

Rakefile: drop --user-install from gem command

This is outdated I guess? Whatever.

lib/mv/plugins/davical.rb: fix mv_plugin include

mailshears.gemspec: bump version to 0.0.6

mailshears.gemspec: http -> https

**/*: remove AgenDAV support

The AgenDAV project is dead and doesn't even work with e.g. php-8.x.
Here we remove all support and documentation for it.

mailshears.gemspec: update the version to 0.0.5.

*/*: drop tty parameters.

The "tty" parameter for postgresql connections has been ignored for as
long as I can remember, but with postgresql-14, it has finally been
removed. Now, attempting to supply it causes an error:

  PG::ConnectionBad: invalid connection option "tty"

This commit removes all mention of the parameter, and updates two
instances where PG::Connection.new() was called with positional
arguments. Now it is called with a hash, sans the :tty key, which
should be backwards-compatible.

lib,test: replace connection query() method with sync_exec{,_params}.

The old generic name was deprecated in favor of the explicit
synchronous with/without-params methods.

lib: replace two PG::Connection.connect with PG::Connection.new.

mailshears.gemspec: bump to v0.0.4, update pg library to v1.2.x.

test/sql: set default_with_oids=false everywhere.

PostgreSQL 12.x no longer supports OIDs, and attempting to create
tables that support them is throwing an error:

  1) Error:
  TestRm#test_rm_domain:
  PG::FeatureNotSupported: ERROR:  tables declared WITH OIDS are not
  supported

This commit disables the OIDs-by-default, and should allow the test
suite to run under newer versions of PostgreSQL.

lib/mv/mv_runner.rb: drop an unused "e" error variable.

doc/TODO: add a few more items.

Update the latest TODO item.

Add another TODO item.

Add a test to ensure that "nonexistent" AgenDAV users' shares are removed.

Fix expected test output for AgendavMv.

Don't fail for nonexistent users in AgendavRm.

Run "gem 'minitest'" to silence a stupid warning.

Fix ownership issues in the agendav.sql test schema.

Fix quoting issues with the new AgenDAV "with" column.

Update the license name in mailshears.gemspec (fixes a warning).

Update fixtures in the test suite setup() comments.

Fix the AgenDAV fixures SQL, again.

Fix the new AgenDAV fixtures SQL.

Add version information to the man page.

Update the version in mailshears.gemspec.

Don't fail if the source user doesn't exist during an AgendavMv.

Update AgenDAV fixtures for the v2.1.0 schema.

Update the AgenDAV test schema for v2.1.0.

Take a stab in the dark at AgenDAV v2.1.0 support.

Update the project homepage.

Replace a TODO item.

Remove ".yardoc" directory in `rake clean`.

Move the install-fixtures.sh script to a harmless location.

Fix warnings with newer minitest versions.

Move the example config under doc/.

Add a man page.
Remove the outdated README and get rid of that TODO item.
Update the gemspec with the description in the man page.

Fix off-by-one error in the header underline.

Change the description at the top of the executable.

Make "postfixadmin" the only default plugin and make dovecot_mail_root safer.

Removed completed items from the TODO.

Fix Postfixadmin alias updating (don't leave commas at the start/end).

Factor out the description-message-building in the runners.

Wrap all close() calls in "ensure" blocks and simplify DB connection-making.

Remove debug code from Plugin.

Remove HTML docs with `rake clean`.

Document everything with YARD and fix some bugs along the way.

Add more TODO items and remove the one about YARD docs (coming in a second).

Don't hide shell output in the Rakefile.

Begin updating docs; remove two unused exit codes.

Update comments in the executable and factor out the make_header() function.

Remove a newline.

Remove a TODO I don't intend to DO.

Add some tests for moving users.

Make pruning use the correct config and clean up *before* running tests, too.

Fix variable names in the prune tests.

Use semantic bound on pg library.

Allow sorting of User/Domain for testing.

Fix broken nesting in lib/mv/plugins/postfixadmin.rb.

Stop pretending that we'll ever work with another DBMS.

Add an idempotence test for pruning.

Add even more TODO items.

Add a few more TODOs.

Add a test case for prune.

Add some new fixtures in preparation for prune tests.

Don't include RmPlugin from PrunePlugin (pointless; also crashes tests!).

Remove pointless include.

Simplify prune plugins and fix array difference error.

Add "-f" to the "rm" call in bin/install-fixtures.sh.

Rename mail_root to dovecot_mail_root for consistency.

Switch to the Affero GPL3 license.

Begin cleaning up the test code to add some prune/mv cases.

Switch to MiniTest and update the test output.

Clean up user/domain describing in the plugins.

Overhaul everything to get consistent error reports.

Update a comment and delete a newline.

Add missing principal stuff to the Davical fixtures.

Add a quick script to load the test databases and fixtures for me.

Add another error reporting TODO and mention not overwriting existing stuff.

Get DovecotMv just barely working.

Move the "mv" invalid destination user check into the runner.

Get the MvRunner working, at least for Postfixadmin.

Implement user moving for Postfixadmin.

Add domain_exists() to PostfixadminPlugin.

Dump our output buffer if a plugin crashes.

Add some "mv" brainstorming to the TODO.

Allow the getting of a dovecot user path even if it doesn't exist.

Disable domain moves in the dummy MvRunner.

Clarify error class comments.

Remove mv_domain() from MvPlugin.

Remove "-K" from the shebang, and remove the outdated intro comment.

Fix nil error when only postfixadmin is enabled.