added documentation to top level perldoc