Fix the documentation about the -i<dirs> option.  These are scanned
left to right, but before the package directories.  Also add a
suitably severe warning about having a module with the same name as a
package module.