Installation instructions for ctail 0.1
=======================================

Prerequisites: 
--------------

    - Perl
    - the Curses Perl module

If you don't have those installed and want to know how to do so, see below 
(-> Obtaining and installing Perl and Curses).


Installation:
-------------

Step 1: adjusting the path to Perl
----------------------------------

The file "ctail" is a Perl script. You should open it in your favorite text
editor and make sure that the path to the Perl binary is correct in the 
file's first line. This first line should usually look like this:

#!/usr/bin/perl

or

#!/usr/local/bin/perl


Step 2: copying ctail and its man page
--------------------------------------

Copy "ctail" to where you want it installed to. Example:

cp ctail /usr/local/bin

Depending on your target directory, you might require root privileges for this
step.

Then, copy the included man page ctail.1 to the man1 subdirectory of any
suitable directory in your MANPATH. Example:

cp ctail.1 /usr/local/man/man1


Checking the installation
-------------------------

Run these commands to verify that ctail has been successfully installed:

1. ctail --help
2. man ctail

That's it! :-)


Obtaining and installing Perl and Curses
========================================

Installing Perl
---------------

Go to http://www.perl.com, download and install Perl. There's plenty of
documentation available, though "./Configure -de && make && make install"
probably will work well for your system.

Installing the Curses module
----------------------------

The easiest way to do so is to run

perl -MCPAN -eshell

If it's the first time you run this command, you'll be asked a couple of
questions, but the default answers are fine in most cases, the only thing
you'll have to pick is the CPAN mirror closest to you, everywhere else you can
just hit Enter if you're in a hurry.

Then, on the CPAN shell, just issue the command

install Curses

and the Curses module will be downloaded, compiled and installed
automatically. You're done!

If you, for any reason, don't want to use the CPAN shell to install Curses,
you of course can download if from www.cpan.org and install it manually.