encouraging the starred form, arguments of environments should not
contain multiple paragraphs.
Some environments should not, others should. I don't see any reason to
either encourage or discourage either form in a reference manual. It
should describe the facts of what's available. -k