Update of /cvsroot/mhonarc/mhonarc/MHonArc/doc
In directory subversions:/tmp/cvs-serv32739/doc
Modified Files:
install.html mhonarc.html
Log Message:
* Change summary for 2.6.5.
* Update installation instruction to include RPM-based install.
Index: install.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/install.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -C2 -r1.20 -r1.21
*** install.html 10 Dec 2002 04:08:02 -0000 1.20
--- install.html 20 Jul 2003 03:27:49 -0000 1.21
***************
*** 36,41 ****
--- 36,43 ----
<ul>
<li><a href="#impatient">For the Impatient</a>
+ <li><a href="#vendors">Vendor Supplied Packages</a>
<li><a href="#sysreqs">System Requirements</a>
<li><a href="#download">Downloading MHonArc</a>
+ <li><a href="#rpminstall">RPM Installation</a>
<li><a href="#extraction">Extracting the MHonArc Distribution</a>
<li><a href="#installingviainstallme">Installing with <tt>install.me</tt></a>
***************
*** 60,72 ****
<h2><a name="impatient">For the Impatient</a></h2>
! <p>If you cannot wait to get going, try the following:
</p>
<table border="1" width="100%"><tr><td><pre class="shell">
! prompt> <b>wget 'http://www.mhonarc.org/release/MHonArc/MHonArc<var>X.X.X</var>'</b>
! prompt> <b>gzip -dc MHonArc<var>X.X.X</var> | tar xvf -</b>
! prompt> <b>cd MHonArc<var>X.X.X</var></b>
prompt> <b>perl install.me</b>
! </pre></td></tr></table>
! <p>where <tt><var>X.X.X</var></tt> represents the version number.</p>
<p>If there were problems doing the above, then keep reading.
--- 62,88 ----
<h2><a name="impatient">For the Impatient</a></h2>
! <p>If you cannot wait to get going, try one of the following:
</p>
+ <ul>
+
+ <li>Plaform independent install:
<table border="1" width="100%"><tr><td><pre class="shell">
! prompt> <b>wget 'http://www.mhonarc.org/release/MHonArc/MHonArc-<var>X.X.X</var>.tar.gz'</b>
! prompt> <b>gzip -dc MHonArc-<var>X.X.X</var>.tar.gz | tar xvf -</b>
! prompt> <b>cd MHonArc-<var>X.X.X</var></b>
prompt> <b>perl install.me</b>
! </pre></td></tr></table><br></li>
!
! <li>RPM install:
! <table border="1" width="100%"><tr><td><pre class="shell">
! prompt> <b>wget 'http://www.mhonarc.org/release/MHonArc/MHonArc-<var>X.X.X-n</var>.noarch.rpm'</b>
! prompt> <b>rpm -Uvh MHonArc-<var>X.X.X</var>-1.noarch.rpm</b>
! </pre></td></tr></table></li>
!
! </ul>
! <p>Where <tt><var>X.X.X</var></tt> represents the version number, and
! <tt><var>X.X.X-n</var></tt> represents the version and release number
! of the RPM. Generally, the release number is equal to '<tt>1</tt>'.
! </p>
<p>If there were problems doing the above, then keep reading.
***************
*** 75,78 ****
--- 91,156 ----
<!-- *************************************************************** -->
<hr>
+ <h2><a name="vendors">Vendor Supplied Packages</a></h2>
+
+ <p>Some software system vendors provide MHonArc, usually as an
+ optional package. The following links provide vendor-supplied
+ versions of MHonArc:
+ </p>
+
+ <dl>
+ <dt>Debian GNU/Linux</dt>
+ <dd><a href="http://packages.debian.org/mhonarc"
+ ><http://packages.debian.org/mhonarc></a>
+ </dd>
+ <dt>Linux (multiple vendors/distros)</dt>
+ <dd><a href="http://www.rpmfind.net/linux/rpm2html/search.php?query=MHonArc"
+ ><http://www.rpmfind.net/linux/rpm2html/search.php?query=MHonArc></a>
+ </dd>
+ </dl>
+
+ <table class="note" width="100%">
+ <tr valign="baseline">
+ <td><strong>NOTE:</strong></td>
+ <td width="100%"><p>Choosing to go with a vendor-supplied package
+ depends on your needs. Here are some things to consider:
+ </p>
+ <ul>
+ <li><p>Some vendors may have their own QA process
+ along with their own support services while others may provide
+ MHonArc as a contributed package with no additional support.
+ </p>
+ </li>
+ <li><p>Vendor/distro versions of MHonArc tend not to reflect the
+ latest release since there is a latency between a new release
+ made available from
+ <a href="http://www.mhonarc.org/">mhonarc.org</a>
+ to when vendors are able to download and
+ create their own packages. This difference can be important
+ depending on what MHonArc features or fixes you need.
+ </p>
+ </li>
+ </ul>
+ <p>In general, if your vendor provides their own QA and support
+ services for the software they provide, it is usually best to use
+ the vendor's version of MHonArc. However, if the vendor does not
+ provide additional support, and/or you need the latest features
+ and fixes, you may want go with what is provided from
+ <a href="http://www.mhonarc.org/">mhonarc.org</a>.
+ </p>
+ <p>If you require professional support and consulting,
+ see <a href="contacts.html#consulting"><cite>Contacts</cite></a> for
+ contact information.
+ </p>
+ </td>
+ </tr>
+ </table>
+
+ <p>This document does not cover any installation details for
+ vendor supplied packages. See your vendor's supplied documentation
+ for installation instructions.
+ </p>
+
+ <!-- *************************************************************** -->
+ <hr>
<h2><a name="sysreqs">System Requirements</a></h2>
***************
*** 129,138 ****
<A HREF="http://www.mhonarc.org/"
><http://www.mhonarc.org/></A>. The homepage
! list various sites that you can download MHonArc. If you are
! familiar with
! <a href="http://www.perl.com/CPAN/">Comprehensive Perl Archive Network
! (CPAN)</a>, MHonArc can be downloaded from
! <a href="http://www.perl.com/CPAN/authors/id/EHOOD/"
! ><http://www.perl.com/CPAN/authors/id/EHOOD/></a>.
</p>
--- 207,211 ----
<A HREF="http://www.mhonarc.org/"
><http://www.mhonarc.org/></A>. The homepage
! list various sites that you can download MHonArc.
</p>
***************
*** 140,156 ****
</p>
<ul>
! <li><b>tar-bz2</b>: <tt>MHonArc<var>X.X.X</var>.tar.bz2</tt>
</li>
! <li><b>tar-gzip</b>: <tt>MHonArc<var>X.X.X</var>.tar.gz</tt>
</li>
! <li><b>zip</b>: <tt>MHonArc<var>X.X.X</var>.zip</tt>
</li>
</ul>
! <p>where <tt><var>X.X.X</var></tt> represents the version number.
</p>
! <p>Alternate distribution formats for MHonArc may be available, like
! Linux RPM. Alternate distribution formats are not covered in this
document.
</p>
<!-- *************************************************************** -->
--- 213,327 ----
</p>
<ul>
! <li><b>RPM</b>: <tt>MHonArc-<var>X.X.X-n</var>.noarch.rpm</tt>
</li>
! <li><b>tar-bz2</b>: <tt>MHonArc-<var>X.X.X</var>.tar.bz2</tt>
</li>
! <li><b>tar-gzip</b>: <tt>MHonArc-<var>X.X.X</var>.tar.gz</tt>
! </li>
! <li><b>zip</b>: <tt>MHonArc-<var>X.X.X</var>.zip</tt>
</li>
</ul>
! <p>Where <tt><var>X.X.X</var></tt> represents the version number, and
! <tt><var>X.X.X-n</var></tt> represents the version and release number
! of the RPM. Generally, the release number is equal to '<tt>1</tt>'.
! Choose the format that best suits your environment.
</p>
!
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>
! Alternate distribution formats for MHonArc may be available from
! third-parties. Alternate distribution formats are not covered in this
document.
</p>
+ </td>
+ </tr>
+ </table>
+
+ <p>If you downloaded the RPM distribution, goto
+ <a href="#rpminstall"><cite>RPM Installation</cite></a>.
+ If you downloaded one of the other formats, goto
+ <a href="#extraction"><cite>Extracting the MHonArc Distribution</cite></a>.
+ </p>
+
+ <!-- *************************************************************** -->
+ <hr>
+ <h2><a name="rpminstall">RPM Installation</a></h2>
+
+ <p><a href="http://www.rpm.org/">RPM</a> is a widely used software
+ package manager for various Linux-based systems and sometimes used
+ for other Unix-based environments. If the software on your system is
+ managed by RPM, you may prefer to install MHonArc via RPM:
+ </p>
+
+ <table border="1" width="100%"><tr><td><pre class="shell">
+ prompt> <b>rpm -Uvh MHonArc-<var>X.X.X-n</var>.noarch.rpm</b>
+ </pre></td></tr></table>
+
+ <p> </p>
+
+ <table class="note" width="100%">
+ <tr valign="baseline">
+ <td><strong>NOTE:</strong></td>
+ <td width="100%"><p>RPM-based installation requires that the perl
+ executable is located at <tt>/usr/bin/perl</tt>.
+ </p>
+ </td>
+ </tr>
+ </table>
+
+ <p>MHonArc files will be installed in the following locations:
+ </p>
+
+ <table>
+ <tr valign="baseline">
+ <td><tt>/usr/bin</tt>: </td>
+ <td>Program files: <tt>mhonarc</tt>, <tt>mha-dbedit</tt>, ...
+ </td>
+ </tr>
+ <tr valign="baseline">
+ <td><tt>/usr/lib/MHonArc</tt>: </td>
+ <td>Library files.
+ </td>
+ </tr>
+ <tr valign="baseline">
+ <td><tt>/usr/share/doc/MHonArc-<var>X.X.X</var></tt>: </td>
+ <td>Documentation, examples, and extras.
+ </td>
+ </tr>
+ <tr valign="baseline">
+ <td><tt>/usr/share/man/man1</var></tt>: </td>
+ <td>Manpages.
+ </td>
+ </tr>
+ </table>
+
+ <p>It is highly likely that you will need to have root priviledges
+ to install via RPM. If you do not have root access, or you want
+ to install in a non-standard location, you will need to
+ <a href="#extraction">install MHonArc from the non-RPM bundles</a>.
+ </p>
+
+ <p>Once the install is completed, you can skip to
+ <a href="#postinstall"><cite>Post Installation Configuration</cite></a>.
+ </p>
+
+ <table class="note" width="100%">
+ <tr valign="baseline">
+ <td><strong>NOTE:</strong></td>
+ <td width="100%"><p>RPM distributions have been directly
+ available starting with MHonArc v2.6.5. However, alternate RPM packages
+ are available for current and older versions via
+ third parties and some Linux distros. Goto
+ <a href="http://www.rpmfind.net/linux/rpm2html/search.php?query=MHonArc"
+ ><http://www.rpmfind.net/linux/rpm2html/search.php?query=MHonArc></a> to
+ get a list of third-party RPM bundles.
+ </p>
+ </td>
+ </tr>
+ </table>
+
+ <p> </p>
<!-- *************************************************************** -->
***************
*** 158,177 ****
<h2><a name="extraction">Extracting the MHonArc Distribution</a></h2>
! <p>After downloading MHonArc, it is best to move the file to a
! temporary location for extraction. To extract the distribution
! under Unix-like systems, use one of the following commands based upon the
! distribution format you downloaded:
</p>
<dl>
<dt><b>tar-bz2</b></dt>
<dd><table border=1 width="100%"><tr><td><pre class="shell">
! prompt> <b>bzip2 -dc MHonArc<var>X.X.X</var>.tar.bz2 | tar xvf -</b></pre></td></tr></table>
<dt><b>tar-gzip</b></dt>
<dd><table border=1 width="100%"><tr><td><pre class="shell">
! prompt> <b>gzip -dc MHonArc<var>X.X.X</var>.tar.gz | tar xvf -</b></pre></td></tr></table>
</dd>
<dt><b>zip</b></dt>
<dd><table border=1 width="100%"><tr><td><pre class="shell">
! prompt> <b>unzip MHonArc<var>X.X.X</var>.zip</b></pre></td></tr></table>
</dd>
</dl>
--- 329,359 ----
<h2><a name="extraction">Extracting the MHonArc Distribution</a></h2>
! <table class="note" width="100%">
! <tr valign="baseline">
! <td><strong>NOTE:</strong></td>
! <td width="100%"><p>If doing an RPM-based install, goto
! <a href="#rpminstall"><cite>RPM Installation</cite></a> above.
! </p>
! </td>
! </tr>
! </table>
!
! <p>After downloading the MHonArc distribution, it is best to move
! the file to a temporary location for extraction. To extract the
! distribution under Unix-like systems, use one of the following commands
! based upon the distribution format you downloaded:
</p>
+
<dl>
<dt><b>tar-bz2</b></dt>
<dd><table border=1 width="100%"><tr><td><pre class="shell">
! prompt> <b>bzip2 -dc MHonArc-<var>X.X.X</var>.tar.bz2 | tar xvf -</b></pre></td></tr></table>
<dt><b>tar-gzip</b></dt>
<dd><table border=1 width="100%"><tr><td><pre class="shell">
! prompt> <b>gzip -dc MHonArc-<var>X.X.X</var>.tar.gz | tar xvf -</b></pre></td></tr></table>
</dd>
<dt><b>zip</b></dt>
<dd><table border=1 width="100%"><tr><td><pre class="shell">
! prompt> <b>unzip MHonArc-<var>X.X.X</var>.zip</b></pre></td></tr></table>
</dd>
</dl>
***************
*** 195,199 ****
</table>
! <p>After extraction, the subdirectory <tt>MHonArc<var>X.X.X</var></tt> will
have been created containing all the files comprising MHonArc.
</p>
--- 377,381 ----
</table>
! <p>After extraction, the subdirectory <tt>MHonArc-<var>X.X.X</var></tt> will
have been created containing all the files comprising MHonArc.
</p>
***************
*** 208,217 ****
</tr>
</table>
! <p>Now, change your current directory to <tt>MHonArc<var>X.X.X</var></tt>
for the <a href="#installingfiles">next step</a>. On a Unix-type
system, the following command will do it:
</p>
<table border=1 width="100%"><tr><td><pre class="shell">
! prompt> <b>cd MHonArc<var>X.X.X</var></b>
</pre></td></tr></table>
--- 390,399 ----
</tr>
</table>
! <p>Now, change your current directory to <tt>MHonArc-<var>X.X.X</var></tt>
for the <a href="#installingfiles">next step</a>. On a Unix-type
system, the following command will do it:
</p>
<table border=1 width="100%"><tr><td><pre class="shell">
! prompt> <b>cd MHonArc-<var>X.X.X</var></b>
</pre></td></tr></table>
***************
*** 574,578 ****
<img align="top" src="monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
! Copyright © 1997-2002, <a href="http://www.mhonarc.org/~ehood/"
>Earl Hood</a>, <a href="mailto:mhonarc(_at_)mhonarc(_dot_)org"
>mhonarc(_at_)mhonarc(_dot_)org</a><br>
--- 756,760 ----
<img align="top" src="monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
! Copyright © 1997-2003, <a href="http://www.mhonarc.org/~ehood/"
>Earl Hood</a>, <a href="mailto:mhonarc(_at_)mhonarc(_dot_)org"
>mhonarc(_at_)mhonarc(_dot_)org</a><br>
Index: mhonarc.html
===================================================================
RCS file: /cvsroot/mhonarc/mhonarc/MHonArc/doc/mhonarc.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -C2 -r1.25 -r1.26
*** mhonarc.html 23 Feb 2003 00:12:07 -0000 1.25
--- mhonarc.html 20 Jul 2003 03:27:49 -0000 1.26
***************
*** 45,50 ****
--- 45,52 ----
<ul>
<li><a name="impatient" href="install.html#impatient">For the Impatient</a></li>
+ <li><a name="vendors" href="install.html#vendors">Vendor Supplied Packages</a></li>
<li><a name="sysreqs" href="install.html#sysreqs">System Requirements</a></li>
<li><a name="download" href="install.html#download">Downloading MHonArc</a></li>
+ <li><a name="rpminstall" href="install.html#rpminstall">RPM Installation</a></li>
<li><a name="extraction" href="install.html#extraction">Extracting the MHonArc Distribution</a></li>
<li><a name="installingviainstallme" href="install.html#installingviainstallme">Installing with <tt>install.me</tt></a></li>
---------------------------------------------------------------------
To sign-off this list, send email to majordomo(_at_)mhonarc(_dot_)org with the
message text UNSUBSCRIBE MHONARC-DEV