Fix up and document input parameters
Fix up and document input parameters

In walking through fixing SSL parameters, it became clear that we have
several confusing or vestigal parameters. Walk through and fix them all
to make them clearer. Also - let people pass through params through the
openstack_clouds code path.

Change-Id: Idc5823ed470e3f973a23504db9d7b179396690e8

dtroyer/python-openstacksdk,openstack-infra/shade,stackforge/python-openstacksdk,stackforge/python-openstacksdk,jsmartin/shade,openstack-infra/shade,openstack/python-openstacksdk,jsmartin/shade,openstack/python-openstacksdk,dtroyer/python-openstacksdk