fixed up docs and examples further.