document allowed uses for 'out' parameters.