Hello there, if you're trying to get some help/info with the patches I've made for portage-utils (with overlay [and paludis] support), then you should read the portage-utils description on the paludis-extras web site.
This is just a quick overview of what has change from the vanilla portage-utils (which doesn't work with paludis nor has overlay support by the way..).
If you're not using gentoo, and paludis, then you probably have nothing to do with this.

Here are some of the nice things you can do with portage-utils
Listing your configured overlays (ebuild format only)

sam@truc ~ $ q --ls-overlays Overlay(s) : Name : einit location : /var/repos/einit metadata : /var/cache/metadata/einit Name : initng location : /var/repos/initng metadata : /var/empty Name : local location : /var/repos/local metadata : /var/cache/metadata/local Name : gentoo location : /var/repos/gentoo metadata : /var/repos/gentoo/metadata/cache

Basically, an option --overlay arg has been added to qgrep, qsearch, quse, qlop. Use it to restrict the given action for an overlay. There is often several verbosity level, I won't list them all for every tool, but here is an example
Listing installed package from the dev-util category

sam@truc ~ $ qlist --installed dev-util/ dev-util/ctags dev-util/cvs ... dev-util/subversion dev-util/unifdef dev-util/valgrind

Now, if you also want to know which version is installed, then add --verbose switch, and a second one if you also want to know from which repositories it was installed:
Listing installed package from the dev-util category with version and overlay

sam@truc ~ $ qlist --installed dev-util/ -vv dev-util/ctags-5.6::gentoo dev-util/cvs-1.12.12-r4::gentoo ... dev-util/subversion-1.4.3::gentoo dev-util/unifdef-1.20::gentoo dev-util/valgrind-3.2.3::gentoo

Need to search for a package in the app-portage/but in one specific overlay?
Searching a package in the app-portage category in the paludis-extras overlay

sam@truc ~ $ qsearch app-portage/ -o paludis-extras app-portage/gentoolkit::paludis-extras Collection of administration scripts for Gentoo (Paludis) app-portage/portage-utils::paludis-extras small and fast paludis helper tools written in C

Want to list the packages of one repository
Listing packages from one repository and their description

sam@truc ~ $ qsearch -o local '' dev-lang/tcl::local Tool Command Language dev-lang/tk::local Tk Widget Set media-sound/ncmpc::local A ncurses client for the Music Player Daemon (MPD) svn version net-im/centerim::local CenterIM is a fork of CenterICQ - a ncurses ICQ/Yahoo!/AIM/IRC/MSN/Jabber/GaduGadu/RSS/LiveJournal Client # or, the following way which accept partial name for overlay (might be a little slower though) sam@truc ~ $ qsearch ::cal dev-lang/tcl::local Tool Command Language dev-lang/tk::local Tk Widget Set media-sound/ncmpc::local A ncurses client for the Music Player Daemon (MPD) svn version net-im/centerim::local CenterIM is a fork of CenterICQ - a ncurses ICQ/Yahoo!/AIM/IRC/MSN/Jabber/GaduGadu/RSS/LiveJournal Client