doc: various cleanups all around

Most notably, the INSTALL is geared towards potential server admins,
whereas the README is also for interested "drive-by" readers.

cgi: cleanup dependencies

We do not need to use CGI::Util internals here.

cgi: make internal interface more Plack-like

This should make it easier to support non-CGI uses,
as well as making it easier to generate static sites.

feed: generate takes a hashref for args

Passing a giant argument list is to error prone and
hard-to-document.

doc: design_www note /full/ namespace for messages

We serve the short, abridge-quote version by default since
it is (unfortunately) common practice to over-quote on mailing lists.

view: use "original" rather than "raw"

This wording is probably clearer to everyone, and also used by at
least one other mailing list WWW interface.

view: minor cleanups

Avoid adding extraneous whitespace in HTML content, as it
increases bandwidth usage of network, disk and memory.

feed: reuse view class to display message

This reduces duplicated/similar code and hopefully makes things more
consistent.

view: all content is assumed to be displayable text

Our Filter class now passes through application/octet-stream
if it looks like text (because some mailers suck); so we
cannot trust the specified Content-Type of a message.

Makefile.PL: update dependencies

This is lightly tested.

view: use URI::Escape to escape URIs

CGI::escape is not a documented subroutine, so the chances of
it going away are higher.

feed: remove unnecessary use

We no longer use DateTime::Format::Mail.

feed: use Date::Parse to parse dates

This is a smaller module dependency-wise and should be easier-to-install
for folks with limited packaging systems or network/disk capacity.
We do not need very powerful date parsing, as bad date formats are
likely the work of spammers.

get a basic CGI feed sender running

We should be able to wire up the rest, soon.

remove failrepo config

We will just use the fallback in Email::Filter to
reduce configuration knobs.  Failed messages are failed
messages, do not classify them beyond that.

public-inbox-mda: preliminary manpage documentation

This still needs to be fleshed out.

view: implement quote folding and flesh out tests

Unfortunately, quoting is often excessive, so hide multi-line quotes
by default and provide anchored links to full messages instead.

config: add shortcut for retrieving elements

Hopefully this makes for less ad-hoc hash access in case
our config format changes.

doc: add design documentation for WWW interface

Mainly, start with URL routes since that's what users usually
see, first.

view: update IRP and MID links

We'll go with .html and .txt suffixes on MIDs to benefit
static hosting setups.

flesh out MDA and simplify config setup

We will be reusing the config parsing code for the CGI
script, too.

precheck uses recipient argument

We will also be using the RECIPIENT env in the future, since
that takes aliases into account.

Reducing the possible callsites to check ENV means we can more
easily update the code in the future.

README: various updates

filter: use regexp to check multipart bodies

This should be safer than running file(1), which has had its share
of vulnerabilities this year (early 2014) We really only care about
diffs and maybe short log files, here.

filter: possibly keep PGP sigs only (not other types)

We may keep PGP signatures for messages we do not modify.
However, we have no way of verifying them on the server-side.

design_notes: with philosophy

filter: use file(1) to detect mime type if octet-stream

Some mailers do not correctly detect/set the Content-Type header; so
attempt to keep messages based on our server-detected MIME type if
application/octet-stream was specified.

config: revamp API and implement lookup

initial cut at Atom feed generation

This should make it easier for non-ssoma users to follow.

precheck: require Message-ID to be set

Valid emails should not arrive without a Message-ID.

view: add view module to be used for rendering HTML

This is to keep content accessible to search engines.

move pre-spamc checks to PublicInbox->precheck

We may add more checks before we go to spamc.

public-inbox-mda: reject messages without From header

trivial config module for dumping config

We'll be using git config files after all...

drop Mail-Followup-To, Mail-Reply-To, and Reply-To

Due to the higher latency of a pull-based email, we want to
encourage the use of reply-to-all for public-inbox.

reject messages if ORIGINAL_RECIPIENT is not specified

SpamAssassin doesn't seem to have this heuristic, but the lack of
the intended email address in To:/Cc: headers cannot be a good
sign (especially when this is a _public_ inbox).

scripts: add a link to GPLv3 license

public-inbox-mda: limit message size before spamc

Unfortunately we slurp, but expect our MTA to provide its own
limit on message sizes.

scripts/import_gmane_spool: fix name in usage

Just use $0 for now, since I suck at naming things.

ignore all *.gz files

We generate them when publishing.

add preliminary INSTALL documentation

add MANIFEST for distribution

initial commit