==================================================================
   exd - Change directory using any number of starting letters
   Copyright (C) 2005 A. Bram Neijt <b.neijt@ai.rug.nl>

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software Foundation,
   Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
=====================================================================


Introduction
============
exd is a program to change directories using a concatination of any of the 
beginning letters of the direcotries in the destination path.
The gool is to let the user be as specific as needed, and no more then that.
While still allowing the user to be sloppy (adding more characters then needed).

The program is a spinoff of the xd project by Frank B. Brokken <frank@icce.rug.nl>. This is does almost the same, however doesn't allow multiple characters per directory. Please visit ftp://ftp.rug.nl/contrib/frank/software/linux/xd/ for more information on xd.

Building
========
To build the program run ccbuild in the src directory.
(For ccbuild, see: http://www.ai.rug.nl/~bneijt/prog/C++/ccbuild )

Installation
============
To use the program you need to create an alias to allow the exd program to work.
The simplest way is add the following line to your ~/.bashrc file.

function xd () { cd "`exd \$*`"; }

This is also the place to put default options, like case insensitive matching with the '-i' option.


Example of use
==============
Say you want to go to "/usr/share/libxklavier".
Simply using "xd /usl" will get you something like this:

[24] /usr/share/libgnomeprint
[22] /usr/share/libxklavier
[21] /usr/share/libgphoto2
[21] /usr/share/latex2html
[19] /usr/sbin/lpdomatic
[18] /usr/share/lintian
[18] /usr/share/libtool
[18] /usr/share/libming
[17] /usr/share/locale
[17] /usr/share/libofx
[17] /usr/share/libgda
[16] /usr/share/linda
[15] /usr/src/linux
[15] /usr/share/lilo
[15] /usr/share/ldap
[14] /usr/sbin/lsof
[10] /usr/local
[8] /usr/lib
Choosing: /usr/share/libgnomeprin

As you can see, the rating system makes sure the longest is chosen. To make sure you will go to "/usr/share/libxklavier" you will have to be more specific.
"xd /uslibx"
This will get you into the /usr/share/libxklavier directory.

Being specific
==============
The following can be used to be more specific:
1. Use more letter. By adding letters you remove the number of posibilities
2. Use slashes to force directory seperation between matching letters.


Documentation
=============
To generate documentation, please run doxygen in the root of this project (where the Doxyfile resides).

When loosing hope
=================
Email me: A. Bram Neijt <bneijt@gmail.com>