Document default open_out parameters
Document default open_out parameters

For some reason the per-parameter definitions for the polymorphic
variant type open_out_flags are not being generated.  This patch
replicates the documentation change for `trunc in the mli file, and
also provides a general doc comment for the type defining the default
parameters.

bennn/batteries-included