                                             Hypermail
                                          ===============

Quote from source of Hypermail
------------------------------

Hypermail is a program that takes a file of mail messages in UNIX mailbox format and
generates a set of cross-referenced HTML documents. Each file that is created represents a
separate message in the mail archive and contains links to other articles, so that the entire archive
can be browsed in a number of ways by following links. Archives generated by Hypermail can be
incrementally updated, and Hypermail is set by default to only update archives when changes are
detected. 

Each HTML file that is generated for a message contains (where applicable): 

      the subject of the article, 
      the name and email address of the sender, 
      the date the article was sent, 
      links to the next and previous messages in the archive, 
      a link to the message the article is in reply to, and 
      a link to the message next in the current thread. 


In addition, Hypermail will convert references in each message to email addresses and URLs to
hyperlinks so they can be selected. Email addresses can be converted to mailto: URLs or links
to a CGI mail program. Note that not all World-Wide Web browsers support the mailto: URL
yet. 

To complement each set of HTML messages, four index files are created which sort the articles
by date received, thread, subject, and author. Each entry in these index files are links to the
individual articles and provide a bird's-eye view of every archived message. 

Hypermail was originally developed and designed by Tom Gruber for Enterprise Integration
Technologies (EIT) in Common Lisp. It was later rewritten in C by Kevin Hughes at EIT. 


The command line is:

hyper [-u] [-p] [-i] [-x] [-r] [ -m mbox ] [ -l subject ] [ -d dir ]
         [ -a URL ] [ -b URL ] [ -c file ]

options: -u : Update archive by one article
         -p : Show progress
         -i : Read messages from standard input
         -x : Overwrite previous messages
         -r : Show replies in output files
         -m : Mail archive to read in
         -l : Subject label for the output archive
         -d : The directory to save HTML files in
         -a : URL to other archives
         -b : URL to archive information
         -c : Configuration file to read in
         -o : Use



For one file from stdin, the command line should be:

hyper -d <archive_directory> -u -l <archive_label> -o -i

For one message from a mailbox, the command line should be:

hyper -d <archive_directory> -u -l <archive_label> -o -m <mailbox>

For many messages in a mailbox, the command line should be:

hyper -d <archive_directory> -u -l <archive_label> -m <mailbox>


At Internet Shopper, we took a copy of the source provided, modified it for use
as an executable with NTMail.  To use hypermail, you should setup a mail box
with the following definition:

    Rhypermail d:\mail\hypermail.exe -ui -o -d d:\www\dir\for\html\pages -l "subject"

If you give this the same name as a list, then Hypermail will automatically
index all responses sent to the list.  We have two examples of archives created
by Hypermail:
	http://www.net-shopper.co.uk/software/ntmail/discuss/index.htm
	http://www.net-shopper.co.uk/software/ntmail/robot/index.htm




                           Hypermail License Agreement
                         -------------------------------

(license rev. 7/11/95) 
Copyright 1994 Enterprise Integration Technologies Corporation 




Enterprise Integration Technologies Corporation (EIT) grants to the possessor of
this copy (the Licensee) a royalty-free, nonexclusive license to use, copy, modify
and distribute both the binary and source code of Hypermail and any related
documentation (the Software) for personal, academic, research and internal
commercial use (as defined in Section 6) only and subject to the following
conditions: 

   1.By using or copying the Software, Licensee agree to abide by the terms of
     this Agreement. 

   2.Title and copyright to the Software remain with EIT and Licensee agrees
     to preserve the same. 

   3.Licensee acknowledges that the Software is still in the development stage
     and that it is being supplied "as is", without any accompanying services
     from EIT. EIT MAKES NO REPRESENTATIONS OR
     WARRANTIES, EXPRESS OR IMPLIED. By way of example, but not
     limitation, EIT MAKES NO REPRESENTATIONS OR
     WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY
     PARTICULAR PURPOSE OR THAT THE USE THE SOFTWARE
     WILL NOT INFRINGE ON ANY PATENTS OR OTHER RIGHTS.
     EIT shall not be held liable for any liability nor for any direct, indirect or
     consequential damages with respect to any claim by Licensee or any third
     party with respect to this Agreement or any use of the Software. 

   4.Licensee may distribute the Software or any derivative work based on the
     Software to third parties provided (1) all copyright notices and this
     Agreement appear on all copies, and (2) no charge is associated with such
     copies. Unless Licensee labels the derivative work with the notice "No
     Grantback", Licensee agrees to grant EIT a royalty-free nonexclusive
     license to use, copy, modify and distribute any modifications to the
     Software owned by Licensee and distributed to third parties as a
     derivative work under this Agreement. 

   5.If Licensee distributes a derivative work, then Licensee also agrees to (1)
     notify EIT of the distribution, and (2) clearly notify users that such
     derivative work is a modified version and not the original EIT Software. 

   6.This license permits internal commercial use of the Software by Licensee.
     Internal commercial use means use by employees, contractors and others
     affiliated with Licensee under the direction of and for the benefit of the
     Licensee. Internal Use may also include initiating or responding
     electronically to requests from a third party whether or not the Licensee or
     third party is paying a fee for being a party to such communications.
     Commercial distribution is not permitted under this license. Any Licensee
     wishing to make a commercial distribution of the Software should contact
     EIT to negotiate an appropriate license. Commercial distribution includes
     (i) integration of all or part of the source code into a product for sale or
     license by or on behalf of Licensee to third parties, or (ii) distribution of the
     binary or source code to third parties that need it to utilize a commercial
     product sold or licensed by or on behalf of Licensee or (iii) any lease or
     rental of the Software to third parties. 

   7.Licensee agrees to abide by all applicable laws of the United States,
     including, but not limited to, copyright and export control laws. 

EIT has the right to terminate this license immediately by written notice upon
Licensee's breach of, or non-compliance with any of its terms. Licensee may be
held legally responsible for any copyright infringement that is caused or
encouraged by licensee's failure to abide by the terms of this license. 

Last updated 7/28/94. This license is included with the source code. 
