minor fixes and enhancements to manual and scaladoc