Installation
~~~~~~~~~~~~
1) Get the latest software release from [1]


2) Create a temporary directory for building the binary 
   and extract the archive there: 

Stella:~> cd /tmp && mkdir -p vared && cd vared
Stella:/tmp/vared> gzip -dc .../vared_x.x.x.orig.tar.gz | tar xf -


3) Compile the application and install the binary, documentation and
   example files: 

Stella:/tmp/vared> make
Stella:/tmp/vared> make strip
Stella:/tmp/vared> make install

You may need to gain administrative access rights before installation.

The default installation location is in the /usr/local/ directory
tree. You may override this with some other location:

Stella:/tmp/vared> make INSTALLDIR=/some/other/location install


5) Copy the shell code which is approbiate for your shell to your
   home directory and source it. Example for csh:

Stella:/tmp/vared> cp alias.csh ~/.alias.vared
Stella:/tmp/vared> echo "source ~/.alias.vared" >> ~/.cshrc

After starting a new shell you should have a new shell function or
an alias named vared at your hand.


Example
~~~~~~~

This example shows the usage of vared. The value of $PATH is shown before
and after manipulating it with vared. During editing you can use all readline
goodies like copy&paste, jumping to the begin or to the end of the line etc.


Stella:~> echo $PATH
/usr/share/qt/bin:/usr/local/java/javaee5sdk5/bin:/usr/local/java/javaee5sdk5/jdk/bin:/usr/local/bin:/usr/local/H-PCTE//scm/bin:/usr/local/java/javaee5sdk5/bin:/usr/local/bin:/usr/bin:/bin:/usr/bin/X11:/usr/games:/usr/local/bin:/usr/local/MuPAD/share/bin:/usr/games:/home/test/bin

Stella:~> vared PATH
/home/test/bin:/usr/share/qt/bin:/usr/local/java/javaee5sdk5/bin:/usr/local/bin:/usr/bin:/bin:/usr/bin/X11:/usr/games:/usr/local/bin:/usr/local/MuPAD/share/bin:/usr/games

Stella:~> echo $PATH
/home/test/bin:/usr/share/qt/bin:/usr/local/java/javaee5sdk5/bin:/usr/local/bin:/usr/bin:/bin:/usr/bin/X11:/usr/games:/usr/local/bin:/usr/local/MuPAD/share/bin:/usr/games


Feedback
~~~~~~~~
Feel free to contact me (pkgs@c0t0d0s0.de) and tell me your opinion about
vared. I'm a (t)csh-user (You should know why ;-), so interoperability with
other shells ins't tested very well. I like to hear which shell you are
using and how it can be expanded with vared. 


License
~~~~~~~
All vared stuff is released under the GNU General Public License [2],
Version 2.


Footnotes
~~~~~~~~~
[1] http://www.c0t0d0s0.de/vared/vared.html
[2] http://www.gnu.org/licenses/gpl.html