Merged from trunk 5937:5961 (hi genone!)

Merged from trunk 5937:5961 (hi genone!)

add docstrings (WarnerBro)

Move dbapi and related classes  out of __init__.py into their own
subpackage.  Also perform some minor cleanups. (genone)

fix syntax

Fix imports from the emerge package.

Fix automatic sys.path insertions so that they're relative instead of
absolute hard coded.

remove broken dblink import

fix broken imports

Use os.path.realpath to handle symlinks properly.

Break a recursive loop.

Fix missing stat import.

Fix vardb.cpv_all() breakage.

Add missing VDB_PATH to fix vardbapi.aux_get() breakage.

Make xterm titles work even when color is disabled.  Thanks to Joachim
Kaeber <joachim.kaeber@web.de> in bug #166255.

Use the real symbols in import statements, not the references in
__init__.py (genone)

import best() from portage.versions

Make subpackage naming consistent (genone)

In the event of a circular dependency panic, eliminate root nodes in
order to reduce the noise level to a minimum.

tweak PORT_LOGDIR comments so as to not give the wrong impression about
the default value (SpankMan)

Fix missing imports.

Detect potential issues with mtime granlarity in env_update() and sleep
if necessary.  Thanks to Brian Harring for reporting.

svn path=/main/branches/prefix/; revision=5962