documentation in __init__.py now links to basinhopping

make several changes suggested from the pull request thread