add some commented documentation for the .out method options