Make some basic improvements to our mailing list archives user interface.
(This is the "low-hanging fruit" part of bug #375557.)

Summary:
--------

  When we switched to MHonArc for mailing list archives, the archive
  pages became very Web 1.0, looking unlike the rest of Launchpad and
  having various usability problems: all the messages in chronological
  order on one page (should be reverse-chronological and multi-page),
  no indication of what team the mailing list is for, etc.

  This branch just brings us back to roughly where we were with
  Pipermail on lists.canonical.com / lists.ubuntu.com.  It does not
  address everything in bug #375557 (which describes many further
  improvements we could make to our mailing list archives).

  This branch makes the following changes to the mailing list archives:

    - Use multi-page indexes, so large archives don't swamp browsers.
    - Sort messages in reverse chronological order.
    - Show the date next to each message on an index page.
    - Show the mailing list's name, and link back to the team.
    - Give pages a white background, instead of browser-default-gray.
    - Put Launchpad logo in upper left corner.

Proposed fix:
-------------

  Create a Launchpad-wide MHonArc control file, to customize the
  appearance of mailing list archive pages (both the indexes and the
  individual messages).  Discussed with Barry and Kiko.

Pre-implementation notes:
-------------------------

  Barry and I talked a lot.  I don't think any issues came up that
  need mentioning here.  We knew we were aiming for the low-hanging
  fruit, and that's what we got.

Implementation details:
-----------------------

  Code changes:

  * lib/canonical/launchpad/mailman/monkeypatches/lp-mhonarc-common.mrc:
    New rc file, controls MHonArc behavior.

  * lib/canonical/launchpad/mailman/monkeypatches/__init__.py
    (monkey_patch): Add flags to PUBLIC_EXTERNAL_ARCHIVER to define the
    mailing list name and point MHonArc to the common rc file. Copy the
    rc file to the correct location.

  Along the way, I discovered that we were not really set up for testing
  changes to "lists.launchpad.dev", and made two branches to fix that:

    https://code.edge.launchpad.net/~kfogel/launchpad/lists-in-hosts
    https://code.edge.launchpad.net/~kfogel/launchpad/lists-testable

  The first has passed EC2 tests and been submitted to PQM.  The
  second is (in theory) done, but not yet tested.

Tests:
------

  Er, see "Demo and Q/A".

Demo and Q/A:
-------------

  * Start launchpad.dev with 'make run_all'.

  * Log in to launchpad.dev as "<email address hidden>" (this test user
    should already exist, and have the appropriate administrative
    privileges).

  * Create a new team 'mltest'.

  * Create a mailing list for that team.

  * Approve the mailing list (at http://launchpad.dev/+mailinglists).

  * Inject the sample data, which you get from here:

    http://launchpadlibrarian.net/26091302/lp-ml-test-data.tar.gz

    Untar it, cd into the resultant lp-ml-test-data/ directory, and
    run "./inject.sh" (while launchpad.dev is running, of course).

    There are 999 messages in the data.  They're originally from the
    Emacs Devel mailing list archive, but although I've left the names
    the same, the sender ("From:") addresses have all been replaced
    with <email address hidden>, so they will successfully load into
    a list whose only owner/subscriber is <email address hidden>.

    If you have any problems loading the messages, try:

      ls -lR /var/tmp/mailman/qfiles    (it should be empty)
      tail -f /var/tmp/mailman/logs/*

  * Visit the archive: http://lists.launchpad.dev/mltest/maillist.html

    You should see the first of five index pages there.  Click on the
    "go to Thread Index" link to make sure the thread index is working
    too (http://lists.launchpad.dev/mltest/threads.html).

lint:
-----

  This is the entire output of 'make lint':

    | = Launchpad lint =
    | 
    | Checking for conflicts. and issues in doctests and templates.
    | Running jslint, xmllint, pyflakes, and pylint.
    | Using normal rules.
    | 
    | Linting changed files:
    |   lib/canonical/launchpad/mailman/monkeypatches/lp-mhonarc-common.mrc

  Looks clean to me :-).

diff:
-----

{{{
=== modified file 'lib/canonical/launchpad/mailman/monkeypatches/__init__.py'
--- lib/canonical/launchpad/mailman/monkeypatches/__init__.py	2009-04-20 19:03:39 +0000
+++ lib/canonical/launchpad/mailman/monkeypatches/__init__.py	2009-04-28 21:41:34 +0000
@@ -91,6 +91,8 @@
 -add \
 -dbfile %(var_dir)s/archives/private/%%(listname)s.mbox/mhonarc.db \
 -outdir %(var_dir)s/mhonarc/%%(listname)s \
+-definevar ML-NAME=%%(listname)s \
+-rcfile %(var_dir)s/data/lp-mhonarc-common.mrc \
 -stderr %(var_dir)s/logs/mhonarc \
 -stdout %(var_dir)s/logs/mhonarc \
 -spammode \
@@ -150,8 +152,13 @@
             print >> handler_file, 'from', module, 'import *'
         finally:
             handler_file.close()
+
+    here = os.path.dirname(__file__)
+    # Install the MHonArc control file.
+    mhonarc_rc_file = os.path.join(here, 'lp-mhonarc-common.mrc')
+    runtime_data_dir = os.path.join(config.mailman.build_var_dir, 'data')
+    shutil.copy(mhonarc_rc_file, runtime_data_dir)
     # Install the launchpad site templates.
-    here = os.path.dirname(__file__)
     launchpad_template_path = os.path.join(here, 'sitetemplates')
     site_template_path = os.path.join(mailman_path, 'templates', 'site')
     if os.path.isdir(site_template_path):

=== added file 'lib/canonical/launchpad/mailman/monkeypatches/lp-mhonarc-common.mrc'
--- lib/canonical/launchpad/mailman/monkeypatches/lp-mhonarc-common.mrc	1970-01-01 00:00:00 +0000
+++ lib/canonical/launchpad/mailman/monkeypatches/lp-mhonarc-common.mrc	2009-04-28 21:21:47 +0000
@@ -0,0 +1,183 @@
+<!-- Launchpad customizations common to all our MHonArc-generated
+     mailing list archives.
+
+     See http://www.mhonarc.org/MHonArc/doc/mhonarc.html and
+     http://www.mhonarc.org/MHonArc/doc/faq/, they are your friends.
+
+     http://www.mhonarc.org/MHonArc/doc/resources.html#index is
+     especially your friend, when all others have abandoned you.  -->
+
+<!-- Basic parameters. -->
+<MAIN>
+<THREAD>
+<SORT>
+<REVERSE>
+<TREVERSE>
+<NODOC>
+
+<!-- Use multi-page indexes.
+     See http://www.mhonarc.org/MHonArc/doc/resources/multipg.html -->
+<MULTIPG>
+<IDXSIZE>
+200
+</IDXSIZE>
+
+<!-- Define a custom resource variable to represent this mailing list.
+     This depends on $ML-NAME$ having been set already, presumably on
+     the command line via '-definevar'.  See 
+     http://www.mhonarc.org/MHonArc/doc/resources/definevar.html. -->
+<DefineVar>
+ML-FULL-TITLE
+<a href="http://launchpad.net/~$ML-NAME$">$ML-NAME$</a> mailing list archive
+</DefineVar>
+
+<IDXLABEL>
+Date Index
+</IDXLABEL>
+
+<TIDXLABEL>
+Thread Index
+</TIDXLABEL>
+
+<!-- What do the next/prev links look like? -->
+<PREVPGLINK>
+<a href="$PG(FIRST)$">&larr;First</a>&nbsp;&nbsp;&nbsp;<a href="$PG(PREV)$">&larr;Prev</a>
+</PREVPGLINK>
+<PREVPGLINKIA>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+</PREVPGLINKIA>
+<TPREVPGLINK>
+<a href="$PG(TFIRST)$">&larr;First</a>&nbsp;&nbsp;&nbsp;<a href="$PG(TPREV)$">&larr;Prev</a>
+</TPREVPGLINK>
+<TPREVPGLINKIA>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+</TPREVPGLINKIA>
+<NEXTPGLINK>
+<a href="$PG(NEXT)$">Next&rarr;</a>&nbsp;&nbsp;&nbsp;<a href="$PG(LAST)$">Last&rarr;</a>
+</NEXTPGLINK>
+<NEXTPGLINKIA>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+</NEXTPGLINKIA>
+<TNEXTPGLINK>
+<a href="$PG(TNEXT)$">Next&rarr;</a>&nbsp;&nbsp;&nbsp;<a href="$PG(TLAST)$">Last&rarr;</a>
+</TNEXTPGLINK>
+<TNEXTPGLINKIA>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+</TNEXTPGLINKIA>
+
+<!-- Formatting for the start of list page.
+     See http://www.mhonarc.org/MHonArc/doc/resources/listbegin.html. -->
+<LISTBEGIN>
+<p>(<a href="$TIDXFNAME$">go to $TIDXLABEL$</a>)</p>
+<hr/>
+<div style="text-align: left;">$PGLINK(PREV)$&nbsp;&nbsp;&nbsp;$PGLINK(NEXT)$</div>
+<div style="text-align: center;">$PGLINKLIST(5;5)$</div>
+<ul>
+</LISTBEGIN>
+
+<LISTEND>
+</ul>
+<div style="text-align: center;">$PGLINKLIST(5;5)$</div>
+<div style="text-align: left;">$PGLINK(PREV)$&nbsp;&nbsp;&nbsp;$PGLINK(NEXT)$</div>
+</LISTEND>
+
+<!-- Formatting for the start of thread page.
+     See http://www.mhonarc.org/MHonArc/doc/resources/thead.html. -->
+<THEAD>
+<p>(<a href="$IDXFNAME$">go to $IDXLABEL$</a>)</p>
+<hr/>
+<div style="text-align: left;">$PGLINK(TPREV)$&nbsp;&nbsp;&nbsp;$PGLINK(TNEXT)$</div>
+<div style="text-align: center;">$PGLINKLIST(T5;T5)$</div>
+<ul>
+</THEAD>
+
+<TFOOT>
+</ul>
+<div style="text-align: center;">$PGLINKLIST(T5;T5)$</div>
+<div style="text-align: left;">$PGLINK(TPREV)$&nbsp;&nbsp;&nbsp;$PGLINK(TNEXT)$</div>
+</TFOOT>
+
+<!-- Per-message formatting on the indexed-by-date main page. -->
+<LITEMPLATE>
+<li><strong>$SUBJECT$</strong>
+<ul><li><em>From</em>: $FROM$,&nbsp;<em>$YYYYMMDD$</em></li></ul>
+</li>
+</LITEMPLATE>
+
+<!-- Per-message formatting on the thread page. -->
+<TTOPBEGIN>
+<li><strong>$SUBJECT$</strong>,
+<em>$FROMNAME$, $YYYYMMDD$</em>
+</TTOPBEGIN>
+<TLITXT>
+<li><strong>$SUBJECT$</strong>,
+<em>$FROMNAME$, $YYYYMMDD$</em>
+</TLITXT>
+<TSINGLETXT>
+<li><strong>$SUBJECT$</strong>,
+<em>$FROMNAME$, $YYYYMMDD$</em>
+</TSINGLETXT>
+
+<!-- Modify appropriate resources to print our link at the bottom
+     of MHonArc generated pages. Notice how the custom resource
+     variable defined above can be used to include our link. -->
+
+<!-- Main index pages -->
+<IDXPGBEGIN>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+        "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<title>$ML-NAME$ mailing list (by date)</title>
+</head>
+<body text="#000000" bgcolor="#FFFFFF">
+<p><a href="http://launchpad.net/"><img border="0" src="http://launchpad.net/@@/launchpad-logo-and-name.png" alt="Launchpad logo and name."/></a></p>
+<h1><center>$ML-FULL-TITLE$ (by date)</center></h1>
+</IDXPGBEGIN>
+
+<IDXPGEND>
+<hr/>
+(<em>$ML-FULL-TITLE$, formatted by <a href="$DOCURL$">MHonArc</a>)
+</body>
+</html>
+</IDXPGEND>
+
+<!-- Thread index pages -->
+<TIDXPGBEGIN>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+        "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<title>$ML-NAME$ mailing list (by thread)</title>
+</head>
+<body text="#000000" bgcolor="#FFFFFF">
+<p><a href="http://launchpad.net/"><img border="0" src="http://launchpad.net/@@/launchpad-logo-and-name.png" alt="Launchpad logo and name."/></a></p>
+<h1><center>$ML-FULL-TITLE$ (by thread)</center></h1>
+</TIDXPGBEGIN>
+
+<TIDXPGEND>
+<hr/>
+(<em>$ML-FULL-TITLE$, formatted by <a href="$DOCURL$">MHonArc</a>)
+</body>
+</html>
+</TIDXPGEND>
+
+<!-- Message pages -->
+<MSGPGBEGIN>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+        "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<title>$SUBJECTNA$</title>
+<link rev="made" href="mailto:$FROMADDR$">
+</head>
+<body text="#000000" bgcolor="#FFFFFF">
+<p><a href="http://launchpad.net/"><img border="0" src="http://launchpad.net/@@/launchpad-logo-and-name.png" alt="Launchpad logo and name."/></a></p>
+</MSGPGBEGIN>
+
+<MSGPGEND>
+<hr/>
+(<em>$ML-FULL-TITLE$, formatted by <a href="$DOCURL$">MHonArc</a>)
+</body>
+</html>
+</MSGPGEND>

}}}