[Prev][Next][TOC][FAQ][Bugs][Home]


Installation

The following section describes how to install MHonArc on your system.


System Requirements

The following is required inorder to use MHonArc:


Downloading MHonArc

The homepage for MHonArc is <http://www.pobox.com/~ehood/mhonarc.html>. The homepage list various sites that you can download MHonArc. If you are familiar with Comprehensive Perl Archive Network (CPAN), MHonArc can be downloaded from <http://www.perl.com/CPAN/authors/id/EHOOD/>.

MHonArc is distributed in either a tar/gzip file or a zip file. The tar/gzip file will have a name like MHonArc2.4.0.tar.gz, and the zip file have a name like MHonArc2.4.0.zip.

NOTE

The version number included in the filename may differ from what is listed here. Hopefully, the version number shown in the copy you have is equal, or greater, to the one used here in this document. If the version number you have is older, please download a newer release.

Alternate distribution formats for MHonArc may be available, like Linux RPM. Alternate distribution formats are not covered in this document.


Extracting the MHonArc Distribution

After downloading MHonArc, it is best to move the file to a temporary location for extraction. To extract a tar/gzip distribution, use the following command:

    shell> gzip -dc MHonArc2.4.0.tar.gz | tar xvf -

To extract the zip distribution, you can use a program like WinZip, or any other program that supports zip archives. When extracting, make sure to preserve the directory structure.

NOTE

WinZip does support tar/gzip files.

After extraction, the subdirectory MHonArc2.4.0 will have been created (remember, the version number shown here may differ from what you have) containing all the files comprising MHonArc.

IMPORTANT

Please read the file RELNOTES included in the MHonArc distribution before continuing for any news about compatibility with previous versions and/or important usage information.

You will now want to change your current directory to MHonArc2.4.0 for the next step.


Installing with install.me

Provided in the MHonArc distribution is a Perl program, install.me that will install MHonArc on your system. To run the program, type the following at your shell prompt:

    shell> perl install.me
IMPORTANT

You must be in the same directory as the install.me program when you run it.

The installation program will ask you a series of questions on where the perl executable is and where to put MHonArc files. Just hit <CR> to accept the default values listed in ()'s. Note, the default values are determined by the configuration of perl on your system. If you choose the defaults, you may need to have root/admin privileges to have a successful install.

install.me can take several options on the command-line to affect what is done during installation. The following is the list of options available:

  -batch                : Run in batch mode (do not ask questions)
  -binpath <path>       : Directory path to install programs/scripts
  -docpath <path>       : Directory path to install documentation
  -help                 : A message summarizing options available
  -libpath <path>       : Directory path to install library files
  -filelist <file>      : List of files to install (def="FILELIST")
  -manpath <path>       : Directory path to manpages
  -nobin                : Do not install programs
  -nodoc                : Do not install documentation
  -nolib                : Do not install library files
  -noman                : Do not install manpages
  -perl <pathname>      : Pathname of perl interpreter
  -prefix <path>        : Set prefix for installation directories

For example, if you do not want to install the documentation, do the following:

    shell> perl install.me -nodoc

Later on, if you decide you want to install the documentation, but not re-install the other files, do the following:

    shell> perl install.me -nobin -nolib -noman

If you want to install files relative to your home directory, do the following:

    shell> perl install.me -prefix $HOME

install.me Notes


The Perl 5 Way

Of course, you can install MHonArc the standard way under Perl 5:

    shell> perl Makefile.PL
    shell> make
    shell> make install

If you want to install in a specific directory, try:

    shell> perl Makefile.PL PREFIX=/tmp/myperl5
    shell> make
    shell> make install
NOTE

install.me is actually called "behind the scenes" to install the files.


Win32 Notes


Alternate Operating Systems

In many cases, the install.me program will work for other operating systems. Please contact the author on any success stories for other operating systems, and please send any patches, if required.


Manual Installation

If install.me will not work properly for your system, here are the steps to install MHonArc manually:


Resource File Editing

If you are a Vim user, <http://www.vim.org/>, a syntax file for MHonArc resource files is included in the examples directory (mhonarc.vim). Vim is known to run on a variety of operating systems, and is free software.

To use mhonarc.vim, copy mhonarc.vim to an appropriate location and add something like the following to your .vimrc file:

au BufNewFile,BufRead *.mrc	so $HOME/share/vim/syntax/mhonarc.vim

Of course, change the pathname to mhonarc.vim to wherever you copied it to.

Now, any file with .mrc extension will put Vim into MHonArc resource file highlighting mode. The mode is best used with color-capable terminals.


[Prev][Next][TOC][FAQ][Bugs][Home]


99/07/25 02:17:33
MHonArc
Copyright © 1997-1999, Earl Hood, mhonarc@pobox.com