wrapped up functionality; minor documentation