 _______           _______  _______  _______  _______  _______
(       )|\     /|(  ____ \(  ____ \(  ___  )(  ____ )(  ____ \|\     /|
| () () || )   ( || (    \/| (    \/| (   ) || (    )|| (    \/| )   ( |
| || || || |   | || (_____ | (__    | (___) || (____)|| |      | (___) |
| |(_)| || |   | |(_____  )|  __)   |  ___  ||     __)| |      |  ___  |
| |   | || |   | |      ) || (      | (   ) || (\ (   | |      | (   ) |
| )   ( || (___) |/\____) || (____/\| )   ( || ) \ \__| (____/\| )   ( |
|/     \|(_______)\_______)(_______/|/     \||/   \__/(_______/|/     \|
                                                     __   ______ _________
                                                    /  | / __   (_______/ |
                                                   /_/ || | //| |  ____ | | _
                                                     | || |// | | (___ \| || \
                                                     | ||  /__| |_____) ) |_) )
                                                     |_(_)_____/(______/|____/



Installation:

 - Decompress musearch
 - Give execution rights to the script:
     $ chmod +x musearch

musearch is ready to run. You can copy it to your /usr/bin directory if you want
in order for it to be accessible from anywhere and for all users:

 - Copy musearch (do not move) as root in /urs/bin in order to get proper ownership.
     $ su -c "cp musearch /usr/bin/"


-----------------------------------------------------------------------------

Usage:

 - Simplest way to call it:
     $ musearch query-string
 
 - If you have eix or esearch install you can use the switches -x, -s to make your
   searches quicker:
     $ musearch -x query-string
   I advise strongly on that since it makes a difference. ;-)
 
 - With -S the search extends to the description of the ebuilds as well:
     $ musearch -s -S query-string
 
 - With -d you can use the specific name of an ebuild in category/package-name
   format. This is very useful because if you can't narrow your search down you
   will cause unnecessary traffic to gentoo-portage.com.
     $ musearch -d gnome-base/gnome 
 
 - In case you need more help use -h or --help. ;-)
 
 - The script will ask for your permission in order to query USE flags for more
   than 5 ebuilds at a time and will refuse completely to search for more than 20
   ebuilds concurrently in order to not cause excess traffic to gentoo-portage.com.