README for MHonArc
                                 v2.6

                      <http://www.mhonarc.org/>

                       Copyright (C) 1995-2010
                   Earl Hood, mhonarc(AT)mhonarc.org

MHonArc is distributed under the GNU General Public License (GPL). The rules for using and copying MHonArc are explained in the file COPYING. If you cannot agree to the conditions of the GPL but still want to use/copy the program, you must contact the author of MHonArc, mhonarc(AT)mhonarc.org, about arranging an alternative license.

MHonArc is a Perl program for converting mail or news messages into HTML archives. It can also be used to convert individual messages into HTML documents. Other capabilities include robust MIME support and powerful user customization features.

  ACKNOWLG        Thanks to people
  BUGS            Bug history
  CHANGES         Revision history of MHonArc
  COPYING         GNU General Public License
  FILELIST        File listing used by install.me
  INSTALL         Instructions on how to install MHonArc
  README          The file you are reading
  RELNOTES        Release notes for MHonArc (PLEASE READ BEFORE INSTALL)
  TODO            TODO list for MHonArc development (probably not complete)
  contrib/        Contributed programs
  doc/            Documentation for MHonArc
  examples/       Example files for use with MHonArc
  extras/         Extra programs for use with MHonArc (See extras/README)
  install.me      Installation program for MHonArc
  lib/            MHonArc libraries
  logo/           MHonArc images
  mha-dbedit     Modify database without regenerating pages
  mha-dbrecover  Rebuild database from HTML message pages
  mha-decode     MIME message decoder
  mhonarc        The MHonArc program

Please read RELNOTES, or load doc/relnotes.html into your favorite web client, before installing MHonArc for any news about compatibility with previous versions and/or important usage information.

Read the file INSTALL, or load doc/install.html into your favorite web client, for instructions on how to install MHonArc.

Documentation for MHonArc is located in the doc/ directory. The main documentation for MHonArc is in multiple HTML files. Load index.html in the doc/ directory into your Web browser to get started.

A MHonArc mailing list exists to provide a general discussion forum for users and developers. The list is the main source for the latest news about MHonArc.

To subscribe to the mailing list, send mail to majordomo@mhonarc.org with the text,

subscribe mhonarc-users

as the message body.

More information about MHonArc mailing lists, include web-accessible archives, is provided in doc/contacts.html.

If you have any comments and suggestions about MHonArc, you may send mail to the MHonArc mailing list, <mailto:mhonarc-users@mhonarc.org>, or to the author at <mailto:mhonarc(AT)mhonarc.org> if you are not subscribed to the list.

NOTE: The author of MHonArc IS subscribed to the list so there

is no need to carbon-copy the author.

See doc/app-bugs.html for bug information and how to submit bug reports.

If you are so inclined, feel free to send the author a donation if you feel guilty on using a program that that cost you nothing, but some poor soul sweated over. The author is more than happy to provide address information to prospective donors inorder to ease their conscience. Plus, requests from donors are more likely to get more timely responses ;-) and help insure the continued development of the program.

The author can be reached at mhonarc(AT)mhonarc.org.