Add a man page.
[mailshears.git] / mailshears.gemspec
index acc46359e8c335923b950d6453db133d0213deff..6af744f0486d29ac836dec338591166f3445d705 100644 (file)
@@ -7,9 +7,24 @@ Gem::Specification.new do |s|
   s.email             = ['michael@orlitzky.com']
   s.homepage          = 'http://michael.orlitzky.com/code/mailshears.php'
   s.summary           = 'Prune unused mail directories.'
-  s.description       = s.summary
-  s.license           = 'AGPL-3'
+  s.description       = <<-EOF
+    Managing a mail system with virtual users is annoying. The
+    authoritative database of users is stored in one table, but every
+    other piece of software keeps its own database of users.
+
+    If you're using PostfixAdmin to manage your users, what happens when
+    you delete a user? Chances are, nothing happens: mail directories are
+    left behind, webmail preferences are saved, address books become
+    orphaned. That's what mailshears was designed to fix. It cleans up
+    after you remove a user or domain.
 
+    Another stupidly difficult task is renaming a single email
+    account. It's easy to move the user in one database, but then all of
+    the remaining filesystem directories and databases need to be updated
+    as well. Since these two tasks are related, mailshears does them both.
+  EOF
+
+  s.license           = 'AGPL-3'
   s.required_rubygems_version = '>= 1.3.6'
 
   # If you have runtime dependencies, add them here