more clever path finding

But still not optimal
DB Javadoc terror

All crucial javadocs are done.
Merge remote-tracking branch 'origin/db-hibernate2'