This file explains how to install rcd.
Please read the README file before (it explains what rcd is).

How to install ?
Well, simply copy the files in a directory. The example I will use is a home
directory:
	~/rcd

1- first, create the "rcd" directory:
	cd ~
	mkdir rcd
	cd rcd

You are now in the rcd directory, ~/rcd
You can copy the files herein.

2- you're not expected to put the rcd directory in your path. The method I use
is an alias.
You should put this alias at the end of the file ~/.profile, if it exists, or
in your file /etc/profile (if you have root priviledges).
If you have no ~/profile and cannot access the /etc/profile, you can create
a ~/.profile and insert the line ".profile" in your shell rc (.bashrc, .cshrc
or .shrc, etc).
You can also put the alias in the .cshrc, I hope it works, too.

The line you should write in the ~/.profile is:

	alias rcd = '~/rcd/rcd ; cd $(cat /tmp/rcd.lastdir)'

If you use the Bourne Shell, you should prefer the following line:

	alias rcd = '~/rcd/rcd ; cd `cat /tmp/rcd.lastdir`'

Be carrefull: the Bourne Shell symbol replacing the parenthesis is a backquote.
In both case, you should replace "~/rcd" by the rcd directory you have chosen
before.


3- you can add the manpage to your system:

	cp rcd.man1 /usr/man/man1/rcd.1

	(you can create the directory if it doesn't exist)

If you don't want to or can't add the manpage to the /usr/man/man1, you
can have it printed by the command line:

	groff -Tascii -mandoc rcd.man1 | less

If you're not under Linux, replace "less" by "more":

	groff -Tascii -mandoc rcd.man1 | more


4- Well, that's all. You can reread your profile by exiting the shell and
entering a new one or by the command "source .profile".

If you want to use rcd, simple type "rcd" (this uses the alias)
The alias doesn't allow you to pass command line parameters to rcd. The
way you can pass them is by typing "~/rcd/rcd -? -r...(etc)" to call it.

If you need on-line help, type: ~/rcd/rcd -?

4- you can mail me at moll@etu.univ-compiegne.fr

Au revoir.


