some convenience functions and docu