#140 added better output so its easier to see which things worked and failed; also fixed completion on the --profile option
#140 added some docs on the offline repo
avoid possible NPE
#140 added test case and better diagnostic errors when things don't work
zapped old crusty doc
#140 tidy the docs