some new rustdocs for path:: module
removed some obsolete stuff from README