added some output features and improved documentation