make test
make install # root permissions may be needed
-Requirements (MUA client)
--------------------------
-* git
-* ssoma - http://ssoma.public-inbox.org/README
-* Perl and several modules:
- - Email::LocalDelivery
- - Email::Filter
- - Email::Simple
- - Digest::SHA
-
Requirements (server MDA)
-------------------------
* git
+* ssoma - http://ssoma.public-inbox.org/README
* SpamAssassin (spamc/spamd)
* MTA - postfix is recommended
-* ssoma - http://ssoma.public-inbox.org/README
-* Perl and several modules:
- - Email::Simple
- - File::FcntlLock
- - Digest::SHA
+* Perl and several modules: (Debian package name)
+ - CGI perl-modules[1]
+ - Date::Parse libtimedate-perl
+ - Email::Address libemail-address-perl
+ - Email::Filter libemail-filter-perl
+ - Email::MIME libemail-mime-perl
+ - Email::MIME::ContentType libemail-mime-contenttype-perl
+ - Encode::MIME::Header perl
+ - File::Path::Expand libfile-path-expand-perl
+ - IPC::Open2 perl
+ - IPC::Run libipc-run-perl
+ - URI::Escape liburi-perl
+ - XML::Atom::SimpleFeed libxml-atom-simplefeed-perl
+
+[1] - Only required for serving/generating Atom and HTML pages.
+ Keep in mind this will be split into a separate Debian package
+ when CGI.pm is dropped from the Perl standard library.
+ Plack/PSGI, FastCGI, and mod_perl2 will all be supported.
Copyright
---------
NAME => 'public-inbox',
VERSION => '0.0.0',
AUTHOR => 'Eric Wong <normalperson@yhbt.net>',
- ABSTRACT => 'public-inbox.org infrastructure',
+ ABSTRACT => 'public-inbox server infrastructure',
EXE_FILES => [qw/public-inbox-mda public-inbox-cgi/],
PREREQ_PM => {
# note: we use ssoma(1) and spamc(1),
'Encode::MIME::Header' => 0,
'XML::Atom::SimpleFeed' => 0,
'IPC::Open2' => 0,
+ 'IPC::Run' => 0,
'File::Path::Expand' => 0,
'CGI' => 0,
'URI::Escape' => 0,
content via SMTP to other mail servers used by readers of the mailing
list. For readers, this requires commitment to subscribe to the list
and extra effort to unsubscribe. New readers may also have difficulty
-following existing discussions if archives do not expose Message-Id
+following existing discussions if archives do not expose Message-ID
headers for responses. List server admins are also burdened with
occasional bounce messages.
_Anybody_ may also setup a delivery-only mailing list server to replay
a public-inbox git archive to subscribers via SMTP.
-[1] http://ssoma.public-inbox.org/
+[1] http://ssoma.public-inbox.org/README
Features
--------
-* anybody may participate by emailing the public address
-* stores email in git, so readers have a full history of the mailing list
+* anybody may participate via plain-text email to the public address
+* stores email in git, readers have a full archive of the mailing list
* Atom feed allows casual readers to follow via feed reader
* Mail user-agent (MUA) users may use Maildir, mbox(5) and/or IMAP locally
* uses only well-documented and easy-to-implement data formats
Requirements (participant)
--------------------------
-* ssoma - http://ssoma.public-inbox.org/
+* ssoma - http://ssoma.public-inbox.org/INSTALL
* any MUA which may send text-only emails ("git send-email" works!)
* participants do not need to install public-inbox, only server admins
-Requirements (server MDA)
--------------------------
-* git
-* MTA - postfix is recommended
-* Perl and several modules:
- - Email::Filter
- - XML::Atom::SimpleFeed
-* ssoma - http://ssoma.public-inbox.org/
-* SpamAssassin (optional, recommended)
-* CGI-capable HTTP server (optional, recommended for Atom feed and archives)
+Requirements (server)
+---------------------
+See INSTALL
Hacking
-------
We are happy to see feedback of all types via plain-text email.
public-inbox discussion is self-hosting on public-inbox.org
Please send comments, user/developer discussion, patches, bug reports,
-and pull requests to our public-inbox.org address at:
+and pull requests to our public-inbox address at:
bugs@public-inbox.org