--------------------------------------------------------------------------- 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 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, . 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