---------------------------------------------------------------------------
                            README for MHonArc
                                 v2.3.0

             http://www.oac.uci.edu/indiv/ehood/mhonarc.html

			 Copyright (C) 1995-1998
		       Earl Hood, earlhood@usa.net

---------------------------------------------------------------------------
USING/COPYING

    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 may contact
    earlhood@usa.net about arranging an alternative license.

---------------------------------------------------------------------------
CONTENTS

ACKNOWLG        Thanks to people
BUGS            Bug list
CHANGES         Revision history of MHonArc
COPYING         GNU General Public License
INSTALL         Instructions on how to install MHonArc
README          The file you are reading
RELNOTES        Release notes for MHonArc (please read)
bat/            Batch files for MS-DOS users
doc/            Documentation for MHonArc
examples/       Example resource files for MHonArc
extras/         Extra programs for use with MHonArc (See extras/README)
faq/            FAQ for MHonArc
install.cfg     Base installation configuration file
install.me      Installation program for MHonArc
lib/            Libraries/MIME filters used by MHonArc
logo/           Gifs of the MHonArc logo
mha-dbedit*	Modify database without regenerating pages
mha-dbrecover*	Rebuild database from HTML message pages
mhonarc*        The MHonArc program

---------------------------------------------------------------------------
	*IMPORTANT* *IMPORTANT* *IMPORTANT* *IMPORTANT* *IMPORTANT*

		Please read the RELNOTES file for important
		 information if you are upgrading from
                           a pre-v2.2 release.

---------------------------------------------------------------------------
INSTALLATION

    Read the file INSTALL for instructions on how to install MHonArc.

---------------------------------------------------------------------------
DOCUMENTATION

    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.

    Filenames of the documentation do NOT follow the 8.3 convention.
    Therefore, you will need a filesystem that supports long names
    to read the documentation locally.

    Some tables are used in the documentation.  Therefore, having
    a table-capable viewer is beneficial, but not essential.

---------------------------------------------------------------------------
MAILING LIST

    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
    mhonarc-request@ncsa.uiuc.edu with the single word "subscribe"
    (without the quotes) as the message body.

    Mail sent to mhonarc@ncsa.uiuc.edu will be distributed to all
    subscribers.

    The list is restricted to subscribers only.  Messages sent to the
    list by non-subscribers are manually screened before distribution;
    which may incur a significant delay before the message is actually
    seen be subscribers.  Any spam messages are happily redirected
    to /dev/null.

    The WWW archive of the mailing list is located at
    <URL:http://www.xray.mpe.mpg.de/mailing-lists/mhonarc/> and is
    searchable via a Glimpse search engine.

---------------------------------------------------------------------------
BUGS/COMMENTS/SUGGESTIONS?

    If you have any bugs/comments/suggestions about MHonArc, you may
    send mail to the MHonArc mailing list,
    <URL:mailto:mhonarc@ncsa.uiuc.edu>.

    NOTE: The author of MHonArc *is* subscribed to the list.

    If it is a bug you are reporting, please include the following in
    your message:

        o  Version of Perl (can be retrievied by "perl -v").
        o  Version of the program (can be retrievied by "mhonarc -v").
	o  The operating system you are using (on Unix the output
	   of "uname -a" is useful).
        o  The exact command-line used to invoke the program.
        o  Error/diagnostic messages from the program.
        o  Any other information that might prove useful (eg. input
           files, resource files, environment settings, etc).

    Before sending e-mail, make sure the documentation, or FAQ, does
    not already have an answer to your question/problem.  Also, check
    the MHonArc home page to see if you have the latest version of
    MHonArc.

---------------------------------------------------------------------------

    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 donars are more likely
    to get more timely responses ;-) and help insure the continued
    development of the program.

---------------------------------------------------------------------------
Copyright (C) 1995-1998,		Earl Hood, earlhood@usa.net
@(#) README 98/10/10 17:36:36
