Improved javadocs and misleading error message around foreign collection
construction.