documenting ‘pretty’ parameter